@glassly/miniapp 0.1.0-dev.26

package/dist/modules/input.js

@@ -0,0 +1,70 @@
+/**
+ * @fileoverview InputModule — physical control events on the glasses.
+ *
+ * Combines button + touch surfaces. Future input modes (gesture, voice
+ * command, eye tracking) will extend this module rather than spawning new
+ * top-level modules.
+ *
+ * Touch overloads:
+ *
+ *   session.input.onTouch(handler)
+ *   session.input.onTouch("single_tap", handler)
+ *   session.input.onTouch(["swipe_up", "swipe_down"], handler)
+ *
+ * Per-gesture filtering rides on `touch_event:<gesture>` stream variants
+ * the phone runtime fans out alongside the bare `touch_event` stream.
+ */
+import { MiniappRequestType, MiniappStreamType } from "../protocol";
+export class InputModule {
+    constructor(session) {
+        this.session = session;
+    }
+    /**
+     * Declare the gestures this miniapp is handling itself, replacing any
+     * previous claim set. While a claimed gesture arrives and this app is
+     * FOREGROUND on the glasses, the host skips its default behavior for it —
+     * today that is `double_tap`, which otherwise opens the dashboard (or
+     * toggles head-up). The events themselves still arrive via `onTouch`
+     * either way; claiming only suppresses the system default.
+     *
+     * Pass `[]` to release every claim. Claims are cleared automatically when
+     * the miniapp stops, and are inert while the app is backgrounded — a
+     * background app never hijacks a system gesture.
+     *
+     *   session.input.setClaimedGestures(["double_tap"]) // in-app back gesture
+     *   session.input.setClaimedGestures([])             // back to system default
+     */
+    setClaimedGestures(gestures) {
+        return this.session
+            .sendRequest({ type: MiniappRequestType.CLAIM_GESTURES, gestures })
+            .then(() => undefined);
+    }
+    onButtonPress(handler) {
+        return this.session._subscribe(MiniappStreamType.BUTTON_PRESS, handler);
+    }
+    onTouch(gestureOrHandler, maybeHandler) {
+        // Plain handler — subscribe to all touches.
+        if (typeof gestureOrHandler === "function") {
+            return this.session._subscribe(MiniappStreamType.TOUCH_EVENT, gestureOrHandler);
+        }
+        const handler = maybeHandler;
+        const gestures = Array.isArray(gestureOrHandler) ? gestureOrHandler : [gestureOrHandler];
+        if (gestures.length === 0)
+            return () => { };
+        const unsubs = [];
+        for (const g of gestures) {
+            unsubs.push(this.session._subscribe(`${MiniappStreamType.TOUCH_EVENT}:${g}`, handler));
+        }
+        return () => {
+            for (const u of unsubs) {
+                try {
+                    u();
+                }
+                catch {
+                    /* ignore */
+                }
+            }
+        };
+    }
+}
+//# sourceMappingURL=input.js.map

package/dist/modules/input.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"input.js","sourceRoot":"","sources":["../../src/modules/input.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAC,kBAAkB,EAAE,iBAAiB,EAAC,MAAM,aAAa,CAAA;AAIjE,MAAM,OAAO,WAAW;IACtB,YAA6B,OAAuB;QAAvB,YAAO,GAAP,OAAO,CAAgB;IAAG,CAAC;IAExD;;;;;;;;;;;;;;OAcG;IACH,kBAAkB,CAAC,QAAkB;QACnC,OAAO,IAAI,CAAC,OAAO;aAChB,WAAW,CAAO,EAAC,IAAI,EAAE,kBAAkB,CAAC,cAAc,EAAE,QAAQ,EAAC,CAAC;aACtE,IAAI,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAA;IAC1B,CAAC;IAED,aAAa,CAAC,OAAwC;QACpD,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,iBAAiB,CAAC,YAAY,EAAE,OAAkC,CAAC,CAAA;IACpG,CAAC;IAYD,OAAO,CACL,gBAAiE,EACjE,YAAwC;QAExC,4CAA4C;QAC5C,IAAI,OAAO,gBAAgB,KAAK,UAAU,EAAE,CAAC;YAC3C,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,iBAAiB,CAAC,WAAW,EAAE,gBAA2C,CAAC,CAAA;QAC5G,CAAC;QAED,MAAM,OAAO,GAAG,YAAa,CAAA;QAC7B,MAAM,QAAQ,GAAG,KAAK,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAA;QACxF,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,GAAG,EAAE,GAAE,CAAC,CAAA;QAE1C,MAAM,MAAM,GAAoB,EAAE,CAAA;QAClC,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;YACzB,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,GAAG,iBAAiB,CAAC,WAAW,IAAI,CAAC,EAAE,EAAE,OAAkC,CAAC,CAAC,CAAA;QACnH,CAAC;QACD,OAAO,GAAG,EAAE;YACV,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;gBACvB,IAAI,CAAC;oBACH,CAAC,EAAE,CAAA;gBACL,CAAC;gBAAC,MAAM,CAAC;oBACP,YAAY;gBACd,CAAC;YACH,CAAC;QACH,CAAC,CAAA;IACH,CAAC;CACF"}

