@glassly/miniapp 0.1.0-dev.26

package/dist/modules/memory.js

@@ -0,0 +1,141 @@
+/**
+ * @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 { MiniappRequestType } from "../protocol";
+export class MemoryModule {
+    constructor(session) {
+        this.session = session;
+    }
+    /** True iff this miniapp's manifest declares the MEMORY permission. */
+    get hasPermission() {
+        return this.session._hasManifestPermission("MEMORY");
+    }
+    /** Append a spoken transcript line to the timeline. */
+    async appendLine(input) {
+        await this.session.sendRequest({
+            type: MiniappRequestType.MEMORY_APPEND_LINE,
+            ...input,
+        });
+    }
+    /**
+     * 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).
+     */
+    async addNote(text, source = "ui", at) {
+        const result = await this.session.sendRequest({
+            type: MiniappRequestType.MEMORY_ADD_NOTE,
+            text,
+            source,
+            at,
+        });
+        return result?.entry ?? null;
+    }
+    /** Delete one entry (line or note) by id. Resolves false when unknown. */
+    async removeEntry(id) {
+        const result = await this.session.sendRequest({
+            type: MiniappRequestType.MEMORY_REMOVE_ENTRY,
+            id,
+        });
+        return !!result?.removed;
+    }
+    /** Delete every entry (and summary) in an hour, or a whole day of hours. */
+    async removeScope(scope, at) {
+        await this.session.sendRequest({
+            type: MiniappRequestType.MEMORY_REMOVE_SCOPE,
+            scope,
+            at,
+        });
+    }
+    /** All sessions (hours with entries), newest hour first. */
+    async sessions() {
+        const result = await this.session.sendRequest({
+            type: MiniappRequestType.MEMORY_SESSION_LIST,
+        });
+        return result?.sessions ?? [];
+    }
+    /**
+     * 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.
+     */
+    async query(q = {}) {
+        return (await this.search(q)).entries;
+    }
+    /**
+     * 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.
+     */
+    async search(q = {}) {
+        const result = await this.session.sendRequest({
+            type: MiniappRequestType.MEMORY_QUERY,
+            ...q,
+        });
+        return {
+            entries: result?.entries ?? [],
+            ...(typeof result?.windowCount === "number" ? { windowCount: result.windowCount } : {}),
+        };
+    }
+    /** Entries in [sinceMs, untilMs), newest last. Uncapped (unlike query). */
+    async window(sinceMs, untilMs) {
+        const result = await this.session.sendRequest({
+            type: MiniappRequestType.MEMORY_WINDOW,
+            sinceMs,
+            untilMs,
+        });
+        return result?.entries ?? [];
+    }
+    /** Plain-text export of a scope, for the OS share sheet. */
+    async exportText(scope, at) {
+        const result = await this.session.sendRequest({
+            type: MiniappRequestType.MEMORY_EXPORT_TEXT,
+            scope,
+            at,
+        });
+        return result?.text ?? "";
+    }
+    /** Upsert the summary heading an hour (keyed by hourStart). */
+    async addSummary(summary) {
+        await this.session.sendRequest({
+            type: MiniappRequestType.MEMORY_SUMMARY_ADD,
+            ...summary,
+        });
+    }
+    /** All hourly summaries, newest hour first. */
+    async summaries() {
+        const result = await this.session.sendRequest({
+            type: MiniappRequestType.MEMORY_SUMMARY_LIST,
+        });
+        return result?.summaries ?? [];
+    }
+    /** Most recent COMPLETED hour with lines but no summary, or null. */
+    async pendingSummaryHour(nowMs) {
+        const result = await this.session.sendRequest({
+            type: MiniappRequestType.MEMORY_PENDING_SUMMARY_HOUR,
+            nowMs,
+        });
+        return result?.hourStart ?? null;
+    }
+    /** Drop the entire timeline: every entry and every summary. */
+    async clear() {
+        await this.session.sendRequest({
+            type: MiniappRequestType.MEMORY_CLEAR,
+        });
+    }
+}
+//# sourceMappingURL=memory.js.map

