paperclip-harness/.pi/memory-vault/packs/paperclip-harness/80-sessions/paperclip-tuios-interface-discovery-skills-api-memory-stack-.md

type: session id: session.paperclip-harness.paperclip-tuios-interface-discovery-skills-api-memory-stack- title: Paperclip-TUIOS interface discovery: skills API, memory stack, MOUSE-1, dashboard, old office scaffold status: active source_of_truth: false freshness: current last_reviewed: 2026-11-10 tags: - pack/paperclip-harness - agent-memory/session - paperclip - tuios - skills-api - memory - mouse-1 - dashboard - office-scaffold

Paperclip-TUIOS interface discovery: skills API, memory stack, MOUSE-1, dashboard, old office scaffold

Discovery pass recorded in docs/PLAN-INTERFACE.md, last commit 3d31243.

1. Skills per agent: GET /api/agents/{id}/skills returns desired/managed sets + per-skill state. Builder currently: desired=[paperclipai/paperclip/paperclip]; company//obsidian-cli desired=false, managed=true, state="stale" (runtimeName obsidian-cli--b74ae42966, currentVersionId cf41ba39-..., sourcePath /home/sam/.paperclip/instances/default/skills//obsidian-cli). POST /api/agents/{id}/skills/sync accepts add/remove/replace (replace = exclusive set, keeps sub-agent context small). Full skills API surface: company skills CRUD/import/install-catalog/scan-projects/browse-project, versions, audit, comments, files, fork + fork-precheck, rename, reset, star, test-inputs, test-runs(+cancel), install-update, update-status, GET/PUT/DELETE /api/companies/{id}/skill-policy + /evaluate, skill-test-run-templates, /api/skills/{index,available,catalog,...}, invite-scoped skill index. Proposal: two rows in Agents>agents settings — skills (desired set, read-only first) and skill source; full browser later; fix stale obsidian-cli.

2. Memory is three distinct things: engram (v1.16.1 installed, MCP mode, NOT registered in ~/.pi/agent/mcp.json), headroom (v0.24.0 proxy at 192.168.20.13:8787, healthy, memory backend disabled, compression on — not a store), and pi memctx (injects notes into prompt). Only mcp servers registered: codebase-memory (/home/sam/.local/bin/codebase-memory-mcp), graphify-vault (/home/sam/.local/bin/relay-graphify-mcp), both lazy. Paperclip per-agent levers are adapterConfig/runtimeConfig. Proposal: a memory row in Agents>agents showing which of the three an agent uses, nothing more until measured.

3. MOUSE-1: MOUSE_API_KEY and JEV_API_KEY env names present (values not inspected); no mouse/mouse1/jev/switch binary installed. Existing notes state policy: "triage only: label, score, route, escalate. Never a gate, never a permit" — ruled out for merges/tool-call gating because it fails open on network errors. Adopted unchanged; if added, may only order Board>board needs-you list or pre-sort findings in Work>review.

4. Lazygit: already wired — t in Board>board or Work>work, opens in correct workspace, quits with q.

5. Old office (~/paseo/projects/tuios_coding_harness, scripts office/new-project/board): remembers host in .harness/host; runs new-project to write scaffold (settings.toml, per-role file, verify.sh, per-screen notes) only what is missing; refuses if session absent and prints exact tuios new <session> line (TUIOS cannot create sessions non-interactively — "Standard output is not a terminal"); then builds pages. Current office does host/refusal/pages but NO scaffold — cheapest real gap.

6. Dashboard: GET /api/companies/{id}/dashboard returns ~1.8KB: agents{active 6, running 0, paused 0, error 0}, tasks{open 8, inProgress 0, blocked 4, done 147}, costs{monthSpendCents 11, monthBudgetCents 0, utilization 0}, runActivity[14]. Proposal: Project>overview panel with those blocks + sparkline via tuios.dev/plot instead of embedding web dashboard. Artifacts explicitly dropped.

Evidence

• Confidence: 90%
• Reason: Rich evidence-backed discovery snapshot with concrete endpoints, component versions, paths, and proposals useful to future agents.

Related

• packs/paperclip-harness/00-system/pi-agent/memory-manifest

Related learned memories

• observation: packs/paperclip-harness/60-observations/tmp-repository-structure-and-configuration-patterns
• runbook: [[packs/paperclip-harness/70-runbooks/tmp-deployment-operations|Adopt an existing folder into the harness with office (and its known scaffold gap)]]
• decision: packs/paperclip-harness/50-decisions/mouse-1-restricted-to-triage-never-a-gate-or-permit
• action: packs/paperclip-harness/40-actions/2026-11-10-wrote-docs-ui-layout-md-and-three-live-layout-mockups
• session: packs/paperclip-harness/80-sessions/paperclip-tuios-interface-discovery-skills-api-memory-stack-
• context: packs/paperclip-harness/20-context/paperclip-tuios-harness-sam-s-coding-harness-office-board-wo
• session: packs/paperclip-harness/80-sessions/rich-discovery-paperclipai-2026-11-10-10-01-16
• context: packs/paperclip-harness/20-context/home