--- path: /studio/isis/comfyui-sdk surface: studio domain: isis auth: signed-in + studio entitlement (AAA-gated — segment `comfyui-sdk` in `AAA_ONLY_STUDIO_ROUTES`) source: apps/oshun/web/src/app/studio/isis/comfyui-sdk/page.tsx status: walked last_walked: '2026-07-24 automated Chromium + Pixel 7 walk — production hard-block, localhost-only entry, real semver form, exact hybrid authority boundary, route status, touch targets, responsive containment, and applicable axe verified' --- # Isis ComfyUI SDK ## Purpose Request-local, non-authoritative semantic-version evaluator with embedded lanes. It hosts one directly-owned wired lane — Node Versioning & Compatibility, via `/v1/admin/isis/comfyui-sdk` — plus five sibling lane workspaces (ComfyUI Nodes, ComfyUI Integration, Workflow Definitions, Client SDK, Generation API). Apart from the versioning lane it owns no `/v1` fetch. It retains no package/release state and owns no distribution, diagnostic/evidence, parity, governance, approval, or release authority. ## Entry points - Breadcrumb in-page (`data-isis-comfyui-sdk-breadcrumbs`) - Sibling quick-actions: `/studio/isis/client-sdk`, `/studio/isis/comfyui-integration`, `/studio/isis/comfyui-nodes` - Studio index (`/studio`) - Direct URL / bookmark (AAA entitlement required) ## Layout regions `page.tsx` mounts `` plus a breadcrumb panel, the workspace, the Route Map, and sibling quick-actions. - **Header**: shell header - **Breadcrumb panel** (`data-isis-comfyui-sdk-breadcrumbs`) - **Workspace panel** (`data-isis-comfyui-sdk-workspace`): - `

` (`WorkspaceHeading`) "Isis ComfyUI SDK Workspace" - Summary paragraph (`data-isis-comfyui-sdk-summary`) - Exact `request_local_non_authoritative_semver_evaluation_with_embedded_lane_composition` disposition and four-card **Authority Boundary** - **Node Versioning & Compatibility lane** (`StudioIsisComfyuiSdkVersioningLane`, `

Node Versioning & Compatibility

`) — the directly-owned wired lane (GET `/v1/admin/isis/comfyui-sdk`, POST `/v1/admin/isis/comfyui-sdk/evaluate`) - **ComfyUI Nodes Lane** (`data-isis-comfyui-sdk-comfyui-nodes-lane`) → `StudioIsisComfyuiNodesWorkspace` - **ComfyUI Integration Lane** (`data-isis-comfyui-sdk-comfyui-integration-lane`) → `StudioIsisComfyUIIntegrationWorkspace` - **Workflow Definitions Lane** (`data-isis-comfyui-sdk-workflow-definitions-lane`) → `StudioIsisWorkflowDefinitionsWorkspace` - **Client SDK Lane** (`data-isis-comfyui-sdk-client-sdk-lane`) → `StudioIsisClientSdkWorkspace` - **Generation API Lane** (`data-isis-comfyui-sdk-generation-api-lane`) → `StudioIsisGenerationApiWorkspace` - **Route Map panel** (`data-isis-comfyui-sdk-route-map`): one `mounted-hybrid-tool` and five `documented-contract` entries - **Sibling quick-actions panel**: `/studio/isis/client-sdk`, `/studio/isis/comfyui-integration`, `/studio/isis/comfyui-nodes`, `/studio` ## States - [ ] **Node Versioning & Compatibility lane** — Loading / Unauthorized (admin 401/403) / Error / Ready / Result, via `/v1/admin/isis/comfyui-sdk` - [ ] **ComfyUI Nodes Lane** — see [`studio-isis-comfyui-nodes.md`](./studio-isis-comfyui-nodes.md) - [ ] **ComfyUI Integration Lane** — see [`studio-isis-comfyui-integration.md`](./studio-isis-comfyui-integration.md) - [ ] **Workflow Definitions Lane** — walk via its own route walkthrough - [ ] **Client SDK Lane** — see [`studio-isis-client-sdk.md`](./studio-isis-client-sdk.md) - [ ] **Generation API Lane** — see [`studio-isis-generation-api.md`](./studio-isis-generation-api.md) - [ ] **Gated (non-AAA)** — route AAA-gated; middleware blocks non-entitled users ## Interactions ### Capability Summary - [ ] **Capability article** ×4 — non-interactive ### Node Versioning & Compatibility lane (owned, wired) - [ ] Evaluates SDK version compatibility; POST `/v1/admin/isis/comfyui-sdk/evaluate` ### Embedded sibling lanes - [ ] **ComfyUI Nodes Lane** — walk in its own doc - [ ] **ComfyUI Integration Lane** — walk in its own doc - [ ] **Workflow Definitions Lane** — walk in its own doc - [ ] **Client SDK Lane** — walk in its own doc - [ ] **Generation API Lane** — walk in its own doc ### Route Map - [ ] **Route-map articles** ×6 ### Sibling quick-actions - [ ] **Open Isis Client SDK workspace** → `/studio/isis/client-sdk` - [ ] **Open Isis ComfyUI Integration workspace** → `/studio/isis/comfyui-integration` - [ ] **Open Isis ComfyUI Nodes workspace** → `/studio/isis/comfyui-nodes` - [ ] **Back to Studio workspace index** → `/studio` ## Data & contracts - **Reads**: the owned versioning lane reads `GET /v1/admin/isis/comfyui-sdk`; sibling lanes read their own endpoints - **Writes**: the owned versioning lane writes `POST /v1/admin/isis/comfyui-sdk/evaluate`; sibling lanes write their own - **Persistence**: none for version inputs or results; evaluation is request-local and recomputable - **Authority**: no package publish, distribution, migration, diagnostic/ evidence record, parity certification, audit, governance, approval, or release action - **Realtime**: none - **Caching**: versioning lane client fetch on mount, `cache: 'no-store'`, `buildBffAuthHeaders()` - **Auth/role check**: route AAA-gated (`comfyui-sdk` in `AAA_ONLY_STUDIO_ROUTES`); the versioning lane and each embedded lane are admin-scoped and fail closed - **Component sources**: - `apps/oshun/web/src/components/studio/StudioIsisComfyuiSdkWorkspace.tsx` - `apps/oshun/web/src/components/studio/StudioIsisComfyuiSdkVersioningLane.tsx` - `apps/oshun/web/src/components/studio/StudioIsisComfyuiSdkRouteMap.ts` ## Cross-references - Studio overview: [`../../studio-overview.md`](../../studio-overview.md) - AAA gating: `libs/isis/entitlements/src/studio-boundary.ts` - Embedded lanes: - [`studio-isis-comfyui-nodes.md`](./studio-isis-comfyui-nodes.md) - [`studio-isis-comfyui-integration.md`](./studio-isis-comfyui-integration.md) - [`studio-isis-client-sdk.md`](./studio-isis-client-sdk.md) - [`studio-isis-generation-api.md`](./studio-isis-generation-api.md) ## Open questions / known gaps - [ ] Apart from the owned versioning lane, the aggregator owns no backend call; sibling-lane coverage depends on each lane's own walkthrough - [ ] Package, release, diagnostics, parity, and governance paths are documented shapes only, with no pages or corresponding authority