---
path: /studio/isis/conversational-ai
surface: studio
domain: isis
auth: signed-in + Studio boundary; direct unauthenticated route is hard-blocked
source: apps/oshun/web/src/app/studio/isis/conversational-ai/page.tsx
status: walked
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'
---

# Isis Reasoning-Step Graph Structure Preview

## 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

- Studio overview: [`../../studio-overview.md`](../../studio-overview.md)
- Sibling routes:
  - [`studio-isis-music-generation.md`](./studio-isis-music-generation.md)
  - [`studio-isis-audio-generation.md`](./studio-isis-audio-generation.md)

## 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.