Studio
The browser app for inspecting what Tarski derives and runs, including observations, facts, intents, effects, provenance, queries, and cloud state.
Studio is the browser app where you inspect a running Tarski app. You can view observations,
facts, intents, effects, activity, worldviews, and cloud state without reading raw store
files, and follow provenance from a fact or intent back to the observations that produced
it. The hosted Studio is at https://app.tarski.run.
Studio renders the platform’s observation-first model and does not keep a second source of truth. The browser keeps only interaction state (selected tab, focused row, open panel, draft forms). The backend owns semantic derivation, provenance traversal, action availability, mutation safety, query execution, and reconciliation. Every mutation carries an idempotency key and expected-state preconditions, destructive actions require two-step confirmation, and a disabled action always shows a backend-supplied reason.
Signing in
Studio shows a sign-in gate until you have a valid session. An unauthenticated, expired, or revoked session renders only the gate; the sidebar, command palette, and data surfaces do not mount.
- Enter your email address. Tarski sends a one-time sign-in code.
- Enter the code. Session cookies are set server-side (
HttpOnly; Secure; SameSite=Lax), and the app never stores durable bearer tokens in the browser. - The app boots into the shell. Sign-out revokes the server-side session.
Wrong, expired, replayed, or rate-limited codes return typed diagnostics. Deep links are retained in memory only and restored after sign-in, and signing in or out in one tab reconciles other open tabs.
For local development, tarski serve can mint a labeled fixture session for local Studio
work, but only when you explicitly set TARSKI_STUDIO_LOCAL_AUTH_FIXTURE=1. The session
shows an amber “fixture session” pill, and production authorities refuse the fixture entirely.
Without it, local boot shows guidance naming the fixture switch and tarski login.
The shell
- Sidebar: grouped navigation, collapsible to an icon rail (forced on small viewports); your collapse choice persists.
- Scope controls: organization (read-only) plus workspace, worldview, and environment selectors fed by backend catalogs. Scope switches are backend-confirmed: a blocking overlay locks the controls until the backend confirms, and only a confirmed response rewrites the URL scope.
- Command palette: Cmd/Ctrl+K merges “Go to…” navigation with the backend command catalog, including shortcut labels and disabled reasons.
- Inspector dock: a shell-level right dock; any row with inspector metadata opens it, and sections render in backend order.
- Status: a session-mode banner plus a runtime status pill that is green only for
production_authoritativeand amber otherwise.
Surfaces
| Group | Surface | What it shows |
|---|---|---|
| Studio | Overview / |
Summary cards, health, onboarding, create-from-template |
| Studio | Activity /activity |
The semantic event feed (observations, candidates, facts, proposals, decisions, intents, effects, gates) with filters, saved views, session follow, and a causal timeline inspector |
| Studio | Agents /agents |
Agent cards, dataflow topology, per-agent inspection, session catalog, and a chat panel whose composer is gated by backend authorization |
| Studio | Cloud /cloud |
Hosted apps with readiness evidence, metrics, provider bindings (credential metadata only; values are never shown), usage, and the admission/verification tab |
| Studio | Ontology /ontology |
Read-only relation catalog, admitted source text, and the rule dependency graph; you can inspect the ontology here but not edit it |
| Inspect | Observations, Facts, Intents, Effects, Events, Projections | The six semantic planes on one shared surface, so evidence and derived truth stay visually distinct; every row offers provenance handoffs |
| Inspect | Provenance /provenance |
Seed-driven neighborhood exploration as a deterministic graph; the only client-side control is a labeled, presentation-only view depth |
| Inspect | Workviews /workviews |
Workview and Work Queue read models; ambiguous queue rows render amber and hand off to Reconcile |
| Operate | Schedules /schedules |
Schedule list, fire history, receipts, preview-before-create; manifest-declared schedules surface tarski.toml guidance instead of edit controls |
| Operate | Storage /storage |
Usage, blob inventory, uploads, downloads, and dry-run-gated reclamation |
| Operate | Commands /commands |
The backend command catalog; replay, export, and GC run as preview-then-confirmed commits |
| Operate | Reconcile /reconcile |
Ambiguous-effect and contradiction queues, each preview-then-confirm with receipts |
| Operate | Query /query |
The query workbench: declared and ad-hoc runs, explain, saved queries, cross-door history, relation browsing, and access-audit reads |
| Operate | Settings, Account | Backend-validated settings, secrets metadata (values never rendered), identity, and confirmed sign-out |
You author observations on the Observations plane: draft a JSON payload, preview the atoms the mapper would deterministically emit, then append with a two-step confirm.
Design language and accessibility
Studio uses the Tarski design system: a deep blue background, volt yellow as a sparingly used accent (live dots, selection, focus rings, verified states), the ⊨ double-turnstile mark reserved for verified states, hairline surfaces without gradients, and IBM Plex Mono for every identifier, digest, count, and timestamp.
Studio has light and dark themes and a compact density mode for data-heavy views, and your choices persist across visits. WCAG AA contrast is enforced, focus is always visible, and every route passes automated accessibility checks with zero serious or critical violations in both themes.