@genesislcap/ai-assistant 15.23.3 → 15.24.0

package/dist/dts/components/orchestrating-driver/orchestrating-driver.d.ts

@@ -286,4 +286,20 @@ export declare class OrchestratingDriver extends EventTarget implements AiDriver
      */
     private appendInlineMessage;
 }
+/**
+ * Narrow a driver to an orchestrator, or `undefined` for a bare `ChatDriver`.
+ *
+ * **The one place in the package that tests for this type** (`docs/code-health.md`
+ * §11.2 constraint 3). Orchestration-only capabilities — the agent pin, the
+ * flow-owner lock, the context guard — are reached through it, so when §7.1 lifts
+ * those onto `AiDriver` and they stop being orchestrator-only, this function is
+ * what changes rather than every consumer.
+ *
+ * Lives beside the class rather than on the assistant element because two modules
+ * need it: the element (for its own driver) and the session persister (for the
+ * driver it restores into), and a private element accessor cannot serve both.
+ *
+ * @internal
+ */
+export declare function asOrchestrator(driver?: AiDriver): OrchestratingDriver | undefined;
 //# sourceMappingURL=orchestrating-driver.d.ts.map

package/dist/dts/components/orchestrating-driver/orchestrating-driver.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"orchestrating-driver.d.ts","sourceRoot":"","sources":["../../../../src/components/orchestrating-driver/orchestrating-driver.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"orchestrating-driver.d.ts","sourceRoot":"","sources":["../../../../src/components/orchestrating-driver/orchestrating-driver.ts"],"names":[],"mappings":"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"}

package/dist/dts/components/settings-modal/index.d.ts

@@ -1,3 +1,4 @@
+export { SettingsModalController, type SettingsModalDeps, type SettingsModalTabsElement, } from './settings-modal';
 export { SettingsModalTemplate, type SettingsModalTab } from './settings-modal.template';
 export { settingsModalStyles } from './settings-modal.styles';
 //# sourceMappingURL=index.d.ts.map

package/dist/dts/components/settings-modal/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/settings-modal/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,KAAK,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AACzF,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/settings-modal/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,uBAAuB,EACvB,KAAK,iBAAiB,EACtB,KAAK,wBAAwB,GAC9B,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,qBAAqB,EAAE,KAAK,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AACzF,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/dts/components/settings-modal/settings-modal.d.ts

@@ -0,0 +1,215 @@
+import type { ChatConfig } from '@genesislcap/foundation-ai';
+import type { Modal } from '@genesislcap/rapid-design-system';
+import type { SettingsContextUsage } from '../../main/main.types';
+import type { AssistantAppSettingsHeading, AssistantAppSettingsProvider, AssistantAppSettingsToggle } from '../../provider/assistant-app-settings';
+import type { MetaEventType } from '../../state/debug-event-log';
+import type { ResolvedCostHistoryConfig } from '../../utils/resolve-cost-history-config';
+import type { SettingsModalTab } from './settings-modal.template';
+/** Design-system tabs element bound to the settings modal tab bar. */
+export type SettingsModalTabsElement = HTMLElement & {
+    activeid?: string;
+};
+/**
+ * What the controller needs from its host.
+ *
+ * The DOM refs (`modal`, `tabsEl`) are callbacks rather than controller state
+ * because the template owns them: it writes them by name through `ref(...)`, so
+ * they have to stay real properties on the element. The same is NOT true of the
+ * four `*Slotted` arrays — `slotted(...)` also writes by name, but those are read
+ * by the visibility getters, so the controller owns them and the element keeps
+ * delegating get/**set** pairs for the template to write through.
+ */
+export interface SettingsModalDeps {
+    chatConfig: () => ChatConfig;
+    contextTokens: () => number | undefined;
+    contextLimit: () => number | undefined;
+    /** The budget meter's own gate — the money sibling of the context indicator. */
+    budgetUsageVisible: () => boolean;
+    /** Resolved `chatConfig.costHistory`, owned by the cost ledger. */
+    costConfig: () => ResolvedCostHistoryConfig;
+    costHistoryLength: () => number;
+    liveCostSessionTitle: () => string | undefined;
+    providerStatusCount: () => number;
+    /**
+     * The live session store, read only to keep the lifetime-usage gate reactive to
+     * a session swap — it depends on `getStateKey()`, which is not observable.
+     */
+    sessionRef: () => unknown;
+    stateKey: () => string | undefined;
+    popoutMode: () => string | undefined;
+    headerTitle: () => string | undefined;
+    appSettingsProvider: () => AssistantAppSettingsProvider;
+    modal: () => Modal | undefined;
+    tabsEl: () => SettingsModalTabsElement | undefined;
+    /** Asked for on open, so the figures are fresh when someone is looking at them. */
+    requestBudgetRefresh: () => void;
+    logMeta: (type: MetaEventType, detail?: Record<string, unknown>) => void;
+}
+/**
+ * The settings modal: which of its sections have anything in them, the two-tab
+ * state, and the design-system tab bar's selection and underline.
+ *
+ * This file is also the `settings-modal.ts` the folder never had (`docs/code-health.md`
+ * §3) — the 943-line template and 853-line stylesheet previously bound against a
+ * component that existed only as ~25 getters on the assistant element.
+ *
+ * **Every section gate answers "is there anything in here", never "should this
+ * feature exist".** A slot with no assigned nodes, a toggle list whose `visible()`
+ * predicates all say no, a cost tab with nothing switched on — each collapses its
+ * own container rather than leaving a heading over emptiness or a flex gap after
+ * nothing. That is why the gates nest (`…HeadingVisible` is broader than
+ * `…SectionVisible`) instead of each re-deriving the config.
+ *
+ * @internal
+ */
+export declare class SettingsModalController {
+    private readonly deps;
+    /** Whether the modal is open. */
+    open: boolean;
+    /** Active tab. Reset to `'settings'` on every open and close — see `openModal`. */
+    tab: SettingsModalTab;
+    /**
+     * Bumped to re-render the app toggles when the host provider notifies a change.
+     *
+     * A revision counter rather than a copy of the provider's values: the provider
+     * owns them, may compute `visible()` and `getValue()` on demand, and is free to
+     * change without telling us which entry moved. Every toggle getter reads this
+     * first, so one bump invalidates the lot.
+     */
+    appSettingsRevision: number;
+    /**
+     * Light-DOM nodes assigned to the modal's four slots, written by the template's
+     * `slotted(...)` bindings through the element's delegating setters.
+     */
+    modelSlotted: HTMLElement[];
+    appSlotted: HTMLElement[];
+    costCurrentSlotted: HTMLElement[];
+    costHistorySlotted: HTMLElement[];
+    private unsubAppSettingsProvider?;
+    constructor(deps: SettingsModalDeps);
+    /** Whether the AI Model section has slotted content, context usage or budget figures. */
+    get modelSectionVisible(): boolean;
+    /** Built-in context window indicator (generic platform concern). */
+    get contextUsageVisible(): boolean;
+    /**
+     * The indicator's figures, pre-formatted, or `undefined` when there is nothing
+     * measurable — see {@link SettingsContextUsage} for why absence is the point.
+     *
+     * The gate above and this getter must agree on when there is something to show,
+     * so both test exactly `tokens != null && limit != null`. A zero `limit` is
+     * therefore still "showable" and still renders `Infinity%`, exactly as before;
+     * that is a separate (and much more obscure) question about a provider
+     * reporting a zero-token window, and silently changing it here would move
+     * behaviour under cover of a bug fix.
+     */
+    get contextUsage(): SettingsContextUsage | undefined;
+    /** Whether the UI Builder section should render. */
+    get appSectionVisible(): boolean;
+    /** App toggles currently visible per each entry's `visible()` predicate. */
+    get visibleAppSettingsToggles(): AssistantAppSettingsToggle[];
+    /**
+     * Host-supplied heading for the toggle group, or `undefined` for none — the
+     * assistant has no default. Suppressed when no toggle is currently visible, so a
+     * `visible()` predicate hiding the last one takes its heading with it rather
+     * than leaving a label over nothing.
+     */
+    get appSettingsTogglesHeading(): AssistantAppSettingsHeading | undefined;
+    getAppSettingValue(id: string): boolean;
+    setAppSettingValue(id: string, value: boolean): void;
+    /** Subscribe to host provider changes. Re-entrant: unwires any previous subscription first. */
+    wireAppSettingsProvider(): void;
+    unwireAppSettingsProvider(): void;
+    get costCurrentSectionVisible(): boolean;
+    /**
+     * Whether the build-history section has anything in it — the built-in row list,
+     * or a host's own markup in the `settings-cost-history` slot.
+     *
+     * Slotted content is checked FIRST, ahead of `enabled`. That flag governs the
+     * *built-in* ledger: it gates the row writes, the reload, and the lifetime sum —
+     * and it defaults to `false` (`cost?.enabled === true`), while the Usage tab
+     * itself shows for `showCost`/`showTokens`, which default true. So a host can
+     * legitimately render its own build history into the slot and never opt into our
+     * `localStorage` ledger. Short-circuiting on `enabled` above the slot check hid
+     * that host's markup outright, since the slot is the only thing in the container.
+     */
+    get costHistorySectionVisible(): boolean;
+    /**
+     * Whether the "Build history" heading has anything under it.
+     *
+     * Broader than {@link SettingsModalController.costHistorySectionVisible} because
+     * the heading also covers the lifetime total, which renders before the first row
+     * exists (rows are written as spend accrues, the lifetime section only needs
+     * history switched on). Gating the heading on the rows alone left that total
+     * sitting under nothing.
+     */
+    get costHistoryHeadingVisible(): boolean;
+    /** Whether the built-in Usage tab summary block has anything to show. */
+    get costSummaryVisible(): boolean;
+    /**
+     * Whether the lifetime-usage section has anything to say.
+     *
+     * Requires build history: with it off there are no rows, so `cumulativeUsage`
+     * falls back to the live session and the section would restate the block
+     * directly below it under a "lifetime" heading it hasn't earned.
+     */
+    get costLifetimeVisible(): boolean;
+    /** Whether the Usage tab should appear at all. */
+    get costTabVisible(): boolean;
+    /** Whether session token usage should render on the Usage tab. */
+    get sessionTokensVisible(): boolean;
+    /**
+     * Whether the chat header (and settings cog) should render — i.e. whether the
+     * modal would have anything in it at all. The one gate that asks about the whole
+     * feature rather than one section, which is why it enumerates the config flags
+     * instead of composing the section gates: a section can be empty right now and
+     * still be configured on, and the cog must not flicker with its contents.
+     */
+    get cogVisible(): boolean;
+    /**
+     * Open the modal, resetting to the Settings tab.
+     *
+     * The `show()` call is deferred through a self-requeueing update because the
+     * modal is a template `ref` — on the very first open it does not exist yet, so
+     * this waits for FAST to bind it rather than dropping the open. Bails if
+     * something closed the modal while it waited.
+     */
+    openModal(): void;
+    /**
+     * Close the modal.
+     *
+     * When the design-system modal is genuinely open, `close()` is all this does:
+     * that fires its own dismiss event, which lands in {@link SettingsModalController.onClosed}
+     * and clears the state there. Clearing it here as well would run the reset twice
+     * and race the modal's own closing animation.
+     */
+    closeModal(): void;
+    /** The modal's own dismiss path — a backdrop click or Escape, as well as `closeModal`. */
+    onClosed(): void;
+    /** Select a tab, refusing one that is not currently available. */
+    setTab(tab: SettingsModalTab): void;
+    /** Sync the active tab when the design-system tab bar changes. */
+    onTabsChange(event: Event): void;
+    /**
+     * Ensure the Settings tab is selected when the modal opens.
+     *
+     * Driven by `click()` rather than by writing `activeid`, because the
+     * design-system tab bar owns its own selection and animation state; clicking is
+     * the only path that updates all of it coherently. Each branch returns after
+     * clicking, since the resulting `change` event brings us back here.
+     */
+    private resetTabsOnOpen;
+    /** Return to the Settings tab when the modal closes on Usage. */
+    private resetTabsOnClose;
+    /**
+     * Snap the tab underline to the Settings tab without animating from Usage.
+     * Used after hide/show when the aria state is correct but the indicator drifted.
+     *
+     * Reaches into the tab bar's private fields, which is deliberate and contained:
+     * the design system exposes no way to reposition the indicator without a
+     * transition, and re-entering through `click()` here would animate the very
+     * slide this exists to suppress. One retry, because the indicator is inside the
+     * tab bar's shadow root and may not be rendered on the first pass.
+     */
+    private snapTabIndicator;
+}
+//# sourceMappingURL=settings-modal.d.ts.map

package/dist/dts/components/settings-modal/settings-modal.d.ts.map

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

package/dist/dts/components/settings-modal/settings-modal.template.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"settings-modal.template.d.ts","sourceRoot":"","sources":["../../../../src/components/settings-modal/settings-modal.template.ts"],"names":[],"mappings":"AACA,OAAO,EAAoC,KAAK,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAC5F,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAqH7D;;;;;;;GAOG;AACH,MAAM,MAAM,gBAAgB,GAAG,UAAU,GAAG,MAAM,CAAC;AA2InD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,2BAA2B,GACtC,aAAa,MAAM,EACnB,WAAW,MAAM,EACjB,SAAS,MAAM,KACd,YAAY,CAAC,qBAAqB,CAUpC,CAAC;AA4aF;;;GAGG;AACH,eAAO,MAAM,qBAAqB,GAChC,oBAAoB,MAAM,KACzB,YAAY,CAAC,qBAAqB,CA+MpC,CAAC"}
+{"version":3,"file":"settings-modal.template.d.ts","sourceRoot":"","sources":["../../../../src/components/settings-modal/settings-modal.template.ts"],"names":[],"mappings":"AACA,OAAO,EAAoC,KAAK,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAC5F,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAqH7D;;;;;;;GAOG;AACH,MAAM,MAAM,gBAAgB,GAAG,UAAU,GAAG,MAAM,CAAC;AAsJnD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,2BAA2B,GACtC,aAAa,MAAM,EACnB,WAAW,MAAM,EACjB,SAAS,MAAM,KACd,YAAY,CAAC,qBAAqB,CAUpC,CAAC;AA4aF;;;GAGG;AACH,eAAO,MAAM,qBAAqB,GAChC,oBAAoB,MAAM,KACzB,YAAY,CAAC,qBAAqB,CA+MpC,CAAC"}

