HalfPint Command

Operator console for the HalfPint agent — inspect traces, sessions, and model memory.

Overview

Live SQLite counts and shortcuts for this HalfPint agent process only (not LangGraph or Postgres).

Health at a glance. Chips reflect the running service; stat cards count rows in the local trace database. Use the sidebar for deep inspection.

Shortcuts

Chat UI

Operator chat — needs admin session to open HTML.

Site /chat

Root chat route on this host.

GET /health

JSON liveness from API base.

Swagger UI

Interactive API explorer.

Traces

Browse execution traces with filters.

Reports

Summary metrics + CSV export.

openapi.json

Schema for codegen or docs.

API base

Use for curl, MCP, or reverse-proxy checks. JWT + cookie accepted on /v1/admin/*.

SQLite path:

Traces

Agent turns. Filters stack with AND. Bookmark this tab.

Browse traces. First page loads when you open this tab. Use pagination for older rows. Click a row for full JSON.

Conversations

Messages load as a chat transcript (like the main chat UI). Newest page of rows shown; use pagination for older turns. Bookmark. Clearing a session removes all stored messages for that id.

Transcript view. Exact match on ids and role except “content contains”. Newest page first; scroll to read chronologically.
Destructive

Feedback

Thumbs and optional notes from the chat UI, linked to traces.

Review feedback. Use q to match message, comment, trace_id, or session_id (substring). Thumbs-down rows are the usual triage queue.

Tool lessons

Self-improvement snippets learned from tool failures and repairs.

Rows appear only when a tool fails and the same chat turn retries that tool with different arguments and succeeds. The chat ↺ Retry (new request) does not create a lesson. The request needs a business_id (Biz ID in chat). On Overview, the Tool lessons count is the same SQLite file as this table—if it shows 0, nothing has been persisted yet (or this server uses a fresh/ephemeral trace DB).

Exact vs fuzzy. tool_name and agent_name are exact filters. Use q to search lesson text (LIKE).

Agent rules

Configured rule rows (global or business-scoped) that steer tool and reply behavior.

Substring fields. Agent and tool filters use LIKE. q matches rule text content.

Uploads

Chat file upload registry (local temp paths and S3 references).

Search uploads. q matches file_id, filename, public URL, or S3 key. Toggle deleted to include soft-deleted registry rows.

Entity tags

Attach labels to traces (or other entities) for triage and bookkeeping.

List vs create. Use filters to find tags. entity_type and entity_id narrow the list; tag (exact) matches one label; q searches tag text, ids, and types.
New tag

Audit log

Immutable log of superadmin mutations and sensitive API actions.

Filter semantics. action is exact match. actor and q use substring search on actor string and JSON payload.

Reports

Rollups over trace activity for the selected window. Export the full trace table as CSV for spreadsheets or BI.

Summaries are computed on demand. Pick a day window (1–90), load the summary, then download CSV if you need raw rows offline.
Download traces CSV