every plugin route renders a workspace, and it is not a rule you can forget

an exclusionary rule, made structural. a plugin does not render a screen: it
contributes panels and says how they are arranged, and the shell renders
WorkspaceView around them.

    web/panels.ts   appRegistryMetas — at least one panel
    web/layout.ts   defaultLayout — how they are arranged

both required the moment web/ exists, and missing either is refused at discovery
by name and with the reason. tested:

    probeplug: has a web/ directory but is missing web/layout.ts.
    Every plugin route renders a Workspace: contribute panels and a layout,
    not a screen.

there is deliberately no way to export a component. one that could would be free
to render a bare div, a full-page form, or its own navigation, and the platform
would become a shell hosting strangers' layouts rather than one application.
non-compliance is not so much refused as unrepresentable — there is nowhere to
put a screen.

the shell registers <prefix> and <prefix>/:section, exactly as the core screens
do, so a plugin's sections stay addressable and cmd-clickable, and panels read
useParams independently rather than passing state between themselves.
appTypes.allowed is pinned to that plugin's own keys, so a persisted layout
naming something else falls back instead of rendering another plugin's panel
inside this screen.

the example plugin is rebuilt to model it — two panels, a layout, one of them
calling its own /api/example/ping through useClient — because the reference
implementation is what everyone copies.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>

src/apps/officer-web/Screens/Dashboard/Settings/ServerSettings/AIHarnessesSection.tsx

@@ -466,7 +466,9 @@ export const AIHarnessesSection = () => {
                           className="h-7 text-xs flex-1"
                           placeholder={getStoredMasked(provider.providerId) || 'Enter API key'}
                           value={keyInputs[provider.providerId] ?? ''}
-                          onChange={(ev) => setKeyInputs((prev) => ({ ...prev, [provider.providerId]: ev.target.value }))}
+                          onChange={(ev) =>
+                            setKeyInputs((prev) => ({ ...prev, [provider.providerId]: ev.target.value }))
+                          }
                           onKeyDown={(ev) => {
                             if (ev.key === 'Enter' && keyInputs[provider.providerId]) saveApiKey(provider.providerId);
                             if (ev.key === 'Escape') setEditingProvider(null);
@@ -496,7 +498,8 @@ export const AIHarnessesSection = () => {
                 {editingProvider &&
                   (() => {
                     const provider = CHAT_PROVIDERS.find((p) => p.key === editingProvider);
-                    if (!provider || connectedProviders.some((cp) => cp.providerId === provider.providerId)) return null;
+                    if (!provider || connectedProviders.some((cp) => cp.providerId === provider.providerId))
+                      return null;
                     return (
                       <div key={provider.providerId} className="flex items-center gap-2">
                         <label className="w-36 text-duck-dark/70 dark:text-foreground/70 shrink-0 truncate font-medium text-[11px]">
@@ -507,7 +510,9 @@ export const AIHarnessesSection = () => {
                           className="h-7 text-xs flex-1"
                           placeholder="Enter API key"
                           value={keyInputs[provider.providerId] ?? ''}
-                          onChange={(ev) => setKeyInputs((prev) => ({ ...prev, [provider.providerId]: ev.target.value }))}
+                          onChange={(ev) =>
+                            setKeyInputs((prev) => ({ ...prev, [provider.providerId]: ev.target.value }))
+                          }
                           onKeyDown={(ev) => {
                             if (ev.key === 'Enter' && keyInputs[provider.providerId]) saveApiKey(provider.providerId);
                             if (ev.key === 'Escape') setEditingProvider(null);