package/dist/modules/memory.js.map

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

package/dist/modules/mic.d.ts

@@ -0,0 +1,61 @@
+/**
+ * @fileoverview MicModule — low-level audio input subscriptions.
+ *
+ * Mirrors cloud SDK v3's MicManager naming. Houses raw audio chunks + VAD;
+ * transcription and translation hoisted to top-level (`session.transcription`
+ * / `session.translation`) in the v3-alignment round so authors don't have to
+ * mentally model "transcription is a microphone thing" — it's just a
+ * top-level domain. This module was called `MicrophoneModule` /
+ * `session.microphone` before that round.
+ *
+ * Audio *output* (TTS, file playback) lives on `session.speaker`.
+ *
+ * MICROPHONE permission must be declared in miniapp.json for any of these
+ * subscriptions to succeed; the phone runtime rejects with
+ * PERMISSION_NOT_DECLARED otherwise.
+ */
+import { MiniappSession } from "../session";
+import type { AudioChunkData, UnsubscribeFn, VadData } from "./events";
+export declare class MicModule {
+    private readonly session;
+    /** All active unsubscribe functions for stop() to tear down at once. */
+    private readonly unsubs;
+    constructor(session: MiniappSession);
+    /**
+     * Subscribe to voice activity detection (VAD) events. `data.status` is
+     * `true` while the user is speaking, `false` when silent.
+     */
+    onVoiceActivity(handler: (data: VadData) => void): UnsubscribeFn;
+    /**
+     * Subscribe to raw audio chunks. Format depends on the phone's mic mode
+     * (PCM or LC3, base64-encoded).
+     */
+    onAudioChunk(handler: (data: AudioChunkData) => void): UnsubscribeFn;
+    /**
+     * Temporarily override glasses-side voice activity detection (GX8002) for
+     * this miniapp's lifetime. When disabled, mic gating falls back to the
+     * loudness gate only (if it is enabled). The Glassly App's configured value
+     * is restored when this miniapp disconnects.
+     *
+     * Requires `MICROPHONE` in the miniapp manifest.
+     */
+    setVoiceActivityDetectionEnabled(enabled: boolean): Promise<void>;
+    /**
+     * Temporarily override the center-mic loudness gate ("Barrier") for this
+     * miniapp's lifetime. It blocks quiet/self-talk audio independent of VAD.
+     * The Glassly App's configured value is restored when this miniapp disconnects.
+     *
+     * Requires `MICROPHONE` in the miniapp manifest.
+     */
+    setLoudnessGateEnabled(enabled: boolean): Promise<void>;
+    /**
+     * Tear down every subscription this module owns. Useful when a component
+     * is unmounting and wants to free everything at once without tracking
+     * individual unsubscribe functions.
+     */
+    stop(): void;
+    /** True iff `MICROPHONE` is declared in the miniapp's manifest. */
+    get hasPermission(): boolean;
+    private track;
+}
+//# sourceMappingURL=mic.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mic.d.ts","sourceRoot":"","sources":["../../src/modules/mic.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAGH,OAAO,EAAC,cAAc,EAAC,MAAM,YAAY,CAAA;AACzC,OAAO,KAAK,EAAC,cAAc,EAAE,aAAa,EAAE,OAAO,EAAC,MAAM,UAAU,CAAA;AAEpE,qBAAa,SAAS;IAIR,OAAO,CAAC,QAAQ,CAAC,OAAO;IAHpC,wEAAwE;IACxE,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA2B;gBAErB,OAAO,EAAE,cAAc;IAEpD;;;OAGG;IACH,eAAe,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,GAAG,aAAa;IAIhE;;;OAGG;IACH,YAAY,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,cAAc,KAAK,IAAI,GAAG,aAAa;IAIpE;;;;;;;OAOG;IACH,gCAAgC,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAOjE;;;;;;OAMG;IACH,sBAAsB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAOvD;;;;OAIG;IACH,IAAI,IAAI,IAAI;IAWZ,mEAAmE;IACnE,IAAI,aAAa,IAAI,OAAO,CAE3B;IAID,OAAO,CAAC,KAAK;CAOd"}

