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

package/dist/chunk-2HXFGEJS.js

@@ -0,0 +1,110 @@
+// src/core/appCenterAppOrdering.ts
+var installableRecommendedAppIds = [
+  ["ai-media-canvas", "media-canvas"],
+  ["vibe-design"],
+  ["group-chat"],
+  ["automation"],
+  ["daily-product-radar", "daily-tech-radar", "radar"]
+];
+var comingSoonRecommendedAppIds = [
+  "ai-ppt",
+  "ai-document",
+  "ai-sheet",
+  "open-cut",
+  "product-competition",
+  "design-review",
+  "calendar",
+  "document-summarizer"
+];
+var recommendedAppDisplayRankById = buildRecommendedAppDisplayRankById();
+function sortMyAppsByCreatedDesc(apps) {
+  return [...apps].sort((left, right) => {
+    const createdOrder = (right.createdAtUnixMs ?? 0) - (left.createdAtUnixMs ?? 0);
+    if (createdOrder !== 0) {
+      return createdOrder;
+    }
+    const nameOrder = left.name.localeCompare(right.name);
+    if (nameOrder !== 0) {
+      return nameOrder;
+    }
+    return left.id.localeCompare(right.id);
+  });
+}
+function sortRecommendedApps(apps) {
+  return [...apps].sort(compareRecommendedApps);
+}
+function sortRecommendedAppsForAllTab(apps) {
+  return [...apps].sort(compareRecommendedApps);
+}
+function compareRecommendedApps(left, right) {
+  const sectionOrder = getRecommendedAppSectionRank(left) - getRecommendedAppSectionRank(right);
+  if (sectionOrder !== 0) {
+    return sectionOrder;
+  }
+  const displayOrder = getRecommendedAppDisplayRank(left.id) - getRecommendedAppDisplayRank(right.id);
+  if (displayOrder !== 0) {
+    return displayOrder;
+  }
+  const comingSoonOrder = getRecommendedAppComingSoonRank(left) - getRecommendedAppComingSoonRank(right);
+  if (comingSoonOrder !== 0) {
+    return comingSoonOrder;
+  }
+  return left.name.localeCompare(right.name);
+}
+function buildRecommendedAppDisplayRankById() {
+  const rankById = /* @__PURE__ */ new Map();
+  let rank = 0;
+  for (const aliases of installableRecommendedAppIds) {
+    for (const appId of aliases) {
+      rankById.set(appId, rank);
+    }
+    rank += 1;
+  }
+  for (const appId of comingSoonRecommendedAppIds) {
+    rankById.set(appId, rank);
+    rank += 1;
+  }
+  return rankById;
+}
+function getRecommendedAppDisplayRank(appId) {
+  return recommendedAppDisplayRankById.get(appId.trim().toLowerCase()) ?? Number.MAX_SAFE_INTEGER;
+}
+function getRecommendedAppSectionRank(app) {
+  const normalizedAppId = app.id.trim().toLowerCase();
+  if (recommendedAppDisplayRankById.has(normalizedAppId)) {
+    return isConfiguredComingSoonApp(normalizedAppId) ? 1 : 0;
+  }
+  return getRecommendedAppComingSoonRank(app);
+}
+function isConfiguredComingSoonApp(appId) {
+  return comingSoonRecommendedAppIds.some(
+    (configuredAppId) => configuredAppId === appId
+  );
+}
+function getRecommendedAppComingSoonRank(app) {
+  return app.statusLabelKey === "status.comingSoon" || app.tags.some((tag) => tag.trim().toLowerCase() === "coming-soon") ? 1 : 0;
+}
+
+// src/core/appFactoryProviderDefaults.ts
+var DEFAULT_APP_FACTORY_PROVIDER = "codex";
+function resolveDefaultAppFactoryProvider(options, preferredProvider) {
+  const normalizedPreferredProvider = preferredProvider?.trim() ?? "";
+  return options.find(
+    (option) => normalizedPreferredProvider !== "" && option.disabled !== true && option.provider === normalizedPreferredProvider
+  )?.provider ?? options.find(
+    (option) => option.disabled !== true && option.provider === DEFAULT_APP_FACTORY_PROVIDER
+  )?.provider ?? options.find((option) => option.disabled !== true)?.provider ?? options.find((option) => option.provider === DEFAULT_APP_FACTORY_PROVIDER)?.provider ?? options[0]?.provider ?? "";
+}
+function resolveSelectedAppFactoryProvider(currentProvider, options, preferredProvider) {
+  return options.some((option) => option.provider === currentProvider) ? currentProvider : resolveDefaultAppFactoryProvider(options, preferredProvider);
+}
+
+export {
+  sortMyAppsByCreatedDesc,
+  sortRecommendedApps,
+  sortRecommendedAppsForAllTab,
+  DEFAULT_APP_FACTORY_PROVIDER,
+  resolveDefaultAppFactoryProvider,
+  resolveSelectedAppFactoryProvider
+};
+//# sourceMappingURL=chunk-2HXFGEJS.js.map

