@doubao-dev/plugin-app-dev 0.0.0-stage → 0.0.40-canary-dea0ddc73-20261026073950

package/dist/plugin.d.ts

@@ -0,0 +1,102 @@
+declare interface AppContext {
+    project: AppProject;
+    signal: AbortSignal;
+    interactive: boolean;
+    log: Logger;
+    report(state: Partial<Omit<ServiceView, 'name' | 'title'>>): void;
+    onDispose(dispose: () => void | Promise<void>): void;
+    onFileChange(listener: () => void | Promise<void>): void;
+}
+
+declare interface AppDevTools {
+    quiet?: boolean;
+    queryVersions(): Promise<{
+        version?: string;
+    }[]>;
+    requestTicket: DeviceSessionOptions['requestTicket'];
+    kitVersion: string;
+    loadKit(output: {
+        interactive: boolean;
+        log: Logger;
+    }): Promise<string>;
+    queryAppInfo(params: {
+        name?: string;
+        ability_id?: string;
+    }, signal: AbortSignal): Promise<{
+        mini_app_base_info?: {
+            app_id?: string;
+        };
+    }>;
+}
+
+declare interface AppProject {
+    root: string;
+    plugin: {
+        name: string;
+        id?: string;
+    };
+    app?: {
+        root: string;
+    };
+    mcpServers: Record<string, unknown>[];
+    readSkills(): {
+        root: string;
+        content: string;
+    }[];
+}
+
+declare interface DeviceSessionOptions {
+    appId: string;
+    host: string;
+    signal: AbortSignal;
+    requestTicket(context: DeviceTicketContext, signal: AbortSignal): Promise<DeviceTicket>;
+    onState(state: DeviceState): void;
+    onQr(ticket?: DeviceTicket): void | Promise<void>;
+}
+
+declare interface DeviceState {
+    phase: 'idle' | 'preparing' | 'waiting' | 'connecting' | 'reconnecting' | 'connected' | 'error';
+    message: string;
+}
+
+declare interface DeviceTicket {
+    qrCodeValue: string;
+    debugToken?: string;
+}
+
+declare interface DeviceTicketContext {
+    appKey: string;
+    hostUrl: string;
+    wifiConnectUrl: string;
+    versionTag?: string;
+}
+
+declare type DevStatus = 'pending' | 'success' | 'error';
+
+declare type Logger = Record<'info' | 'success' | 'warn' | 'error', (message: string) => void>;
+
+declare interface ServiceView {
+    name: string;
+    title: string;
+    status: DevStatus;
+    message: string;
+    details?: Readonly<Record<string, string>>;
+    links?: Readonly<Record<string, string>>;
+    actions?: Readonly<Record<string, {
+        label: string;
+        run(): void | Promise<void>;
+    }>>;
+    progress?: number;
+    busy?: boolean;
+    panel?: {
+        title: string;
+        message: string;
+        status: DevStatus;
+        qr?: string;
+        select?: boolean;
+    };
+}
+
+export declare function startApp(ctx: AppContext, tools: AppDevTools): Promise<void>;
+
+export { }