{"_id":"@badliveware/pi-model-catalog","_rev":"3-ef82025191f7dd72232c37681890eb65","name":"@badliveware/pi-model-catalog","dist-tags":{"latest":"0.2.0"},"versions":{"0.1.0":{"name":"@badliveware/pi-model-catalog","version":"0.1.0","keywords":["pi-package","pi-extension","models"],"author":{"name":"BadLiveware"},"license":"MIT","_id":"@badliveware/pi-model-catalog@0.1.0","maintainers":[{"name":"doz3r","email":"flarsson93@gmail.com"}],"homepage":"https://github.com/BadLiveware/pi/tree/main/agent/extensions/public/model-catalog#readme","bugs":{"url":"https://github.com/BadLiveware/pi/issues"},"pi":{"extensions":["./index.ts"]},"dist":{"shasum":"c99ac26d64ff5516890fd4347036449665a7bbe2","tarball":"https://registry.npmjs.org/@badliveware/pi-model-catalog/-/pi-model-catalog-0.1.0.tgz","fileCount":4,"integrity":"sha512-HdeqTUOpEiY/v+HCCv+HmU5xeBmEg9Xm9f7q0Gv5gcsVX+e/QjjwUMUUMTCv9v2b1FkZ97gmmnmyS4cTomzjMw==","signatures":[{"sig":"MEYCIQDrJZExc6JrIxWBOigXZXIPjUkS6NcDGqYRvRIQWS7aZAIhAIW7XKzYCMNCzHB8I7B6tRMzVyqgQjzaEPllrXqibSFx","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":27536},"type":"module","engines":{"node":">=20"},"gitHead":"cb0878d4f4de79753ccea89954bfc98db598f88a","_npmUser":{"name":"doz3r","email":"flarsson93@gmail.com"},"repository":{"url":"git+https://github.com/BadLiveware/pi.git","type":"git","directory":"agent/extensions/public/model-catalog"},"_npmVersion":"10.9.7","description":"Expose Pi model listings and selection guidance as an agent tool.","directories":{},"_nodeVersion":"22.22.2","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"peerDependencies":{"typebox":"*","@mariozechner/pi-ai":"*","@mariozechner/pi-coding-agent":"*"},"_npmOperationalInternal":{"tmp":"tmp/pi-model-catalog_0.1.0_1777196607239_0.7429683005181127","host":"s3://npm-registry-packages-npm-production"}},"0.1.1":{"name":"@badliveware/pi-model-catalog","version":"0.1.1","keywords":["pi-package","pi-extension","models"],"author":{"name":"BadLiveware"},"license":"MIT","_id":"@badliveware/pi-model-catalog@0.1.1","maintainers":[{"name":"doz3r","email":"flarsson93@gmail.com"}],"homepage":"https://github.com/BadLiveware/pi/tree/main/agent/extensions/public/model-catalog#readme","bugs":{"url":"https://github.com/BadLiveware/pi/issues"},"pi":{"extensions":["./index.ts"]},"dist":{"shasum":"a350654e3f679bac8d5e1e0f7a276806d8f95282","tarball":"https://registry.npmjs.org/@badliveware/pi-model-catalog/-/pi-model-catalog-0.1.1.tgz","fileCount":4,"integrity":"sha512-cc9s1Q/gkQC9rZNVzTXyQndm2iUJK8iuEkw4xEFAjz4Ni6p42qpfGpDuCyQ2ZIywKkNma/sgyQZfGHIFXggeyQ==","signatures":[{"sig":"MEUCIGsKO2E+YmrkQ33l8gv8pgBjmtkg7OvuvGPq3QAbf09uAiEAkLIL+gmTv+pk0R337Ce/C8QpaQRH0Uf6UtDO8yxygU8=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@badliveware%2fpi-model-catalog@0.1.1","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":25624},"type":"module","engines":{"node":">=20"},"gitHead":"c36b71f3d327837c2101ffb79a1c53498c952a89","_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:cbded907-4219-4a22-8f9c-67f084416d66"}},"repository":{"url":"git+https://github.com/BadLiveware/pi.git","type":"git","directory":"agent/extensions/public/model-catalog"},"_npmVersion":"11.13.0","description":"Expose Pi model listings and selection guidance as an agent tool.","directories":{},"_nodeVersion":"24.14.1","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"peerDependencies":{"typebox":"*","@mariozechner/pi-ai":"*","@mariozechner/pi-coding-agent":"*"},"_npmOperationalInternal":{"tmp":"tmp/pi-model-catalog_0.1.1_1777197836238_0.63139158549931","host":"s3://npm-registry-packages-npm-production"}},"0.2.0":{"name":"@badliveware/pi-model-catalog","version":"0.2.0","description":"Expose Pi model listings and selection guidance as an agent tool.","type":"module","keywords":["pi-package","pi-extension","models"],"license":"MIT","author":{"name":"BadLiveware"},"repository":{"type":"git","url":"git+https://github.com/BadLiveware/pi.git","directory":"agent/extensions/public/model-catalog"},"bugs":{"url":"https://github.com/BadLiveware/pi/issues"},"homepage":"https://github.com/BadLiveware/pi/tree/main/agent/extensions/public/model-catalog#readme","publishConfig":{"access":"public"},"pi":{"extensions":["./index.ts"]},"peerDependencies":{"@earendil-works/pi-ai":"*","@earendil-works/pi-coding-agent":"*","typebox":"*"},"engines":{"node":">=20"},"gitHead":"7d4a9c3021d2cac70f8015aa341494170c727831","_id":"@badliveware/pi-model-catalog@0.2.0","_nodeVersion":"24.15.0","_npmVersion":"11.14.1","dist":{"integrity":"sha512-i/8mBcMMUAy/8GHp+L0I/1lL+m09uml8gQNY5ZRpl9KVzr9m+YYcKXZtiGiypsETZGbSCIFqZ3omwPub7eFFHw==","shasum":"a3a4af55492ab959e2ad658c635c90c364479a39","tarball":"https://registry.npmjs.org/@badliveware/pi-model-catalog/-/pi-model-catalog-0.2.0.tgz","fileCount":6,"unpackedSize":27024,"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@badliveware%2fpi-model-catalog@0.2.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIAeEYeJClmpZd16Rw3zcnoDicCWAhAC1hdRndQZ8loHOAiB6XIIuyAiXlP9D3yvrQhGtdy4rhoQ3oFglAx4jBHFgNQ=="}]},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:cbded907-4219-4a22-8f9c-67f084416d66"}},"directories":{},"maintainers":[{"name":"doz3r","email":"flarsson93@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/pi-model-catalog_0.2.0_1778966548194_0.0478387663378288"},"_hasShrinkwrap":false}},"time":{"created":"2026-04-26T09:43:27.183Z","modified":"2026-05-16T21:22:28.643Z","0.1.0":"2026-04-26T09:43:27.383Z","0.1.1":"2026-04-26T10:03:56.401Z","0.2.0":"2026-05-16T21:22:28.370Z"},"bugs":{"url":"https://github.com/BadLiveware/pi/issues"},"author":{"name":"BadLiveware"},"license":"MIT","homepage":"https://github.com/BadLiveware/pi/tree/main/agent/extensions/public/model-catalog#readme","keywords":["pi-package","pi-extension","models"],"repository":{"type":"git","url":"git+https://github.com/BadLiveware/pi.git","directory":"agent/extensions/public/model-catalog"},"description":"Expose Pi model listings and selection guidance as an agent tool.","maintainers":[{"name":"doz3r","email":"flarsson93@gmail.com"}],"readme":"# pi-model-catalog\n\nAdds a `list_pi_models` tool that lets agents inspect Pi's current model registry before choosing or recommending a model.\n\nUse it when model choice should depend on what is actually available in your Pi setup: auth status, local support notes, enabled/cycling preferences, context size, capabilities, supported thinking levels, quota guidance, and optional price data.\n\n## Install\n\n```bash\npi install npm:@badliveware/pi-model-catalog\n```\n\nNo external services or credentials are required beyond the model credentials already configured in Pi.\n\n## Quick use\n\nAsk the agent to call `list_pi_models` before choosing a model, or use the UI command:\n\n```text\n/models-guide mini\n/models-guide --pricing --relative-to openai-codex/gpt-5.4-mini codex\n```\n\nTool example:\n\n```json\n{\n  \"query\": \"sonnet\",\n  \"includePricing\": true,\n  \"relativeTo\": \"openai-codex/gpt-5.4-mini\"\n}\n```\n\n## What it returns\n\nDefault output is intentionally compact:\n\n- full model id, with `*` on the current model\n- `auth`, `support`, and `enabled` status\n- context and max output tokens\n- capability marker: `text`, `think`, `img`, or `think+img`\n- supported Pi thinking levels, shown as `off`, `min`, `low`, `med`, `high`, and `xhi` in the compact table\n- price tier and rough relative cost\n- quota/scarcity guidance\n\nPass `includeDetails: true` for verbose use/avoid guidance and full thinking level names. Pass `includePricing: true` for numeric input/output prices and relative ratios. Structured tool details include `thinkingLevels` and any model-specific `thinkingLevelMap`; Pi uses `off` for provider no/none thinking.\n\n## Tool parameters\n\n| Parameter | What it does |\n| --- | --- |\n| `query` | Optional substring filter such as `mini`, `codex`, or `sonnet`. |\n| `includeUnavailable` | Include models without configured auth. Default: `false`. |\n| `includeDetails` | Include verbose use/avoid guidance. Default: `false`. |\n| `includePricing` | Include numeric registry prices in $/million tokens. Default: `false`. |\n| `relativeTo` | Baseline model id for relative price ratios. |\n| `unsupported` | `exclude`, `include`, or `only` locally unsupported models. Default: `exclude`. |\n\n## Command\n\n| Command | What it does |\n| --- | --- |\n| `/models-guide [query]` | Show the concise available-model table. |\n| `/models-guide --verbose [query]` | Include verbose use/avoid guidance. |\n| `/models-guide --pricing --relative-to <model> [query]` | Include numeric pricing and ratios. |\n\n## Local support notes\n\nSome providers report a model as authenticated even when a specific account cannot use it. Add local unsupported-model notes in:\n\n```text\n~/.pi/agent/model-catalog.json\n```\n\nExample:\n\n```json\n{\n  \"unsupportedModels\": [\n    {\n      \"model\": \"provider/model-id\",\n      \"reason\": \"short reason shown to the agent\"\n    }\n  ]\n}\n```\n\nUnsupported models are excluded by default so agents do not choose them accidentally.\n\n## Price and quota caveats\n\n`price-tier`, numeric prices, and quota labels are guidance from Pi's local model registry, not live billing or remaining quota. For subscription-backed providers, numeric prices may be nominal weights rather than direct billing.\n","readmeFilename":"README.md"}