V1 Web PWA · Surface walkthrough

Isis Provider Factory

A per-surface walkthrough of the V1 Web PWA studio surface: layout, states, interactions, data, and cross-references.

walked
8sections2 minread
Markdown source
On this page

Context. surface studio · domain isis · route /studio/isis/provider-factory · auth signed-in + studio entitlement (NOT AAA-gated) · source apps/oshun/web/src/app/studio/isis/provider-factory/page.tsx

Last walked. 2026-05-29 automated runtime walk (Playwright headless) — render, /v1 data (2xx), console/page-errors, expected content, screenshot verified; live screen-reader, touch, offline, and telemetry-delivery checks pending a manual AT pass. Evidence: WALKTHROUGH/results/runtime-sweep-2026-05-29.md; body re-derived 2026-06-03 from current source (lane-console architecture)

Purpose#

Read-only admin lane console exposing the real @isis/ai-providers multi-cloud ComfyUI provider registry. It lists each cloud provider with its endpoint paths and non-secret default config — base URL, GPU cost/hour, max concurrency, cold-start time, and warm-instance support. API keys are configured at deploy time, not here.

Entry points#

  • Sibling quick-action card from /studio/isis/unified-provider-architecture
  • Studio index (/studio)
  • Direct URL / bookmark

Layout regions#

page.tsx mounts ShellLayout active="studio" and three panels (no breadcrumb panel).

  • Workspace panel (data-isis-provider-factory-workspace):
    • <h1> "Isis Provider Factory Workspace" (WorkspaceHeading)
    • Summary paragraph (data-isis-provider-factory-summary)
    • Registered-providers section (<h2> "Registered cloud providers (N)") of data-provider-factory-entry cards, each showing data-provider-factory-base-url, data-provider-factory-cost, and data-provider-factory-submit (submit endpoint)
  • Route map panel (data-isis-provider-factory-route-map): <h2> "Route Map" enumerating STUDIO_ISIS_PROVIDER_FACTORY_ROUTE_MAP
  • Quick-actions panel: quickAction links to /studio/isis/unified-provider-architecture and "Back to Studio workspace index" → /studio

States#

  • Loading — data-provider-factory-loading "Loading provider registry…"
  • Unauthorized — data-provider-factory-unauthorized (admin-scope fail-closed on 401/403, "Isis workspace scope required to view the provider factory.")
  • Error — data-provider-factory-error on non-OK / malformed response
  • Ready — registered-providers cards render

Interactions#

Provider registry#

  • Provider cards — non-interactive read-only entries (data-provider-factory-entry); no form / write verb

Route map#

  • Route-map articles — non-interactive path + purpose entries

Quick-actions#

  • Open Isis Unified Provider Architecture workspace → /studio/isis/unified-provider-architecture
  • Back to Studio workspace index → /studio

Data & contracts#

  • Reads: GET /v1/admin/isis/provider-factory (PROVIDER_FACTORY_ENDPOINT) on mount — providers + registry
  • Writes: None (read-only registry view)
  • Realtime: None
  • Caching: client fetch on mount, cache: 'no-store', buildBffAuthHeaders()
  • Auth: admin-scoped fail-closed (401/403 → unauthorized state); route behind the signed-in + studio proxy gate
  • Component sources:
    • apps/oshun/web/src/components/studio/StudioIsisProviderFactoryWorkspace.tsx
    • apps/oshun/web/src/components/studio/StudioIsisProviderFactoryRouteMap.ts

Cross-references#

Open questions / known gaps#

  • Config shown is the non-secret deterministic registry; live provider instances require per-cloud API keys provisioned at deploy time
  • No way to register / edit a provider from this surface — read-only by design