@mihe-dev/js 0.0.0-stage → 0.2.0

package/dist/store.d.ts

@@ -0,0 +1,175 @@
+/**
+ * The app's declaration of itself.
+ *
+ * Spec §5.1 — the host app publishes assistant-readable context rather than
+ * the assistant scraping the DOM. This store is where those declarations
+ * accumulate: the current screen from `useAssistantScreen`, the components
+ * that mounted under it from `useAssistantComponent`, and the action handlers
+ * from `useAssistantAction`.
+ *
+ * Deliberately framework-free and dependency-free. React binds to it through
+ * `useSyncExternalStore`, which keeps the store itself testable without a
+ * renderer and avoids pulling a state library into a published SDK.
+ */
+import type { ChartPoint, ChartSeries, ChartXKind, ComponentContext, ScreenContext, ViewControl } from "@mihe-dev/protocol";
+/** What a screen declares about itself, minus the components. */
+export interface ScreenDeclaration {
+    screenId: string;
+    route: string;
+    title: string;
+    description?: string;
+    keywords?: string[];
+    /**
+     * Summary values visible on screen. Keep this small and scalar — counts,
+     * totals, statuses. It is context for the assistant, not a data dump, and
+     * every byte here is sent on every screen change.
+     */
+    visibleData?: Record<string, unknown>;
+    /**
+     * The page's data has not arrived yet. While true, `visibleData` is not
+     * sent, and a navigation to this screen is not reported done.
+     *
+     * Without it, the counts a page declares before its queries resolve are
+     * zeros, and an assistant that has just navigated here reads them as the
+     * truth: "you have no raw materials", on a page about to show sixteen.
+     */
+    loading?: boolean;
+}
+/** What a component declares about itself. */
+export interface ComponentDeclaration {
+    type: ComponentContext["type"];
+    label: string;
+    description?: string;
+    actions?: string[];
+}
+/**
+ * A tab set, or another control that changes what the screen shows
+ * (amendment 67). `onChange` is the app's own code, which is what lets this
+ * work however the tabs are built.
+ */
+export interface ViewControlDeclaration {
+    kind: ViewControl["kind"];
+    label: string;
+    options: {
+        value: string;
+        label: string;
+    }[];
+    value?: string;
+    onChange: (value: string) => void | Promise<void>;
+}
+/**
+ * A table the assistant can read (amendment 67, step 2). The rows stay here,
+ * read through `read_table` when a question needs them.
+ */
+export interface TableDeclaration {
+    label: string;
+    columns: {
+        key: string;
+        label: string;
+    }[];
+    /** The input name a row's id fills, such as `orderId`. */
+    rowIdName?: string;
+    /** The screen a row opens. Each row read carries its `open` params. */
+    opens?: string;
+    /** Rows in the whole list, when the page shows only some. */
+    total?: number;
+    /** How many rows are loaded, for the screen context. */
+    loadedRows: number;
+    /** The rows as they are right now, rendered to declared columns only. */
+    read: (offset: number, limit: number) => TableRow[];
+    /** How the table can be searched past its loaded rows (amendment 67, step 3). */
+    query?: TableQueryDeclaration;
+}
+/** One parameter a table search accepts, as the page declared it. */
+export interface QueryParamDeclaration {
+    key: string;
+    kind: "text" | "enum" | "date";
+    /** For `enum`: the values accepted. */
+    values: string[];
+    description: string;
+}
+/** A table's search: what it takes, and the app's code that runs it. */
+export interface TableQueryDeclaration {
+    params: QueryParamDeclaration[];
+    /** Runs the app's own search and renders the result to declared columns. */
+    run: (params: Record<string, string>) => Promise<{
+        rows: TableRow[];
+        total?: number;
+    }>;
+    /** Makes the table on screen show this search, when the page can. */
+    show?: (params: Record<string, string>) => void | Promise<void>;
+}
+/**
+ * One row as the model sees it: its id, the params that open it when the
+ * table opens a screen, and each declared column by label.
+ */
+export type TableRow = {
+    id: string;
+    open?: Record<string, string>;
+} & Record<string, string | number | boolean | null | Record<string, string> | undefined>;
+/** A chart the assistant can explain (amendment 67, step 4). */
+export interface ChartDeclaration {
+    title: string;
+    xLabel: string;
+    xKind: ChartXKind;
+    /** Names, units and summaries, as the screen context carries them. */
+    series: ChartSeries[];
+    /** The points as they are right now, thinned to `limit` per series. */
+    read: (series: string | undefined, limit: number) => {
+        name: string;
+        points: ChartPoint[];
+    }[];
+}
+/** A frontend action the assistant may run. */
+export interface ActionHandler {
+    name: string;
+    handler: (input: Record<string, unknown>) => unknown | Promise<unknown>;
+}
+type Listener = () => void;
+export declare class AssistantStore {
+    private screen;
+    /** Insertion-ordered, so the context sent to the model is stable. */
+    private components;
+    private controls;
+    private tables;
+    private charts;
+    /** Values a component on the screen adds to its `visibleData`, by key. */
+    private values;
+    private actions;
+    private listeners;
+    /** Cached so `useSyncExternalStore` sees a stable reference between changes. */
+    private snapshot;
+    private snapshotDirty;
+    subscribe: (listener: Listener) => (() => void);
+    /**
+     * The current screen context, or null before any screen has registered.
+     *
+     * Returns the same object until something actually changes, so React can
+     * bail out of re-rendering and the provider can skip republishing.
+     */
+    getScreenContext: () => ScreenContext | null;
+    setScreen(screen: ScreenDeclaration): void;
+    clearScreen(screenId: string): void;
+    registerComponent(componentKey: string, meta: ComponentDeclaration): void;
+    unregisterComponent(componentKey: string): void;
+    registerControl(controlKey: string, control: ViewControlDeclaration): void;
+    unregisterControl(controlKey: string): void;
+    getControl(controlKey: string): ViewControlDeclaration | undefined;
+    registerTable(tableKey: string, table: TableDeclaration): void;
+    unregisterTable(tableKey: string): void;
+    getTable(tableKey: string): TableDeclaration | undefined;
+    setValues(key: string, values: Record<string, unknown>): void;
+    clearValues(key: string): void;
+    registerChart(chartKey: string, chart: ChartDeclaration): void;
+    unregisterChart(chartKey: string): void;
+    getChart(chartKey: string): ChartDeclaration | undefined;
+    registerAction(action: ActionHandler): void;
+    unregisterAction(name: string): void;
+    getAction(name: string): ActionHandler | undefined;
+    /** Whether the current screen says its data is still loading. */
+    isScreenLoading(): boolean;
+    hasComponent(componentKey: string): boolean;
+    private invalidate;
+}
+export {};
+//# sourceMappingURL=store.d.ts.map

