@theaiplatform/miniapp-sdk 0.2.4 → 0.3.1

package/dist/sdk.d.ts

@@ -326,6 +326,8 @@ export declare type MiniAppPlatformApi = {
     credentials?: MiniAppCredentialsApi;
     /** Desktop host capability; feature-detect before use on portable targets. */
     printing?: MiniAppReceiptPrintingApi;
+    /** Desktop host capability; feature-detect before opening a terminal. */
+    terminal?: MiniAppTerminalApi;
     /** Browser capabilities appear only when the selected target supports them. */
     auth?: MiniAppAuthApi;
     vfs?: MiniAppVfsApi;
@@ -591,6 +593,76 @@ export declare type MiniAppStorageSetOptions = MiniAppStorageAddress & {
     expectedRevision: number | null;
 };
 
+export declare type MiniAppTerminalApi = {
+    readonly v1: MiniAppTerminalV1Api;
+};
+
+/** Versioned, desktop-only host terminal capability. */
+export declare type MiniAppTerminalV1Api = {
+    getCapabilities(): Promise<MiniAppTerminalV1Capabilities>;
+    open(options: MiniAppTerminalV1OpenOptions): Promise<MiniAppTerminalV1Session>;
+};
+
+export declare type MiniAppTerminalV1Capabilities = {
+    profiles: MiniAppTerminalV1Profile[];
+    limits: MiniAppTerminalV1Limits;
+};
+
+export declare type MiniAppTerminalV1DataEvent = {
+    type: 'data';
+    sequence: number;
+    data: Uint8Array;
+};
+
+export declare type MiniAppTerminalV1Event = MiniAppTerminalV1DataEvent | MiniAppTerminalV1ExitEvent;
+
+export declare type MiniAppTerminalV1ExitEvent = {
+    type: 'exit';
+    sequence: number;
+    code: number | null;
+    signal: string | null;
+    reason: 'exited' | 'closed' | 'revoked' | 'error';
+};
+
+export declare type MiniAppTerminalV1Limits = {
+    maxSessionsPerDocument: number;
+    maxWriteBytes: number;
+    maxOutputBytesInFlight: number;
+    maxCols: number;
+    maxRows: number;
+};
+
+export declare type MiniAppTerminalV1OpenOptions = {
+    profile: MiniAppTerminalV1ProfileId;
+    cols: number;
+    rows: number;
+};
+
+export declare type MiniAppTerminalV1Profile = {
+    id: MiniAppTerminalV1ProfileId;
+    available: boolean;
+    unavailableReason: string | null;
+};
+
+/** Host-owned terminal runtime profiles exposed by `sdk.terminal.v1`. */
+export declare type MiniAppTerminalV1ProfileId = 'workspace-shell' | 'neovim';
+
+export declare type MiniAppTerminalV1ResizeOptions = {
+    cols: number;
+    rows: number;
+};
+
+export declare type MiniAppTerminalV1Session = {
+    /** Opaque host-minted session identity; it carries no ambient authority. */
+    readonly id: string;
+    readonly profile: MiniAppTerminalV1ProfileId;
+    /** Ordered output with byte-sized backpressure owned by the host session. */
+    readonly events: ReadableStream<MiniAppTerminalV1Event>;
+    write(data: Uint8Array): Promise<void>;
+    resize(options: MiniAppTerminalV1ResizeOptions): Promise<void>;
+    close(): Promise<void>;
+};
+
 export declare type MiniAppUserProfile = {
     sub: string;
     name?: string | null;

package/dist/testing/rstest.d.ts

@@ -0,0 +1,131 @@
+import { afterAll } from '@rstest/playwright';
+import { afterEach } from '@rstest/playwright';
+import { APIRequestContext } from 'playwright';
+import { beforeAll } from '@rstest/playwright';
+import { beforeEach } from '@rstest/playwright';
+import type { Browser } from 'playwright';
+import type { BrowserContext } from 'playwright';
+import { describe } from '@rstest/playwright';
+import { expect } from '@rstest/playwright';
+import type { FrameLocator } from 'playwright';
+import type { Page } from 'playwright';
+import { PlaywrightOptions } from '@rstest/playwright';
+import { PlaywrightServe } from '@rstest/playwright';
+import { PlaywrightTest } from '@rstest/playwright';
+import { z } from 'zod';
+
+export { afterAll }
+
+export { afterEach }
+
+export { beforeAll }
+
+export { beforeEach }
+
+export { describe }
+
+export { expect }
+
+/** Validate a driver session before any endpoint or provenance field is used. */
+export declare function parseTapMiniappTestSession(value: unknown): TapMiniappTestSession;
+
+declare const sessionSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    runId: z.ZodString;
+    workspaceId: z.ZodString;
+    channelId: z.ZodString;
+    packageId: z.ZodString;
+    installationId: z.ZodString;
+    mode: z.ZodEnum<{
+        surface: "surface";
+        "live-tap": "live-tap";
+    }>;
+    dataScope: z.ZodEnum<{
+        fixture: "fixture";
+        "selected-channel": "selected-channel";
+    }>;
+    permissionScenario: z.ZodString;
+    surfaceId: z.ZodString;
+    surfaceSelector: z.ZodString;
+    surfaceAssetOrigin: z.ZodString;
+    pageUrlPrefix: z.ZodString;
+    cdpEndpoint: z.ZodString;
+    cdpAuthorization: z.ZodString;
+    artifactDirectory: z.ZodString;
+    allowedNetworkOrigins: z.ZodArray<z.ZodString>;
+    credentialAliases: z.ZodArray<z.ZodString>;
+    releaseDigest: z.ZodOptional<z.ZodString>;
+    localGeneration: z.ZodOptional<z.ZodNumber>;
+    sourceDigest: z.ZodString;
+    testBundleDigest: z.ZodString;
+}, z.core.$strip>;
+
+export declare type TapMiniappTestControl = {
+    /** Restore the run's declared fixture and permission scenario. */
+    reset: () => Promise<void>;
+    /** Ask the TAP host to emit one versioned platform event through the normal frame bridge. */
+    emitHostEvent: (event: string, payload?: unknown) => Promise<void>;
+};
+
+export declare type TapMiniappTestFixture = Readonly<Pick<TapMiniappTestSession, 'channelId' | 'dataScope' | 'installationId' | 'localGeneration' | 'mode' | 'packageId' | 'permissionScenario' | 'releaseDigest' | 'runId' | 'sourceDigest' | 'surfaceId' | 'surfaceAssetOrigin' | 'testBundleDigest' | 'workspaceId'> & {
+    readonly allowedNetworkOrigins: readonly string[];
+    readonly credentialAliases: readonly string[];
+    control: TapMiniappTestControl;
+}>;
+
+export declare type TapMiniappTestSession = z.infer<typeof sessionSchema>;
+
+export declare type TapRstestFixtures = {
+    browser: Browser;
+    context: BrowserContext;
+    page: Page;
+    /** Locator for the authorized miniapp iframe mounted by TAP's real frame host. */
+    surface: FrameLocator;
+    /** Provenance and scoped host controls for this exact test run. */
+    tap: TapMiniappTestFixture;
+};
+
+/**
+ * Rstest's Playwright test API with TAP-owned browser, page, iframe, and run
+ * fixtures. The upstream runner still owns scheduling, assertions, hooks, and
+ * reporting; TAP owns the privileged browser/session boundary.
+ */
+export declare const test: PlaywrightTest<    {
+browser: Browser;
+context: BrowserContext;
+request: APIRequestContext;
+surface: FrameLocator;
+page: Page;
+tap: Readonly<Pick<{
+schemaVersion: 1;
+runId: string;
+workspaceId: string;
+channelId: string;
+packageId: string;
+installationId: string;
+mode: "surface" | "live-tap";
+dataScope: "fixture" | "selected-channel";
+permissionScenario: string;
+surfaceId: string;
+surfaceSelector: string;
+surfaceAssetOrigin: string;
+pageUrlPrefix: string;
+cdpEndpoint: string;
+cdpAuthorization: string;
+artifactDirectory: string;
+allowedNetworkOrigins: string[];
+credentialAliases: string[];
+sourceDigest: string;
+testBundleDigest: string;
+releaseDigest?: string | undefined;
+localGeneration?: number | undefined;
+}, "packageId" | "installationId" | "workspaceId" | "channelId" | "mode" | "runId" | "dataScope" | "permissionScenario" | "surfaceId" | "surfaceAssetOrigin" | "releaseDigest" | "localGeneration" | "sourceDigest" | "testBundleDigest"> & {
+readonly allowedNetworkOrigins: readonly string[];
+readonly credentialAliases: readonly string[];
+control: TapMiniappTestControl;
+}>;
+playwright: PlaywrightOptions;
+serve: PlaywrightServe;
+}>;
+
+export { }

package/dist/testing/rstest.js

@@ -0,0 +1,241 @@
+import * as __rspack_external__rstest_playwright_5734ff29 from "@rstest/playwright";
+import * as __rspack_external_node_fs_promises_3b710708 from "node:fs/promises";
+import * as __rspack_external_node_path_806ed179 from "node:path";
+import * as __rspack_external_playwright from "playwright";
+import * as __rspack_external_zod from "zod";
+const SESSION_ENV = 'TAP_MINIAPP_TEST_SESSION_FILE';
+const sessionSchema = __rspack_external_zod.z.object({
+    schemaVersion: __rspack_external_zod.z.literal(1),
+    runId: __rspack_external_zod.z.string().min(1),
+    workspaceId: __rspack_external_zod.z.string().min(1),
+    channelId: __rspack_external_zod.z.string().min(1),
+    packageId: __rspack_external_zod.z.string().min(1),
+    installationId: __rspack_external_zod.z.string().min(1),
+    mode: __rspack_external_zod.z["enum"]([
+        'surface',
+        'live-tap'
+    ]),
+    dataScope: __rspack_external_zod.z["enum"]([
+        'fixture',
+        'selected-channel'
+    ]),
+    permissionScenario: __rspack_external_zod.z.string().min(1),
+    surfaceId: __rspack_external_zod.z.string().min(1),
+    surfaceSelector: __rspack_external_zod.z.string().min(1),
+    surfaceAssetOrigin: __rspack_external_zod.z.string().url(),
+    pageUrlPrefix: __rspack_external_zod.z.string().url(),
+    cdpEndpoint: __rspack_external_zod.z.string().url(),
+    cdpAuthorization: __rspack_external_zod.z.string().min(1),
+    artifactDirectory: __rspack_external_zod.z.string().min(1),
+    allowedNetworkOrigins: __rspack_external_zod.z.array(__rspack_external_zod.z.string().url()).max(128),
+    credentialAliases: __rspack_external_zod.z.array(__rspack_external_zod.z.string().min(1).max(256)).max(64),
+    releaseDigest: __rspack_external_zod.z.string().min(1).optional(),
+    localGeneration: __rspack_external_zod.z.number().int().nonnegative().optional(),
+    sourceDigest: __rspack_external_zod.z.string().min(1),
+    testBundleDigest: __rspack_external_zod.z.string().min(1)
+});
+let sessionPromise;
+let browserPromise;
+function parseTapMiniappTestSession(value) {
+    return sessionSchema.parse(value);
+}
+async function loadSession() {
+    sessionPromise ??= (async ()=>{
+        const sessionPath = process.env[SESSION_ENV]?.trim();
+        if (!sessionPath) throw new Error(`${SESSION_ENV} is missing. Start this suite from The AI Platform Miniapp Test Lab.`);
+        const raw = await (0, __rspack_external_node_fs_promises_3b710708.readFile)(sessionPath, 'utf8');
+        return parseTapMiniappTestSession(JSON.parse(raw));
+    })();
+    return sessionPromise;
+}
+function selectPage(context, session) {
+    const candidates = context.pages().filter((candidate)=>candidate.url().startsWith(session.pageUrlPrefix));
+    if (1 !== candidates.length) throw new Error(`TAP Browser Driver exposed ${candidates.length} matching pages for run ${session.runId}; expected exactly one.`);
+    const page = candidates[0];
+    if (!page) throw new Error('TAP Browser Driver page selection failed');
+    return page;
+}
+async function emitHostEvent(page, session, event, payload) {
+    if (!event.startsWith('tap.') || event.length > 160 || event.trim() !== event) throw new Error('TAP host events must be bounded, trimmed tap.* event names.');
+    await page.evaluate(({ controlEvent, event, payload, runId })=>{
+        const response = {};
+        globalThis.dispatchEvent(new CustomEvent(controlEvent, {
+            detail: {
+                event,
+                payload,
+                response,
+                runId
+            }
+        }));
+        if (response.error) throw new Error(response.error);
+        if (!response.delivered) throw new Error(`The TAP frame host has no active subscriber for ${event}. Declare the event on the miniapp surface before using it in a test.`);
+    }, {
+        controlEvent: 'tap:miniapp-test-control',
+        event,
+        payload,
+        runId: session.runId
+    });
+}
+function fixtureMetadata(session, page) {
+    return Object.freeze({
+        allowedNetworkOrigins: Object.freeze([
+            ...session.allowedNetworkOrigins
+        ]),
+        channelId: session.channelId,
+        credentialAliases: Object.freeze([
+            ...session.credentialAliases
+        ]),
+        control: Object.freeze({
+            emitHostEvent: (event, payload)=>emitHostEvent(page, session, event, payload),
+            reset: async ()=>{
+                await page.reload({
+                    waitUntil: 'domcontentloaded'
+                });
+                await page.locator(session.surfaceSelector).waitFor({
+                    state: 'attached'
+                });
+            }
+        }),
+        dataScope: session.dataScope,
+        installationId: session.installationId,
+        localGeneration: session.localGeneration,
+        mode: session.mode,
+        packageId: session.packageId,
+        permissionScenario: session.permissionScenario,
+        releaseDigest: session.releaseDigest,
+        runId: session.runId,
+        sourceDigest: session.sourceDigest,
+        surfaceAssetOrigin: session.surfaceAssetOrigin,
+        surfaceId: session.surfaceId,
+        testBundleDigest: session.testBundleDigest,
+        workspaceId: session.workspaceId
+    });
+}
+function safeArtifactSegment(value) {
+    return value.replaceAll(/[^a-zA-Z0-9._-]/g, '-').slice(0, 160);
+}
+const test = __rspack_external__rstest_playwright_5734ff29.test.extend({
+    browser: async (_context, use)=>{
+        const session = await loadSession();
+        browserPromise ??= __rspack_external_playwright.chromium.connectOverCDP(session.cdpEndpoint, {
+            headers: {
+                authorization: `Bearer ${session.cdpAuthorization}`,
+                'x-tap-miniapp-test-run': session.runId
+            }
+        });
+        await use(await browserPromise);
+    },
+    context: async ({ browser, task }, use)=>{
+        const session = await loadSession();
+        const contexts = browser.contexts().filter((candidate)=>candidate.pages().some((page)=>page.url().startsWith(session.pageUrlPrefix)));
+        if (1 !== contexts.length) throw new Error(`TAP Browser Driver exposed ${contexts.length} matching contexts for run ${session.runId}; expected exactly one.`);
+        const context = contexts[0];
+        if (!context) throw new Error('TAP Browser Driver context selection failed');
+        const hostPage = selectPage(context, session);
+        const runtimeOrigins = new Set(hostPage.frames().map((frame)=>originOf(frame.url())).filter((origin)=>void 0 !== origin));
+        const allowedOrigins = new Set([
+            ...runtimeOrigins,
+            new URL(session.surfaceAssetOrigin).origin,
+            ...session.allowedNetworkOrigins.map((value)=>new URL(value).origin)
+        ]);
+        const enforceNetworkPolicy = async (route)=>{
+            const url = route.request().url();
+            const origin = originOf(url);
+            if (void 0 === origin || allowedOrigins.has(origin)) return void await route.continue();
+            await route.abort('blockedbyclient');
+        };
+        await context.route('**/*', enforceNetworkPolicy);
+        const traceDirectory = (0, __rspack_external_node_path_806ed179.join)(session.artifactDirectory, 'traces', safeArtifactSegment(task.id));
+        await (0, __rspack_external_node_fs_promises_3b710708.mkdir)(traceDirectory, {
+            recursive: true
+        });
+        await context.tracing.start({
+            screenshots: true,
+            snapshots: true,
+            sources: true
+        });
+        try {
+            await use(context);
+        } finally{
+            await context.tracing.stop({
+                path: (0, __rspack_external_node_path_806ed179.join)(traceDirectory, 'trace.zip')
+            });
+            const traceSummary = {
+                schemaVersion: 1,
+                runId: session.runId,
+                taskId: task.id,
+                mode: session.mode,
+                dataScope: session.dataScope,
+                packageId: session.packageId,
+                surfaceId: session.surfaceId,
+                sourceDigest: session.sourceDigest,
+                testBundleDigest: session.testBundleDigest,
+                tracePath: 'trace.zip',
+                redactions: [
+                    'authorization headers',
+                    'cookies',
+                    'credential values',
+                    'network bodies'
+                ]
+            };
+            await Promise.all([
+                (0, __rspack_external_node_fs_promises_3b710708.writeFile)((0, __rspack_external_node_path_806ed179.join)(traceDirectory, 'trace-summary.json'), `${JSON.stringify(traceSummary, void 0, 2)}\n`, 'utf8'),
+                (0, __rspack_external_node_fs_promises_3b710708.writeFile)((0, __rspack_external_node_path_806ed179.join)(traceDirectory, 'debug.md'), [
+                    '# Miniapp test trace',
+                    '',
+                    `- Run: \`${session.runId}\``,
+                    `- Rstest task: \`${task.id}\``,
+                    `- Mode: \`${session.mode}\``,
+                    `- Data scope: \`${session.dataScope}\``,
+                    `- Surface: \`${session.surfaceId}\``,
+                    `- Source digest: \`${session.sourceDigest}\``,
+                    `- Test bundle digest: \`${session.testBundleDigest}\``,
+                    '',
+                    'Open `trace.zip` from The AI Platform Test Lab for the DOM, screenshots, console, and network timeline. The final assertion outcome is authoritative in `report.json` and `report.md`.',
+                    ''
+                ].join('\n'), 'utf8')
+            ]);
+            await context.unroute('**/*', enforceNetworkPolicy);
+        }
+    },
+    page: async ({ context }, use)=>{
+        const session = await loadSession();
+        const page = selectPage(context, session);
+        await page.locator(session.surfaceSelector).waitFor({
+            state: 'attached'
+        });
+        await use(page);
+    },
+    surface: async ({ page }, use)=>{
+        const session = await loadSession();
+        await use(page.frameLocator(session.surfaceSelector));
+    },
+    tap: async ({ page }, use)=>{
+        await use(fixtureMetadata(await loadSession(), page));
+    }
+});
+function originOf(value) {
+    try {
+        const url = new URL(value);
+        if (matchesNonNetworkScheme(url.protocol)) return;
+        return url.origin;
+    } catch  {
+        return;
+    }
+}
+function matchesNonNetworkScheme(protocol) {
+    return NON_NETWORK_PROTOCOLS.has(protocol);
+}
+const NON_NETWORK_PROTOCOLS = new Set([
+    'about:',
+    'blob:',
+    'data:',
+    'file:'
+]);
+var afterAll = __rspack_external__rstest_playwright_5734ff29.afterAll;
+var afterEach = __rspack_external__rstest_playwright_5734ff29.afterEach;
+var beforeAll = __rspack_external__rstest_playwright_5734ff29.beforeAll;
+var beforeEach = __rspack_external__rstest_playwright_5734ff29.beforeEach;
+var describe = __rspack_external__rstest_playwright_5734ff29.describe;
+var expect = __rspack_external__rstest_playwright_5734ff29.expect;
+export { afterAll, afterEach, beforeAll, beforeEach, describe, expect, parseTapMiniappTestSession, test };

package/dist/ui/wasm.js

@@ -6,7 +6,7 @@ import { clsx } from "clsx";
 import { twMerge } from "tailwind-merge";
 import { Slot as react_slot_Slot } from "@radix-ui/react-slot";
 import "prism-react-renderer";
-import { composeRefs } from "@radix-ui/react-compose-refs";
+import { useComposedRefs } from "@radix-ui/react-compose-refs";
 import { useCallback as external_react_useCallback, useEffect, useRef } from "react";
 import "react-resizable-panels";
 import "@radix-ui/react-scroll-area";
@@ -626,6 +626,7 @@ DialogContentPrimitive.displayName = __rspack_external__radix_ui_react_dialog_da
 function DialogContent({ className, children, ref, container, hideCloseButton, onOpenAutoFocus, onEscapeKeyDown, ...props }) {
     const { ref: occlusionRef, ready } = native_view_occlusion_useNativeViewOcclusion();
     const contentRef = __rspack_external_react.useRef(null);
+    const composedContentRef = useComposedRefs(ref, contentRef);
     const closeButtonRef = __rspack_external_react.useRef(null);
     const shouldFocusWhenReadyRef = __rspack_external_react.useRef(false);
     const handleOpenAutoFocus = __rspack_external_react.useCallback((event)=>{
@@ -670,7 +671,7 @@ function DialogContent({ className, children, ref, container, hideCloseButton, o
             bottom: 'var(--chat-input-offset, 0px)'
         } : void 0
     }, /*#__PURE__*/ __rspack_external_react.createElement(DialogContentPrimitive, {
-        ref: composeRefs(ref, contentRef),
+        ref: composedContentRef,
         className: utils_cn('bg-surface-level-1 pointer-events-auto relative grid max-h-full w-full max-w-lg min-w-0 gap-4 overflow-auto rounded-3xl border p-8 break-words shadow-lg', className),
         ...container ? {
             onInteractOutside: (e)=>{
@@ -1348,8 +1349,9 @@ function SelectScrollDownButton({ className, ref, ...props }) {
 SelectScrollDownButton.displayName = __rspack_external__radix_ui_react_select_4606f4d3.ScrollDownButton.displayName;
 function SelectContent({ className, children, position = 'popper', ref, ...props }) {
     const { ref: occlusionRef, ready } = native_view_occlusion_useNativeViewOcclusion();
+    const composedRef = useComposedRefs(ref, occlusionRef);
     return /*#__PURE__*/ __rspack_external_react.createElement(__rspack_external__radix_ui_react_select_4606f4d3.Portal, null, /*#__PURE__*/ __rspack_external_react.createElement(__rspack_external__radix_ui_react_select_4606f4d3.Content, {
-        ref: composeRefs(ref, occlusionRef),
+        ref: composedRef,
         className: utils_cn('bg-popover text-popover-foreground data-[state=open]:animate-in data-[state=closed]:animate-out data-[state=closed]:fade-out-0 data-[state=open]:fade-in-0 data-[state=closed]:zoom-out-95 data-[state=open]:zoom-in-95 data-[side=bottom]:slide-in-from-top-2 data-[side=left]:slide-in-from-right-2 data-[side=right]:slide-in-from-left-2 data-[side=top]:slide-in-from-bottom-2 relative z-(--z-popover) max-h-[--radix-select-content-available-height] min-w-[8rem] overflow-x-hidden overflow-y-auto rounded-lg shadow-sm data-[side=bottom]:origin-top data-[side=left]:origin-right data-[side=right]:origin-left data-[side=top]:origin-bottom', 'popper' === position && 'data-[side=bottom]:translate-y-1 data-[side=left]:-translate-x-1 data-[side=right]:translate-x-1 data-[side=top]:-translate-y-1', !ready && 'invisible', className),
         position: position,
         ...props

package/dist/ui.js

@@ -4,7 +4,7 @@ import { twMerge } from "tailwind-merge";
 import { Slot } from "@radix-ui/react-slot";
 import { Check, CheckIcon, ChevronDown, ChevronUp, Circle, CopyIcon, GripVertical, X, XIcon } from "lucide-react";
 import { Highlight, themes } from "prism-react-renderer";
-import { composeRefs } from "@radix-ui/react-compose-refs";
+import { useComposedRefs } from "@radix-ui/react-compose-refs";
 import { useCallback, useEffect, useRef } from "react";
 import { Group, Panel, Separator as external_react_resizable_panels_Separator } from "react-resizable-panels";
 import * as __rspack_external_react from "react";
@@ -808,6 +808,7 @@ DialogContentPrimitive.displayName = __rspack_external__radix_ui_react_dialog_da
 function DialogContent({ className, children, ref, container, hideCloseButton, onOpenAutoFocus, onEscapeKeyDown, ...props }) {
     const { ref: occlusionRef, ready } = useNativeViewOcclusion();
     const contentRef = __rspack_external_react.useRef(null);
+    const composedContentRef = useComposedRefs(ref, contentRef);
     const closeButtonRef = __rspack_external_react.useRef(null);
     const shouldFocusWhenReadyRef = __rspack_external_react.useRef(false);
     const handleOpenAutoFocus = __rspack_external_react.useCallback((event)=>{
@@ -852,7 +853,7 @@ function DialogContent({ className, children, ref, container, hideCloseButton, o
             bottom: 'var(--chat-input-offset, 0px)'
         } : void 0
     }, /*#__PURE__*/ __rspack_external_react.createElement(DialogContentPrimitive, {
-        ref: composeRefs(ref, contentRef),
+        ref: composedContentRef,
         className: cn('bg-surface-level-1 pointer-events-auto relative grid max-h-full w-full max-w-lg min-w-0 gap-4 overflow-auto rounded-3xl border p-8 break-words shadow-lg', className),
         ...container ? {
             onInteractOutside: (e)=>{
@@ -1725,8 +1726,9 @@ function SelectScrollDownButton({ className, ref, ...props }) {
 SelectScrollDownButton.displayName = __rspack_external__radix_ui_react_select_4606f4d3.ScrollDownButton.displayName;
 function SelectContent({ className, children, position = 'popper', ref, ...props }) {
     const { ref: occlusionRef, ready } = useNativeViewOcclusion();
+    const composedRef = useComposedRefs(ref, occlusionRef);
     return /*#__PURE__*/ __rspack_external_react.createElement(__rspack_external__radix_ui_react_select_4606f4d3.Portal, null, /*#__PURE__*/ __rspack_external_react.createElement(__rspack_external__radix_ui_react_select_4606f4d3.Content, {
-        ref: composeRefs(ref, occlusionRef),
+        ref: composedRef,
         className: cn('bg-popover text-popover-foreground data-[state=open]:animate-in data-[state=closed]:animate-out data-[state=closed]:fade-out-0 data-[state=open]:fade-in-0 data-[state=closed]:zoom-out-95 data-[state=open]:zoom-in-95 data-[side=bottom]:slide-in-from-top-2 data-[side=left]:slide-in-from-right-2 data-[side=right]:slide-in-from-left-2 data-[side=top]:slide-in-from-bottom-2 relative z-(--z-popover) max-h-[--radix-select-content-available-height] min-w-[8rem] overflow-x-hidden overflow-y-auto rounded-lg shadow-sm data-[side=bottom]:origin-top data-[side=left]:origin-right data-[side=right]:origin-left data-[side=top]:origin-bottom', 'popper' === position && 'data-[side=bottom]:translate-y-1 data-[side=left]:-translate-x-1 data-[side=right]:translate-x-1 data-[side=top]:-translate-y-1', !ready && 'invisible', className),
         position: position,
         ...props

package/dist/web.d.ts

@@ -367,6 +367,8 @@ export declare type MiniAppPlatformApi = {
     credentials?: MiniAppCredentialsApi;
     /** Desktop host capability; feature-detect before use on portable targets. */
     printing?: MiniAppReceiptPrintingApi;
+    /** Desktop host capability; feature-detect before opening a terminal. */
+    terminal?: MiniAppTerminalApi;
     /** Browser capabilities appear only when the selected target supports them. */
     auth?: MiniAppAuthApi;
     vfs?: MiniAppVfsApi;
@@ -632,6 +634,76 @@ declare type MiniAppStorageSetOptions = MiniAppStorageAddress & {
     expectedRevision: number | null;
 };
 
+declare type MiniAppTerminalApi = {
+    readonly v1: MiniAppTerminalV1Api;
+};
+
+/** Versioned, desktop-only host terminal capability. */
+declare type MiniAppTerminalV1Api = {
+    getCapabilities(): Promise<MiniAppTerminalV1Capabilities>;
+    open(options: MiniAppTerminalV1OpenOptions): Promise<MiniAppTerminalV1Session>;
+};
+
+declare type MiniAppTerminalV1Capabilities = {
+    profiles: MiniAppTerminalV1Profile[];
+    limits: MiniAppTerminalV1Limits;
+};
+
+declare type MiniAppTerminalV1DataEvent = {
+    type: 'data';
+    sequence: number;
+    data: Uint8Array;
+};
+
+declare type MiniAppTerminalV1Event = MiniAppTerminalV1DataEvent | MiniAppTerminalV1ExitEvent;
+
+declare type MiniAppTerminalV1ExitEvent = {
+    type: 'exit';
+    sequence: number;
+    code: number | null;
+    signal: string | null;
+    reason: 'exited' | 'closed' | 'revoked' | 'error';
+};
+
+declare type MiniAppTerminalV1Limits = {
+    maxSessionsPerDocument: number;
+    maxWriteBytes: number;
+    maxOutputBytesInFlight: number;
+    maxCols: number;
+    maxRows: number;
+};
+
+declare type MiniAppTerminalV1OpenOptions = {
+    profile: MiniAppTerminalV1ProfileId;
+    cols: number;
+    rows: number;
+};
+
+declare type MiniAppTerminalV1Profile = {
+    id: MiniAppTerminalV1ProfileId;
+    available: boolean;
+    unavailableReason: string | null;
+};
+
+/** Host-owned terminal runtime profiles exposed by `sdk.terminal.v1`. */
+declare type MiniAppTerminalV1ProfileId = 'workspace-shell' | 'neovim';
+
+declare type MiniAppTerminalV1ResizeOptions = {
+    cols: number;
+    rows: number;
+};
+
+declare type MiniAppTerminalV1Session = {
+    /** Opaque host-minted session identity; it carries no ambient authority. */
+    readonly id: string;
+    readonly profile: MiniAppTerminalV1ProfileId;
+    /** Ordered output with byte-sized backpressure owned by the host session. */
+    readonly events: ReadableStream<MiniAppTerminalV1Event>;
+    write(data: Uint8Array): Promise<void>;
+    resize(options: MiniAppTerminalV1ResizeOptions): Promise<void>;
+    close(): Promise<void>;
+};
+
 export declare type MiniAppTheme = 'light' | 'dark';
 
 export declare type MiniAppUiScale = number;