package/dist/chunk-2HXFGEJS.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/core/appCenterAppOrdering.ts","../src/core/appFactoryProviderDefaults.ts"],"sourcesContent":["import type { AppCenterViewModel } from \"../contracts/viewModel.ts\";\n\nconst installableRecommendedAppIds = [\n  [\"ai-media-canvas\", \"media-canvas\"],\n  [\"vibe-design\"],\n  [\"group-chat\"],\n  [\"automation\"],\n  [\"daily-product-radar\", \"daily-tech-radar\", \"radar\"]\n] as const;\n\nconst comingSoonRecommendedAppIds = [\n  \"ai-ppt\",\n  \"ai-document\",\n  \"ai-sheet\",\n  \"open-cut\",\n  \"product-competition\",\n  \"design-review\",\n  \"calendar\",\n  \"document-summarizer\"\n] as const;\n\nconst recommendedAppDisplayRankById = buildRecommendedAppDisplayRankById();\n\nexport function sortMyAppsByCreatedDesc(\n  apps: readonly AppCenterViewModel[\"apps\"][number][]\n): AppCenterViewModel[\"apps\"] {\n  return [...apps].sort((left, right) => {\n    const createdOrder =\n      (right.createdAtUnixMs ?? 0) - (left.createdAtUnixMs ?? 0);\n    if (createdOrder !== 0) {\n      return createdOrder;\n    }\n    const nameOrder = left.name.localeCompare(right.name);\n    if (nameOrder !== 0) {\n      return nameOrder;\n    }\n    return left.id.localeCompare(right.id);\n  });\n}\n\nexport function sortRecommendedApps(\n  apps: readonly AppCenterViewModel[\"apps\"][number][]\n): AppCenterViewModel[\"apps\"] {\n  return [...apps].sort(compareRecommendedApps);\n}\n\nexport function sortRecommendedAppsForAllTab(\n  apps: readonly AppCenterViewModel[\"apps\"][number][]\n): AppCenterViewModel[\"apps\"] {\n  return [...apps].sort(compareRecommendedApps);\n}\n\nfunction compareRecommendedApps(\n  left: AppCenterViewModel[\"apps\"][number],\n  right: AppCenterViewModel[\"apps\"][number]\n): number {\n  const sectionOrder =\n    getRecommendedAppSectionRank(left) - getRecommendedAppSectionRank(right);\n  if (sectionOrder !== 0) {\n    return sectionOrder;\n  }\n\n  const displayOrder =\n    getRecommendedAppDisplayRank(left.id) -\n    getRecommendedAppDisplayRank(right.id);\n  if (displayOrder !== 0) {\n    return displayOrder;\n  }\n\n  const comingSoonOrder =\n    getRecommendedAppComingSoonRank(left) -\n    getRecommendedAppComingSoonRank(right);\n  if (comingSoonOrder !== 0) {\n    return comingSoonOrder;\n  }\n\n  return left.name.localeCompare(right.name);\n}\n\nfunction buildRecommendedAppDisplayRankById(): Map<string, number> {\n  const rankById = new Map<string, number>();\n  let rank = 0;\n\n  for (const aliases of installableRecommendedAppIds) {\n    for (const appId of aliases) {\n      rankById.set(appId, rank);\n    }\n    rank += 1;\n  }\n\n  for (const appId of comingSoonRecommendedAppIds) {\n    rankById.set(appId, rank);\n    rank += 1;\n  }\n\n  return rankById;\n}\n\nfunction getRecommendedAppDisplayRank(appId: string): number {\n  return (\n    recommendedAppDisplayRankById.get(appId.trim().toLowerCase()) ??\n    Number.MAX_SAFE_INTEGER\n  );\n}\n\nfunction getRecommendedAppSectionRank(\n  app: AppCenterViewModel[\"apps\"][number]\n): number {\n  const normalizedAppId = app.id.trim().toLowerCase();\n  if (recommendedAppDisplayRankById.has(normalizedAppId)) {\n    return isConfiguredComingSoonApp(normalizedAppId) ? 1 : 0;\n  }\n\n  return getRecommendedAppComingSoonRank(app);\n}\n\nfunction isConfiguredComingSoonApp(appId: string): boolean {\n  return comingSoonRecommendedAppIds.some(\n    (configuredAppId) => configuredAppId === appId\n  );\n}\n\nfunction getRecommendedAppComingSoonRank(\n  app: AppCenterViewModel[\"apps\"][number]\n): number {\n  return app.statusLabelKey === \"status.comingSoon\" ||\n    app.tags.some((tag) => tag.trim().toLowerCase() === \"coming-soon\")\n    ? 1\n    : 0;\n}\n","export interface AppFactoryProviderDefaultOption {\n  readonly disabled?: boolean;\n  readonly provider: string;\n}\n\nexport const DEFAULT_APP_FACTORY_PROVIDER = \"codex\";\n\nexport function resolveDefaultAppFactoryProvider(\n  options: readonly AppFactoryProviderDefaultOption[],\n  preferredProvider?: string | null\n): string {\n  const normalizedPreferredProvider = preferredProvider?.trim() ?? \"\";\n  return (\n    options.find(\n      (option) =>\n        normalizedPreferredProvider !== \"\" &&\n        option.disabled !== true &&\n        option.provider === normalizedPreferredProvider\n    )?.provider ??\n    options.find(\n      (option) =>\n        option.disabled !== true &&\n        option.provider === DEFAULT_APP_FACTORY_PROVIDER\n    )?.provider ??\n    options.find((option) => option.disabled !== true)?.provider ??\n    options.find((option) => option.provider === DEFAULT_APP_FACTORY_PROVIDER)\n      ?.provider ??\n    options[0]?.provider ??\n    \"\"\n  );\n}\n\nexport function resolveSelectedAppFactoryProvider(\n  currentProvider: string,\n  options: readonly AppFactoryProviderDefaultOption[],\n  preferredProvider?: string | null\n): string {\n  return options.some((option) => option.provider === currentProvider)\n    ? currentProvider\n    : resolveDefaultAppFactoryProvider(options, preferredProvider);\n}\n"],"mappings":"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","names":[]}