package/dist/modules/keys.d.ts

@@ -0,0 +1,30 @@
+/**
+ * @fileoverview KeysModule — read user-supplied provider API keys.
+ *
+ * Users can enter their own provider API keys in the Glassly App
+ * (Settings > API Keys). A miniapp that declares the API_KEYS permission in
+ * miniapp.json can read the providers in {@link ApiKeyProvider}; the phone
+ * runtime rejects with PERMISSION_NOT_DECLARED otherwise.
+ *
+ * The provider set is an explicit host-side allowlist — asking for anything
+ * else (e.g. the Soniox transcription key, which is deliberately not exposed
+ * to miniapps) rejects with INVALID_ARGUMENT. Keys are device-local settings:
+ * the value travels only across the local bridge, never through any server.
+ */
+import { MiniappSession } from "../session";
+/** Providers whose user-supplied keys miniapps may read. */
+export type ApiKeyProvider = "anthropic" | "gemini" | "openai" | "elevenlabs" | "mapbox";
+export declare class KeysModule {
+    private readonly session;
+    constructor(session: MiniappSession);
+    /** True iff `API_KEYS` is declared in the miniapp's manifest. */
+    get hasPermission(): boolean;
+    /**
+     * Fetch the user's API key for a provider. Resolves with the key, or null
+     * when the user hasn't saved one for that provider. Values are not cached —
+     * re-fetch (e.g. on retry after a 401 from the provider) to pick up a key
+     * the user edited in Settings while the miniapp was running.
+     */
+    get(provider: ApiKeyProvider): Promise<string | null>;
+}
+//# sourceMappingURL=keys.d.ts.map

package/dist/modules/keys.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"keys.d.ts","sourceRoot":"","sources":["../../src/modules/keys.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,EAAC,cAAc,EAAC,MAAM,YAAY,CAAA;AAEzC,4DAA4D;AAC5D,MAAM,MAAM,cAAc,GAAG,WAAW,GAAG,QAAQ,GAAG,QAAQ,GAAG,YAAY,GAAG,QAAQ,CAAA;AAMxF,qBAAa,UAAU;IACT,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAAP,OAAO,EAAE,cAAc;IAEpD,iEAAiE;IACjE,IAAI,aAAa,IAAI,OAAO,CAE3B;IAED;;;;;OAKG;IACG,GAAG,CAAC,QAAQ,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;CAO5D"}

package/dist/modules/keys.js

@@ -0,0 +1,37 @@
+/**
+ * @fileoverview KeysModule — read user-supplied provider API keys.
+ *
+ * Users can enter their own provider API keys in the Glassly App
+ * (Settings > API Keys). A miniapp that declares the API_KEYS permission in
+ * miniapp.json can read the providers in {@link ApiKeyProvider}; the phone
+ * runtime rejects with PERMISSION_NOT_DECLARED otherwise.
+ *
+ * The provider set is an explicit host-side allowlist — asking for anything
+ * else (e.g. the Soniox transcription key, which is deliberately not exposed
+ * to miniapps) rejects with INVALID_ARGUMENT. Keys are device-local settings:
+ * the value travels only across the local bridge, never through any server.
+ */
+import { MiniappRequestType } from "../protocol";
+export class KeysModule {
+    constructor(session) {
+        this.session = session;
+    }
+    /** True iff `API_KEYS` is declared in the miniapp's manifest. */
+    get hasPermission() {
+        return this.session._hasManifestPermission("API_KEYS");
+    }
+    /**
+     * Fetch the user's API key for a provider. Resolves with the key, or null
+     * when the user hasn't saved one for that provider. Values are not cached —
+     * re-fetch (e.g. on retry after a 401 from the provider) to pick up a key
+     * the user edited in Settings while the miniapp was running.
+     */
+    async get(provider) {
+        const result = await this.session.sendRequest({
+            type: MiniappRequestType.KEYS_GET,
+            provider,
+        });
+        return result?.key ?? null;
+    }
+}
+//# sourceMappingURL=keys.js.map

