Pi Surface Reference¶
Generated page — do not edit by hand
Rendered by scripts/build_reference_pages.py from the committed
537 contract trinity. Run python scripts/build_reference_pages.py build¶
after changing a source; CI runs check and fails on stale output.
Pi is a first-class surface, not a CLI fold-in. This page renders the npm-extension anatomy from templates/surface-template/generated/pi/package.json (package template-service-pi, surface Template Service API v0.1.0).
Extension anatomy¶
| Facet | Value |
|---|---|
| Package | template-service-pi |
| Source spec | specs/example.openapi.yaml |
| Default provider | huggingface |
| Agent settings | ~/.pi/agent |
| Provider token env | HF_TOKEN |
Providers¶
| Provider | Client | Endpoint | Token env |
|---|---|---|---|
huggingface |
huggingface_hub.InferenceClient |
https://router.huggingface.co/v1 |
HF_TOKEN |
Operations — tools · commands · skills · prompts¶
Each Pi operation bundles the MCP tool, the CLI command, and the HITL gate (prompt) for one contract operation — the extension's tool/command/skill/prompt anatomy in one row:
| operationId | MCP tool | CLI command | HITL prompt (gate) | Reversible |
|---|---|---|---|---|
listItems |
list_items |
list-items |
list_items_review |
yes |
createItem |
create_item |
create-item |
create_item_review |
no |
getItem |
get_item |
get-item |
get_item_review |
yes |