Merges a significant refactor of agent action gating into a unified `gating-classifications.ts` module shared across permanent agents and executor gating logic, plus new glasses quick-capture support with dedicated routes and parser, and a fix restoring step progress visibility during task execution Fusion-Task-Id: FN-3742
Even Realities Glasses Plugin (Fusion)
@fusion-plugin-examples/even-realities-glasses is a standalone Fusion plugin that provides a task-centric card workflow for Even Realities glasses.
Scope (v1)
- Read board/task status through Fusion dashboard HTTP APIs (
/api/tasks*) - Quick capture text into new tasks
- Polling-based task transition notifications
- Agent actions: start work (
in-progress) and request review (in-review)
Out of scope in v1: missions, roadmaps, search, multi-project routing, cloud/remote deployment orchestration.
Install (workspace local)
From repo root:
pnpm install
pnpm --filter @fusion-plugin-examples/even-realities-glasses build
pnpm --filter @fusion-plugin-examples/even-realities-glasses test
Required settings
fusionApiBaseUrl(defaulthttp://localhost:4040)fusionApiToken(required Bearer token)glassesDeviceId(optional identifier)pollingIntervalSeconds(default 30, min 5)notifyOnColumns(default["in-review"])quickCaptureDefaultColumn(defaulttriage)enableAgentActions(defaulttrue)
Quick capture
Use POST /quick-capture for one-gesture glasses capture (POST /tasks is still the general-purpose route).
Pipeline:
- Strip leading wake phrase (
hey fusion,fusion,ok fusion,note,task,capture) - Strip filler tokens (
um,uh,er,like,you know) and transcript punctuation noise - Split first sentence into title + description (title capped at 80 chars; overflow moved into description)
- Resolve column from request
columnor plugin settingquickCaptureDefaultColumn(fallbacktriage)
Example:
curl -X POST http://localhost:4040/api/plugins/fusion-plugin-even-realities-glasses/quick-capture \
-H "Authorization: Bearer <apiKey>" \
-H "Content-Type: application/json" \
-d '{"text":"hey fusion, file a bug about the merge gate"}'
Response:
{
"task": {
"id": "FN-1234",
"description": "file a bug about the merge gate\nfile a bug about the merge gate",
"column": "triage"
},
"card": {
"id": "task-FN-1234",
"kind": "task",
"title": "FN-1234: file a bug about the merge gate",
"bodyLines": [
"file a bug about the merge gate\nfile a bug about the merge gate",
"Column: triage"
],
"accentColor": "yellow"
}
}
Security notes
- Uses
Authorization: Bearer <token>for all API requests. - Prefer local/self-hosted Fusion instances and avoid exposing dashboard APIs to public networks.
- Treat
fusionApiTokenas secret material and rotate regularly.
Transport extension point
The plugin intentionally uses GlassesTransport + StubGlassesTransport for now. The real Even Realities BLE/SDK transport should be wired behind this interface.
Dependency research task FN-3737 was not available in this task runtime, so no concrete protocol implementation is included yet. Integrate the real SDK by replacing the stub transport in src/index.ts while keeping route + notifier behavior unchanged.