package/dist/modules/keys.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"keys.js","sourceRoot":"","sources":["../../src/modules/keys.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAC,kBAAkB,EAAC,MAAM,aAAa,CAAA;AAU9C,MAAM,OAAO,UAAU;IACrB,YAA6B,OAAuB;QAAvB,YAAO,GAAP,OAAO,CAAgB;IAAG,CAAC;IAExD,iEAAiE;IACjE,IAAI,aAAa;QACf,OAAO,IAAI,CAAC,OAAO,CAAC,sBAAsB,CAAC,UAAU,CAAC,CAAA;IACxD,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,GAAG,CAAC,QAAwB;QAChC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,WAAW,CAAgB;YAC3D,IAAI,EAAE,kBAAkB,CAAC,QAAQ;YACjC,QAAQ;SACT,CAAC,CAAA;QACF,OAAO,MAAM,EAAE,GAAG,IAAI,IAAI,CAAA;IAC5B,CAAC;CACF"}

package/dist/modules/languages.d.ts

@@ -0,0 +1,42 @@
+/**
+ * @fileoverview Language validation at the SDK boundary (issue 021, WP2).
+ *
+ * The registry itself lives in `@glassly/cloud-protocol/languages` (single
+ * source of truth shared with the cloud). This module re-exports the types so
+ * miniapps import everything from `@glassly/miniapp`, and adds the throwing
+ * validators the typed module surfaces (`transcription.*`, `translation.*`)
+ * call on every language parameter.
+ *
+ * Contract (design doc docs/issues/021-typed-language-subscriptions):
+ *   - Valid by construction: params are typed as literal unions, so TS users
+ *     get autocomplete and compile errors.
+ *   - Loud at runtime: JS users (or `any` casts) get a thrown
+ *     `MiniappValidationError` with a suggestion, never silent fallback.
+ *   - Canonical on the wire: bare codes ("fr") canonicalize to their default
+ *     tag ("fr-FR") before becoming stream keys, so the phone/cloud only ever
+ *     see registry tags.
+ */
+import { isTranscriptionLanguage, SUPPORTED_LANGUAGE_HINTS, SUPPORTED_TRANSCRIPTION_LANGUAGES } from "@glassly/cloud-protocol/languages";
+import type { LanguageHint, TranscriptionLanguage } from "@glassly/cloud-protocol/languages";
+export { SUPPORTED_LANGUAGE_HINTS, SUPPORTED_TRANSCRIPTION_LANGUAGES, isTranscriptionLanguage };
+export type { LanguageHint, TranscriptionLanguage };
+/**
+ * Thrown synchronously by SDK methods when a parameter fails validation.
+ * Deliberately a hard throw (not a warning, not a silent default): an invalid
+ * language previously produced a subscription that silently transcribed the
+ * wrong language or silently never spoke (OS-1746).
+ */
+export declare class MiniappValidationError extends Error {
+    constructor(message: string);
+}
+/**
+ * Canonicalize a subscription language or throw. Accepts registry tags
+ * ("fr-FR") and bare registry codes ("fr" -> "fr-FR").
+ */
+export declare function requireTranscriptionLanguage(value: string, param: string): TranscriptionLanguage;
+/**
+ * Normalize a language hint to the bare code the STT provider accepts, or
+ * throw. Accepts bare codes ("fr") and registry tags ("fr-FR" -> "fr").
+ */
+export declare function requireLanguageHint(value: string, param: string): LanguageHint;
+//# sourceMappingURL=languages.d.ts.map

package/dist/modules/languages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"languages.d.ts","sourceRoot":"","sources":["../../src/modules/languages.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EACL,uBAAuB,EAIvB,wBAAwB,EACxB,iCAAiC,EAClC,MAAM,mCAAmC,CAAA;AAC1C,OAAO,KAAK,EAAC,YAAY,EAAE,qBAAqB,EAAC,MAAM,mCAAmC,CAAA;AAE1F,OAAO,EAAC,wBAAwB,EAAE,iCAAiC,EAAE,uBAAuB,EAAC,CAAA;AAC7F,YAAY,EAAC,YAAY,EAAE,qBAAqB,EAAC,CAAA;AAEjD;;;;;GAKG;AACH,qBAAa,sBAAuB,SAAQ,KAAK;gBACnC,OAAO,EAAE,MAAM;CAI5B;AAED;;;GAGG;AACH,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,qBAAqB,CAShG;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,YAAY,CAO9E"}

