Files
claw3d/tests/unit/useRuntimeConnection.test.ts
gsknnft 083c146aac feat: add runtime seam, Hermes adapter support, and demo gateway mode (#89)
* fix: include kanbanImmersive in immersiveOverlayActive calculation

When Kanban board is open, HUD elements (camera preset buttons, edit toolbar, overlays) should be suppressed. The kanbanImmersive flag was defined but not included in the immersiveOverlayActive condition, causing HUD elements to remain visible.

This fix adds kanbanImmersive to the immersiveOverlayActive calculation so HUD elements are properly hidden when the Kanban board is open.

Co-authored-by: Luke The Dev <iamlukethedev@users.noreply.github.com>

* Fix: Hide mini status bar when Kanban immersive overlay is open

Wraps the bottom-left mini status bar (showing agent stats, vibe score, and
control hints) with !immersiveOverlayActive check to match the behavior of
other HUD elements like camera controls and toolbar.

This ensures the status bar is properly hidden when the Kanban board or any
other immersive overlay is active, maintaining a clean immersive experience.

Co-authored-by: Luke The Dev <iamlukethedev@users.noreply.github.com>

* chore: drop unrelated package-lock line from branch

Co-authored-by: Luke The Dev <iamlukethedev@users.noreply.github.com>

* universal-backend-plan

* backend-neutral runtime seam

* package.json update

* feat: add Hermes gateway adapter as alternative to OpenClaw

Adds a WebSocket adapter that lets Claw3D connect to a Hermes AI agent
runtime without any changes to the frontend. The adapter implements the
full Claw3D gateway protocol and bridges it to the Hermes HTTP API.

Changes:
- server/hermes-gateway-adapter.js: WebSocket bridge implementing the
  Claw3D gateway protocol against the Hermes HTTP API. Supports all
  core methods (agents, sessions, chat streaming, cron, config, files,
  approvals) and multi-agent orchestration via spawn_agent/delegate_task
  tools. Persists conversation history to ~/.hermes/clawd3d-history.json.
- scripts/clawd3d-start.sh: All-in-one startup script that launches
  Hermes, the adapter, and the Next.js dev server with auto port
  conflict resolution. Alias as `claw3d` for convenience.
- src/features/office/hooks/useCronAgents.ts: Hook that polls the
  gateway for cron-scheduled agents and surfaces them in the 3D office.
- package.json: adds `hermes-adapter` npm script
- .env.example: documents Hermes config vars
- docs/hermes-gateway.md: setup guide and protocol reference

Usage:
  npm run hermes-adapter   # start adapter (connect to http://localhost:8642)
  npm run dev              # start Claw3D, point browser at localhost:3000
  # or: bash scripts/clawd3d-start.sh  (starts everything automatically)

Both OpenClaw and Hermes are supported simultaneously — the gateway URL
in NEXT_PUBLIC_GATEWAY_URL determines which backend Claw3D connects to.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

* feat: add read_agent_context tool for cross-agent coordination

Agents can now read each other's conversation history via the
read_agent_context tool, enabling the orchestrator to check what
a sub-agent has done before re-delegating work.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

* feat: wire Hermes office UX and role-aware runtime updates

* feature update - demomode & hermes adapter

* fix lint blockers

* lintfix #2

* fix: stabilize retro office camera preset callbacks

* Initial plan

* fix: stabilize retro office overview preset hooks

Agent-Logs-Url: https://github.com/gsknnft/Claw3D/sessions/9cc71555-591e-44cf-aec4-25affbdcb405

Co-authored-by: gsknnft <123185582+gsknnft@users.noreply.github.com>

* feat: add truthful backend selection, Hermes adapter hardening, and demo gateway mode

* fix: address bugbot review and finalize backend selection

* fixed - onboarding and hermes calls

* office systems roadmap

* feat specs in docs

* specs ready

* feat: continue custom runtime seam and gateway alignment

* custom lane wired

* feat: add custom runtime provider path and office runtime alignment

* runtime fixes

* fix lukes findings

* fix lukes findings #2

* stable UI & connect screen page -> overlay

* better baseline for connection

* stable providers & ui rendering

* best launch yet

* nearly no gateway on reconnect

* auto reconnect last state

* fix: preserve selected runtime across reconnects

Keep backend selection aligned with the operator's chosen runtime instead of reviving a mismatched last-known-good adapter, and keep custom runtimes prompting for reconnect when Studio cannot auto-connect them.

Made-with: Cursor

---------

Co-authored-by: Cursor Agent <cursoragent@cursor.com>
Co-authored-by: Luke The Dev <iamlukethedev@users.noreply.github.com>
Co-authored-by: Elias Pfeffer <eliaspfeffer@gmail.com>
Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>
Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>
Co-authored-by: iamlukethedev <lucas.guilherme@smartwayslfl.com>
2026-04-02 15:27:24 -05:00

96 lines
3.0 KiB
TypeScript

import { createElement } from "react";
import { afterEach, describe, expect, it, vi } from "vitest";
import { cleanup, render, screen } from "@testing-library/react";
describe("useRuntimeConnection", () => {
afterEach(() => {
cleanup();
vi.resetModules();
vi.restoreAllMocks();
});
it("selects the hermes provider from the active adapter type", async () => {
vi.doMock("@/lib/gateway/GatewayClient", () => ({
useGatewayConnection: () => ({
client: {},
status: "connected",
gatewayUrl: "ws://localhost:18789",
token: "",
selectedAdapterType: "hermes",
detectedAdapterType: "hermes",
activeAdapterType: "hermes",
localGatewayDefaults: null,
error: null,
connectPromptReady: true,
shouldPromptForConnect: false,
connect: async () => {},
disconnect: () => {},
useLocalGatewayDefaults: () => {},
setGatewayUrl: () => {},
setToken: () => {},
setSelectedAdapterType: () => {},
clearError: () => {},
}),
}));
const { useRuntimeConnection } = await import("@/lib/runtime/useRuntimeConnection");
const Probe = () => {
const state = useRuntimeConnection({} as never);
return createElement(
"div",
null,
createElement("div", { "data-testid": "providerId" }, state.providerId),
createElement("div", { "data-testid": "providerLabel" }, state.providerLabel)
);
};
render(createElement(Probe));
expect(screen.getByTestId("providerId")).toHaveTextContent("hermes");
expect(screen.getByTestId("providerLabel")).toHaveTextContent("Hermes");
});
it("selects the custom provider from the active adapter type", async () => {
vi.doMock("@/lib/gateway/GatewayClient", () => ({
useGatewayConnection: () => ({
client: {},
status: "connected",
gatewayUrl: "http://127.0.0.1:7770",
token: "",
selectedAdapterType: "custom",
detectedAdapterType: "custom",
activeAdapterType: "custom",
localGatewayDefaults: null,
error: null,
connectPromptReady: true,
shouldPromptForConnect: false,
connect: async () => {},
disconnect: () => {},
useLocalGatewayDefaults: () => {},
setGatewayUrl: () => {},
setToken: () => {},
setSelectedAdapterType: () => {},
clearError: () => {},
}),
}));
const { useRuntimeConnection } = await import("@/lib/runtime/useRuntimeConnection");
const Probe = () => {
const state = useRuntimeConnection({} as never);
return createElement(
"div",
null,
createElement("div", { "data-testid": "providerId" }, state.providerId),
createElement("div", { "data-testid": "providerLabel" }, state.providerLabel)
);
};
render(createElement(Probe));
expect(screen.getByTestId("providerId")).toHaveTextContent("custom");
expect(screen.getByTestId("providerLabel")).toHaveTextContent("Custom");
});
});