Loading prompt...

Hook Observability and Session Replay | Evokore

🤖system prompt•6 months ago

Hook Observability and Session Replay

Instrument hooks with replayable logs, task-state visibility, and non-blocking observability around agent sessions.

devops

Quality

👁️0 views

docs

>Payload Data

Editable Format

# Hook Observability and Session Replay

Imported from curated first-party documentation sources.

## What this covers
Use this skill when you need to understand what hooks fired, what they emitted, and how a session can be replayed after the fact.

## Use this when
- Debugging hook-driven automation
- Replaying session events after failures
- Adding observability without blocking interactive work

## Expected outcomes
- Hook activity becomes inspectable and replayable
- Operational state survives beyond a single terminal session
- Observability stays useful without overwhelming operators

## Source synthesis
- EVOKORE-MCP/docs/VOICE_AND_HOOKS.md (https://github.com/mattmre/EVOKORE-MCP/blob/main/docs/VOICE_AND_HOOKS.md)
- EVOKORE-MCP/docs/USE_CASES_AND_WALKTHROUGHS.md (https://github.com/mattmre/EVOKORE-MCP/blob/main/docs/USE_CASES_AND_WALKTHROUGHS.md)

## Dedupe notes
Focuses on replay and observability instead of importing the broader voice-sidecar guide verbatim.

## Source excerpts

### EVOKORE-MCP/docs/VOICE_AND_HOOKS.md
EVOKORE currently has three separate voice-related systems plus a set of hook and observability utilities. They overlap in operator workflows, but they are not the same runtime.

## The three voice-related systems

### 1. ElevenLabs MCP proxy

This is the optional `elevenlabs` child server configured in `mcp.config.json`.

What it is:

- proxied through the EVOKORE router
- exposed as prefixed MCP tools
- available to any EVOKORE-connected MCP client when configured successfully

What it is for:

- text-to-speech and other ElevenLabs MCP operations as tools
- routing voice-related actions through the standard EVOKORE proxy/security stack

Requirements:

- `uvx` available on PATH
- `ELEVENLABS_API_KEY` set

### 2. VoiceMode

VoiceMode is a separate voice-conversation system for Claude Code.

What it is:

- registered separately from EVOKORE
- not routed through EVOKOREâ€™s stdio server
- used for bidirectional voice conversation in Claude Code

What it is for:

- speaking to Claude and hearing spoken responses
- using `OPENAI_API_KEY` and VoiceModeâ€™s own runtime

Windows note:

- VoiceMode relies on `uvx` being directly available
- set `OPENAI_API_KEY` in the shell that launches Claude Code

### 3. VoiceSidecar

VoiceSidecar is a standalone WebSocket server implemented in `src/Voice
...

### EVOKORE-MCP/docs/USE_CASES_AND_WALKTHROUGHS.md
This guide turns the runtime contracts into practical operator flows.

## Walkthrough 1: Adopt a workflow from the skill library

Use this when you want EVOKORE to retrieve process guidance before the model starts acting.

### Goal

Find and adopt an existing workflow such as `session-wrap`.

### Steps

1. Ask the client to search skills:

```text
   Search the MCP for a workflow about session wrap-up and continuity.
   ```

2. EVOKORE uses `search_skills` and returns matching skills.
3. Ask for a specific skill:

```text
   Show me help for the session-wrap skill.
   ```

4. EVOKORE uses `get_skill_help` and returns the skillâ€™s internal instructions.
5. For broader task matching, ask:

```text
   Resolve a workflow for wrapping this session, documenting open risks, and preparing the next handoff.
   ```

6. EVOKORE uses `resolve_workflow` and injects the top 1-3 relevant workflows directly into the tool response.

### Why this matters

- keeps the model grounded in repo-specific process
- reduces prompt drift
- makes handoff and governance behavior repeatable

## Walkthrough 2: Use a proxied tool that requires HITL approval

Use this when the tool is configured as `require_approval` in `permissions.yml`.

### Goal

Allow a protected proxied tool call such as `fs_write_f
...

Source

https://github.com/mattmre/EVOKORE-MCP/blob/main/docs/VOICE_AND_HOOKS.md

SIMILAR_PROMPTS

SCANNING_SIMILARITY...