package/dist/{chunk-PD2WLRHE.js → chunk-7BJAJ7F3.js}

@@ -13,4 +13,4 @@ var workspaceAppRuntimeStatuses = [
 export {
   workspaceAppRuntimeStatuses
 };
-//# sourceMappingURL=chunk-PD2WLRHE.js.map
+//# sourceMappingURL=chunk-7BJAJ7F3.js.map

package/dist/chunk-7BJAJ7F3.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/contracts/runtime.ts"],"sourcesContent":["export const workspaceAppRuntimeStatuses = [\n  \"idle\",\n  \"installing\",\n  \"preparing\",\n  \"starting\",\n  \"running\",\n  \"failed\",\n  \"stopping\",\n  \"unavailable\"\n] as const;\n\nexport type WorkspaceAppRuntimeStatus =\n  (typeof workspaceAppRuntimeStatuses)[number];\n\nexport interface WorkspaceAppRuntimeError {\n  readonly code?: string;\n  readonly message: string;\n}\n\nexport type WorkspaceAppInstallUserPhase =\n  | \"downloading\"\n  | \"installing\"\n  | \"starting\";\n\nexport interface WorkspaceAppInstallProgress {\n  readonly userPhase: WorkspaceAppInstallUserPhase;\n  readonly overallPercent: number;\n  readonly downloadedBytes?: number | null;\n  readonly totalBytes?: number | null;\n  readonly indeterminate: boolean;\n}\n\nexport interface WorkspaceAppRuntimeState {\n  readonly runtimeId?: string;\n  readonly installationId?: string;\n  readonly appId: string;\n  readonly status: WorkspaceAppRuntimeStatus;\n  readonly launchUrl?: string | null;\n  readonly installProgress?: WorkspaceAppInstallProgress | null;\n  readonly error?: WorkspaceAppRuntimeError | null;\n  readonly startedAt?: string | null;\n  readonly updatedAt?: string | null;\n}\n"],"mappings":";AAAO,IAAM,8BAA8B;AAAA,EACzC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;","names":[]}

package/dist/{chunk-5SANC3S6.js → chunk-DPJRK63W.js}

@@ -1,6 +1,6 @@
 import {
   workspaceAppManifestSchemaVersion
-} from "./chunk-UBERYRMA.js";
+} from "./chunk-Y63TZ5JT.js";
 
 // src/core/appCenterControllerHelpers.ts
 function resolveAppRunDurationMs(startedAtUnixMs, now) {
@@ -30,16 +30,28 @@ function mergeWorkspaceAppCatalogFields(currentApp, snapshotApp) {
     updateAvailable: snapshotApp.updateAvailable
   };
 }