package/dist/modules/languages.js

@@ -0,0 +1,57 @@
+/**
+ * @fileoverview Language validation at the SDK boundary (issue 021, WP2).
+ *
+ * The registry itself lives in `@glassly/cloud-protocol/languages` (single
+ * source of truth shared with the cloud). This module re-exports the types so
+ * miniapps import everything from `@glassly/miniapp`, and adds the throwing
+ * validators the typed module surfaces (`transcription.*`, `translation.*`)
+ * call on every language parameter.
+ *
+ * Contract (design doc docs/issues/021-typed-language-subscriptions):
+ *   - Valid by construction: params are typed as literal unions, so TS users
+ *     get autocomplete and compile errors.
+ *   - Loud at runtime: JS users (or `any` casts) get a thrown
+ *     `MiniappValidationError` with a suggestion, never silent fallback.
+ *   - Canonical on the wire: bare codes ("fr") canonicalize to their default
+ *     tag ("fr-FR") before becoming stream keys, so the phone/cloud only ever
+ *     see registry tags.
+ */
+import { isTranscriptionLanguage, suggestTranscriptionLanguage, toLanguageHint, toTranscriptionLanguage, SUPPORTED_LANGUAGE_HINTS, SUPPORTED_TRANSCRIPTION_LANGUAGES, } from "@glassly/cloud-protocol/languages";
+export { SUPPORTED_LANGUAGE_HINTS, SUPPORTED_TRANSCRIPTION_LANGUAGES, isTranscriptionLanguage };
+/**
+ * Thrown synchronously by SDK methods when a parameter fails validation.
+ * Deliberately a hard throw (not a warning, not a silent default): an invalid
+ * language previously produced a subscription that silently transcribed the
+ * wrong language or silently never spoke (OS-1746).
+ */
+export class MiniappValidationError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "MiniappValidationError";
+    }
+}
+/**
+ * Canonicalize a subscription language or throw. Accepts registry tags
+ * ("fr-FR") and bare registry codes ("fr" -> "fr-FR").
+ */
+export function requireTranscriptionLanguage(value, param) {
+    const canonical = toTranscriptionLanguage(value);
+    if (canonical)
+        return canonical;
+    const suggestion = suggestTranscriptionLanguage(value);
+    throw new MiniappValidationError(`${param}: unknown language ${JSON.stringify(value)}` +
+        (suggestion ? ` — did you mean ${JSON.stringify(suggestion)}?` : "") +
+        ` Supported values are BCP-47 tags from SUPPORTED_TRANSCRIPTION_LANGUAGES (e.g. "en-US", "fr-FR").`);
+}
+/**
+ * Normalize a language hint to the bare code the STT provider accepts, or
+ * throw. Accepts bare codes ("fr") and registry tags ("fr-FR" -> "fr").
+ */
+export function requireLanguageHint(value, param) {
+    const hint = toLanguageHint(value);
+    if (hint)
+        return hint;
+    throw new MiniappValidationError(`${param}: unknown language hint ${JSON.stringify(value)}. ` +
+        `Hints are bare ISO 639-1 codes from SUPPORTED_LANGUAGE_HINTS (e.g. "en", "fr").`);
+}
+//# sourceMappingURL=languages.js.map

