gemstone-nexus · Phase 6
DOC — Didymus orchestration & desktop bridge (practitioner punchlist)
Metadata
| id | doc_id | title | category | source_path | summary | content_hash | indexed_at |
|---|---|---|---|---|---|---|---|
| 50 | DOC-DIDYMUS-BRIDGE-PUNCHLIST | DOC — Didymus orchestration & desktop bridge (practitioner punchlist) | punchlist | DevResources/docs/DOC-Didymus-Bridge-Punchlist.md | 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. | e9463b68f802829297e552bc21764286db809b21 | 2026-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.