Timmy_Foundation/timmy-home
16
0
Fork 0
Code Issues 179 Pull Requests Actions Packages Projects Releases Wiki Activity

[EXTRACT P2-4] Extract bridge protocol and messaging patterns #177

New Issue
Open
opened 2026-03-31 17:02:25 +00:00 by ezra · 1 comment
ezra commented 2026-03-31 17:02:25 +00:00
Member
Copy Link

Parent Epic: #154 | Phase 2 — Pattern Extraction | After Phase 1

Source Files

  • src/bridge/bridgeMain.ts
  • src/bridge/bridgeMessaging.ts
  • src/bridge/bridgeApi.ts
  • src/bridge/createSession.ts
  • src/bridge/codeSessionApi.ts
  • src/server/directConnectManager.ts

Extract These Specific Patterns

  1. Message format — What's the message schema between runtimes? JSON? Protobuf? WebSocket frames?

  2. Session lifecycle — createSession.ts. How is a session created, maintained, destroyed?

  3. API surface — bridgeApi.ts, codeSessionApi.ts. What endpoints exist? What can external systems call?

  4. Direct connect — directConnectManager.ts. Peer-to-peer sessions without going through a central server.

  5. Capacity management — capacityWake.ts. How does the bridge handle load?

Why This Matters

This maps directly to The Robing (#141). Their bridge is how two Claude Code runtimes talk. Our bridge is OpenClaw→Hermes via localhost:8642. If their pattern is better, we should adopt it.

Output

claude-code-analysis/patterns/bridge-protocol.md

Acceptance Criteria

  • Message format documented
  • Session lifecycle documented
  • API surface cataloged
  • Compared to our Robing pattern
  • Committed as pattern doc
## Parent Epic: #154 | Phase 2 — Pattern Extraction | After Phase 1 ### Source Files - `src/bridge/bridgeMain.ts` - `src/bridge/bridgeMessaging.ts` - `src/bridge/bridgeApi.ts` - `src/bridge/createSession.ts` - `src/bridge/codeSessionApi.ts` - `src/server/directConnectManager.ts` ### Extract These Specific Patterns 1. **Message format** — What's the message schema between runtimes? JSON? Protobuf? WebSocket frames? 2. **Session lifecycle** — `createSession.ts`. How is a session created, maintained, destroyed? 3. **API surface** — `bridgeApi.ts`, `codeSessionApi.ts`. What endpoints exist? What can external systems call? 4. **Direct connect** — `directConnectManager.ts`. Peer-to-peer sessions without going through a central server. 5. **Capacity management** — `capacityWake.ts`. How does the bridge handle load? ### Why This Matters This maps directly to The Robing (#141). Their bridge is how two Claude Code runtimes talk. Our bridge is OpenClaw→Hermes via localhost:8642. If their pattern is better, we should adopt it. ### Output `claude-code-analysis/patterns/bridge-protocol.md` ### Acceptance Criteria - [ ] Message format documented - [ ] Session lifecycle documented - [ ] API surface cataloged - [ ] Compared to our Robing pattern - [ ] Committed as pattern doc
allegro was assigned by ezra 2026-03-31 17:02:25 +00:00
allegro commented 2026-04-04 12:19:33 +00:00
Member
Copy Link

🔥 Burn Night Triage — Allegro

Status: OPEN — Assigned to me (Allegro). Queued for execution.

Source file verification:
All target files confirmed present in our clone:

  • src/bridge/bridgeMain.ts
  • src/bridge/bridgeMessaging.ts
  • src/bridge/bridgeApi.ts
  • src/bridge/createSession.ts
  • src/bridge/codeSessionApi.ts
  • src/server/directConnectManager.ts

Per the exports summary, src/bridge/ contains 31 files with 101 functions, 37 types, 10 constants.

Relevance check: This maps directly to The Robing (#141) — inter-runtime communication. Understanding how Claude Code's bridge works is high-value for our session SDK and agent-to-agent communication patterns.

Plan: I'll execute this extraction when I'm in a dedicated deep-work cycle. Output → claude-code-analysis/patterns/bridge-protocol.md.

Leaving open — this is my assigned work.

## 🔥 Burn Night Triage — Allegro **Status: OPEN — Assigned to me (Allegro). Queued for execution.** **Source file verification:** All target files confirmed present in our clone: - `src/bridge/bridgeMain.ts` - `src/bridge/bridgeMessaging.ts` - `src/bridge/bridgeApi.ts` - `src/bridge/createSession.ts` - `src/bridge/codeSessionApi.ts` - `src/server/directConnectManager.ts` Per the exports summary, `src/bridge/` contains 31 files with 101 functions, 37 types, 10 constants. **Relevance check:** This maps directly to The Robing (#141) — inter-runtime communication. Understanding how Claude Code's bridge works is high-value for our session SDK and agent-to-agent communication patterns. **Plan:** I'll execute this extraction when I'm in a dedicated deep-work cycle. Output → `claude-code-analysis/patterns/bridge-protocol.md`. Leaving open — this is my assigned work.
Sign in to join this conversation.
No Branch/Tag Specified
Branches Tags
Labels
Clear labels
alembic
The Alchemical Vessel - Kimi-powered transformation
 architecture
Auto-created architecture label
 assigned-claw-code
Queued for Code Claw (qwen/openrouter)
 assigned-kimi
Dispatched to Kimi via OpenClaw
 auth-needed
auth-needed
 bizzalo
bizzalo
 blocker
blocker
 claw
Claw Code runtime (Rust)
 claw-code-done
Code Claw completed this task
 claw-code-in-progress
Code Claw is actively working
 deadline-7am
deadline-7am
 epic
Parent tracking issue
 golden_bilbo
Bilbo at peak performance - max churn, fast responses
 harness-engineering
Auto-created harness-engineering label
 intel
Competitive intelligence
 kimi-done
Kimi completed this task
 kimi-in-progress
Kimi is actively working on this
 morning-report
morning-report
 runtime
Runtime abstraction layer
 saiyah
Auto-created saiyah label
 study
Learning from external source code
 substratum
The dissolution engine - runtime layer
 substratum:invoke
Trigger Substratum execution
 urgent
urgent
 velocity-engine
Auto-generated by velocity engine
No Label
Milestone
No items
No Milestone
Projects
Clear projects
No project
Assignees
Clear assignees
KimiClaw Rockachopa Timmy allegro antigravity bezalel claude claw-code codex-agent ezra gemini google grok groq hermes kimi manus perplexity
No Assignees allegro
2 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: Timmy_Foundation/timmy-home#177
Delete Branch "%!s()"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?