package/dist/modules/languages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"languages.js","sourceRoot":"","sources":["../../src/modules/languages.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EACL,uBAAuB,EACvB,4BAA4B,EAC5B,cAAc,EACd,uBAAuB,EACvB,wBAAwB,EACxB,iCAAiC,GAClC,MAAM,mCAAmC,CAAA;AAG1C,OAAO,EAAC,wBAAwB,EAAE,iCAAiC,EAAE,uBAAuB,EAAC,CAAA;AAG7F;;;;;GAKG;AACH,MAAM,OAAO,sBAAuB,SAAQ,KAAK;IAC/C,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAA;QACd,IAAI,CAAC,IAAI,GAAG,wBAAwB,CAAA;IACtC,CAAC;CACF;AAED;;;GAGG;AACH,MAAM,UAAU,4BAA4B,CAAC,KAAa,EAAE,KAAa;IACvE,MAAM,SAAS,GAAG,uBAAuB,CAAC,KAAK,CAAC,CAAA;IAChD,IAAI,SAAS;QAAE,OAAO,SAAS,CAAA;IAC/B,MAAM,UAAU,GAAG,4BAA4B,CAAC,KAAK,CAAC,CAAA;IACtD,MAAM,IAAI,sBAAsB,CAC9B,GAAG,KAAK,sBAAsB,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE;QACnD,CAAC,UAAU,CAAC,CAAC,CAAC,mBAAmB,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;QACpE,mGAAmG,CACtG,CAAA;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAAC,KAAa,EAAE,KAAa;IAC9D,MAAM,IAAI,GAAG,cAAc,CAAC,KAAK,CAAC,CAAA;IAClC,IAAI,IAAI;QAAE,OAAO,IAAI,CAAA;IACrB,MAAM,IAAI,sBAAsB,CAC9B,GAAG,KAAK,2BAA2B,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI;QAC1D,iFAAiF,CACpF,CAAA;AACH,CAAC"}

package/dist/modules/led.d.ts

@@ -0,0 +1,35 @@
+/**
+ * @fileoverview LedModule — glasses RGB LED control.
+ *
+ * API mirrors the cloud SDK's LED module. Colors are named strings
+ * (the phone maps them to per-device LED indices). Actions are "on" / "off".
+ */
+import { MiniappSession } from "../session";
+export type LedColor = "red" | "green" | "blue" | "orange" | "white";
+export type LedControlResult = {
+    type?: "rgb_led_control_response";
+    state: "success";
+    requestId: string;
+};
+export interface LedControlOptions {
+    color?: LedColor;
+    /** LED on duration in ms. */
+    ontime?: number;
+    /** LED off duration in ms. */
+    offtime?: number;
+    /** Number of on/off cycles. */
+    count?: number;
+}
+export declare class LedModule {
+    private readonly session;
+    constructor(session: MiniappSession);
+    /** Turn an LED on with the given pattern. Resolves after the glasses acknowledge the command. */
+    turnOn(options?: LedControlOptions): Promise<LedControlResult>;
+    /** Turn all LEDs off. Resolves after the glasses acknowledge the command. */
+    turnOff(): Promise<LedControlResult>;
+    /** Blink pattern — repeats `count` times with ontime/offtime. */
+    blink(color: LedColor, ontime: number, offtime: number, count: number): Promise<LedControlResult>;
+    /** Solid LED for a fixed duration. */
+    solid(color: LedColor, duration: number): Promise<LedControlResult>;
+}
+//# sourceMappingURL=led.d.ts.map

package/dist/modules/led.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"led.d.ts","sourceRoot":"","sources":["../../src/modules/led.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAC,cAAc,EAAC,MAAM,YAAY,CAAA;AAEzC,MAAM,MAAM,QAAQ,GAAG,KAAK,GAAG,OAAO,GAAG,MAAM,GAAG,QAAQ,GAAG,OAAO,CAAA;AAEpE,MAAM,MAAM,gBAAgB,GAAG;IAC7B,IAAI,CAAC,EAAE,0BAA0B,CAAA;IACjC,KAAK,EAAE,SAAS,CAAA;IAChB,SAAS,EAAE,MAAM,CAAA;CAClB,CAAA;AAED,MAAM,WAAW,iBAAiB;IAChC,KAAK,CAAC,EAAE,QAAQ,CAAA;IAChB,6BAA6B;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,8BAA8B;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,+BAA+B;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED,qBAAa,SAAS;IACR,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAAP,OAAO,EAAE,cAAc;IAEpD,iGAAiG;IAC3F,MAAM,CAAC,OAAO,GAAE,iBAAsB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAWxE,6EAA6E;IACvE,OAAO,IAAI,OAAO,CAAC,gBAAgB,CAAC;IAO1C,iEAAiE;IAC3D,KAAK,CAAC,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAIvG,sCAAsC;IAChC,KAAK,CAAC,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;CAG1E"}

package/dist/modules/led.js