package/dist/modules/mic.js

@@ -0,0 +1,94 @@
+/**
+ * @fileoverview MicModule — low-level audio input subscriptions.
+ *
+ * Mirrors cloud SDK v3's MicManager naming. Houses raw audio chunks + VAD;
+ * transcription and translation hoisted to top-level (`session.transcription`
+ * / `session.translation`) in the v3-alignment round so authors don't have to
+ * mentally model "transcription is a microphone thing" — it's just a
+ * top-level domain. This module was called `MicrophoneModule` /
+ * `session.microphone` before that round.
+ *
+ * Audio *output* (TTS, file playback) lives on `session.speaker`.
+ *
+ * MICROPHONE permission must be declared in miniapp.json for any of these
+ * subscriptions to succeed; the phone runtime rejects with
+ * PERMISSION_NOT_DECLARED otherwise.
+ */
+import { MiniappRequestType, MiniappStreamType } from "../protocol";
+export class MicModule {
+    constructor(session) {
+        this.session = session;
+        /** All active unsubscribe functions for stop() to tear down at once. */
+        this.unsubs = new Set();
+    }
+    /**
+     * Subscribe to voice activity detection (VAD) events. `data.status` is
+     * `true` while the user is speaking, `false` when silent.
+     */
+    onVoiceActivity(handler) {
+        return this.track(this.session._subscribe(MiniappStreamType.VAD, handler));
+    }
+    /**
+     * Subscribe to raw audio chunks. Format depends on the phone's mic mode
+     * (PCM or LC3, base64-encoded).
+     */
+    onAudioChunk(handler) {
+        return this.track(this.session._subscribe(MiniappStreamType.AUDIO_CHUNK, handler));
+    }
+    /**
+     * Temporarily override glasses-side voice activity detection (GX8002) for
+     * this miniapp's lifetime. When disabled, mic gating falls back to the
+     * loudness gate only (if it is enabled). The Glassly App's configured value
+     * is restored when this miniapp disconnects.
+     *
+     * Requires `MICROPHONE` in the miniapp manifest.
+     */
+    setVoiceActivityDetectionEnabled(enabled) {
+        return this.session.sendRequest({
+            type: MiniappRequestType.MIC_SET_VAD_ENABLED,
+            enabled,
+        });
+    }
+    /**
+     * Temporarily override the center-mic loudness gate ("Barrier") for this
+     * miniapp's lifetime. It blocks quiet/self-talk audio independent of VAD.
+     * The Glassly App's configured value is restored when this miniapp disconnects.
+     *
+     * Requires `MICROPHONE` in the miniapp manifest.
+     */
+    setLoudnessGateEnabled(enabled) {
+        return this.session.sendRequest({
+            type: MiniappRequestType.MIC_SET_LOUDNESS_GATE_ENABLED,
+            enabled,
+        });
+    }
+    /**
+     * Tear down every subscription this module owns. Useful when a component
+     * is unmounting and wants to free everything at once without tracking
+     * individual unsubscribe functions.
+     */
+    stop() {
+        for (const u of this.unsubs) {
+            try {
+                u();
+            }
+            catch {
+                /* ignore */
+            }
+        }
+        this.unsubs.clear();
+    }
+    /** True iff `MICROPHONE` is declared in the miniapp's manifest. */
+    get hasPermission() {
+        return this.session._hasManifestPermission("MICROPHONE");
+    }
+    // ------------------------------------------------------------------------
+    track(unsub) {
+        this.unsubs.add(unsub);
+        return () => {
+            this.unsubs.delete(unsub);
+            unsub();
+        };
+    }
+}
+//# sourceMappingURL=mic.js.map