package/dist/dts/main/attachment-controller.d.ts

@@ -0,0 +1,66 @@
+import type { ChatAttachment } from '@genesislcap/foundation-ai';
+import type { MetaEventType } from '../state/debug-event-log';
+/** The outcome of reading a batch of picked files. */
+export interface ProcessedFiles {
+    attachments: ChatAttachment[];
+    errors: string[];
+}
+/** What the controller needs from its host beyond the shadow root. */
+export interface AttachmentDeps {
+    /** `chatConfig.ui.acceptedFiles` — unset means attachments are off entirely. */
+    acceptedFiles: () => string | undefined;
+    logMeta: (type: MetaEventType, detail?: Record<string, unknown>) => void;
+}
+/**
+ * The composer's file attachments: what is pending on the next message, what was
+ * rejected and why, and the reading and validation that gets a picked `File` into
+ * a {@link ChatAttachment}.
+ *
+ * @internal
+ */
+export declare class AttachmentController {
+    /** Typed `HTMLElement` — the hidden file input is all this needs from the DOM. */
+    private readonly host;
+    private readonly deps;
+    /** Attachments pending on the next message. */
+    attachments: ChatAttachment[];
+    /** Rejection messages for files the last pick refused. */
+    errors: string[];
+    constructor(
+    /** Typed `HTMLElement` — the hidden file input is all this needs from the DOM. */
+    host: HTMLElement, deps: AttachmentDeps);
+    /** Open the OS file picker via the hidden input the template renders. */
+    triggerFileInput(): void;
+    /** `@change` on the hidden input. Fire-and-forget; the read is async. */
+    handleFileSelect(e: Event): void;
+    remove(attachment: ChatAttachment): void;
+    dismissError(message: string): void;
+    /**
+     * Hand the pending attachments to a send and clear both lists in one step.
+     *
+     * Read-and-clear as one method rather than two statements: the previous inline
+     * form copied the array and then blanked the fields separately, leaving a state
+     * the element could be observed in between the two.
+     */
+    take(): ChatAttachment[] | undefined;
+    /** Drop everything pending, without handing it anywhere. */
+    clear(): void;
+    /** Total bytes already committed, for budgeting a further pick against the cap. */
+    pendingBytes(): number;
+    /**
+     * Read and validate a batch of files without committing them — for
+     * `submitMessage({ files })`, which must be able to refuse the whole message
+     * rather than half-attach it.
+     */
+    process(files: File[], existingBytes?: number): Promise<ProcessedFiles>;
+    private isAccepted;
+    private readAsText;
+    /**
+     * The base64 payload of a file, without any `data:` prefix — the raw form
+     * `ChatImageAttachment.data` specifies (transports add their own framing).
+     */
+    private readAsBase64;
+    /** The picker path: read the picked files and APPEND whatever passed. */
+    private loadSelected;
+}
+//# sourceMappingURL=attachment-controller.d.ts.map