@@ -0,0 +1,39 @@
+/**
+ * @fileoverview LedModule — glasses RGB LED control.
+ *
+ * API mirrors the cloud SDK's LED module. Colors are named strings
+ * (the phone maps them to per-device LED indices). Actions are "on" / "off".
+ */
+import { MiniappRequestType } from "../protocol";
+export class LedModule {
+    constructor(session) {
+        this.session = session;
+    }
+    /** Turn an LED on with the given pattern. Resolves after the glasses acknowledge the command. */
+    async turnOn(options = {}) {
+        return this.session.sendRequest({
+            type: MiniappRequestType.RGB_LED,
+            action: "on",
+            color: options.color ?? "red",
+            ontime: options.ontime ?? 1000,
+            offtime: options.offtime ?? 0,
+            count: options.count ?? 1,
+        });
+    }
+    /** Turn all LEDs off. Resolves after the glasses acknowledge the command. */
+    async turnOff() {
+        return this.session.sendRequest({
+            type: MiniappRequestType.RGB_LED,
+            action: "off",
+        });
+    }
+    /** Blink pattern — repeats `count` times with ontime/offtime. */
+    async blink(color, ontime, offtime, count) {
+        return this.turnOn({ color, ontime, offtime, count });
+    }
+    /** Solid LED for a fixed duration. */
+    async solid(color, duration) {
+        return this.turnOn({ color, ontime: duration, offtime: 0, count: 1 });
+    }
+}
+//# sourceMappingURL=led.js.map

package/dist/modules/led.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"led.js","sourceRoot":"","sources":["../../src/modules/led.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAC,kBAAkB,EAAC,MAAM,aAAa,CAAA;AAqB9C,MAAM,OAAO,SAAS;IACpB,YAA6B,OAAuB;QAAvB,YAAO,GAAP,OAAO,CAAgB;IAAG,CAAC;IAExD,iGAAiG;IACjG,KAAK,CAAC,MAAM,CAAC,UAA6B,EAAE;QAC1C,OAAO,IAAI,CAAC,OAAO,CAAC,WAAW,CAAmB;YAChD,IAAI,EAAE,kBAAkB,CAAC,OAAO;YAChC,MAAM,EAAE,IAAI;YACZ,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,KAAK;YAC7B,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,IAAI;YAC9B,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,CAAC;YAC7B,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;SAC1B,CAAC,CAAA;IACJ,CAAC;IAED,6EAA6E;IAC7E,KAAK,CAAC,OAAO;QACX,OAAO,IAAI,CAAC,OAAO,CAAC,WAAW,CAAmB;YAChD,IAAI,EAAE,kBAAkB,CAAC,OAAO;YAChC,MAAM,EAAE,KAAK;SACd,CAAC,CAAA;IACJ,CAAC;IAED,iEAAiE;IACjE,KAAK,CAAC,KAAK,CAAC,KAAe,EAAE,MAAc,EAAE,OAAe,EAAE,KAAa;QACzE,OAAO,IAAI,CAAC,MAAM,CAAC,EAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAC,CAAC,CAAA;IACrD,CAAC;IAED,sCAAsC;IACtC,KAAK,CAAC,KAAK,CAAC,KAAe,EAAE,QAAgB;QAC3C,OAAO,IAAI,CAAC,MAAM,CAAC,EAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAC,CAAC,CAAA;IACrE,CAAC;CACF"}

package/dist/modules/location.d.ts

@@ -0,0 +1,27 @@
+/**
+ * @fileoverview LocationModule — phone location events.
+ *
+ * Exposes both a continuous `onUpdate` subscription and a one-shot
+ * `getOnce()` poll over `MiniappRequestType.LOCATION_POLL`.
+ *
+ * LOCATION permission must be declared in miniapp.json for either path to
+ * succeed; the phone runtime rejects with PERMISSION_NOT_DECLARED
+ * otherwise.
+ */
+import { MiniappSession } from "../session";
+import type { LocationData, UnsubscribeFn } from "./events";
+export declare class LocationModule {
+    private readonly session;
+    constructor(session: MiniappSession);
+    /** True iff `LOCATION` is declared in the miniapp's manifest. */
+    get hasPermission(): boolean;
+    /** Subscribe to continuous location updates. */
+    onUpdate(handler: (data: LocationData) => void): UnsubscribeFn;
+    /**
+     * Request a single location fix. Resolves with the next available
+     * reading from the phone. Useful at app load to seed UI before a
+     * continuous stream of updates begins.
+     */
+    getOnce(): Promise<LocationData>;
+}
+//# sourceMappingURL=location.d.ts.map

