OUT-3981 | Client UI: dynamic Studio app rows in Your Actions

[arpandhakal]

Changes

Renders a "Your Actions" row for each registered Studio app the signed-in client has unread notifications from — as [Verb] [count] [noun] (e.g. "Review 3 documents"), visually indistinguishable from built-in rows.

• installed-apps/lib/dynamic-action.ts — DynamicActionDefinition + toDynamicActionDefinition() synthesizes a row from an ActionableInstallDto (OUT-3979): verb ← actionLabel.verb, label ← pluralNoun, singularLabel ← singularNoun, icon mapped onto the design-system Icon (fallback CustomApps), plus installId/appId. Also exports the RenderableAction union and isDynamicAction() guard.
• installed-apps/lib/icon-names.ts — runtime allow-list of valid design-system IconType names + isIconType(). The package does not expose its icon registry at runtime (its exports map blocks the subpath), so we snapshot the names to validate arbitrary install icon strings before rendering.
• useEnabledActions — merges dynamic definitions after the built-ins (no drag-order participation in v1), filtered by actions.hiddenAppIds (OUT-3978, deny-list by appId).
• ActionItem / ActionsCard — render the RenderableAction union: dynamic count from the per-app apps map (OUT-3980); navigation via postMessage({ type: 'history.push', id: installId, route: 'apps' }); dynamic rows never render a zero/empty state in any mode.
• Widened ActionDefinition.icon to IconType so built-in and dynamic rows share the field. Built-in rows unchanged in behavior and appearance.

Testing Criteria

• As a client with unread notifications from an installed Studio app that has a registered action label, confirm a row appears reading [verb] [count] [noun], styled identically to built-in rows.
• Count of 1 uses the singular noun; 2+ uses the plural.
• Row is hidden entirely when the app's unread count is 0 (never a "0 items" row).
• Clicking the row opens the app in the parent portal (history.push → apps with the install id).
• An app whose appId is in actions.hiddenAppIds does not render.
• An install with an unrecognized/absent icon falls back to the CustomApps glyph.
• Built-in rows (invoices/contracts/tasks/forms) unchanged in appearance and behavior.
• pnpm typecheck and pnpm lint pass.
• Loom video: TODO

Notes

• Stacked on OUT-3980 (per-app counts, base branch) with OUT-3979 (actionable-installs discovery endpoint) merged in. Also depends on OUT-3978 (hiddenAppIds, already in feature/studio-apps-action). Merge order: 3979 → 3980 → 3981 into feature/studio-apps-action.
• icon-names.ts is a snapshot of the design-system icon set; regenerate if the design system adds icons. Staleness is safe — a newly-added icon simply falls back to CustomApps.

Impact & Surface Area of Change

• useEnabledActions now depends on useInstalledApps (a workspace-scoped React Query) and returns a RenderableAction[] union instead of ActionDefinition[]. Only consumer is ActionsCard; the editor sidebar uses its own useActions and is unaffected.
• ActionDefinition.icon widened from the 4-value ActionItemIcon to IconType — verify built-in action icons still render.
• Worth a regression check on the "Your Actions" card in all three surfaces (editor, preview, client/readonly).

🤖 Generated with Claude Code

[linear-code]

OUT-3981

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
client-home-v3	Ready	Preview, Comment	Jul 27, 2026 11:10am

[greptile-apps]

Greptile Summary

Adds workspace-scoped discovery and rendering of actionable Studio app installs.

• Introduces an authenticated installed-apps API and service that retrieves active installs with registered action labels.
• Converts eligible installs into dynamic action definitions with validated design-system icons.
• Merges dynamic rows with built-in actions, applies the hidden-app deny-list, and resolves unread counts by app ID.
• Navigates dynamic rows to their corresponding install in the parent portal.

Confidence Score: 5/5

The PR appears safe to merge, with no concrete changed-code-triggered failures established.

The new endpoint is authenticated, dynamic install metadata is validated before rendering, empty app actions are suppressed, and navigation retains the install-specific identifier.

Important Files Changed

Filename	Overview
src/features/installed-apps/lib/installed-apps.service.ts	Retrieves active installs, fetches each notification action label, and isolates individual settings-fetch failures.
src/features/settings/hooks/useEnabledActions.ts	Appends dynamic install actions after enabled built-ins and filters them using hidden app IDs.
src/features/action-items/components/actions-card.tsx	Resolves per-app counts, suppresses empty dynamic rows, and renders built-in and dynamic actions together.
src/features/action-items/components/action-item.tsx	Renders dynamic labels and routes dynamic action clicks to the associated app install.
src/features/installed-apps/hooks/useInstalledApps.ts	Adds a workspace-keyed query for validated actionable-install data.
src/features/installed-apps/lib/dynamic-action.ts	Defines the renderable action union and maps install metadata into presentation fields.
src/app/routes.ts	Registers the installed-apps endpoint for authenticated internal and client users.

Flowchart

%%{init: {'theme': 'neutral'}}%%
flowchart LR
  A[ActionsCard] --> B[useEnabledActions]
  B --> C[useInstalledApps]
  C --> D[GET /api/installed-apps]
  D --> E[InstalledAppsService]
  E --> F[Assembly installs and notification settings]
  B --> G[Dynamic action definitions]
  H[Notification counts by appId] --> A
  G --> A
  A --> I[Visible action rows]
  I --> J[Parent portal history.push by installId]

Loading

_{Reviews (1): Last reviewed commit: "feat(OUT-3981): render dynamic Studio ap..." | Re-trigger Greptile}