package/dist/dts/main/attachment-controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"attachment-controller.d.ts","sourceRoot":"","sources":["../../../src/main/attachment-controller.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAEjE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AA+D9D,sDAAsD;AACtD,MAAM,WAAW,cAAc;IAC7B,WAAW,EAAE,cAAc,EAAE,CAAC;IAC9B,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,sEAAsE;AACtE,MAAM,WAAW,cAAc;IAC7B,gFAAgF;IAChF,aAAa,EAAE,MAAM,MAAM,GAAG,SAAS,CAAC;IACxC,OAAO,EAAE,CAAC,IAAI,EAAE,aAAa,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;CAC1E;AAED;;;;;;GAMG;AACH,qBAAa,oBAAoB;IAO7B,kFAAkF;IAClF,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,IAAI;IARvB,+CAA+C;IACnC,WAAW,EAAE,cAAc,EAAE,CAAM;IAC/C,0DAA0D;IAC9C,MAAM,EAAE,MAAM,EAAE,CAAM;;IAGhC,kFAAkF;IACjE,IAAI,EAAE,WAAW,EACjB,IAAI,EAAE,cAAc;IAGvC,yEAAyE;IACzE,gBAAgB,IAAI,IAAI;IAIxB,yEAAyE;IACzE,gBAAgB,CAAC,CAAC,EAAE,KAAK,GAAG,IAAI;IAIhC,MAAM,CAAC,UAAU,EAAE,cAAc,GAAG,IAAI;IAIxC,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAOnC;;;;;;OAMG;IACH,IAAI,IAAI,cAAc,EAAE,GAAG,SAAS;IAOpC,4DAA4D;IAC5D,KAAK,IAAI,IAAI;IAKb,mFAAmF;IACnF,YAAY,IAAI,MAAM;IAItB;;;;OAIG;IACG,OAAO,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,aAAa,SAAI,GAAG,OAAO,CAAC,cAAc,CAAC;IAgFxE,OAAO,CAAC,UAAU;IAkBlB,OAAO,CAAC,UAAU;IAIlB;;;OAGG;YACW,YAAY;IAU1B,yEAAyE;YAC3D,YAAY;CAc3B"}