package/dist/modules/location.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"location.d.ts","sourceRoot":"","sources":["../../src/modules/location.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,EAAC,cAAc,EAAC,MAAM,YAAY,CAAA;AACzC,OAAO,KAAK,EAAC,YAAY,EAAE,aAAa,EAAC,MAAM,UAAU,CAAA;AAEzD,qBAAa,cAAc;IACb,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAAP,OAAO,EAAE,cAAc;IAEpD,iEAAiE;IACjE,IAAI,aAAa,IAAI,OAAO,CAE3B;IAED,gDAAgD;IAChD,QAAQ,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,YAAY,KAAK,IAAI,GAAG,aAAa;IAI9D;;;;OAIG;IACH,OAAO,IAAI,OAAO,CAAC,YAAY,CAAC;CAKjC"}

package/dist/modules/location.js

@@ -0,0 +1,35 @@
+/**
+ * @fileoverview LocationModule — phone location events.
+ *
+ * Exposes both a continuous `onUpdate` subscription and a one-shot
+ * `getOnce()` poll over `MiniappRequestType.LOCATION_POLL`.
+ *
+ * LOCATION permission must be declared in miniapp.json for either path to
+ * succeed; the phone runtime rejects with PERMISSION_NOT_DECLARED
+ * otherwise.
+ */
+import { MiniappRequestType, MiniappStreamType } from "../protocol";
+export class LocationModule {
+    constructor(session) {
+        this.session = session;
+    }
+    /** True iff `LOCATION` is declared in the miniapp's manifest. */
+    get hasPermission() {
+        return this.session._hasManifestPermission("LOCATION");
+    }
+    /** Subscribe to continuous location updates. */
+    onUpdate(handler) {
+        return this.session._subscribe(MiniappStreamType.LOCATION_UPDATE, handler);
+    }
+    /**
+     * Request a single location fix. Resolves with the next available
+     * reading from the phone. Useful at app load to seed UI before a
+     * continuous stream of updates begins.
+     */
+    getOnce() {
+        return this.session.sendRequest({
+            type: MiniappRequestType.LOCATION_POLL,
+        });
+    }
+}
+//# sourceMappingURL=location.js.map

package/dist/modules/location.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"location.js","sourceRoot":"","sources":["../../src/modules/location.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAC,kBAAkB,EAAE,iBAAiB,EAAC,MAAM,aAAa,CAAA;AAIjE,MAAM,OAAO,cAAc;IACzB,YAA6B,OAAuB;QAAvB,YAAO,GAAP,OAAO,CAAgB;IAAG,CAAC;IAExD,iEAAiE;IACjE,IAAI,aAAa;QACf,OAAO,IAAI,CAAC,OAAO,CAAC,sBAAsB,CAAC,UAAU,CAAC,CAAA;IACxD,CAAC;IAED,gDAAgD;IAChD,QAAQ,CAAC,OAAqC;QAC5C,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,iBAAiB,CAAC,eAAe,EAAE,OAAkC,CAAC,CAAA;IACvG,CAAC;IAED;;;;OAIG;IACH,OAAO;QACL,OAAO,IAAI,CAAC,OAAO,CAAC,WAAW,CAAe;YAC5C,IAAI,EAAE,kBAAkB,CAAC,aAAa;SACvC,CAAC,CAAA;IACJ,CAAC;CACF"}

package/dist/modules/memory.d.ts