package/dist/modules/mic.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mic.js","sourceRoot":"","sources":["../../src/modules/mic.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAC,kBAAkB,EAAE,iBAAiB,EAAC,MAAM,aAAa,CAAA;AAIjE,MAAM,OAAO,SAAS;IAIpB,YAA6B,OAAuB;QAAvB,YAAO,GAAP,OAAO,CAAgB;QAHpD,wEAAwE;QACvD,WAAM,GAAG,IAAI,GAAG,EAAiB,CAAA;IAEK,CAAC;IAExD;;;OAGG;IACH,eAAe,CAAC,OAAgC;QAC9C,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,iBAAiB,CAAC,GAAG,EAAE,OAAkC,CAAC,CAAC,CAAA;IACvG,CAAC;IAED;;;OAGG;IACH,YAAY,CAAC,OAAuC;QAClD,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,iBAAiB,CAAC,WAAW,EAAE,OAAkC,CAAC,CAAC,CAAA;IAC/G,CAAC;IAED;;;;;;;OAOG;IACH,gCAAgC,CAAC,OAAgB;QAC/C,OAAO,IAAI,CAAC,OAAO,CAAC,WAAW,CAAO;YACpC,IAAI,EAAE,kBAAkB,CAAC,mBAAmB;YAC5C,OAAO;SACR,CAAC,CAAA;IACJ,CAAC;IAED;;;;;;OAMG;IACH,sBAAsB,CAAC,OAAgB;QACrC,OAAO,IAAI,CAAC,OAAO,CAAC,WAAW,CAAO;YACpC,IAAI,EAAE,kBAAkB,CAAC,6BAA6B;YACtD,OAAO;SACR,CAAC,CAAA;IACJ,CAAC;IAED;;;;OAIG;IACH,IAAI;QACF,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAC5B,IAAI,CAAC;gBACH,CAAC,EAAE,CAAA;YACL,CAAC;YAAC,MAAM,CAAC;gBACP,YAAY;YACd,CAAC;QACH,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAA;IACrB,CAAC;IAED,mEAAmE;IACnE,IAAI,aAAa;QACf,OAAO,IAAI,CAAC,OAAO,CAAC,sBAAsB,CAAC,YAAY,CAAC,CAAA;IAC1D,CAAC;IAED,2EAA2E;IAEnE,KAAK,CAAC,KAAoB;QAChC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAA;QACtB,OAAO,GAAG,EAAE;YACV,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;YACzB,KAAK,EAAE,CAAA;QACT,CAAC,CAAA;IACH,CAAC;CACF"}

package/dist/modules/miniapps.d.ts