+function areWorkspaceAppInstallProgressEqual(left, right) {
+  if (left == null && right == null) {
+    return true;
+  }
+  if (left == null || right == null) {
+    return false;
+  }
+  return left.userPhase === right.userPhase && left.overallPercent === right.overallPercent && left.downloadedBytes === right.downloadedBytes && left.totalBytes === right.totalBytes && left.indeterminate === right.indeterminate;
+}
 function areWorkspaceAppCenterAppsEqual(left, right) {
   if (left.length !== right.length) {
     return false;
   }
   return left.every((leftApp, index) => {
     const rightApp = right[index];
-    return rightApp !== void 0 && leftApp.appId === rightApp.appId && leftApp.availableIconUrl === rightApp.availableIconUrl && leftApp.availableVersion === rightApp.availableVersion && leftApp.createdAtUnixMs === rightApp.createdAtUnixMs && leftApp.description === rightApp.description && leftApp.enabled === rightApp.enabled && leftApp.exportable === rightApp.exportable && leftApp.iconUrl === rightApp.iconUrl && leftApp.installed === rightApp.installed && leftApp.installationId === rightApp.installationId && areWorkspaceAppCenterLocalizationsEqual(
+    return rightApp !== void 0 && leftApp.appId === rightApp.appId && leftApp.availableIconUrl === rightApp.availableIconUrl && leftApp.availableVersion === rightApp.availableVersion && leftApp.createdAtUnixMs === rightApp.createdAtUnixMs && leftApp.description === rightApp.description && leftApp.enabled === rightApp.enabled && leftApp.exportable === rightApp.exportable && leftApp.iconUrl === rightApp.iconUrl && leftApp.installed === rightApp.installed && areWorkspaceAppInstallProgressEqual(
+      leftApp.installProgress,
+      rightApp.installProgress
+    ) && leftApp.installationId === rightApp.installationId && areWorkspaceAppCenterLocalizationsEqual(
       leftApp.localizations ?? [],
       rightApp.localizations ?? []
-    ) && leftApp.minimizeBehavior === rightApp.minimizeBehavior && leftApp.name === rightApp.name && leftApp.references.searchSupported === rightApp.references.searchSupported && leftApp.runtimeId === rightApp.runtimeId && leftApp.runtimeStatus === rightApp.runtimeStatus && leftApp.source === rightApp.source && leftApp.stateRevision === rightApp.stateRevision && areStringArraysEqual(leftApp.tags ?? [], rightApp.tags ?? []) && (leftApp.updateAvailable ?? false) === (rightApp.updateAvailable ?? false) && leftApp.launchUrl === rightApp.launchUrl && leftApp.version === rightApp.version && leftApp.windowMinHeight === rightApp.windowMinHeight && leftApp.windowMinWidth === rightApp.windowMinWidth;
+    ) && leftApp.minimizeBehavior === rightApp.minimizeBehavior && leftApp.name === rightApp.name && leftApp.references.listSupported === rightApp.references.listSupported && leftApp.runtimeId === rightApp.runtimeId && leftApp.runtimeStatus === rightApp.runtimeStatus && leftApp.source === rightApp.source && leftApp.stateRevision === rightApp.stateRevision && areStringArraysEqual(leftApp.tags ?? [], rightApp.tags ?? []) && (leftApp.updateAvailable ?? false) === (rightApp.updateAvailable ?? false) && leftApp.launchUrl === rightApp.launchUrl && leftApp.version === rightApp.version && leftApp.windowMinHeight === rightApp.windowMinHeight && leftApp.windowMinWidth === rightApp.windowMinWidth;
   });
 }
 function normalizeWorkspaceAppCenterViewState(value) {
@@ -276,6 +288,85 @@ var WorkspaceAppCenterControllerBase = class {
   }
 };
 
