@tutti-os/workspace-app-center 0.0.9 → 0.0.11

package/dist/contracts/index.d.ts

@@ -1,158 +1,157 @@
-declare const workspaceAppManifestSchemaVersion = "tutti.app.manifest.v1";
-type WorkspaceAppManifestSchemaVersion = typeof workspaceAppManifestSchemaVersion;
-interface WorkspaceAppManifestIcon {
-    readonly type: "asset";
-    readonly src: string;
-}
-interface WorkspaceAppManifestRuntime {
-    readonly bootstrap: string;
-    readonly healthcheckPath: string;
-}
-type WorkspaceAppManifestWindowMinimizeBehavior = "hibernate" | "keep-mounted";
-interface WorkspaceAppManifestWindow {
-    readonly minimizeBehavior?: WorkspaceAppManifestWindowMinimizeBehavior;
-    readonly minHeight?: number;
-    readonly minWidth?: number;
-}
-interface WorkspaceAppManifestAuthor {
-    readonly name: string;
-    readonly url?: string;
-}
-interface WorkspaceAppManifestLocalizationInfo {
-    readonly defaultLocale: string;
-    readonly additionalLocales?: readonly WorkspaceAppManifestLocalizationFile[];
-}
-interface WorkspaceAppManifestLocalizationFile {
-    readonly locale: string;
-    readonly file: string;
-}
-interface WorkspaceAppManifest {
-    readonly schemaVersion: WorkspaceAppManifestSchemaVersion;
-    readonly appId: string;
-    readonly name: string;
-    readonly version: string;
-    readonly description: string;
-    readonly icon?: WorkspaceAppManifestIcon;
-    readonly runtime: WorkspaceAppManifestRuntime;
-    readonly window?: WorkspaceAppManifestWindow;
-    readonly author?: WorkspaceAppManifestAuthor;
-    readonly tags?: readonly string[];
-    readonly localizationInfo?: WorkspaceAppManifestLocalizationInfo;
-}
-
-type WorkspaceAppCatalogSourceKind = "bundled" | "local" | "remote";
-interface WorkspaceAppCatalogSource {
-    readonly id?: string;
-    readonly kind: WorkspaceAppCatalogSourceKind;
-    readonly label?: string;
-}
-interface WorkspaceAppCatalogLocalization {
-    readonly locale: string;
-    readonly name?: string | null;
-    readonly description?: string | null;
-    readonly tags?: readonly string[];
-}
-interface WorkspaceAppCatalogEntry {
-    readonly localizations?: readonly WorkspaceAppCatalogLocalization[];
-    readonly manifest: WorkspaceAppManifest;
-    readonly source?: WorkspaceAppCatalogSource;
-}
-interface WorkspaceAppInstallRecord {
-    readonly appId: string;
-    readonly installedAt?: string | null;
-    readonly updatedAt?: string | null;
-    readonly catalogSourceId?: string | null;
-}
-interface WorkspaceAppRecord {
-    readonly availableIconUrl?: string | null;
-    readonly availableVersion?: string | null;
-    readonly catalog?: WorkspaceAppCatalogEntry | null;
-    readonly category?: string | null;
-    readonly createdAtUnixMs?: number | null;
-    readonly install?: WorkspaceAppInstallRecord | null;
-    readonly manifest: WorkspaceAppManifest;
-    readonly updateAvailable?: boolean;
-}
+import { w as WorkspaceAppRuntimeStatus, f as WorkspaceAppFactoryJobStatus } from '../viewModel-BEb0vvYM.js';
+export { A as AppCenterViewModel, W as WorkspaceAppActionContext, a as WorkspaceAppCardViewModel, b as WorkspaceAppCatalogEntry, c as WorkspaceAppCatalogLocalization, d as WorkspaceAppCatalogSource, e as WorkspaceAppCatalogSourceKind, g as WorkspaceAppFactoryJobViewModel, h as WorkspaceAppInstallRecord, i as WorkspaceAppManifest, j as WorkspaceAppManifestAuthor, k as WorkspaceAppManifestIcon, l as WorkspaceAppManifestLocalizationFile, m as WorkspaceAppManifestLocalizationInfo, n as WorkspaceAppManifestReferences, o as WorkspaceAppManifestRuntime, p as WorkspaceAppManifestSchemaVersion, q as WorkspaceAppManifestWindow, r as WorkspaceAppManifestWindowMinimizeBehavior, s as WorkspaceAppPrimaryAction, t as WorkspaceAppRecord, u as WorkspaceAppRuntimeError, v as WorkspaceAppRuntimeState, x as WorkspaceAppStatusTone, y as workspaceAppManifestSchemaVersion, z as workspaceAppRuntimeStatuses } from '../viewModel-BEb0vvYM.js';
 
