feat: paperclip Pi extension + otel telemetry subagent fixes #3

Merged

aaron merged 1 commit from plane/HOMELAB-1120-otel-telemetry into main

2026-06-19 04:33:18 +00:00

aaron commented

2026-06-19 04:29:56 +00:00

Owner

What's New

Paperclip Extension (NEW)

Full Pi extension for the Paperclip control plane API
Key tools: paperclip_get_issue, paperclip_list_comments, paperclip_add_comment, paperclip_update_issue, paperclip_create_issue, paperclip_checkout, paperclip_get_inbox, paperclip_get_heartbeat_context, paperclip_get_approval, paperclip_list_agents
Commands: /issue HOM-56, /wip, /paperclip, /paperclip-inbox
Shortcuts: Ctrl+Shift+P / Cmd+Shift+P — open last tracked issue
Env vars: PAPERCLIP_API_URL, PAPERCLIP_API_KEY, PAPERCLIP_AGENT_ID, PAPERCLIP_COMPANY_ID

Otel Telemetry (fixes + subagent spans)

Fixes for pi-otel-telemetry bugs
Adds span-per-subagent telemetry to Tempo via subagent.ts
New query_telemetry tool for querying traces and metrics

Files Added

paperclip/index.ts, paperclip/api.ts, paperclip/types.ts
pi-otel-telemetry/subagents.ts

Files Modified

README.md — documented new extension and env vars
pi-otel-telemetry/index.ts — bug fixes and telemetry read path

How to Use

# Set up env vars (run once per agent identity)
paperclipai agent local-cli <agent-id> --company-id 8a87b923-e686-4bee-b481-ca3523ebc5f7

# Restart Pi to discover the extension

Then use /issue HOM-56 or paperclip_get_issue / paperclip_list_comments tools.

## What's New ### Paperclip Extension (NEW) - Full Pi extension for the Paperclip control plane API - **Key tools**: `paperclip_get_issue`, `paperclip_list_comments`, `paperclip_add_comment`, `paperclip_update_issue`, `paperclip_create_issue`, `paperclip_checkout`, `paperclip_get_inbox`, `paperclip_get_heartbeat_context`, `paperclip_get_approval`, `paperclip_list_agents` - **Commands**: `/issue HOM-56`, `/wip`, `/paperclip`, `/paperclip-inbox` - **Shortcuts**: `Ctrl+Shift+P` / `Cmd+Shift+P` — open last tracked issue - **Env vars**: `PAPERCLIP_API_URL`, `PAPERCLIP_API_KEY`, `PAPERCLIP_AGENT_ID`, `PAPERCLIP_COMPANY_ID` ### Otel Telemetry (fixes + subagent spans) - Fixes for pi-otel-telemetry bugs - Adds `span-per-subagent` telemetry to Tempo via subagent.ts - New `query_telemetry` tool for querying traces and metrics ## Files Added - `paperclip/index.ts`, `paperclip/api.ts`, `paperclip/types.ts` - `pi-otel-telemetry/subagents.ts` ## Files Modified - `README.md` — documented new extension and env vars - `pi-otel-telemetry/index.ts` — bug fixes and telemetry read path ## How to Use ```bash # Set up env vars (run once per agent identity) paperclipai agent local-cli <agent-id> --company-id 8a87b923-e686-4bee-b481-ca3523ebc5f7 # Restart Pi to discover the extension ``` Then use `/issue HOM-56` or `paperclip_get_issue` / `paperclip_list_comments` tools.

aaron added 1 commit

2026-06-19 04:29:56 +00:00

feat: add paperclip Pi extension fb6d1dcadd

Native Pi tools for the Paperclip control plane API:
- paperclip_get_issue - fetch issue details by identifier or UUID
- paperclip_list_comments - read full comment threads (the missing tool!)
- paperclip_get_comment - fetch single comment
- paperclip_add_comment - post markdown comments
- paperclip_update_issue - change status, priority, assignee, blockers
- paperclip_create_issue - create new issues
- paperclip_checkout / paperclip_release_issue - ownership control
- paperclip_get_heartbeat_context - compact issue context
- paperclip_get_inbox - agent inbox
- paperclip_get_agent / paperclip_list_agents - identity
- paperclip_get_approval - approval workflow

Also adds /issue, /wip, /paperclip, /paperclip-inbox commands
and Ctrl+Shift+P shortcut for last tracked issue.