HalfPint Command

Overview

Live counts and shortcuts. Data is limited to this HalfPint agent service — not LangGraph or Postgres.

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.

Loads first page automatically when you open this tab. Use pagination for older rows.

Show raw JSON instead of table

Conversations

SQLite conversation rows (newest id first). Bookmark this tab. Clear session removes rows for that id.

Loads first page when you open this tab. Filters use exact match except “content contains”.

Raw JSON

Feedback

User thumbs / feedback linked to traces.

Opens with the first page of feedback. Use q to search message, comment, trace_id, or session_id (substring).

Raw JSON

Tool lessons

Self-improvement lessons learned from tool failures.

tool_name and agent_name are exact row matches. Use q to search across lesson text columns (LIKE).

Raw JSON

Agent rules

Configured rule rows (global or business-scoped).

tool_name and q use substring match on rule text / tool column.

Raw JSON

Uploads

Chat upload registry (S3 + local references).

q matches file_id, filename, URL, or s3 key (substring).

Include deleted rows

Raw JSON

Entity tags

Attach labels to traces or other entities for triage.

List filters: entity_type / entity_id narrow the query; tag_exact is exact tag string; q searches tag, entity_id, entity_type.

Add tag:

Raw JSON

Audit log

Recent superadmin mutations and sensitive actions.

action is exact; actor and q use substring on payload JSON / actor field.

Raw JSON

Reports

Aggregated trace activity and downloadable CSV.

Show raw JSON