@@ -0,0 +1,126 @@
+/**
+ * @fileoverview MemoryModule — the user's shared, phone-local memory timeline.
+ *
+ * One unified per-hour stream of what happened around the user — spoken
+ * transcript lines AND notes (manual, voice, auto) — plus the hourly summary
+ * that heads each session. The store lives on the phone (host-level,
+ * user-scoped), NOT in the per-miniapp storage namespace: every miniapp that
+ * declares the MEMORY manifest permission reads and writes the same timeline,
+ * and the user manages it in Settings > Memory.
+ *
+ * A "session" is one clock hour that has entries, derived from entry
+ * timestamps at read time — there is no stored session id.
+ *
+ * All calls require the MEMORY manifest permission; without it the host
+ * rejects with PERMISSION_NOT_DECLARED. Nothing here leaves the phone.
+ */
+import { MiniappSession } from "../session";
+export type MemoryEntryKind = "line" | "note";
+/** How a note entry originated (only meaningful when kind === "note"). */
+export type MemoryNoteSource = "voice" | "ui" | "auto";
+export interface MemoryEntry {
+    id: string;
+    kind: MemoryEntryKind;
+    text: string;
+    /** Epoch ms the entry happened. */
+    at: number;
+    speakerId: string | null;
+    /** Enrolled-speaker display name resolved by on-device speaker ID, when known. */
+    resolvedSpeakerName?: string | null;
+    language: string | null;
+    /** Present for note entries. */
+    source?: MemoryNoteSource;
+}
+export interface MemorySummary {
+    /** Epoch ms of the hour bucket start. */
+    hourStart: number;
+    text: string;
+    createdAt: number;
+}
+/** One derived session: a clock hour with its entries and summary. */
+export interface MemorySession {
+    hourStart: number;
+    entries: MemoryEntry[];
+    summary: string | null;
+    lineCount: number;
+    noteCount: number;
+}
+export interface MemoryQuery {
+    /** Epoch ms lower bound (inclusive). Omit for "from the beginning". */
+    sinceMs?: number;
+    /** Epoch ms upper bound (inclusive). Omit for "until now". */
+    untilMs?: number;
+    /** Case-insensitive EXACT substring filter (codes, URLs, exact phrases). */
+    contains?: string;
+    /**
+     * Fuzzy any-of terms: an entry matches when ANY term matches, and a
+     * multi-word term requires all of its words. Matching tolerates the small
+     * misspellings speech-to-text produces for names ("Korwin" matches
+     * "Corwin"). Host caps at 8 terms. Combined with `contains` as AND.
+     * Ignored by hosts that predate fuzzy search.
+     */
+    terms?: string[];
+    /** Max entries returned (host caps at 200; default 60). Newest kept. */
+    limit?: number;
+}
+export interface MemorySearchResult {
+    /** Matches in chronological order (newest last). */
+    entries: MemoryEntry[];
+    /**
+     * Entries inside the TIME window before keyword filtering — distinguishes
+     * "keyword matched nothing" from "window empty". Undefined on hosts that
+     * predate fuzzy search.
+     */
+    windowCount?: number;
+}
+export declare class MemoryModule {
+    private readonly session;
+    constructor(session: MiniappSession);
+    /** True iff this miniapp's manifest declares the MEMORY permission. */
+    get hasPermission(): boolean;
+    /** Append a spoken transcript line to the timeline. */
+    appendLine(input: {
+        text: string;
+        speakerId: string | null;
+        language: string | null;
+        at: number;
+    }): Promise<void>;
+    /**
+     * Add a note. `at` targets the hour it belongs to — omit for "now" (the
+     * current session), or pass a timestamp inside a past hour to append to
+     * that session. Notes dedupe on normalized text within the same hour;
+     * resolves null when the note was a duplicate (or empty).
+     */
+    addNote(text: string, source?: MemoryNoteSource, at?: number): Promise<MemoryEntry | null>;
+    /** Delete one entry (line or note) by id. Resolves false when unknown. */
+    removeEntry(id: string): Promise<boolean>;
+    /** Delete every entry (and summary) in an hour, or a whole day of hours. */
+    removeScope(scope: "session" | "day", at: number): Promise<void>;
+    /** All sessions (hours with entries), newest hour first. */
+    sessions(): Promise<MemorySession[]>;
+    /**
+     * Query the full timeline by absolute-time window and keyword — the
+     * on-device executor shape for LLM history-search tools. Newest last, so
+     * slicing keeps the most recent matches when the limit bites.
+     */
+    query(q?: MemoryQuery): Promise<MemoryEntry[]>;
+    /**
+     * query() plus search diagnostics ({@link MemorySearchResult.windowCount}).
+     * Same wire request; prefer this from LLM history-search tools so an empty
+     * result can explain WHY it was empty instead of triggering a blind retry.
+     */
+    search(q?: MemoryQuery): Promise<MemorySearchResult>;
+    /** Entries in [sinceMs, untilMs), newest last. Uncapped (unlike query). */
+    window(sinceMs: number, untilMs?: number): Promise<MemoryEntry[]>;
+    /** Plain-text export of a scope, for the OS share sheet. */
+    exportText(scope: "session" | "day" | "all", at?: number): Promise<string>;
+    /** Upsert the summary heading an hour (keyed by hourStart). */
+    addSummary(summary: MemorySummary): Promise<void>;
+    /** All hourly summaries, newest hour first. */
+    summaries(): Promise<MemorySummary[]>;
+    /** Most recent COMPLETED hour with lines but no summary, or null. */
+    pendingSummaryHour(nowMs?: number): Promise<number | null>;
+    /** Drop the entire timeline: every entry and every summary. */
+    clear(): Promise<void>;
+}
+//# sourceMappingURL=memory.d.ts.map

package/dist/modules/memory.d.ts.map

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