@kmlckj/aios-agent-server-sdk 0.0.0-stage → 0.0.1

package/dist/shared/desktop-api.d.ts

@@ -0,0 +1,449 @@
+import type { CloudAssistantApi } from './cloud-assistant-api.js';
+import type { CollaborationDesktopApi } from './collaboration-api.js';
+import type { ActionCenterApi } from './action-center-api.js';
+import type { AccountContextApi } from './account-context-api.js';
+import type { UsageStatisticsApi } from './usage-statistics-api.js';
+import type { ShortcutBindings } from './shortcut-api.js';
+import type { ClientDownloadsApi } from './client-downloads-api.js';
+import type { NavigationApi } from './navigation-api.js';
+import type { TaskMenuApi } from './task-menu-api.js';
+import type { DesktopLanguage } from './desktop-language.js';
+import type { MyExpertApi } from './my-expert-api.js';
+import type { LocalTaskApi, LocalTaskAttachmentKind, LocalTaskExecutionApi, LocalTaskPermissionMode } from './local-task-api.js';
+import type { LocalRuntimeApi } from './local-runtime-api.js';
+import type { SkillMarketApi } from './skill-market-api.js';
+import type { SceneCaseApi } from './scene-case-api.js';
+import type { ProfessionMarketApi } from './profession-market-api.js';
+import type { LocalSkillApi } from './local-skill-api.js';
+import type { ProjectLocalSkillApi } from './project-local-skill-api.js';
+import type { SkillActivationApi } from './skill-activation-api.js';
+import type { SkillAssetApi } from './skill-asset-api.js';
+import type { PluginMarketApi } from './plugin-market-api.js';
+import type { LocalPluginApi } from './local-plugin-api.js';
+import type { LocalMcpServerApi } from './local-mcp-server-api.js';
+import type { DesktopMcpServiceApi } from './desktop-mcp-service-api.js';
+import type { ClientReleaseChannel, DesktopUpdatesApi } from './update-api.js';
+import type { SpeechRecognitionApi } from './speech-recognition-api.js';
+import type { TaskInitializationApi } from './task-initialization-api.js';
+import type { DesktopSecurityPolicy, SecurityCenterApi, SecurityRuntimeToolEnablement } from './security-center-api.js';
+import type { AutomationApi } from './automation-api.js';
+import type { EnterpriseKnowledgeApi } from './enterprise-knowledge-api.js';
+import type { ComputerUseApi, ComputerUseSettings } from './computer-use-api.js';
+import type { CollaborationDeepLink } from './collaboration-deep-link.js';
+import type { DesktopFeedbackApi } from './feedback-api.js';
+import type { LocalCustomModelApi } from './local-custom-model-api.js';
+import type { PlatformBrandingApi } from './platform-branding-api.js';
+export type DesktopAppearance = 'system' | 'light' | 'dark';
+export type DesktopEnvironment = 'development' | 'release';
+export type DesktopResponseStyle = 'default' | 'professional' | 'friendly' | 'straightforward' | 'creative' | 'efficient' | 'sarcastic' | 'socratic';
+export interface DesktopPersonalizationSettings {
+    responseStyle: DesktopResponseStyle;
+    showLoadingWelcome: boolean;
+    customInstructions: string;
+}
+export type DirectoryPermission = 'read' | 'read-write';
+export type WriteBackPolicy = 'confirm' | 'allow' | 'deny';
+export interface DesktopPaths {
+    appDataDir: string;
+    cacheDir: string;
+    logsDir: string;
+    defaultWorkspaceRoot: string;
+}
+export interface DesktopStorageInfo {
+    dataDirectory: string;
+    dataBytes: number;
+    diskTotalBytes: number;
+    diskUsedBytes: number;
+    diskAvailableBytes: number;
+}
+export interface SelectFilesResult {
+    canceled: boolean;
+    files: Array<{
+        path: string;
+        name: string;
+        sizeBytes: number;
+        mediaType: string;
+        kind: LocalTaskAttachmentKind;
+    }>;
+}
+export interface DesktopRuntimeConfig {
+    environment: DesktopEnvironment;
+    webGatewayUrl: string;
+    agentGatewayUrl: string;
+    platformBaseUrl: string;
+    mcpRegistryUrl: string;
+    rendererDevUrl?: string;
+    openDevTools: boolean;
+    localRuntimePort: number;
+    updateFeedUrl?: string;
+    buildNumber: number;
+    updateChannel: ClientReleaseChannel;
+    updatePublicKey?: string;
+}
+export interface LocalSpace {
+    id: string;
+    name: string;
+    kind: 'local' | 'cloud';
+    rootPath?: string;
+    workspaceId?: string;
+    description?: string;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface AuthorizedDirectory {
+    id: string;
+    name: string;
+    path: string;
+    permission: DirectoryPermission;
+    writeBackPolicy: WriteBackPolicy;
+    expiresAt?: string;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface CommandPolicy {
+    allowlist: string[];
+    confirmList: string[];
+    denylist: string[];
+}
+export interface NetworkPolicy {
+    allowDomains: string[];
+    denyDomains: string[];
+    proxyMode: 'system' | 'custom' | 'off';
+    proxyUrl?: string;
+}
+export interface DesktopSettings extends DesktopPersonalizationSettings {
+    git?: import('./git-api.js').GitSettings;
+    worktrees?: import('./worktree-api.js').WorktreeSettings;
+    storageUnavailable?: boolean;
+    appearance: DesktopAppearance;
+    displayLanguage: DesktopLanguage;
+    fontScale: number;
+    launchAtLogin: boolean;
+    closeBehavior: 'tray' | 'quit';
+    notificationsEnabled: boolean;
+    preventSleep: boolean;
+    deletionProtection: boolean;
+    defaultTaskPermissionMode: LocalTaskPermissionMode;
+    securityPolicy: DesktopSecurityPolicy;
+    runtimeToolsEnabled: SecurityRuntimeToolEnablement;
+    workspaceDirectory: string;
+    shortcutBindings: ShortcutBindings;
+    downloadDirectory: string;
+    proxyMode: 'system' | 'custom' | 'off';
+    proxyUrl?: string;
+    computerUse: ComputerUseSettings;
+}
+export interface PlatformUser {
+    id: string;
+    username: string;
+    displayName: string;
+    email?: string;
+    phone?: string;
+    avatarUrl?: string | null;
+    tenantId?: string | null;
+    roles: string[];
+}
+export interface TenantSummary {
+    id: string;
+    name: string;
+    displayName: string;
+    status?: string;
+}
+export interface LoginContext {
+    currentTenantId?: string | null;
+    currentWorkspaceId?: string | null;
+    personalMode?: boolean;
+    contextVersion?: number;
+}
+export interface AuthSession {
+    user: PlatformUser;
+    tenants: TenantSummary[];
+    context?: LoginContext;
+    platformBaseUrl: string;
+    authenticatedAt: string;
+    accessTokenExpiresAt: string;
+}
+export type AuthLoginType = 'USERNAME' | 'PHONE';
+export interface AuthPasswordChangeRequired {
+    nextAction: 'CHANGE_PASSWORD';
+    challengeId: string;
+}
+export type AuthLoginResult = AuthSession | AuthPasswordChangeRequired;
+export interface AuthRequiredPasswordChangeRequest {
+    challengeId: string;
+    newPassword: string;
+    confirmPassword: string;
+}
+export interface AuthLoginRequest {
+    loginType: AuthLoginType;
+    username?: string;
+    countryCode?: string;
+    phoneNumber?: string;
+    password: string;
+    device?: LoginDeviceInfo;
+}
+export interface LoginDeviceInfo {
+    deviceKey: string;
+    deviceType: 'WEB' | 'DESKTOP' | 'IOS' | 'ANDROID';
+    deviceName?: string;
+    osName?: string;
+    osVersion?: string;
+    clientName?: string;
+    clientVersion?: string;
+    appVersion?: string;
+    deviceManufacturer?: string;
+    deviceModel?: string;
+    architecture?: string;
+    locale?: string;
+    timezone?: string;
+    physicalDevice?: boolean;
+    platformApiLevel?: number;
+}
+export interface AuthRegisterRequest {
+    username: string;
+    password: string;
+    displayName: string;
+    email: string;
+}
+export interface AuthCaptchaResponse {
+    captchaId: string;
+    imageDataUrl: string;
+    expiresIn: number;
+}
+export interface AuthSmsCodeRequest {
+    countryCode: string;
+    phoneNumber: string;
+    captchaId: string;
+    captchaCode: string;
+}
+export interface AuthSmsCodeResponse {
+    verificationId: string;
+    expiresIn: number;
+    retryAfter: number;
+}
+export interface AuthSmsRegistrationVerifyRequest {
+    verificationId: string;
+    countryCode: string;
+    phoneNumber: string;
+    smsCode: string;
+}
+export interface AuthRegistrationTicketResponse {
+    registrationTicket: string;
+    expiresIn: number;
+}
+export interface AuthSmsRegistrationCompleteRequest {
+    operationId: string;
+    registrationTicket: string;
+    countryCode: string;
+    phoneNumber: string;
+    password: string;
+    displayName: string;
+    agreementVersion: string;
+    privacyVersion: string;
+}
+export interface AuthSmsRegistrationCompleteResponse {
+    nextAction: 'LOGIN';
+    loginType: 'PHONE';
+    countryCode: string;
+    maskedPhoneNumber: string;
+}
+export interface AuthSwitchSubjectRequest {
+    subjectType: 'USER' | 'TENANT';
+    subjectId: string;
+}
+export interface WebLoginTicketCreateRequest {
+    sourceClientType: 'DESKTOP' | 'IOS' | 'ANDROID';
+    targetPath: string;
+}
+export interface WebLoginTicketCreateResponse {
+    ticket: string;
+    targetPath: string;
+    expiresIn: number;
+}
+export interface DesktopDeviceState {
+    id: string;
+    name: string;
+    hostname: string;
+    platform: string;
+    arch: string;
+    identityVersion?: number;
+    identitySource?: 'platform-uuid' | 'machine-guid' | 'machine-id' | 'device-fingerprint';
+    status: 'online' | 'offline' | 'revoked';
+    createdAt: string;
+    lastHeartbeatAt?: string;
+    revokedAt?: string;
+}
+export type AuditCategory = 'auth' | 'device' | 'filesystem' | 'runtime' | 'security' | 'settings' | 'task';
+export type AuditResult = 'SUCCESS' | 'FAILED' | 'PENDING' | 'INFO';
+export type AuditRecordType = 'denial' | 'command' | 'configuration' | 'network' | 'file' | 'other';
+export type AuditOutcome = 'allowed' | 'approved' | 'rejected' | 'blocked' | 'failed' | 'info' | 'pending';
+export interface AuditRecord {
+    id: string;
+    timestamp: string;
+    category: AuditCategory;
+    action: string;
+    result: AuditResult;
+    resource?: string;
+    detail?: string;
+}
+export interface AuditQuery {
+    category?: AuditCategory;
+    recordType?: AuditRecordType;
+    outcome?: AuditOutcome;
+    keyword?: string;
+    from?: string;
+    to?: string;
+    limit?: number;
+    offset?: number;
+}
+export interface AuditSearchResult {
+    records: AuditRecord[];
+    total: number;
+}
+export interface ExportAuditResult {
+    canceled: boolean;
+    path?: string;
+}
+export interface SelectDirectoryResult {
+    canceled: boolean;
+    path?: string;
+    name?: string;
+}
+export type DesktopTitleBarAppearance = 'light' | 'dark';
+export type DesktopWindowAction = 'undo' | 'redo' | 'cut' | 'copy' | 'paste' | 'select-all' | 'minimize' | 'toggle-maximize' | 'toggle-full-screen' | 'close' | 'quit';
+export interface DesktopAboutInfo {
+    version: string;
+    buildNumber: number;
+    electronVersion: string;
+    chromeVersion: string;
+    nodeVersion: string;
+}
+export interface DesktopQuitConfirmation {
+    id: string;
+    kind: 'running-task';
+    title: string;
+    message: string;
+    detail: string;
+    cancelLabel: string;
+    confirmLabel: string;
+}
+export interface DesktopQuitConfirmationResolution {
+    id: string;
+    confirmed: boolean;
+}
+export interface DesktopApi {
+    office: import('./office-window-api.js').OfficeWindowApi;
+    diagnostics: import('./desktop-diagnostics-api.js').DesktopDiagnosticsApi;
+    remoteConnections: import('./remote-connection-api.js').RemoteConnectionsApi;
+    remoteInstallation: import('./remote-installation-api.js').RemoteInstallationApi;
+    remoteTasks: import('./remote-tasks-api.js').RemoteTasksApi;
+    taskTerminals: import('./task-terminal-api.js').TaskTerminalApi;
+    git: import('./git-api.js').GitApi;
+    worktrees: import('./worktree-api.js').WorktreeApi;
+    localEnvironments: import('./local-environment-api.js').LocalEnvironmentApi;
+    hostedGit: import('./hosted-git-api.js').HostedGitApi;
+    localMemory: import('./local-memory.js').LocalMemoryApi;
+    accountContext: AccountContextApi;
+    usageStatistics: UsageStatisticsApi;
+    actionCenter: ActionCenterApi;
+    branding: PlatformBrandingApi;
+    clientDownloads: ClientDownloadsApi;
+    navigation: NavigationApi;
+    taskMenu: TaskMenuApi;
+    app: {
+        getConfig: () => Promise<DesktopRuntimeConfig>;
+        getVersion: () => Promise<string>;
+        getAboutInfo: () => Promise<DesktopAboutInfo>;
+        getPaths: () => Promise<DesktopPaths>;
+        getStorageInfo: () => Promise<DesktopStorageInfo>;
+        openDataDirectory: () => Promise<void>;
+        openExternal: (url: string) => Promise<void>;
+        writeClipboardText: (text: string) => Promise<void>;
+        executeWindowAction: (action: DesktopWindowAction) => Promise<void>;
+        setTitleBarAppearance: (appearance: DesktopTitleBarAppearance) => Promise<void>;
+        getQuitConfirmation: () => Promise<DesktopQuitConfirmation | null>;
+        resolveQuitConfirmation: (resolution: DesktopQuitConfirmationResolution) => Promise<void>;
+        onQuitConfirmation: (listener: (confirmation: DesktopQuitConfirmation) => void) => () => void;
+    };
+    auth: {
+        getSession: () => Promise<AuthSession | null>;
+        login: (request: AuthLoginRequest) => Promise<AuthLoginResult>;
+        startBrowserLogin: () => Promise<AuthSession | null>;
+        cancelBrowserLogin: () => Promise<void>;
+        completeRequiredPasswordChange: (request: AuthRequiredPasswordChangeRequest) => Promise<AuthSession>;
+        cancelRequiredPasswordChange: (challengeId: string) => Promise<void>;
+        register: (request: AuthRegisterRequest) => Promise<PlatformUser>;
+        getRegistrationCaptcha: () => Promise<AuthCaptchaResponse>;
+        sendRegistrationSms: (request: AuthSmsCodeRequest) => Promise<AuthSmsCodeResponse>;
+        verifySmsRegistration: (request: AuthSmsRegistrationVerifyRequest) => Promise<AuthRegistrationTicketResponse>;
+        completeSmsRegistration: (request: AuthSmsRegistrationCompleteRequest) => Promise<AuthSmsRegistrationCompleteResponse>;
+        refresh: () => Promise<AuthSession>;
+        switchSubject: (request: AuthSwitchSubjectRequest) => Promise<AuthSession>;
+        openWeb: (targetPath: string) => Promise<void>;
+        logout: () => Promise<void>;
+        onSessionExpired: (listener: (reason: string) => void) => () => void;
+        onSessionChanged: (listener: () => void) => () => void;
+    };
+    cloudAssistant: CloudAssistantApi;
+    collaboration: CollaborationDesktopApi;
+    collaborationDeepLinks: {
+        consumePending: () => Promise<CollaborationDeepLink[]>;
+        onOpen: (listener: (deepLink: CollaborationDeepLink) => void) => () => void;
+    };
+    enterpriseKnowledge: EnterpriseKnowledgeApi & {
+        openManagement: () => Promise<void>;
+    };
+    professionMarket: ProfessionMarketApi;
+    myExperts: MyExpertApi;
+    skillMarket: SkillMarketApi;
+    sceneCases: SceneCaseApi;
+    localSkills: LocalSkillApi;
+    projectLocalSkills: ProjectLocalSkillApi;
+    skillActivation: SkillActivationApi;
+    skillAssets: SkillAssetApi;
+    pluginMarket: PluginMarketApi;
+    localPlugins: LocalPluginApi;
+    localMcpServers: LocalMcpServerApi;
+    desktopMcpServices: DesktopMcpServiceApi;
+    localCustomModels: LocalCustomModelApi;
+    computerUse: ComputerUseApi;
+    localRuntime: LocalRuntimeApi;
+    localTaskExecution: LocalTaskExecutionApi;
+    localTasks: LocalTaskApi;
+    taskStorageRecovery: import('./task-storage-recovery.js').TaskStorageRecoveryApi;
+    storageIntegrity: import('./storage-integrity.js').StorageIntegrityApi;
+    automation: AutomationApi;
+    speechRecognition: SpeechRecognitionApi;
+    taskInitialization: TaskInitializationApi;
+    feedback: DesktopFeedbackApi;
+    securityCenter: SecurityCenterApi;
+    sensitiveProtection: import('./sensitive-protection-api.js').SensitiveProtectionApi;
+    device: {
+        getState: () => Promise<DesktopDeviceState>;
+        heartbeat: () => Promise<DesktopDeviceState>;
+        revokeLocal: () => Promise<DesktopDeviceState>;
+    };
+    settings: {
+        get: () => Promise<DesktopSettings>;
+        update: (settings: Partial<DesktopSettings>) => Promise<DesktopSettings>;
+        onChanged: (listener: (settings: DesktopSettings) => void) => () => void;
+    };
+    updates: DesktopUpdatesApi;
+    fileDialog: {
+        selectDirectory: () => Promise<SelectDirectoryResult>;
+        selectFiles: () => Promise<SelectFilesResult>;
+        getPathForFile: (file: File) => string;
+    };
+    audit: {
+        list: (query?: AuditQuery) => Promise<AuditRecord[]>;
+        search: (query?: AuditQuery) => Promise<AuditSearchResult>;
+        clear: () => Promise<void>;
+        openLogsDir: () => Promise<void>;
+        export: () => Promise<ExportAuditResult>;
+    };
+}
+declare global {
+    interface Window {
+        aiosDesktop: DesktopApi;
+    }
+}

package/dist/shared/desktop-diagnostics-api.d.ts

@@ -0,0 +1,56 @@
+export type DesktopHelpPanel = 'resources' | 'diagnostics';
+export type ResourceModule = 'interface' | 'background' | 'main' | 'graphics' | 'extensions' | 'tasks' | 'helper' | 'sandbox';
+export interface ResourceRow {
+    module: ResourceModule;
+    processes: number;
+    memoryBytes: number;
+    cpuPercent: number | null;
+}
+export interface DesktopResourceSnapshot {
+    sampledAt: string;
+    memory: {
+        totalBytes: number;
+        appBytes: number;
+        otherBytes: number;
+        availableBytes: number;
+    };
+    cpuPercent: number | null;
+    rows: ResourceRow[];
+}
+export type DiagnosticStatus = 'waiting' | 'running' | 'passed' | 'warning' | 'failed' | 'skipped';
+export declare const networkDiagnosticCheckIds: readonly ["proxy", "hosts", "service", "tcp", "loss"];
+export declare const localDiagnosticCheckIds: readonly ["system", "storage", "node", "runtime", "dependencies"];
+export type DiagnosticCheckId = typeof networkDiagnosticCheckIds[number] | typeof localDiagnosticCheckIds[number];
+export declare function diagnosticOverall(statuses: DiagnosticStatus[]): DiagnosticStatus;
+export interface DiagnosticCheck {
+    id: DiagnosticCheckId;
+    status: DiagnosticStatus;
+    detail: string;
+    value: string;
+    durationMs?: number;
+}
+export interface DesktopDiagnosticSnapshot {
+    status: DiagnosticStatus;
+    startedAt: string | null;
+    durationMs: number | null;
+    endpoint: string;
+    host: string;
+    proxy: string;
+    checks: DiagnosticCheck[];
+    reportDirectory: string;
+    reportName: string | null;
+    reportError: string | null;
+}
+export interface DesktopDiagnosticsApi {
+    openResources(): Promise<void>;
+    sampleResources(): Promise<DesktopResourceSnapshot>;
+    closeResources(): Promise<void>;
+    copyResources(): Promise<void>;
+    getDiagnostics(): Promise<DesktopDiagnosticSnapshot>;
+    startDiagnostics(): Promise<DesktopDiagnosticSnapshot>;
+    onDiagnostics(listener: (snapshot: DesktopDiagnosticSnapshot) => void): () => void;
+    openReportDirectory(): Promise<void>;
+    exportReport(): Promise<void>;
+    revealReport(): Promise<void>;
+    onOpen(listener: (panel: DesktopHelpPanel) => void): () => void;
+}

package/dist/shared/desktop-language.d.ts

@@ -0,0 +1,3 @@
+export declare const DESKTOP_LANGUAGES: readonly ["zh-CN", "en-US"];
+export type DesktopLanguage = (typeof DESKTOP_LANGUAGES)[number];
+export declare function isDesktopLanguage(value: unknown): value is DesktopLanguage;

package/dist/shared/desktop-mcp-service-api.d.ts

@@ -0,0 +1,157 @@
+import type { LocalMcpServer } from './local-mcp-server-api.js';
+export type DesktopMcpServiceCategory = 'INDUSTRIAL_AUTOMATION' | 'ELECTRICAL_ELECTRONICS' | 'CAD_3D' | 'BIM_ARCHITECTURE' | 'CAE_ROBOTICS';
+export type DesktopMcpRiskLevel = 'LOW' | 'MEDIUM' | 'HIGH' | 'CRITICAL';
+export type DesktopMcpTargetOs = 'WINDOWS' | 'MACOS' | 'LINUX' | 'UNIVERSAL';
+export type DesktopMcpTargetArch = 'X64' | 'ARM64' | 'UNIVERSAL';
+export type DesktopMcpRuntimeType = 'PYTHON' | 'NODE' | 'NATIVE';
+export type DesktopMcpInstallStatus = 'INSTALLED' | 'ENABLED' | 'DISABLED';
+export type DesktopMcpInstallPhase = 'PREPARING' | 'DOWNLOADING' | 'VERIFYING' | 'INSTALLING' | 'CHECKING' | 'COMPLETED';
+export interface DesktopMcpInstallProgress {
+    serviceId: string;
+    phase: DesktopMcpInstallPhase;
+    receivedBytes: number;
+    totalBytes: number;
+    percent: number;
+}
+export interface DesktopMcpServiceIcon {
+    url: string;
+    fileName: string;
+    contentType: string;
+    fileSize: number;
+    sha256: string;
+}
+export interface DesktopMcpWindowsUninstallDetectionRule {
+    type: 'windows-uninstall';
+    displayName: string;
+    match: 'exact' | 'prefix' | 'contains';
+    relativePaths: string[];
+}
+export type DesktopMcpRuntimeDetectionRule = string | DesktopMcpWindowsUninstallDetectionRule;
+export interface DesktopMcpRuntimeManifest {
+    schemaVersion: 1;
+    id: string;
+    name: string;
+    version: string;
+    runtime: {
+        type: 'python' | 'node' | 'native';
+        source?: 'package' | 'software';
+        version?: string;
+        entry: string;
+        args?: string[];
+        env?: Record<string, string>;
+        detection?: {
+            windows?: DesktopMcpRuntimeDetectionRule[];
+            macos?: DesktopMcpRuntimeDetectionRule[];
+            linux?: DesktopMcpRuntimeDetectionRule[];
+        };
+    };
+    targets: string[];
+    software: {
+        name: string;
+        versions: string[];
+        detection?: {
+            windows?: string[];
+            macos?: string[];
+            linux?: string[];
+        };
+    };
+    transport: 'stdio';
+    permissions: {
+        filesystem: string[];
+        network: string[];
+        processes: string[];
+    };
+    toolGroups: string[];
+    healthCheck: {
+        method: 'mcp-tools-list';
+        timeoutSeconds: number;
+    };
+}
+export interface DesktopMcpExecutionPackage {
+    id: string;
+    versionId: string;
+    targetOs: DesktopMcpTargetOs;
+    targetArch: DesktopMcpTargetArch;
+    runtimeType: DesktopMcpRuntimeType;
+    fileName: string;
+    contentType: string;
+    fileSize: number;
+    sha256: string;
+    signature: string;
+    signingKeyId: string;
+    createdAt: string;
+    downloadUrl?: string;
+}
+export interface DesktopMcpServiceVersion {
+    id: string;
+    serviceId: string;
+    versionNo: string;
+    sourceCommit: string;
+    releaseNotes?: string;
+    manifest: DesktopMcpRuntimeManifest;
+    minimumDesktopVersion?: string;
+    publishedAt?: string;
+    packages: DesktopMcpExecutionPackage[];
+}
+export interface DesktopMcpCatalogService {
+    id: string;
+    code: string;
+    name: string;
+    summary?: string;
+    icon?: DesktopMcpServiceIcon;
+    category: DesktopMcpServiceCategory;
+    softwareName: string;
+    softwareVersions: string[];
+    upstreamRepository: string;
+    licenseSpdx: string;
+    riskLevel: DesktopMcpRiskLevel;
+    currentVersion: DesktopMcpServiceVersion;
+    localSoftware?: {
+        status: 'NOT_CONFIGURED' | 'DETECTED' | 'NOT_FOUND';
+        matchedPath?: string;
+    };
+}
+export interface DesktopMcpCatalogQuery {
+    keyword?: string;
+    category?: DesktopMcpServiceCategory;
+}
+export interface DesktopMcpDownloadTicket {
+    serviceId: string;
+    serviceCode: string;
+    serviceName: string;
+    versionId: string;
+    versionNo: string;
+    manifest: DesktopMcpRuntimeManifest;
+    executionPackage: DesktopMcpExecutionPackage & {
+        downloadUrl: string;
+    };
+    expiresInSeconds: number;
+}
+export interface DesktopMcpInstalledService {
+    serviceId: string;
+    serviceCode: string;
+    serviceName: string;
+    versionId: string;
+    versionNo: string;
+    packageId: string;
+    packageSha256: string;
+    installPath: string;
+    installedAt: string;
+    status: DesktopMcpInstallStatus;
+    server: LocalMcpServer;
+}
+export interface InstallDesktopMcpServiceRequest {
+    serviceId: string;
+}
+export interface SetDesktopMcpServiceEnabledRequest {
+    serviceId: string;
+    enabled: boolean;
+}
+export interface DesktopMcpServiceApi {
+    listCatalog: (query?: DesktopMcpCatalogQuery) => Promise<DesktopMcpCatalogService[]>;
+    listInstalled: () => Promise<DesktopMcpInstalledService[]>;
+    install: (request: InstallDesktopMcpServiceRequest) => Promise<DesktopMcpInstalledService>;
+    onInstallProgress: (listener: (progress: DesktopMcpInstallProgress) => void) => () => void;
+    setEnabled: (request: SetDesktopMcpServiceEnabledRequest) => Promise<DesktopMcpInstalledService>;
+    remove: (serviceId: string) => Promise<void>;
+}