package/dist/store.d.ts.map

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

package/dist/store.js

@@ -0,0 +1,208 @@
+/**
+ * The app's declaration of itself.
+ *
+ * Spec §5.1 — the host app publishes assistant-readable context rather than
+ * the assistant scraping the DOM. This store is where those declarations
+ * accumulate: the current screen from `useAssistantScreen`, the components
+ * that mounted under it from `useAssistantComponent`, and the action handlers
+ * from `useAssistantAction`.
+ *
+ * Deliberately framework-free and dependency-free. React binds to it through
+ * `useSyncExternalStore`, which keeps the store itself testable without a
+ * renderer and avoids pulling a state library into a published SDK.
+ */
+export class AssistantStore {
+    screen = null;
+    /** Insertion-ordered, so the context sent to the model is stable. */
+    components = new Map();
+    controls = new Map();
+    tables = new Map();
+    charts = new Map();
+    /** Values a component on the screen adds to its `visibleData`, by key. */
+    values = new Map();
+    actions = new Map();
+    listeners = new Set();
+    /** Cached so `useSyncExternalStore` sees a stable reference between changes. */
+    snapshot = null;
+    snapshotDirty = true;
+    subscribe = (listener) => {
+        this.listeners.add(listener);
+        return () => {
+            this.listeners.delete(listener);
+        };
+    };
+    /**
+     * The current screen context, or null before any screen has registered.
+     *
+     * Returns the same object until something actually changes, so React can
+     * bail out of re-rendering and the provider can skip republishing.
+     */
+    getScreenContext = () => {
+        if (!this.snapshotDirty)
+            return this.snapshot;
+        this.snapshot = this.screen
+            ? {
+                screenId: this.screen.screenId,
+                route: this.screen.route,
+                title: this.screen.title,
+                description: this.screen.description ?? "",
+                keywords: this.screen.keywords ?? [],
+                visibleData: (this.screen.loading
+                    ? {}
+                    : {
+                        ...(this.screen.visibleData ?? {}),
+                        ...Object.fromEntries(this.values),
+                    }),
+                components: [...this.components.entries()].map(([componentKey, meta]) => ({
+                    componentKey,
+                    type: meta.type,
+                    label: meta.label,
+                    description: meta.description ?? "",
+                    actions: meta.actions ?? [],
+                })),
+                controls: [...this.controls.entries()].map(([controlKey, control]) => ({
+                    controlKey,
+                    kind: control.kind,
+                    label: control.label,
+                    options: control.options.map(({ value, label }) => ({ value, label })),
+                    ...(control.value === undefined ? {} : { value: control.value }),
+                })),
+                tables: [...this.tables.entries()].map(([tableKey, table]) => ({
+                    tableKey,
+                    label: table.label,
+                    columns: table.columns.map(({ key, label }) => ({ key, label })),
+                    loadedRows: table.loadedRows,
+                    ...(table.rowIdName ? { rowId: table.rowIdName } : {}),
+                    ...(table.opens ? { opens: table.opens } : {}),
+                    ...(table.total === undefined ? {} : { totalRows: table.total }),
+                    ...(table.query
+                        ? {
+                            query: {
+                                params: table.query.params.map(({ key, kind, values, description }) => ({
+                                    key,
+                                    kind,
+                                    values,
+                                    description,
+                                })),
+                                canShow: table.query.show !== undefined,
+                            },
+                        }
+                        : {}),
+                })),
+                charts: [...this.charts.entries()].map(([chartKey, chart]) => ({
+                    chartKey,
+                    title: chart.title,
+                    xLabel: chart.xLabel,
+                    xKind: chart.xKind,
+                    series: chart.series,
+                })),
+            }
+            : null;
+        this.snapshotDirty = false;
+        return this.snapshot;
+    };
+    setScreen(screen) {
+        const previous = this.screen;
+        this.screen = screen;
+        // Components belong to the screen that registered them. Moving to a new
+        // screen clears them, so the assistant is never told it can point at an
+        // element from the page the user just left.
+        if (previous && previous.screenId !== screen.screenId) {
+            this.components.clear();
+            this.controls.clear();
+            this.tables.clear();
+            this.charts.clear();
+            this.values.clear();
+        }
+        this.invalidate();
+    }
+    clearScreen(screenId) {
+        // Ignore a stale unmount: React mounts the next screen before unmounting
+        // the previous one, so a late cleanup must not wipe the new screen.
+        if (this.screen?.screenId !== screenId)
+            return;
+        this.screen = null;
+        this.components.clear();
+        this.controls.clear();
+        this.tables.clear();
+        this.charts.clear();
+        this.values.clear();
+        this.invalidate();
+    }
+    registerComponent(componentKey, meta) {
+        this.components.set(componentKey, meta);
+        this.invalidate();
+    }
+    unregisterComponent(componentKey) {
+        if (this.components.delete(componentKey))
+            this.invalidate();
+    }
+    registerControl(controlKey, control) {
+        this.controls.set(controlKey, control);
+        this.invalidate();
+    }
+    unregisterControl(controlKey) {
+        if (this.controls.delete(controlKey))
+            this.invalidate();
+    }
+    getControl(controlKey) {
+        return this.controls.get(controlKey);
+    }
+    registerTable(tableKey, table) {
+        this.tables.set(tableKey, table);
+        this.invalidate();
+    }
+    unregisterTable(tableKey) {
+        if (this.tables.delete(tableKey))
+            this.invalidate();
+    }
+    getTable(tableKey) {
+        return this.tables.get(tableKey);
+    }
+    setValues(key, values) {
+        this.values.set(key, values);
+        this.invalidate();
+    }
+    clearValues(key) {
+        if (this.values.delete(key))
+            this.invalidate();
+    }
+    registerChart(chartKey, chart) {
+        this.charts.set(chartKey, chart);
+        this.invalidate();
+    }
+    unregisterChart(chartKey) {
+        if (this.charts.delete(chartKey))
+            this.invalidate();
+    }
+    getChart(chartKey) {
+        return this.charts.get(chartKey);
+    }
+    registerAction(action) {
+        if (this.actions.has(action.name)) {
+            console.warn(`[assistant] Two handlers registered for action "${action.name}". ` +
+                `The most recent one wins; the earlier one will never run.`);
+        }
+        this.actions.set(action.name, action);
+        // Handlers are not part of the published context, so no invalidate.
+    }
+    unregisterAction(name) {
+        this.actions.delete(name);
+    }
+    getAction(name) {
+        return this.actions.get(name);
+    }
+    /** Whether the current screen says its data is still loading. */
+    isScreenLoading() {
+        return this.screen?.loading === true;
+    }
+    hasComponent(componentKey) {
+        return this.components.has(componentKey);
+    }
+    invalidate() {
+        this.snapshotDirty = true;
+        for (const listener of this.listeners)
+            listener();
+    }
+}
+//# sourceMappingURL=store.js.map