+// src/core/installProgressMerge.ts
+var installUserPhaseOrder = {
+  downloading: 0,
+  installing: 1,
+  starting: 2
+};
+var defaultDownloadCompletePercent = 70;
+var defaultInstallingPartialPercent = 79;
+var defaultStartingPartialPercent = 96;
+function reconcilePendingInstallProgress(input) {
+  const runtimePhase = runtimeStatusToInstallUserPhase(input.runtimeStatus);
+  const progress = input.incoming ?? input.previous ?? (runtimePhase == null ? null : createProgressForRuntimePhase(runtimePhase));
+  if (progress == null) {
+    return null;
+  }
+  if (runtimePhase == null) {
+    return clearDownloadBytesUnlessDownloading(progress);
+  }
+  if (compareInstallUserPhase(progress.userPhase, runtimePhase) >= 0) {
+    return clearDownloadBytesUnlessDownloading(progress);
+  }
+  return advanceInstallProgressToPhase(progress, runtimePhase);
+}
+function runtimeStatusToInstallUserPhase(runtimeStatus) {
+  switch (runtimeStatus) {
+    case "preparing":
+      return "installing";
+    case "starting":
+      return "starting";
+    default:
+      return null;
+  }
+}
+function compareInstallUserPhase(left, right) {
+  return installUserPhaseOrder[left] - installUserPhaseOrder[right];
+}
+function advanceInstallProgressToPhase(progress, targetPhase) {
+  let overallPercent = progress.overallPercent;
+  let userPhase = progress.userPhase;
+  if (targetPhase === "installing" || targetPhase === "starting") {
+    overallPercent = Math.max(overallPercent, defaultDownloadCompletePercent);
+    userPhase = "installing";
+  }
+  if (targetPhase === "starting") {
+    overallPercent = Math.max(overallPercent, defaultStartingPartialPercent);
+    userPhase = "starting";
+  } else if (targetPhase === "installing") {
+    overallPercent = Math.max(overallPercent, defaultInstallingPartialPercent);
+  }
+  return clearDownloadBytesUnlessDownloading({
+    ...progress,
+    indeterminate: false,
+    overallPercent,
+    userPhase
+  });
+}
+function createProgressForRuntimePhase(userPhase) {
+  return advanceInstallProgressToPhase(
+    {
+      downloadedBytes: null,
+      indeterminate: false,
+      overallPercent: 0,
+      totalBytes: null,
+      userPhase: "downloading"
+    },
+    userPhase
+  );
+}
+function clearDownloadBytesUnlessDownloading(progress) {
+  if (progress.userPhase === "downloading") {
+    return progress;
+  }
+  return {
+    ...progress,
+    downloadedBytes: null,
+    totalBytes: null
+  };
+}
+
 // src/core/appCenterControllerState.ts
 var WorkspaceAppCenterControllerState = class extends WorkspaceAppCenterControllerBase {
   applySnapshot(workspaceId, snapshot) {
@@ -371,11 +462,16 @@ var WorkspaceAppCenterControllerState = class extends WorkspaceAppCenterControll
       return;
     }
     const appIdsToClose = currentApp?.installed === true && !nextApp.installed ? [nextApp.appId] : [];
+    const mergedApp = this.mergeActiveInstallAppState(
+      workspaceId,
+      nextApp,
+      currentApp
+    );
     const nextApps = sortWorkspaceAppCenterApps([
       ...this.store.apps.filter(
         (candidate) => candidate.appId !== nextApp.appId
       ),
-      nextApp
+      mergedApp
     ]);
     if (areWorkspaceAppCenterAppsEqual(this.store.apps, nextApps)) {
       return;
@@ -385,8 +481,8 @@ var WorkspaceAppCenterControllerState = class extends WorkspaceAppCenterControll
     this.store.loadStatus = "ready";
     this.bumpRevision();
     this.settlePendingInstallReport({
-      app: nextApp,
-      failureReason: options.installFailureReason ?? nextApp.failureReason ?? nextApp.lastError ?? null,
+      app: mergedApp,
+      failureReason: options.installFailureReason ?? mergedApp.failureReason ?? mergedApp.lastError ?? null,
       workspaceId
     });
     this.closeWorkspaceAppViews(workspaceId, appIdsToClose);
@@ -495,15 +591,24 @@ var WorkspaceAppCenterControllerState = class extends WorkspaceAppCenterControll
       this.bumpRevision();
     }
   }
