V1 Web PWA · Surface walkthrough

Isis Reasoning-Step Graph Structure Preview

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

walked
8sections3 minread
Markdown source
On this page

Context. surface studio · domain isis · route /studio/isis/conversational-ai · auth signed-in + Studio boundary; direct unauthenticated route is hard-blocked · source apps/oshun/web/src/app/studio/isis/conversational-ai/page.tsx

Last walked. 2026-07-21 isolated Chromium: direct hard block, anonymous redirect, exact catalog and POST, scope denial, adversarial catalog/result, direct BFF contract, axe, touch, and 390px containment; 9/9 with one worker and retries disabled

Purpose#

Admin-scoped, request-local structure checks over a caller-supplied reasoning- step graph. The input shorthand is n:TYPE:maxTokens:deps; the service reports dependency validation, topological order, dependency depth, and a declared token estimate with source-defined 1.2 overhead. It does not execute a model, expose hidden model reasoning, or create a conversation, session, transcript, realtime transport, speech, tool invocation, memory, artifact, governance record, release decision, mutation, or authoritative state.

Entry points#

  • Sibling quick-action from /studio/isis/music-generation
  • Studio index (/studio)
  • Direct URL or bookmark, subject to the Studio boundary

Layout regions#

page.tsx mounts <ShellLayout active="studio"> and three panels: the workspace, the route inventory, and sibling quick-actions.

  • Workspace panel (data-isis-conversational-ai-workspace):
    • one <h1>: "Isis Reasoning-Step Graph Structure Preview"
    • exact non-authoritative summary (data-isis-ca-summary)
    • disposition and source-defined step labels (data-isis-ca-disposition, data-isis-ca-step-types)
    • bounded graph form (data-isis-ca-analyze-form)
    • result (data-isis-ca-result) with structural validity, topological order, depth, declared token estimate, and issues
  • Route Map panel (data-isis-conversational-ai-route-map): one mounted route and four documented-contract shapes
  • Sibling quick-actions (data-isis-ca-quick-actions): music generation and Studio index links

States#

  • Loading — data-isis-ca-loading
  • Unauthorized — BFF 401/403 fail-closed; data-isis-ca-unauthorized
  • Catalog error — non-OK, network failure, or any non-exact successful catalog; data-isis-ca-error
  • Ready — exact catalog acknowledged and bounded form rendered
  • Input error — malformed or out-of-bounds shorthand is suppressed before POST; data-isis-ca-analyze-error
  • Result — exact input echo, disposition, keys, types, token arithmetic, and bounded structure acknowledged; data-isis-ca-result

Interactions#

Structure-preview form (data-isis-ca-analyze-form)#

  • Caller step graph (data-isis-ca-field-chain, textarea): 1–20 exact n:TYPE:maxTokens:deps segments
  • Preview graph structure (data-isis-ca-analyze-submit, 44px minimum) → POST /v1/admin/isis/conversational-ai/analyze

Route inventory#

  • One mounted route
  • Four documented shapes that do not imply pages or state

Sibling quick-actions#

  • Open Isis Music Generation workspace → /studio/isis/music-generation
  • Back to Studio workspace index → /studio

Data and contracts#

  • Read: GET /v1/admin/isis/conversational-ai returns the exact disposition, bounded input contract, six source-defined step labels, and the 1.2 declared-token overhead factor with Cache-Control: no-store
  • Request-local analysis: POST /v1/admin/isis/conversational-ai/analyze; exact root and step keys only
  • Bounds: 1–20 steps; step numbers 1–10,000; trimmed instruction length 1–2,000; per-step max tokens 1–100,000; at most 19 unique dependencies per step; at most 2,000,000 declared tokens total
  • Persistence and realtime: none
  • Auth: admin:*, admin:studio, or admin:workspace:isis; otherwise fail-closed
  • Component sources:
    • apps/oshun/web/src/components/studio/StudioIsisConversationalAIWorkspace.tsx
    • apps/oshun/web/src/components/studio/StudioIsisConversationalAIRouteMap.ts

Cross-references#

Known gaps#

  • The legacy path retains conversational-ai, but the mounted capability is only a reasoning-step graph structure preview.
  • The scene, export, revision, and governance paths are documented shapes, not mounted pages or state.
  • No provider/model execution, conversational runtime, durable state, artifact, governance, or release authority is connected.