package/dist/store.js.map

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

package/dist/voice.d.ts

@@ -0,0 +1,192 @@
+/**
+ * The voice session (doc 03, phase 5a).
+ *
+ * A second, short-lived WebSocket carrying audio only. Commands and
+ * confirmation cards keep arriving on the chat socket, which is the whole
+ * design: voice is an input modality, not a second command channel, so a
+ * confirmation card is the same card whether the user typed or spoke and there
+ * is exactly one place that draws it.
+ *
+ * Push-to-talk, deliberately, before hands-free. It has no VAD edge cases, it
+ * works on a phone the day it ships, and the button press doubles as the user
+ * gesture iOS Safari requires before any audio can start. Hands-free is 5b.
+ */
+import { type VoiceEndReason } from "@mihe-dev/protocol";
+export type VoiceState = "idle" | "connecting"
+/** Connected, microphone closed, waiting for the user to press. */
+ | "listening"
+/** The button is held down and audio is going up. */
+ | "recording"
+/** The utterance is committed and the model has not answered yet. */
+ | "thinking" | "speaking" | "error";
+export type VoiceEvent = {
+    type: "state";
+    state: VoiceState;
+} | {
+    type: "transcript";
+    role: "user" | "assistant";
+    text: string;
+    final: boolean;
+} | {
+    type: "error";
+    code: string;
+    message: string;
+    /** True when the session survived and the user can simply try again. */
+    recoverable: boolean;
+    fallbackToChat: boolean;
+}
+/** The duration ceiling is near. The session is still running. */
+ | {
+    type: "ending_soon";
+    secondsRemaining: number;
+}
+/**
+ * The session finished the way it was meant to — the minutes ran out, or
+ * nobody spoke. Deliberately not an `error`: the chat socket is untouched and
+ * the transcript is already in the conversation, so the user has lost
+ * nothing and should not be told they have.
+ */
+ | {
+    type: "ended";
+    reason: VoiceEndReason;
+    message: string;
+};
+export interface VoiceSessionOptions {
+    /** Voice socket URL, already carrying the single-use token. */
+    url: string;
+    /**
+     * Hands-free: the microphone stays open, the provider decides when an
+     * utterance ends, and the user can talk over the assistant.
+     *
+     * The trade is echo. Under push-to-talk the microphone is shut except while
+     * the button is held, so the assistant physically cannot hear itself; here
+     * it can, and browser echo cancellation is the only thing between the two.
+     * On a laptop that is usually enough. On a phone with the speaker beside the
+     * microphone it may not be, and the failure is the assistant answering its
+     * own last sentence.
+     */
+    handsFree?: boolean;
+    onEvent: (event: VoiceEvent) => void;
+    /**
+     * How loud each side is, 0 to 1, as it happens: the user's voice as it is
+     * captured, the assistant's as it plays. Deliberately not a `VoiceEvent`:
+     * it fires tens of times a second, and whatever listens should move a ring
+     * rather than re-render a component tree.
+     */
+    onLevel?: (source: "user" | "assistant", level: number) => void;
+    /** Injectable for tests. */
+    socketFactory?: (url: string) => VoiceSocketLike;
+}
+/** The slice of `WebSocket` a voice session uses. */
+export interface VoiceSocketLike {
+    binaryType: string;
+    send(data: string | ArrayBuffer): void;
+    close(): void;
+    onopen: ((event: unknown) => void) | null;
+    onclose: ((event: unknown) => void) | null;
+    onerror: ((event: unknown) => void) | null;
+    onmessage: ((event: {
+        data: unknown;
+    }) => void) | null;
+}
+export declare class VoiceSession {
+    private readonly options;
+    private socket;
+    private state;
+    private mic;
+    private speaker;
+    /**
+     * Audio captured since a held press began, not yet sent.
+     *
+     * A press on a draggable orb is ambiguous for its first moment: it may be
+     * the start of speech or the start of a drag. Holding the frames here means
+     * neither answer costs anything. Confirmed, they go up in order and the first
+     * word survives. Discarded, they never leave the browser, because the voice
+     * socket has no way to take back audio it has been sent.
+     */
+    private held;
+    private stopped;
+    /**
+     * Milliseconds of audio captured since the last commit.
+     *
+     * Counted rather than timed from the button press, because those differ:
+     * the microphone graph delivers in render quanta, so a press held for
+     * exactly the floor produces slightly less audio than the clock suggests.
+     * The provider measures the buffer, so we measure the buffer too.
+     */
+    private utteranceMs;
+    /** The assistant's line so far, joined from streamed transcript deltas. */
+    private assistantLine;
+    /** Reports playback position while speaking, for barge-in truncation. */
+    private playbackTimer;
+    /**
+     * The provider's shortest acceptable utterance, learned at `ready`.
+     *
+     * Defaults high enough to be safe before the runtime has told us, since
+     * guessing low means the first press of a session is the one that fails.
+     */
+    private minUtteranceMs;
+    constructor(options: VoiceSessionOptions);
+    get currentState(): VoiceState;
+    /**
+     * Open the socket and the audio devices.
+     *
+     * Must be called from a user gesture. Both the microphone permission prompt
+     * and iOS Safari's audio unlock require one, and a session started from an
+     * effect will connect happily and then be silent in both directions with no
+     * error anywhere.
+     */
+    start(): Promise<void>;
+    /**
+     * The user pressed the button. Push-to-talk only.
+     *
+     * With `hold`, capture starts but nothing is sent, and the assistant is not
+     * interrupted, until `confirmUtterance`. `discardUtterance` drops it
+     * instead. For a control where a press might turn out to be a drag.
+     */
+    beginUtterance(options?: {
+        hold?: boolean;
+    }): void;
+    /** A held press was speech after all: send what was captured, and carry on. */
+    confirmUtterance(): void;
+    /** A held press was a drag: drop what was captured, and send nothing. */
+    discardUtterance(): void;
+    /**
+     * Pressing while the assistant is talking is an interruption. Split out so a
+     * held press does not cut the assistant off before it is known to be speech.
+     */
+    private interruptPlayback;
+    /** The user released the button. Push-to-talk only. */
+    endUtterance(): void;
+    stop(): Promise<void>;
+    private handleControl;
+    private sendAudio;
+    private sendControl;
+    private setState;
+    /**
+     * Tell the runtime how much of the current reply has actually been heard,
+     * a few times a second, for as long as the assistant is speaking.
+     *
+     * Push-to-talk does not need this: the interruption *is* a button press, so
+     * the position can be measured at exactly that moment. Hands-free has no
+     * such moment on this side — the provider notices the user talking, upstream
+     * — so the runtime has to already hold a recent figure when it truncates.
+     *
+     * Without it, truncation falls back to nothing and the model's history keeps
+     * the whole reply, including the part the user cut off. It then answers
+     * follow-ups about words nobody heard.
+     *
+     * Four frames a second of small JSON, against fifty of audio.
+     */
+    private reportPlaybackWhileSpeaking;
+    private emit;
+}
+/**
+ * Derive the voice socket URL from the chat socket URL.
+ *
+ * One `url` prop for the whole SDK rather than two: the two sockets are always
+ * served by the same runtime, and a second prop would be a second thing to get
+ * wrong in every integration for no configurability anyone wants.
+ */
+export declare function voiceUrl(chatUrl: string, token: string, handsFree?: boolean): string;
+//# sourceMappingURL=voice.d.ts.map

package/dist/voice.d.ts.map

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