@@ -0,0 +1,82 @@
+/**
+ * @fileoverview MiniappsModule — `session.miniapps`.
+ *
+ * Discover and control the lifecycle of OTHER miniapps: list, start, stop.
+ * SYSTEM-only — every call rejects with NOT_PERMITTED unless the caller is a
+ * system app (Glassly AI is the first consumer). The action *capability* layer
+ * (invoke / handle) lives on `session.actions`, not here — these three are
+ * operations on the app as a whole, not on a declared action.
+ */
+import { MiniappSession } from "../session";
+/** A declared action surfaced by {@link MiniappsModule.list}. */
+export interface MiniappActionInfo {
+    id: string;
+    description: string;
+    /**
+     * JSON-Schema input descriptor (the MCP-compatible subset). Maps verbatim
+     * to an MCP tool `inputSchema`. Undefined for actions that take no params.
+     */
+    parameters?: Record<string, unknown>;
+    /** JSON-Schema descriptor for the structured value returned by the action. */
+    outputSchema?: Record<string, unknown>;
+}
+/**
+ * Hardware compatibility for a listed miniapp. Structurally mirrors the host's
+ * `CompatibilityResult` so the runtime can pass it straight through.
+ */
+export interface MiniappCompatibility {
+    isCompatible: boolean;
+    missingRequired: Array<{
+        type: string;
+        level?: string;
+    }>;
+    missingOptional: Array<{
+        type: string;
+        level?: string;
+    }>;
+    warnings: string[];
+}
+/** One installed miniapp, as surfaced to a system caller. */
+export interface MiniappInfo {
+    packageName: string;
+    name: string;
+    description?: string;
+    version: string;
+    running: boolean;
+    compatibility: MiniappCompatibility;
+    /** Declared actions (empty if the miniapp declares none). */
+    actions: MiniappActionInfo[];
+}
+export interface ListMiniappsOptions {
+    /** Include incompatible miniapps too (default false — compatible-only). */
+    includeIncompatible?: boolean;
+}
+export declare class MiniappsModule {
+    private readonly session;
+    constructor(session: MiniappSession);
+    /**
+     * List installed miniapps. Compatible-only by default; pass
+     * `{includeIncompatible: true}` to include the rest (each carries a
+     * `compatibility` result with the missing hardware). SYSTEM-only.
+     */
+    list(opts?: ListMiniappsOptions): Promise<MiniappInfo[]>;
+    /**
+     * Start another miniapp in the **background** — spawns its background JS
+     * context without changing the user's phone navigation or foregrounding
+     * anything. The app reports as running and can handle actions / drive the
+     * glasses immediately; its WebView only mounts if the user later opens it.
+     * SYSTEM-only.
+     */
+    start(packageName: string): Promise<void>;
+    /** Stop another miniapp. SYSTEM-only. */
+    stop(packageName: string): Promise<void>;
+    /**
+     * Stop THIS miniapp — the host tears the background context down shortly
+     * after. Not system-gated: an app may always stop itself. Fire-and-forget
+     * (no reply — the caller is going away); flush anything pending first, e.g.
+     * defer this with a short setTimeout from an action handler so the
+     * ACTION_RESULT reaches the caller before teardown.
+     */
+    stopSelf(): void;
+}
+//# sourceMappingURL=miniapps.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"miniapps.d.ts","sourceRoot":"","sources":["../../src/modules/miniapps.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EAAC,cAAc,EAAC,MAAM,YAAY,CAAA;AAEzC,iEAAiE;AACjE,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAA;IACV,WAAW,EAAE,MAAM,CAAA;IACnB;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACpC,8EAA8E;IAC9E,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACvC;AAED;;;GAGG;AACH,MAAM,WAAW,oBAAoB;IACnC,YAAY,EAAE,OAAO,CAAA;IACrB,eAAe,EAAE,KAAK,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAC,CAAC,CAAA;IACtD,eAAe,EAAE,KAAK,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAC,CAAC,CAAA;IACtD,QAAQ,EAAE,MAAM,EAAE,CAAA;CACnB;AAED,6DAA6D;AAC7D,MAAM,WAAW,WAAW;IAC1B,WAAW,EAAE,MAAM,CAAA;IACnB,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,EAAE,OAAO,CAAA;IAChB,aAAa,EAAE,oBAAoB,CAAA;IACnC,6DAA6D;IAC7D,OAAO,EAAE,iBAAiB,EAAE,CAAA;CAC7B;AAED,MAAM,WAAW,mBAAmB;IAClC,2EAA2E;IAC3E,mBAAmB,CAAC,EAAE,OAAO,CAAA;CAC9B;AAED,qBAAa,cAAc;IACb,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAAP,OAAO,EAAE,cAAc;IAEpD;;;;OAIG;IACG,IAAI,CAAC,IAAI,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAQ9D;;;;;;OAMG;IACG,KAAK,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAO/C,yCAAyC;IACnC,IAAI,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAO9C;;;;;;OAMG;IACH,QAAQ,IAAI,IAAI;CAGjB"}

package/dist/modules/miniapps.js