-  isPendingInstallSettled(installKey, app) {
+  isPendingInstallSettled(installKey, app, previousApp) {
+    if (this.isPendingInstallAbandoned(installKey, app, previousApp)) {
+      return true;
+    }
     if (app.runtimeStatus === "failed") {
       return true;
     }
+    if (this.isRuntimeInstallBusy(app.runtimeStatus)) {
+      return false;
+    }
     if (this.pendingInstallReportKeys.has(installKey)) {
       return app.installed;
     }
     return app.installed && !app.updateAvailable && !app.availableVersion;
   }
+  isRuntimeInstallBusy(runtimeStatus) {
+    return runtimeStatus === "installing" || runtimeStatus === "preparing" || runtimeStatus === "starting";
+  }
   mergeSnapshotAppsByStateRevision(workspaceId, snapshotApps) {
     if (this.store.workspaceId !== workspaceId) {
       return [...snapshotApps];
@@ -520,7 +625,8 @@ var WorkspaceAppCenterControllerState = class extends WorkspaceAppCenterControll
       if (this.pendingInstallKeys.has(installKey)) {
         const pendingSettled = this.isPendingInstallSettled(
           installKey,
-          snapshotApp
+          snapshotApp,
+          currentApp
         );
         if (pendingSettled && currentApp.stateRevision <= snapshotApp.stateRevision) {
           return snapshotApp;
@@ -545,22 +651,50 @@ var WorkspaceAppCenterControllerState = class extends WorkspaceAppCenterControll
       void this.refresh(workspaceId);
     }, this.dependencies.catalogLoadingRefreshDelayMs ?? defaultCatalogLoadingRefreshDelayMs);
   }
+  mergeActiveInstallAppState(workspaceId, app, previousApp) {
+    const installKey = appRuntimeKey(workspaceId, app.appId);
+    if (!this.pendingInstallKeys.has(installKey)) {
+      return app;
+    }
+    if (this.isPendingInstallSettled(installKey, app, previousApp)) {
+      return app;
+    }
+    const incomingRuntimeStatus = app.runtimeStatus;
+    const runtimeStatus = this.isRuntimeInstallLifecycleStatus(
+      incomingRuntimeStatus
+    ) ? incomingRuntimeStatus : "installing";
+    return {
+      ...app,
+      enabled: true,
+      installed: this.pendingInstallReportKeys.has(installKey) ? false : app.installed,
+      installProgress: reconcilePendingInstallProgress({
+        incoming: app.installProgress,
+        previous: previousApp?.installProgress ?? null,
+        runtimeStatus: incomingRuntimeStatus
+      }),
+      runtimeStatus
+    };
+  }
+  isRuntimeInstallLifecycleStatus(runtimeStatus) {
+    return runtimeStatus === "installing" || runtimeStatus === "preparing" || runtimeStatus === "starting";
+  }
+  isPendingInstallAbandoned(installKey, app, previousApp) {
+    return this.pendingInstallReportKeys.has(installKey) && !app.installed && app.runtimeStatus === "idle" && app.installProgress == null && this.hasObservedInstallActivity(previousApp);
+  }
+  hasObservedInstallActivity(app) {
+    return app?.installProgress != null || app?.runtimeStatus === "preparing" || app?.runtimeStatus === "starting";
+  }
   withPendingInstallState(workspaceId, apps) {
-    return apps.map((app) => {
-      const installKey = appRuntimeKey(workspaceId, app.appId);
-      if (!this.pendingInstallKeys.has(installKey)) {
-        return app;
-      }
-      if (this.isPendingInstallSettled(installKey, app)) {
-        return app;
-      }
-      return {
-        ...app,
-        enabled: true,
-        installed: this.pendingInstallReportKeys.has(installKey) ? false : app.installed,
-        runtimeStatus: "installing"
-      };
-    });
+    const previousAppsById = new Map(
+      this.store.apps.map((app) => [app.appId, app])
+    );
+    return apps.map(
+      (app) => this.mergeActiveInstallAppState(
+        workspaceId,
+        app,
+        previousAppsById.get(app.appId)
+      )
+    );
   }
   async refreshInstallState(workspaceId, appId) {
     try {
@@ -595,6 +729,9 @@ var WorkspaceAppCenterControllerState = class extends WorkspaceAppCenterControll
       this.dependencies.hooks?.onAppInstalled?.(input.app);
       return;
     }
+    if (input.app.runtimeStatus === "idle" && input.app.installProgress == null && input.failureReason == null && input.app.failureReason == null && input.app.lastError == null) {
+      return;
+    }
     this.dependencies.hooks?.onAppInstallFailed?.({
       app: input.app,
       appId: input.app.appId,
@@ -954,11 +1091,16 @@ var WorkspaceAppCenterController = class extends WorkspaceAppCenterControllerSta
     this.pendingInstallKeys.add(installKey);
     this.markAppInstalling(input.appId, { preserveInstalled: true });
     try {
+      const restartRunning = app?.installed === true && app.runtimeStatus === "running";
       const snapshot = await this.dependencies.gateway.installWorkspaceApp(
         input.workspaceId,
-        input.appId
+        input.appId,
+        restartRunning ? { restartRunning: true } : void 0
       );
       this.applySnapshot(input.workspaceId, snapshot);
+      if (restartRunning) {
+        this.closeWorkspaceAppViews(input.workspaceId, [input.appId]);
+      }
       this.dependencies.hooks?.onAppUpdated?.({
         app,
         trigger: input.trigger
@@ -1146,9 +1288,9 @@ function validateWorkspaceAppManifest(value) {
   }
   const icon = validateIcon(value.icon, issues);
   const runtime = validateRuntime(value.runtime, issues);
+  const references = validateReferences(value.references, issues);
   const window = validateWindow(value.window, issues);
   const author = validateAuthor(value.author, issues);
-  const references = validateReferences(value.references, issues);
   const tags = validateTags(value.tags, issues);
   const localizationInfo = validateLocalizationInfo(
     value.localizationInfo,
@@ -1170,9 +1312,9 @@ function validateWorkspaceAppManifest(value) {
       description,
       ...icon ? { icon } : {},
       runtime,
+      ...references ? { references } : {},
       ...window ? { window } : {},
       ...author ? { author } : {},
-      ...references ? { references } : {},
       ...tags ? { tags } : {},
       ...localizationInfo ? { localizationInfo } : {}
     },
@@ -1239,6 +1381,40 @@ function validateRuntime(value, issues) {
     healthcheckPath
   };
 }
+function validateReferences(value, issues) {
+  if (value === void 0) {
+    return void 0;
+  }
+  if (!isRecord(value)) {
+    issues.push({
+      code: "manifest.references",
+      message: "references must be an object when provided.",
+      path: "$.references"
+    });
+    return void 0;
+  }
+  const unsupportedKey = Object.keys(value).find(
+    (key) => key !== "listEndpoint"
+  );
+  if (unsupportedKey) {
+    issues.push({
+      code: "manifest.references",
+      message: `references.${unsupportedKey} is unsupported.`,
+      path: `$.references.${unsupportedKey}`
+    });
+    return void 0;
+  }
+  const listEndpoint = readOptionalString(value.listEndpoint);
+  if (!listEndpoint || !isRelativeUrlPath(listEndpoint)) {
+    issues.push({
+      code: "manifest.references",
+      message: "references.listEndpoint must be a relative URL path without query or fragment.",
+      path: "$.references.listEndpoint"
+    });
+    return void 0;
+  }
+  return { listEndpoint };
+}
 function validateWindow(value, issues) {
   if (value === void 0) {
     return void 0;
@@ -1324,29 +1500,6 @@ function validateAuthor(value, issues) {
     ...url ? { url } : {}
   };
 }
-function validateReferences(value, issues) {
-  if (value === void 0) {
-    return void 0;
-  }
-  if (!isRecord(value)) {
-    issues.push({
-      code: "manifest.references",
-      message: "references must be an object when provided.",
-      path: "$.references"
-    });
-    return void 0;
-  }
-  const searchEndpoint = readOptionalString(value.searchEndpoint);
-  if (!searchEndpoint || !isRelativeUrlPath(searchEndpoint)) {
-    issues.push({
-      code: "manifest.references",
-      message: "references.searchEndpoint must be a relative URL path without query or hash.",
-      path: "$.references.searchEndpoint"
-    });
-    return void 0;
-  }
-  return { searchEndpoint };
-}
 function validateTags(value, issues) {
   if (value === void 0) {
     return void 0;
@@ -1452,11 +1605,15 @@ function isRelativePackagePath(value) {
   return !value.startsWith("/") && !value.split(/[\\/]/u).includes("..");
 }
 function isRelativeUrlPath(value) {
-  const trimmed = value.trim();
-  if (!trimmed || !trimmed.startsWith("/") || trimmed.startsWith("//") || trimmed.includes("\0") || trimmed.includes("?") || trimmed.includes("#") || trimmed.includes("%")) {
+  if (!value || !value.startsWith("/") || value.startsWith("//") || value.includes("\0")) {
+    return false;
+  }
+  try {
+    const parsed = new URL(value, "http://tutti.local");
+    return parsed.origin === "http://tutti.local" && parsed.pathname === value && parsed.search === "" && parsed.hash === "";
+  } catch {
     return false;
   }
-  return true;
 }
 function isRecord(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
@@ -1585,9 +1742,11 @@ function createAppCenterViewModel({
       manifest: app.manifest
     });
     const factoryAgentSessionId = factoryJob?.agentSessionId?.trim() || null;
-    const status = runtime?.status ?? "idle";
+    const factoryEditAction = factoryJob && factoryAgentSessionId ? factoryJob.status === "published" ? "prepare_modification" : "open_session" : null;
+    const status = resolveRuntimeStatusForViewModel(runtime);
     const presentation = resolveWorkspaceAppStatusPresentation(status);
     const installed = Boolean(app.install);
+    const installBusy = runtime?.installProgress != null || status === "installing";
     const sourceKind = resolveCatalogSourceKind(app.catalog);
     const localApp = sourceKind === "local";
     const runtimeId = normalizeOptionalString(runtime?.runtimeId);
@@ -1609,6 +1768,7 @@ function createAppCenterViewModel({
       installed,
       status
     });
+    const iconUrl = resolveWorkspaceAppIconUrl(app);
     return {
       id: app.manifest.appId,
       installationId,
@@ -1621,30 +1781,37 @@ function createAppCenterViewModel({
       ...app.availableVersion && !comingSoon ? { availableVersion: app.availableVersion } : {},
       ...app.category?.trim() ? { category: app.category.trim() } : {},
       updateAvailable: app.updateAvailable ?? false,
-      ...app.manifest.icon ? { icon: app.manifest.icon } : {},
+      ...iconUrl ? {
+        icon: {
+          type: "asset",
+          src: iconUrl
+        }
+      } : {},
       tags: metadata.tags,
       installed,
       status,
       statusLabelKey: comingSoon ? "status.comingSoon" : resolvePrimaryActionLabelKey(primaryAction, presentation.labelKey),
       statusTone: presentation.tone,
-      statusPulse: presentation.pulse,
+      statusPulse: runtime?.installProgress ? false : presentation.pulse,
       primaryAction,
       sourceKind,
       canOpen,
       canExport: localApp,
       canDelete: localApp,
       canReplaceIcon: replaceableIconAppIdSet.has(app.manifest.appId),
-      canOpenFolder: installed,
-      canOpenPackageFolder: installed && localApp && Boolean(displayVersion),
+      canOpenFolder: installed && !installBusy,
+      canOpenPackageFolder: installed && localApp && Boolean(displayVersion) && !installBusy,
       canOpenFactorySession: Boolean(factoryAgentSessionId),
       canPublishFactoryUpdate: installed && factoryJob?.status === "ready" && Boolean(factoryJob.publishedVersion?.trim()),
-      canUninstall: installed,
+      canUninstall: installed && !installBusy,
       canRetry,
       canUpdate,
       ...factoryAgentSessionId ? { factoryAgentSessionId } : {},
+      ...factoryEditAction ? { factoryEditAction } : {},
       ...factoryJob?.jobId ? { factoryJobId: factoryJob.jobId } : {},
       ...factoryJob?.provider ? { factoryProvider: factoryJob.provider } : {},
-      ...runtime?.error?.message ? { errorMessage: runtime.error.message } : {}
+      ...runtime?.error?.message ? { errorMessage: runtime.error.message } : {},
+      ...runtime?.installProgress ? { installProgress: runtime.installProgress } : {}
     };
   }).sort((left, right) => left.name.localeCompare(right.name));
   return {
@@ -1662,7 +1829,8 @@ function createRuntimeStateMaps(runtimeStates) {
   for (const state of runtimeStates) {
     const runtime = {
       ...state,
-      status: mapWorkspaceAppRuntimeStatus(state.status)
+      status: mapWorkspaceAppRuntimeStatus(state.status),
+      installProgress: state.installProgress ?? null
     };
     const installationId = normalizeOptionalString(runtime.installationId);
     if (installationId) {
@@ -1688,6 +1856,15 @@ function findRuntimeStateForApp(maps, appId, installationId) {
   }
   return maps.fallbackByAppId.get(appId);
 }
+function resolveRuntimeStatusForViewModel(runtime) {
+  if (!runtime) {
+    return "idle";
+  }
+  if (runtime.installProgress != null && runtime.status === "idle") {
+    return "installing";
+  }
+  return runtime.status;
+}
 function resolveCatalogSourceKind(catalog) {
   return catalog?.source?.kind ?? "bundled";
 }
@@ -1734,6 +1911,16 @@ function normalizeOptionalString(value) {
   const normalized = value?.trim() ?? "";
   return normalized.length > 0 ? normalized : null;
 }
+function resolveWorkspaceAppIconUrl(app) {
+  const manifestIconUrl = normalizeOptionalString(app.manifest.icon?.src);
+  if (manifestIconUrl && isResolvedIconUrl(manifestIconUrl)) {
+    return manifestIconUrl;
+  }
+  return normalizeOptionalString(app.availableIconUrl) ?? manifestIconUrl;
+}
+function isResolvedIconUrl(value) {
+  return /^[a-z][a-z0-9+.-]*:/iu.test(value) || value.startsWith("/");
+}
 function resolvePrimaryAction(input) {
   if (input.comingSoon) {
     return "none";
@@ -1819,7 +2006,7 @@ function createFactoryJobViewModel(job) {
     canFix: canFixValidationFailure,
     canOpenAgentSession: Boolean(agentSessionId),
     canPublish: job.status === "ready",
-    canRetryValidation: canFixValidationFailure,
+    canRetryValidation: false,
     failureReason: job.failureReason,
     updatedAtUnixMs: job.updatedAtUnixMs
   };
@@ -1854,4 +2041,4 @@ export {
   resolveWorkspaceAppCatalogMetadata,
   createWorkspaceAppRecord
 };
-//# sourceMappingURL=chunk-5SANC3S6.js.map
+//# sourceMappingURL=chunk-DPJRK63W.js.map