@vtstech/pi-shared

Shared utilities for Pi Coding Agent extensions by VTSTech.

This is an internal dependency — you don't need to install it directly. It's pulled in automatically when you install any @vtstech/pi-* extension package.

Modules

Module	Description
debug	Conditional debug logging via PI_EXTENSIONS_DEBUG=1 env var — debugLog(module, message, ...args)
format	Section headers, indicators (ok/fail/warn/info), numeric formatters (bytes, ms, percentages), string utilities
model-test-utils	Shared test utilities — ChatFn abstraction, unified test functions, scoring helpers, tool support cache, user config (~/.pi/agent/model-test-config.json), test history with regression detection (~/.pi/agent/cache/model-test-history.json)
ollama	Ollama base URL resolution, models.json I/O with TTL cache, async write mutex (acquireModelsJsonLock, readModifyWriteModelsJson), exponential backoff retry (withRetry), model family detection, provider detection, Ollama API helpers
react-parser	Multi-dialect ReAct text parser — 4 dialects (react, function, tool, call), parseReact(), detectReactDialect(), fuzzyMatchToolName()
security	Security mode toggle (basic/max), partitioned command blocklist (41 CRITICAL + 25 EXTENDED) with full-word scanning, mode-aware SSRF (22 + 7 patterns), path validation with symlink dereference, URL validation, command sanitization, DNS rebinding protection (resolveAndCheckHostname), buffered audit logging with mode tracking (AUDIT_LOG_PATH exported)
types	Type definitions (ToolSupportLevel, AuditEntry, etc.)

Usage

import { section, ok, fail, info } from "@vtstech/pi-shared/format";
import { readModelsJson, getOllamaBaseUrl } from "@vtstech/pi-shared/ollama";

Links

• Main Repository
• Changelog

License

MIT — VTSTech