@@ -0,0 +1,58 @@
+/**
+ * @fileoverview MiniappsModule — `session.miniapps`.
+ *
+ * Discover and control the lifecycle of OTHER miniapps: list, start, stop.
+ * SYSTEM-only — every call rejects with NOT_PERMITTED unless the caller is a
+ * system app (Glassly AI is the first consumer). The action *capability* layer
+ * (invoke / handle) lives on `session.actions`, not here — these three are
+ * operations on the app as a whole, not on a declared action.
+ */
+import { MiniappRequestType } from "../protocol";
+export class MiniappsModule {
+    constructor(session) {
+        this.session = session;
+    }
+    /**
+     * List installed miniapps. Compatible-only by default; pass
+     * `{includeIncompatible: true}` to include the rest (each carries a
+     * `compatibility` result with the missing hardware). SYSTEM-only.
+     */
+    async list(opts) {
+        const result = await this.session.sendRequest({
+            type: MiniappRequestType.MINIAPPS_LIST,
+            includeIncompatible: opts?.includeIncompatible ?? false,
+        });
+        return result ?? [];
+    }
+    /**
+     * Start another miniapp in the **background** — spawns its background JS
+     * context without changing the user's phone navigation or foregrounding
+     * anything. The app reports as running and can handle actions / drive the
+     * glasses immediately; its WebView only mounts if the user later opens it.
+     * SYSTEM-only.
+     */
+    async start(packageName) {
+        await this.session.sendRequest({
+            type: MiniappRequestType.MINIAPPS_START,
+            packageName,
+        });
+    }
+    /** Stop another miniapp. SYSTEM-only. */
+    async stop(packageName) {
+        await this.session.sendRequest({
+            type: MiniappRequestType.MINIAPPS_STOP,
+            packageName,
+        });
+    }
+    /**
+     * Stop THIS miniapp — the host tears the background context down shortly
+     * after. Not system-gated: an app may always stop itself. Fire-and-forget
+     * (no reply — the caller is going away); flush anything pending first, e.g.
+     * defer this with a short setTimeout from an action handler so the
+     * ACTION_RESULT reaches the caller before teardown.
+     */
+    stopSelf() {
+        this.session.sendOneShot({ type: MiniappRequestType.MINIAPPS_STOP_SELF });
+    }
+}
+//# sourceMappingURL=miniapps.js.map

package/dist/modules/miniapps.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"miniapps.js","sourceRoot":"","sources":["../../src/modules/miniapps.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAC,kBAAkB,EAAC,MAAM,aAAa,CAAA;AA4C9C,MAAM,OAAO,cAAc;IACzB,YAA6B,OAAuB;QAAvB,YAAO,GAAP,OAAO,CAAgB;IAAG,CAAC;IAExD;;;;OAIG;IACH,KAAK,CAAC,IAAI,CAAC,IAA0B;QACnC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,WAAW,CAAgB;YAC3D,IAAI,EAAE,kBAAkB,CAAC,aAAa;YACtC,mBAAmB,EAAE,IAAI,EAAE,mBAAmB,IAAI,KAAK;SACxD,CAAC,CAAA;QACF,OAAO,MAAM,IAAI,EAAE,CAAA;IACrB,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,KAAK,CAAC,WAAmB;QAC7B,MAAM,IAAI,CAAC,OAAO,CAAC,WAAW,CAAO;YACnC,IAAI,EAAE,kBAAkB,CAAC,cAAc;YACvC,WAAW;SACZ,CAAC,CAAA;IACJ,CAAC;IAED,yCAAyC;IACzC,KAAK,CAAC,IAAI,CAAC,WAAmB;QAC5B,MAAM,IAAI,CAAC,OAAO,CAAC,WAAW,CAAO;YACnC,IAAI,EAAE,kBAAkB,CAAC,aAAa;YACtC,WAAW;SACZ,CAAC,CAAA;IACJ,CAAC;IAED;;;;;;OAMG;IACH,QAAQ;QACN,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,EAAC,IAAI,EAAE,kBAAkB,CAAC,kBAAkB,EAAC,CAAC,CAAA;IACzE,CAAC;CACF"}