-declare const workspaceAppRuntimeStatuses: readonly ["idle", "installing", "preparing", "starting", "running", "failed", "stopping"];
-type WorkspaceAppRuntimeStatus = (typeof workspaceAppRuntimeStatuses)[number];
-interface WorkspaceAppRuntimeError {
-    readonly code?: string;
-    readonly message: string;
-}
-interface WorkspaceAppRuntimeState {
-    readonly appId: string;
-    readonly status: WorkspaceAppRuntimeStatus;
-    readonly error?: WorkspaceAppRuntimeError | null;
-    readonly startedAt?: string | null;
-    readonly updatedAt?: string | null;
-}
-
-type WorkspaceAppStatusTone = "neutral" | "blue" | "green" | "amber" | "red";
-type WorkspaceAppPrimaryAction = "install" | "open" | "retry" | "update" | "none";
-interface WorkspaceAppCardViewModel {
-    readonly id: string;
-    readonly name: string;
-    readonly createdAtUnixMs: number | null;
-    readonly description?: string;
-    readonly version?: string;
-    readonly availableVersion?: string;
-    readonly category?: string | null;
-    readonly updateAvailable: boolean;
-    readonly icon?: {
-        readonly type: "asset";
-        readonly src: string;
-    };
-    readonly tags: readonly string[];
-    readonly installed: boolean;
-    readonly status: WorkspaceAppRuntimeStatus;
-    readonly statusLabelKey: string;
-    readonly statusTone: WorkspaceAppStatusTone;
-    readonly statusPulse: boolean;
-    readonly primaryAction: WorkspaceAppPrimaryAction;
-    readonly sourceKind: WorkspaceAppCatalogSourceKind;
-    readonly canOpen: boolean;
-    readonly canOpenFolder: boolean;
-    readonly canOpenPackageFolder: boolean;
-    readonly canExport: boolean;
-    readonly canDelete: boolean;
-    readonly canReplaceIcon: boolean;
-    readonly canOpenFactorySession: boolean;
-    readonly canPublishFactoryUpdate: boolean;
-    readonly canUninstall: boolean;
-    readonly canRetry: boolean;
-    readonly canUpdate: boolean;
-    readonly errorMessage?: string;
-    readonly factoryAgentSessionId?: string | null;
-    readonly factoryJobId?: string | null;
-    readonly factoryProvider?: string | null;
-}
-interface AppCenterViewModel {
-    readonly apps: readonly WorkspaceAppCardViewModel[];
-    readonly factoryJobs?: readonly WorkspaceAppFactoryJobViewModel[];
-    readonly installedCount: number;
-    readonly runningCount: number;
-    readonly failedCount: number;
-    readonly empty: boolean;
-}
-type WorkspaceAppFactoryJobStatus = "canceled" | "failed" | "generating" | "preparing" | "published" | "queued" | "ready" | "validating";
-interface WorkspaceAppFactoryJobViewModel {
-    readonly id: string;
-    readonly agentSessionId?: string | null;
-    readonly appId?: string | null;
-    readonly title: string;
-    readonly prompt: string;
-    readonly provider?: string | null;
-    readonly status: WorkspaceAppFactoryJobStatus;
-    readonly statusLabelKey: string;
-    readonly canCancel: boolean;
-    readonly canDelete: boolean;
-    readonly canFix: boolean;
-    readonly canOpenAgentSession: boolean;
-    readonly canPublish: boolean;
-    readonly canRetryValidation: boolean;
-    readonly failureReason?: string | null;
-    readonly updatedAtUnixMs: number;
+type WorkspaceAppCenterRuntimeStatus = WorkspaceAppRuntimeStatus;
+type WorkspaceAppCenterSource = "builtin" | "generated" | "imported";
+interface WorkspaceAppCenterLocalization {
+    locale: string;
+    name?: string | null;
+    description?: string | null;
+    tags: readonly string[];
+}
+type WorkspaceAppCenterCliStatus = "none" | "pending" | "active" | "warning" | "error";
+interface WorkspaceAppCenterCliIssue {
+    code: string;
+    message: string;
+    path?: string | null;
+}
+interface WorkspaceAppCenterCliState {
+    active: boolean;
+    issues: readonly WorkspaceAppCenterCliIssue[];
+    scope?: string | null;
+    status: WorkspaceAppCenterCliStatus;
+}
+interface WorkspaceAppCenterReferencesState {
+    searchSupported: boolean;
+}
+interface WorkspaceAppCenterApp {
+    availableIconUrl?: string | null;
+    availableVersion?: string | null;
+    description?: string | null;
+    installationId?: string | null;
+    runtimeId?: string | null;
+    appId: string;
+    createdAtUnixMs: number;
+    enabled: boolean;
+    exportable: boolean;
+    failureReason?: string | null;
+    iconUrl?: string | null;
+    installed: boolean;
+    lastError?: string | null;
+    cli?: WorkspaceAppCenterCliState;
+    localizations?: readonly WorkspaceAppCenterLocalization[];
+    minimizeBehavior: WorkspaceAppMinimizeBehavior;
+    name: string;
+    references: WorkspaceAppCenterReferencesState;
+    runtimeStatus: WorkspaceAppCenterRuntimeStatus;
+    source: WorkspaceAppCenterSource;
+    stateRevision: number;
+    tags?: readonly string[];
+    updateAvailable?: boolean;
+    launchUrl?: string | null;
+    version?: string | null;
+    windowMinHeight?: number | null;
+    windowMinWidth?: number | null;
+}
+type WorkspaceAppMinimizeBehavior = "hibernate" | "keep-mounted";
+type WorkspaceAppCenterCatalogStatus = "disabled" | "failed" | "loading" | "ready";
+interface WorkspaceAppCenterSnapshot {
+    apps: readonly WorkspaceAppCenterApp[];
+    catalogLastError?: string | null;
+    catalogStatus: WorkspaceAppCenterCatalogStatus;
+    catalogUpdatedAtUnixMs?: number | null;
+}
+interface WorkspaceAppFactoryJob {
+    agentSessionId?: string | null;
+    appId?: string | null;
+    createdAtUnixMs: number;
+    description?: string | null;
+    displayName: string;
+    failureReason?: string | null;
+    jobId: string;
+    model?: string | null;
+    prompt: string;
+    provider?: string | null;
+    reasoningEffort?: string | null;
+    publishedVersion?: string | null;
+    status: WorkspaceAppFactoryJobStatus;
+    updatedAtUnixMs: number;
+    validationResult?: Record<string, unknown> | null;
+    workspaceId: string;
+}
+interface WorkspaceAppFactorySnapshot {
+    jobs: readonly WorkspaceAppFactoryJob[];
+}
+interface WorkspaceAppFactoryModelOption {
+    label: string;
+    value: string;
+}
+interface WorkspaceAppFactoryReasoningOption {
+    label: string;
+    value: string;
+}
+interface WorkspaceAppFactoryPermissionOption {
+    label: string;
+    semantic?: string | null;
+    value: string;
+}
+interface WorkspaceAppFactoryProviderConfiguration {
+    defaultModel?: string | null;
+    defaultPermissionModeId?: string | null;
+    defaultReasoningEffort?: string | null;
+    modelOptions: readonly WorkspaceAppFactoryModelOption[];
+    permissionModeOptions: readonly WorkspaceAppFactoryPermissionOption[];
+    reasoningEffortOptions: readonly WorkspaceAppFactoryReasoningOption[];
+}
+type WorkspaceAppCenterLoadStatus = "idle" | "loading" | "ready" | "unavailable";
+interface WorkspaceAppCenterStoreState {
+    apps: WorkspaceAppCenterApp[];
+    catalogLastError: string | null;
+    catalogStatus: WorkspaceAppCenterCatalogStatus;
+    catalogUpdatedAtUnixMs: number | null;
+    error: string | null;
+    factoryJobs: WorkspaceAppFactoryJob[];
+    loadStatus: WorkspaceAppCenterLoadStatus;
+    openingFolderAppId: string | null;
+    revision: number;
+    viewStateByWorkspaceId: Record<string, WorkspaceAppCenterViewState | undefined>;
+    workspaceId: string | null;
+}
+type WorkspaceAppCenterAppTab = "my" | "recommended";
+interface WorkspaceAppCenterViewState {
+    activeAppTab: WorkspaceAppCenterAppTab;
+}
+type WorkspaceAppCenterReadableStoreState = Readonly<WorkspaceAppCenterStoreState>;
+interface WorkspaceAppCenterGateway {
+    installWorkspaceApp(workspaceId: string, appId: string): Promise<WorkspaceAppCenterSnapshot>;
+    launchWorkspaceApp(workspaceId: string, appId: string): Promise<WorkspaceAppCenterSnapshot>;
+    deleteWorkspaceApp(workspaceId: string, appId: string): Promise<WorkspaceAppCenterSnapshot>;
+    listWorkspaceApps(workspaceId: string): Promise<WorkspaceAppCenterSnapshot>;
+    refreshWorkspaceAppCatalog(workspaceId: string): Promise<WorkspaceAppCenterSnapshot>;
+    uninstallWorkspaceApp(workspaceId: string, appId: string): Promise<WorkspaceAppCenterSnapshot>;
+    retryWorkspaceApp(workspaceId: string, appId: string): Promise<WorkspaceAppCenterSnapshot>;
+    rollbackWorkspaceApp(workspaceId: string, appId: string, version: string): Promise<WorkspaceAppCenterSnapshot>;
+    listWorkspaceAppFactoryJobs(workspaceId: string): Promise<WorkspaceAppFactorySnapshot>;
+    createWorkspaceAppFactoryJob(workspaceId: string, input: {
+        displayName: string;
+        model?: string;
+        permissionModeId?: string;
+        prompt: string;
+        provider?: string;
+        reasoningEffort?: string;
+    }): Promise<WorkspaceAppFactorySnapshot>;
+    cancelWorkspaceAppFactoryJob(workspaceId: string, jobId: string): Promise<WorkspaceAppFactorySnapshot>;
+    deleteWorkspaceAppFactoryJob(workspaceId: string, jobId: string): Promise<WorkspaceAppFactorySnapshot>;
+    retryWorkspaceAppFactoryJobValidation(workspaceId: string, jobId: string): Promise<WorkspaceAppFactorySnapshot>;
+    fixWorkspaceAppFactoryJob(workspaceId: string, jobId: string, input: {
+        prompt: string;
+    }): Promise<WorkspaceAppFactorySnapshot>;
+    prepareWorkspaceAppFactoryJobModification(workspaceId: string, jobId: string): Promise<WorkspaceAppFactorySnapshot>;
+    publishWorkspaceAppFactoryJob(workspaceId: string, jobId: string): Promise<{
+        appSnapshot: WorkspaceAppCenterSnapshot;
+        factorySnapshot: WorkspaceAppFactorySnapshot;
+    }>;
+    startEnabledWorkspaceApps(workspaceId: string): Promise<WorkspaceAppCenterSnapshot>;
 }
 
-export { type AppCenterViewModel, type WorkspaceAppCardViewModel, type WorkspaceAppCatalogEntry, type WorkspaceAppCatalogLocalization, type WorkspaceAppCatalogSource, type WorkspaceAppCatalogSourceKind, type WorkspaceAppFactoryJobStatus, type WorkspaceAppFactoryJobViewModel, type WorkspaceAppInstallRecord, type WorkspaceAppManifest, type WorkspaceAppManifestAuthor, type WorkspaceAppManifestIcon, type WorkspaceAppManifestLocalizationFile, type WorkspaceAppManifestLocalizationInfo, type WorkspaceAppManifestRuntime, type WorkspaceAppManifestSchemaVersion, type WorkspaceAppManifestWindow, type WorkspaceAppManifestWindowMinimizeBehavior, type WorkspaceAppPrimaryAction, type WorkspaceAppRecord, type WorkspaceAppRuntimeError, type WorkspaceAppRuntimeState, type WorkspaceAppRuntimeStatus, type WorkspaceAppStatusTone, workspaceAppManifestSchemaVersion, workspaceAppRuntimeStatuses };
+export { type WorkspaceAppCenterApp, type WorkspaceAppCenterAppTab, type WorkspaceAppCenterCatalogStatus, type WorkspaceAppCenterCliIssue, type WorkspaceAppCenterCliState, type WorkspaceAppCenterCliStatus, type WorkspaceAppCenterGateway, type WorkspaceAppCenterLoadStatus, type WorkspaceAppCenterLocalization, type WorkspaceAppCenterReadableStoreState, type WorkspaceAppCenterReferencesState, type WorkspaceAppCenterRuntimeStatus, type WorkspaceAppCenterSnapshot, type WorkspaceAppCenterSource, type WorkspaceAppCenterStoreState, type WorkspaceAppCenterViewState, type WorkspaceAppFactoryJob, WorkspaceAppFactoryJobStatus, type WorkspaceAppFactoryModelOption, type WorkspaceAppFactoryPermissionOption, type WorkspaceAppFactoryProviderConfiguration, type WorkspaceAppFactoryReasoningOption, type WorkspaceAppFactorySnapshot, type WorkspaceAppMinimizeBehavior, WorkspaceAppRuntimeStatus };

package/dist/contracts/index.js

@@ -1,9 +1,9 @@
 import {
   workspaceAppRuntimeStatuses
-} from "../chunk-VLUZD2IT.js";
+} from "../chunk-PD2WLRHE.js";
 import {
   workspaceAppManifestSchemaVersion
-} from "../chunk-QSAEUGFC.js";
+} from "../chunk-UBERYRMA.js";
 export {
   workspaceAppManifestSchemaVersion,
   workspaceAppRuntimeStatuses

package/dist/core/index.d.ts

@@ -1,5 +1,218 @@
-export { C as CreateAppCenterViewModelInput, W as WorkspaceAppFactoryJobInput, a as WorkspaceAppManifestValidationIssue, b as WorkspaceAppManifestValidationIssueCode, c as WorkspaceAppManifestValidationResult, d as WorkspaceAppStatusPresentation, e as createAppCenterViewModel, f as createWorkspaceAppIdentity, g as createWorkspaceAppRecord, i as isWorkspaceAppId, m as mapWorkspaceAppRuntimeStatus, n as normalizeWorkspaceAppId, h as normalizeWorkspaceAppRuntimeState, r as resolveWorkspaceAppCatalogMetadata, j as resolveWorkspaceAppStatusPresentation, v as validateWorkspaceAppManifest, w as workspaceAppIdPattern } from '../index-Bert0Egy.js';
-import { AppCenterViewModel } from '../contracts/index.js';
+import { WorkspaceAppCenterGateway, WorkspaceAppCenterApp, WorkspaceAppFactoryJob, WorkspaceAppCenterStoreState, WorkspaceAppCenterReadableStoreState, WorkspaceAppCenterViewState, WorkspaceAppCenterSnapshot, WorkspaceAppFactorySnapshot } from '../contracts/index.js';
+export { C as CreateAppCenterViewModelInput, W as WorkspaceAppFactoryJobInput, a as WorkspaceAppManifestValidationIssue, b as WorkspaceAppManifestValidationIssueCode, c as WorkspaceAppManifestValidationResult, d as WorkspaceAppStatusPresentation, e as createAppCenterViewModel, f as createWorkspaceAppIdentity, g as createWorkspaceAppRecord, i as isWorkspaceAppId, m as mapWorkspaceAppRuntimeStatus, n as normalizeWorkspaceAppId, h as normalizeWorkspaceAppRuntimeState, r as resolveWorkspaceAppCatalogMetadata, j as resolveWorkspaceAppStatusPresentation, v as validateWorkspaceAppManifest, w as workspaceAppIdPattern } from '../index-B1t4jDvQ.js';
+import { A as AppCenterViewModel } from '../viewModel-BEb0vvYM.js';
+
+type WorkspaceAppCenterOperation = "app_center.refresh" | "app_center.refresh_catalog" | "app_center.start_workspace_updates" | "app_factory.prepare_modification" | "app_factory.publish" | "workspace_app.delete" | "workspace_app.export" | "workspace_app.import" | "workspace_app.install" | "workspace_app.prepare_launch" | "workspace_app.refresh_install_state" | "workspace_app.refresh_launch_wait_state" | "workspace_app.replace_icon" | "workspace_app.retry" | "workspace_app.start_enabled" | "workspace_app.update";
+type WorkspaceAppCenterUiAction = "delete_app" | "export_app" | "import_app" | "install_app" | "open_app" | "prepare_factory_job_modification" | "publish_factory_job" | "refresh_install_state" | "refresh_launch_wait_state" | "replace_app_icon" | "retry_app" | "update_app";
+interface WorkspaceAppCenterOperationDetails {
+    appId?: string;
+    jobId?: string;
+    operation: WorkspaceAppCenterOperation;
+    uiAction?: WorkspaceAppCenterUiAction;
+    workspaceId: string;
+}
+interface WorkspaceAppCenterRefreshDiscard {
+    currentSequence: number;
+    itemCount?: number;
+    operation: "app_center.refresh" | "app_center.refresh_catalog";
+    sequence: number;
+    snapshotKind: "apps" | "catalog_apps" | "factory_jobs";
+    workspaceId: string;
+}
+interface WorkspaceAppCenterControllerHooks {
+    onAppDeleted?: (app: WorkspaceAppCenterApp | null) => void;
+    onAppInstallFailed?: (input: {
+        app: WorkspaceAppCenterApp | null;
+        appId: string;
+        failureReason: string | null;
+    }) => void;
+    onAppInstalled?: (app: WorkspaceAppCenterApp) => void;
+    onAppRuntimeFailed?: (input: {
+        app: WorkspaceAppCenterApp;
+        failureReason: string | null;
+    }) => void;
+    onAppStopped?: (input: {
+        app: WorkspaceAppCenterApp;
+        runDurationMs: number | null;
+    }) => void;
+    onAppUninstalled?: (app: WorkspaceAppCenterApp | null) => void;
+    onAppUpdated?: (input: {
+        app: WorkspaceAppCenterApp | undefined;
+        trigger: "badge_button" | "primary_action";
+    }) => void;
+    onCatalogRefreshed?: (input: {
+        appCount: number | null;
+        errorReason: string | null;
+        success: boolean;
+    }) => void;
+    onCloseWorkspaceAppViews?: (input: {
+        appIds: readonly string[];
+        workspaceId: string;
+    }) => void;
+    onFactoryJobCreated?: (job: WorkspaceAppFactoryJob | null) => void;
+    onFactorySnapshotApplied?: (input: {
+        nextJobs: readonly WorkspaceAppFactoryJob[];
+        previousJobs: readonly WorkspaceAppFactoryJob[];
+        workspaceId: string;
+    }) => void;
+    onOperationFailure?: (input: {
+        details: WorkspaceAppCenterOperationDetails;
+        error: unknown;
+        toastMessage: string;
+    }) => void;
+    onRefreshDiscard?: (input: WorkspaceAppCenterRefreshDiscard) => void;
+}
+interface WorkspaceAppCenterControllerDependencies {
+    appOpenLaunchWaitTimeoutMs?: number;
+    catalogLoadingRefreshDelayMs?: number;
+    formatError: (error: unknown, details?: WorkspaceAppCenterOperationDetails) => string;
+    gateway: WorkspaceAppCenterGateway;
+    getErrorReason?: (error: unknown) => string | null;
+    hooks?: WorkspaceAppCenterControllerHooks;
+    installRefreshDelayMs?: number;
+    now?: () => number;
+    store?: WorkspaceAppCenterStoreState;
+}
+declare function createWorkspaceAppCenterStoreState(): WorkspaceAppCenterStoreState;
+
+declare abstract class WorkspaceAppCenterControllerBase {
+    readonly store: WorkspaceAppCenterStoreState;
+    protected readonly dependencies: WorkspaceAppCenterControllerDependencies;
+    protected readonly listeners: Set<() => void>;
+    protected catalogRefreshTimer: ReturnType<typeof setTimeout> | null;
+    protected installRefreshTimers: Map<string, NodeJS.Timeout>;
+    protected pendingFactoryPublishKeys: Set<string>;
+    protected pendingInstallKeys: Set<string>;
+    protected pendingInstallReportKeys: Set<string>;
+    protected appLoadSequence: number;
+    protected factoryLoadSequence: number;
+    protected pollingWorkspaceId: string | null;
+    constructor(dependencies: WorkspaceAppCenterControllerDependencies);
+    get readableStore(): WorkspaceAppCenterReadableStoreState;
+    consumeError(): string | null;
+    subscribe(listener: () => void): () => void;
+    beginWorkspacePolling(workspaceId: string): void;
+    endWorkspacePolling(workspaceId: string): void;
+    getViewState(workspaceId: string, restoredState?: WorkspaceAppCenterViewState | null): WorkspaceAppCenterViewState;
+    setViewState(input: {
+        state: Partial<WorkspaceAppCenterViewState>;
+        workspaceId: string;
+    }): void;
+    setOperationError(error: unknown, details: WorkspaceAppCenterOperationDetails): void;
+    setUnavailableError(error: unknown, details: WorkspaceAppCenterOperationDetails): void;
+    protected clearCatalogRefreshTimer(): void;
+    protected clearInstallRefreshTimer(workspaceId: string, appId: string): void;
+    protected clearInstallRefreshTimers(): void;
+    protected recordOperationFailure(error: unknown, toastMessage: string, details: WorkspaceAppCenterOperationDetails): void;
+    protected bumpRevision(): void;
+    protected closeWorkspaceAppViews(workspaceId: string, appIds: readonly string[]): void;
+    protected getErrorReason(error: unknown): string | null;
+}
+
+declare abstract class WorkspaceAppCenterControllerState extends WorkspaceAppCenterControllerBase {
+    abstract refresh(workspaceId: string): Promise<void>;
+    applySnapshot(workspaceId: string, snapshot: WorkspaceAppCenterSnapshot): void;
+    applyFactorySnapshot(workspaceId: string, snapshot: WorkspaceAppFactorySnapshot): void;
+    applyAppUpdate(input: {
+        app: WorkspaceAppCenterApp;
+        failureReason?: string | null;
+        startedAtUnixMs?: number | null;
+        workspaceId: string;
+    }): void;
+    applyAppSnapshot(workspaceId: string, nextApp: WorkspaceAppCenterApp, options?: {
+        installFailureReason?: string | null;
+    }): void;
+    applyFactoryJobUpdate(workspaceId: string, job: WorkspaceAppFactoryJob): void;
+    protected scheduleInstallRefresh(workspaceId: string, appId: string): void;
+    protected markAppStarting(appId: string): void;
+    protected markLaunchWaitTimedOut(input: {
+        appId: string;
+        workspaceId: string;
+    }): void;
+    protected resolveLaunchableApp(input: {
+        appId: string;
+        workspaceId: string;
+    }): WorkspaceAppCenterApp | null;
+    protected markAppInstalling(appId: string, options?: {
+        preserveInstalled?: boolean;
+    }): void;
+    protected markEnabledAppsStarting(): void;
+    protected isPendingInstallSettled(installKey: string, app: WorkspaceAppCenterApp): boolean;
+    private mergeSnapshotAppsByStateRevision;
+    private scheduleCatalogLoadingRefresh;
+    private withPendingInstallState;
+    private refreshInstallState;
+    private settlePendingInstallReport;
+}
+
+declare function createWorkspaceAppCenterController(dependencies: WorkspaceAppCenterControllerDependencies): WorkspaceAppCenterController;
+declare class WorkspaceAppCenterController extends WorkspaceAppCenterControllerState {
+    installApp(input: {
+        appId: string;
+        workspaceId: string;
+    }): Promise<void>;
+    prepareAppLaunch(input: {
+        appId: string;
+        workspaceId: string;
+    }): Promise<WorkspaceAppCenterApp | null>;
+    createFactoryJob(input: {
+        displayName: string;
+        model?: string;
+        permissionModeId?: string;
+        provider?: string;
+        prompt: string;
+        reasoningEffort?: string;
+        workspaceId: string;
+    }): Promise<void>;
+    cancelFactoryJob(input: {
+        jobId: string;
+        workspaceId: string;
+    }): Promise<void>;
+    deleteFactoryJob(input: {
+        jobId: string;
+        workspaceId: string;
+    }): Promise<void>;
+    deleteApp(input: {
+        appId: string;
+        workspaceId: string;
+    }): Promise<void>;
+    retryFactoryValidation(input: {
+        jobId: string;
+        workspaceId: string;
+    }): Promise<void>;
+    fixFactoryJob(input: {
+        jobId: string;
+        prompt: string;
+        workspaceId: string;
+    }): Promise<void>;
+    prepareFactoryJobModification(input: {
+        jobId: string;
+        workspaceId: string;
+    }): Promise<WorkspaceAppFactoryJob | null>;
+    publishFactoryJob(input: {
+        jobId: string;
+        workspaceId: string;
+    }): Promise<WorkspaceAppFactoryJob | null>;
+    refresh(workspaceId: string): Promise<void>;
+    refreshCatalog(workspaceId: string): Promise<void>;
+    startEnabledApps(workspaceId: string): Promise<void>;
+    uninstallApp(input: {
+        appId: string;
+        workspaceId: string;
+    }): Promise<void>;
+    updateApp(input: {
+        appId: string;
+        trigger: "badge_button" | "primary_action";
+        workspaceId: string;
+    }): Promise<void>;
+    retryApp(input: {
+        appId: string;
+        workspaceId: string;
+    }): Promise<void>;
+    private waitForLaunchableApp;
+    private refreshLaunchWaitState;
+    private shouldAbortLaunchWait;
+}
 
 declare function sortMyAppsByCreatedDesc(apps: readonly AppCenterViewModel["apps"][number][]): AppCenterViewModel["apps"];
 declare function sortRecommendedApps(apps: readonly AppCenterViewModel["apps"][number][]): AppCenterViewModel["apps"];
@@ -13,4 +226,4 @@ declare const DEFAULT_APP_FACTORY_PROVIDER = "codex";
 declare function resolveDefaultAppFactoryProvider(options: readonly AppFactoryProviderDefaultOption[], preferredProvider?: string | null): string;
 declare function resolveSelectedAppFactoryProvider(currentProvider: string, options: readonly AppFactoryProviderDefaultOption[], preferredProvider?: string | null): string;
 
-export { type AppFactoryProviderDefaultOption, DEFAULT_APP_FACTORY_PROVIDER, resolveDefaultAppFactoryProvider, resolveSelectedAppFactoryProvider, sortMyAppsByCreatedDesc, sortRecommendedApps, sortRecommendedAppsForAllTab };
+export { type AppFactoryProviderDefaultOption, DEFAULT_APP_FACTORY_PROVIDER, WorkspaceAppCenterController, type WorkspaceAppCenterControllerDependencies, type WorkspaceAppCenterControllerHooks, type WorkspaceAppCenterOperation, type WorkspaceAppCenterOperationDetails, type WorkspaceAppCenterRefreshDiscard, type WorkspaceAppCenterUiAction, createWorkspaceAppCenterController, createWorkspaceAppCenterStoreState, resolveDefaultAppFactoryProvider, resolveSelectedAppFactoryProvider, sortMyAppsByCreatedDesc, sortRecommendedApps, sortRecommendedAppsForAllTab };

package/dist/core/index.js

@@ -1,5 +1,8 @@
 import {
+  WorkspaceAppCenterController,
   createAppCenterViewModel,
+  createWorkspaceAppCenterController,
+  createWorkspaceAppCenterStoreState,
   createWorkspaceAppIdentity,
   createWorkspaceAppRecord,
   isWorkspaceAppId,
@@ -10,8 +13,8 @@ import {
   resolveWorkspaceAppStatusPresentation,
   validateWorkspaceAppManifest,
   workspaceAppIdPattern
-} from "../chunk-XDDBJJGP.js";
-import "../chunk-QSAEUGFC.js";
+} from "../chunk-5SANC3S6.js";
+import "../chunk-UBERYRMA.js";
 import {
   DEFAULT_APP_FACTORY_PROVIDER,
   resolveDefaultAppFactoryProvider,
@@ -22,7 +25,10 @@ import {
 } from "../chunk-LBSZLLZK.js";
 export {
   DEFAULT_APP_FACTORY_PROVIDER,
+  WorkspaceAppCenterController,
   createAppCenterViewModel,
+  createWorkspaceAppCenterController,
+  createWorkspaceAppCenterStoreState,
   createWorkspaceAppIdentity,
   createWorkspaceAppRecord,
   isWorkspaceAppId,

package/dist/i18n/index.js

@@ -276,7 +276,8 @@ var appCenterEn = {
     preparing: "Preparing",
     running: "Running",
     starting: "Starting",
-    stopping: "Stopping"
+    stopping: "Stopping",
+    unavailable: "Unavailable"
   },
   title: "Applications"
 };
@@ -542,7 +543,8 @@ var appCenterZhCN = {
     preparing: "\u51C6\u5907\u4E2D",
     running: "\u8FD0\u884C\u4E2D",
     starting: "\u542F\u52A8\u4E2D",
-    stopping: "\u505C\u6B62\u4E2D"
+    stopping: "\u505C\u6B62\u4E2D",
+    unavailable: "\u4E0D\u53EF\u7528"
   },
   title: "\u5E94\u7528"
 };