gemstone-nexus · Phase 6

DOC — Didymus orchestration & desktop bridge (practitioner punchlist)

← Documents

Metadata

iddoc_idtitlecategorysource_pathsummarycontent_hashindexed_at
50DOC-DIDYMUS-BRIDGE-PUNCHLISTDOC — Didymus orchestration & desktop bridge (practitioner punchlist)punchlistDevResources/docs/DOC-Didymus-Bridge-Punchlist.mdGemStone is the **orchestrator**. Practitioners connect AI workers (Cursor, Claude, Gemini, Ollama). Didymus shows approval-gated tasks and buffered conversation events linked to **registered** desktop sessions. Changes in the GemStone Agent window are mirrored into the Didymus relay as far as APIs allow; **desktop IDE chat windows are not claimed as live** until vendor bridge keys exist.e9463b68f802829297e552bc21764286db809b212026-08-06 19:15:30

Content

# DOC — Didymus orchestration & desktop bridge (practitioner punchlist)

**Date:** 2026-07-23 · **Status:** Scaffold + live execute path

## Product intent

GemStone is the **orchestrator**. Practitioners connect AI workers (Cursor, Claude, Gemini, Ollama). Didymus shows approval-gated tasks and buffered conversation events linked to **registered** desktop sessions. Changes in the GemStone Agent window are mirrored into the Didymus relay as far as APIs allow; **desktop IDE chat windows are not claimed as live** until vendor bridge keys exist.

## What works today

1. Per-practitioner vault keys (`/app/onboarding/workers`) + bouncing-ball guide modal.
2. Approval queue + **Execute** (`POST /api/didymus/tasks/{id}/execute`) → `mode: live|simulated`.
3. Bridge scaffold: `GET /api/didymus/bridge/status`, session register, event buffer, `WS /ws/didymus/bridge`.
4. Honest UI: `mirror_ready` stays false; `pushed_to_desktop` stays false; status lists `blocked_on_keys`.

## Secrets Mark must supply (DATARIGHT_DEV_SECRETS / host `.env`)

| Key | Purpose |
| --- | --- |
| `WORKER_SECRETS_KEY` | AES-GCM vault master (required for Connect UI) |
| `DIDYMUS_WORKER_CURSOR_TOKEN` | Cursor **Cloud Agents** execute (not IDE UI mirror) |
| `DIDYMUS_WORKER_CLAUDE_API_KEY` | Anthropic Messages API execute |
| `DIDYMUS_WORKER_GEMINI_API_KEY` / `GEMINI_API_KEY` | Gemini worker (+ voice) |
| `DIDYMUS_CURSOR_DEFAULT_REPO` | Optional default GitHub URL for Cursor tasks |
| *Future* Cursor/Claude **desktop bridge** tokens | True bidirectional IDE chat sync |

## Verify (bouncing ball)

1. Sign in → `/app/onboarding/workers` → vault available → Connect keys → badges **Connected (last4)**.
2. `/app/didymus` → Approve → Execute → status shows `live` (or `simulated` if no key).
3. Register a desktop session link → appears as **registered (not mirrored)**.
4. Bridge WS hint shows connected; buffered turns appear after Execute.

## Out of scope until keys/adapters exist

- Pushing Agent window turns into Cursor IDE / Claude Desktop chat panes in real time.
- Claiming “connected” for desktop UI when only Cloud Agents / Messages API keys are present.