@hyav/pi-provider 0.1.0 → 0.1.2

package/CHANGELOG.md

@@ -2,10 +2,22 @@
 
 This file is the authoritative user-facing release history for `@hyav/pi-provider`.
 
+## 0.1.2 - 2026-08-17
+
+- Expose one Pi package entrypoint while preserving file-level Adapter discovery when `/reload` runs.
+- Isolate invalid Adapter modules behind capability-relative diagnostics and declare `jiti` as the runtime loader.
+- Rename the public APIs to Pi Provider equivalents and remove legacy aliases; programmatic consumers must update those imported names.
+- Store generated metadata under `<agent-dir>/pi-provider/`, following Pi's resolved agent directory.
+
+## 0.1.1 - 2026-08-16
+
+- Hardened zero-coupling contract tests and isolated temporary directories for manifest drop-in validation.
+- Stabilized asynchronous pricing and metadata background refresh timing under high-load runners.
+
 ## 0.1.0 - 2026-08-16
 
 - Initial public release of `@hyav/pi-provider`.
-- Provider Kit host for dynamic providers, status, preflight, live checks, and request tuners.
+- Pi Provider host for dynamic providers, status, preflight, live checks, and request tuners.
 - Manifest-discovered adapter extensions with deterministic ordering, reload isolation, validation, and conflict handling.
 - Cached model catalogs, bounded background refresh, pricing metadata, and explicit free-versus-billable diagnostics.
 - Built-in Charm Hyper, DeepSeek, Google Gemini, OpenAI Codex, OpenCode Zen, and OpenCode Go integrations.

package/README.md

@@ -8,8 +8,8 @@ A provider extension toolkit for [Pi](https://pi.dev). It registers LLM provider
 
 ## Highlights
 
-- One Provider Kit Host for registration, status, preflight checks, live checks, and request tuners
-- Manifest-discovered provider, status, preflight, and tuner adapters reloaded with `/reload`
+- One Pi Provider Host for registration, status, preflight checks, live checks, and request tuners
+- Provider, status, preflight, and tuner Adapter files discovered by one Pi entrypoint on `/reload`
 - Resilient model catalogs with cached fallback, bounded background refresh, and failure retention
 - Provider-first pricing metadata with optional OpenRouter completion and quality indicators
 - Explicit diagnostics: cached `/status`, free `/status refresh`, and potentially billable `/status check`
@@ -46,11 +46,11 @@ Use `/status refresh` for free endpoint, authentication, catalog, and account ch
 | Name | Required | Default | Effect |
 |---|---:|---|---|
 | `HYPER_API_KEY` | For Charm Hyper API-key auth | None | Supplies the built-in `charm-hyper` provider credential; OAuth users may use `/login` |
-| `PI_CODING_AGENT_DIR` | No | `~/.pi/agent` | Changes the base directory for public OpenRouter metadata cache |
+| `PI_CODING_AGENT_DIR` | No | `~/.pi/agent` | Changes Pi's agent directory; public OpenRouter metadata is cached under `<agent-dir>/pi-provider/` |
 
-Programmatic integrations can configure pricing fallback, pricing policies, request timeouts, metadata URLs, and cache paths through `createProviderKitRuntime()` or `createProviderKitHost()`. The source definition [`ProviderKitDependencies`](core/runtime-config.ts) is authoritative.
+Programmatic integrations can configure pricing fallback, pricing policies, request timeouts, metadata URLs, and cache paths through `createPiProviderRuntime()` or `createPiProviderHost()`. Host packages with a custom capability root can call `createPiProviderExtension({ adapterRoot, dependencies })`. The source definition [`PiProviderDependencies`](core/runtime-config.ts) is authoritative.
 
-Trusted packages can add adapters through manifest entries under `providers/`, `status/`, `preflight/`, and `tuners/`. See the [adapter extension contract](https://github.com/hyav/pi-provider/blob/main/docs/adapter-extensions.md) for helpers, validation, conflicts, reload behavior, and lifecycle boundaries. The root [`index.ts`](index.ts) defines the public TypeScript exports.
+Add or remove Adapter files under `@hyav/pi-provider`'s `providers/`, `status/`, `preflight/`, or `tuners/` directories, then run `/reload` to rediscover them without changing `index.ts`. Standalone trusted Adapter packages still declare their capability entries in their own Pi manifest. See the [adapter extension contract](https://github.com/hyav/pi-provider/blob/main/docs/adapter-extensions.md) for helpers, validation, conflicts, reload behavior, and lifecycle boundaries. The root [`index.ts`](index.ts) defines the public TypeScript exports.
 
 ## Before you use it
 

package/README.zh-CN.md

@@ -8,8 +8,8 @@
 
 ## 核心能力
 
-- 由一个 Provider Kit Host 统一负责注册、Status、Preflight、实时检查和请求 Tuner
-- 通过 manifest 发现 Provider、Status、Preflight 和 Tuner Adapter，并在 `/reload` 后重新加载
+- 由一个 Pi Provider Host 统一负责注册、Status、Preflight、实时检查和请求 Tuner
+- 由单一 Pi 入口在 `/reload` 时发现 Provider、Status、Preflight 和 Tuner Adapter 文件
 - 通过缓存回退、有界后台刷新和失败保留提供可靠的模型目录
 - 优先采用 Provider 价格元数据，并可由 OpenRouter 补全价格和质量指标
 - 显式诊断：缓存 `/status`、免费 `/status refresh` 和可能计费的 `/status check`
@@ -46,11 +46,11 @@ pi install npm:@hyav/pi-provider
 | 名称 | 必需 | 默认值 | 作用 |
 |---|---:|---|---|
 | `HYPER_API_KEY` | Charm Hyper API Key 鉴权需要 | 无 | 为内置 `charm-hyper` Provider 提供凭据；OAuth 用户可以使用 `/login` |
-| `PI_CODING_AGENT_DIR` | 否 | `~/.pi/agent` | 修改公开 OpenRouter 元数据缓存的基础目录 |
+| `PI_CODING_AGENT_DIR` | 否 | `~/.pi/agent` | 修改 Pi agent 目录；公开 OpenRouter 元数据缓存在 `<agent-dir>/pi-provider/` 下 |
 
-程序化集成可以通过 `createProviderKitRuntime()` 或 `createProviderKitHost()` 配置价格回退、价格策略、请求超时、元数据 URL 和缓存路径。源码定义 [`ProviderKitDependencies`](core/runtime-config.ts) 是权威依据。
+程序化集成可以通过 `createPiProviderRuntime()` 或 `createPiProviderHost()` 配置价格回退、价格策略、请求超时、元数据 URL 和缓存路径；使用自定义 capability 根目录的 Host 包可以调用 `createPiProviderExtension({ adapterRoot, dependencies })`。源码定义 [`PiProviderDependencies`](core/runtime-config.ts) 是权威依据。
 
-可信包可以通过 manifest 中的 `providers/`、`status/`、`preflight/` 和 `tuners/` 条目添加 Adapter。Helper、校验、冲突、reload 行为和生命周期边界见 [Adapter Extension 契约](https://github.com/hyav/pi-provider/blob/main/docs/adapter-extensions.zh-CN.md)。根目录 [`index.ts`](index.ts) 定义公开 TypeScript 导出。
+在 `@hyav/pi-provider` 的 `providers/`、`status/`、`preflight/` 或 `tuners/` 目录增删 Adapter 文件后，执行 `/reload` 即可重新发现，无需修改 `index.ts`。独立的可信 Adapter 包仍通过自身 Pi manifest 声明 capability 入口。Helper、校验、冲突、reload 行为和生命周期边界见 [Adapter Extension 契约](https://github.com/hyav/pi-provider/blob/main/docs/adapter-extensions.zh-CN.md)。根目录 [`index.ts`](index.ts) 定义公开 TypeScript 导出。
 
 ## 使用须知
 

package/SECURITY.md

@@ -30,7 +30,7 @@ Reports are handled on a best-effort basis; no acknowledgement, remediation, or
 
 ## Scope and dependency boundary
 
-This policy covers the source repository, the published `@hyav/pi-provider` npm artifact, its Pi manifest, built-in adapters, credential handling, remote response validation, deadlines, and the Provider Kit runtime. The published artifact has no bundled runtime dependencies; its Pi core imports are host-supplied peers. CI runs both `npm run audit:runtime` for the published boundary and `npm run audit:all` for development and tested-host dependencies. Scanner findings are triaged rather than force-fixed across an untested host version.
+This policy covers the source repository, the published `@hyav/pi-provider` npm artifact, its Pi manifest, built-in adapters, credential handling, remote response validation, deadlines, and the Pi Provider runtime. The published artifact has no bundled runtime dependencies; its Pi core imports are host-supplied peers. CI runs both `npm run audit:runtime` for the published boundary and `npm run audit:all` for development and tested-host dependencies. Scanner findings are triaged rather than force-fixed across an untested host version.
 
 Vulnerabilities in Pi, a Provider service, npm, GitHub, or another dependency should also be reported to the relevant upstream maintainer. For ordinary defects and usage questions, use [SUPPORT.md](SUPPORT.md) and the [public issue tracker](https://github.com/hyav/pi-provider/issues).
 

package/core/adapter-extensions.ts

@@ -2,21 +2,21 @@ import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
 import {
 	type AdapterKind,
 	type AdapterRegistrationEnvelope,
-	PROVIDER_KIT_ADAPTER_EVENT,
-	PROVIDER_KIT_ADAPTER_PROTOCOL_VERSION,
-	PROVIDER_KIT_STARTUP_BRIDGE_EVENT,
+	PI_PROVIDER_ADAPTER_EVENT,
+	PI_PROVIDER_ADAPTER_PROTOCOL_VERSION,
+	PI_PROVIDER_STARTUP_BRIDGE_EVENT,
 	type StartupBridge,
 	type StartupBridgeRequest,
 } from "./adapter-protocol.ts";
 import { isStableAdapterId, validateAdapter, validateAdapterIdentity } from "./adapter-validation.ts";
 import type { PreflightAdapter } from "./preflight-manager.ts";
 import { registerProviderAdapter } from "./provider-registration.ts";
-import type { ProviderKitDependencies } from "./runtime-config.ts";
-import { getDefaultProviderKitDependencies } from "./runtime-config.ts";
+import type { PiProviderDependencies } from "./runtime-config.ts";
+import { getDefaultPiProviderDependencies } from "./runtime-config.ts";
 import type { ProviderAdapter, StatusAdapter, TunerAdapter } from "./types.ts";
 
 /** Context supplied to an Adapter Extension factory. */
-export interface AdapterExtensionContext extends ProviderKitDependencies {
+export interface AdapterExtensionContext extends PiProviderDependencies {
 	/** The Pi API that owns this extension factory. */
 	pi: ExtensionAPI;
 }
@@ -52,19 +52,19 @@ function validateStaticIdentity(kind: AdapterKind, id: string, providerId?: stri
 
 function getStartupBridge(pi: ExtensionAPI): StartupBridge {
 	const request: StartupBridgeRequest = {};
-	pi.events.emit(PROVIDER_KIT_STARTUP_BRIDGE_EVENT, request);
+	pi.events.emit(PI_PROVIDER_STARTUP_BRIDGE_EVENT, request);
 	return (
 		request.bridge ?? {
-			dependencies: getDefaultProviderKitDependencies(),
+			dependencies: getDefaultPiProviderDependencies(),
 			officialPricing: Promise.resolve({}),
 		}
 	);
 }
 
 function emitRegistration(pi: ExtensionAPI, envelope: AdapterRegistrationEnvelope): void {
-	pi.events.emit(PROVIDER_KIT_ADAPTER_EVENT, envelope);
+	pi.events.emit(PI_PROVIDER_ADAPTER_EVENT, envelope);
 	pi.on("session_start", () => {
-		pi.events.emit(PROVIDER_KIT_ADAPTER_EVENT, envelope);
+		pi.events.emit(PI_PROVIDER_ADAPTER_EVENT, envelope);
 	});
 }
 
@@ -94,7 +94,7 @@ function createAdapterExtension<TAdapter extends ProviderAdapter | StatusAdapter
 			// loaded later can recreate the adapter with its configured runtime.
 			registerProviderAdapter(pi, providerAdapter, bridge.dependencies, {}, modelDrafts);
 			emitRegistration(pi, {
-				version: PROVIDER_KIT_ADAPTER_PROTOCOL_VERSION,
+				version: PI_PROVIDER_ADAPTER_PROTOCOL_VERSION,
 				kind: "provider",
 				id,
 				token,
@@ -110,7 +110,7 @@ function createAdapterExtension<TAdapter extends ProviderAdapter | StatusAdapter
 			validateAdapter("status", statusAdapter);
 			validateAdapterIdentity("status", id, providerId, statusAdapter);
 			emitRegistration(pi, {
-				version: PROVIDER_KIT_ADAPTER_PROTOCOL_VERSION,
+				version: PI_PROVIDER_ADAPTER_PROTOCOL_VERSION,
 				kind: "status",
 				id,
 				providerId: providerId!,
@@ -126,7 +126,7 @@ function createAdapterExtension<TAdapter extends ProviderAdapter | StatusAdapter
 			validateAdapter("preflight", preflightAdapter);
 			validateAdapterIdentity("preflight", id, providerId, preflightAdapter);
 			emitRegistration(pi, {
-				version: PROVIDER_KIT_ADAPTER_PROTOCOL_VERSION,
+				version: PI_PROVIDER_ADAPTER_PROTOCOL_VERSION,
 				kind: "preflight",
 				id,
 				providerId: providerId!,
@@ -141,7 +141,7 @@ function createAdapterExtension<TAdapter extends ProviderAdapter | StatusAdapter
 		validateAdapter("tuner", tunerAdapter);
 		validateAdapterIdentity("tuner", id, tunerAdapter);
 		emitRegistration(pi, {
-			version: PROVIDER_KIT_ADAPTER_PROTOCOL_VERSION,
+			version: PI_PROVIDER_ADAPTER_PROTOCOL_VERSION,
 			kind: "tuner",
 			id,
 			token,

package/core/adapter-loader.ts

@@ -0,0 +1,53 @@
+import type { Dirent } from "node:fs";
+import { readdir } from "node:fs/promises";
+import { dirname, extname, join, relative } from "node:path";
+import { fileURLToPath } from "node:url";
+import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
+import { createJiti } from "jiti";
+
+const adapterDirectories = ["providers", "status", "preflight", "tuners"] as const;
+const packageRoot = dirname(dirname(fileURLToPath(import.meta.url)));
+
+type AdapterExtensionFactory = (pi: ExtensionAPI) => void | Promise<void>;
+
+function isAdapterFile(name: string): boolean {
+	if (name.endsWith(".d.ts")) return false;
+	return extname(name) === ".ts" || extname(name) === ".js";
+}
+
+function warnAdapterLoadIssue(path: string, error: unknown): void {
+	const message = error instanceof Error ? error.message : String(error);
+	console.warn(`[pi-provider] failed to load adapter extension ${JSON.stringify(path)}: ${message}`);
+}
+
+async function discoverAdapterPaths(root: string): Promise<string[]> {
+	const paths: string[] = [];
+	for (const directory of adapterDirectories) {
+		let entries: Dirent[];
+		try {
+			entries = await readdir(join(root, directory), { withFileTypes: true });
+		} catch (error) {
+			if ((error as NodeJS.ErrnoException).code === "ENOENT") continue;
+			throw error;
+		}
+		for (const entry of entries) {
+			if (entry.isFile() && isAdapterFile(entry.name)) paths.push(join(root, directory, entry.name));
+		}
+	}
+	return paths.sort();
+}
+
+export async function loadPackageAdapterExtensions(pi: ExtensionAPI, root: string = packageRoot): Promise<void> {
+	const jiti = createJiti(import.meta.url, { moduleCache: false, tryNative: false });
+	for (const path of await discoverAdapterPaths(root)) {
+		try {
+			const factory = (await jiti.import(path, { default: true })) as unknown;
+			if (typeof factory !== "function") {
+				throw new TypeError("default export must be a Pi extension factory");
+			}
+			await (factory as AdapterExtensionFactory)(pi);
+		} catch (error) {
+			warnAdapterLoadIssue(relative(root, path).replaceAll("\\", "/"), error);
+		}
+	}
+}

package/core/adapter-protocol.ts

@@ -1,24 +1,24 @@
 import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
 import type { OfficialModelMeta } from "./official-pricing.ts";
 import type { PreflightAdapter } from "./preflight-manager.ts";
-import type { ProviderKitDependencies } from "./runtime-config.ts";
+import type { PiProviderDependencies } from "./runtime-config.ts";
 import type { ProviderAdapter, ProviderModelDraft, StatusAdapter, TunerAdapter } from "./types.ts";
 
 /** Registration protocol version shared by Host and Adapter Extensions. */
-export const PROVIDER_KIT_ADAPTER_PROTOCOL_VERSION = 2 as const;
+export const PI_PROVIDER_ADAPTER_PROTOCOL_VERSION = 2 as const;
 
 /** Event-bus channel used for Adapter Extension registration envelopes. */
-export const PROVIDER_KIT_ADAPTER_EVENT = "provider-kit:adapter";
+export const PI_PROVIDER_ADAPTER_EVENT = "pi-provider:adapter";
 
 /** Event-bus channel used by the Host to expose the factory-stage startup bridge. */
-export const PROVIDER_KIT_STARTUP_BRIDGE_EVENT = "provider-kit:startup-bridge";
+export const PI_PROVIDER_STARTUP_BRIDGE_EVENT = "pi-provider:startup-bridge";
 
-/** Event-bus channel used to detect more than one Provider Kit Host. */
-export const PROVIDER_KIT_HOST_CLAIM_EVENT = "provider-kit:host-claim";
+/** Event-bus channel used to detect more than one Pi Provider Host. */
+export const PI_PROVIDER_HOST_CLAIM_EVENT = "pi-provider:host-claim";
 
 export type AdapterKind = "provider" | "status" | "preflight" | "tuner";
 
-export interface AdapterFactoryContext extends ProviderKitDependencies {
+export interface AdapterFactoryContext extends PiProviderDependencies {
 	pi: ExtensionAPI;
 }
 
@@ -32,14 +32,14 @@ export type AdapterFactory = (
 	| Promise<ProviderAdapter | StatusAdapter | PreflightAdapter | TunerAdapter>;
 
 export interface AdapterRegistrationEnvelopeBase {
-	version: typeof PROVIDER_KIT_ADAPTER_PROTOCOL_VERSION;
+	version: typeof PI_PROVIDER_ADAPTER_PROTOCOL_VERSION;
 	kind: AdapterKind;
 	id: string;
 	token: object;
 	/** Factory retained for Host-side rehydration when Host loaded after Adapter. */
 	factory: AdapterFactory;
 	/** Exact dependency object used by the initial factory invocation. */
-	startupDependencies: ProviderKitDependencies;
+	startupDependencies: PiProviderDependencies;
 }
 
 export interface ProviderAdapterRegistrationEnvelope extends AdapterRegistrationEnvelopeBase {
@@ -73,7 +73,7 @@ export type AdapterRegistrationEnvelope =
 	| TunerAdapterRegistrationEnvelope;
 
 export interface StartupBridge {
-	dependencies: ProviderKitDependencies;
+	dependencies: PiProviderDependencies;
 	officialPricing: Promise<Record<string, OfficialModelMeta>>;
 }
 
@@ -102,7 +102,7 @@ export function isAdapterRegistrationEnvelope(value: unknown): value is AdapterR
 	if (value === null || typeof value !== "object") return false;
 	const candidate = value as Partial<AdapterRegistrationEnvelope>;
 	return (
-		candidate.version === PROVIDER_KIT_ADAPTER_PROTOCOL_VERSION &&
+		candidate.version === PI_PROVIDER_ADAPTER_PROTOCOL_VERSION &&
 		(candidate.kind === "provider" ||
 			candidate.kind === "status" ||
 			candidate.kind === "preflight" ||

package/core/definition.ts

@@ -2,7 +2,7 @@ import { validateAdapter } from "./adapter-validation.ts";
 import type { PreflightAdapter } from "./preflight-manager.ts";
 import type { ProviderAdapter, StatusAdapter, TunerAdapter } from "./types.ts";
 
-export interface ProviderKitDefinition {
+export interface PiProviderDefinition {
 	providers: ProviderAdapter[];
 	statuses?: StatusAdapter[];
 	preflights?: PreflightAdapter[];
@@ -24,15 +24,15 @@ function rejectDuplicate(ids: Set<string>, id: string, label: string): void {
  * Dynamic Hosts use the same adapter validators while resolving conflicts, but
  * keep invalid entries isolated instead of failing the whole registry.
  */
-export function validateProviderKitDefinition(value: unknown): asserts value is ProviderKitDefinition {
+export function validatePiProviderDefinition(value: unknown): asserts value is PiProviderDefinition {
 	if (value === null || typeof value !== "object" || Array.isArray(value)) {
-		throw new Error("Provider kit definition must be an object");
+		throw new Error("Pi Provider definition must be an object");
 	}
-	const definition = value as Partial<ProviderKitDefinition>;
-	assertArray(definition.providers, "Provider kit definition providers");
-	if (definition.statuses !== undefined) assertArray(definition.statuses, "Provider kit definition statuses");
-	if (definition.preflights !== undefined) assertArray(definition.preflights, "Provider kit definition preflights");
-	if (definition.tuners !== undefined) assertArray(definition.tuners, "Provider kit definition tuners");
+	const definition = value as Partial<PiProviderDefinition>;
+	assertArray(definition.providers, "Pi Provider definition providers");
+	if (definition.statuses !== undefined) assertArray(definition.statuses, "Pi Provider definition statuses");
+	if (definition.preflights !== undefined) assertArray(definition.preflights, "Pi Provider definition preflights");
+	if (definition.tuners !== undefined) assertArray(definition.tuners, "Pi Provider definition tuners");
 
 	const providerIds = new Set<string>();
 	for (const adapter of definition.providers) {

package/core/extension.ts

@@ -1,5 +1,5 @@
-export type { ProviderKitDefinition } from "./definition.ts";
-export { validateProviderKitDefinition } from "./definition.ts";
+export type { PiProviderDefinition } from "./definition.ts";
+export { validatePiProviderDefinition } from "./definition.ts";
 export {
 	normalizeProviderModel,
 	normalizeProviderModels,
@@ -7,14 +7,14 @@ export {
 	registerProviderAdapter,
 } from "./provider-registration.ts";
 export {
-	createProviderKitRuntime,
-	installProviderKitRuntime,
-	type ProviderKitRuntimeController,
+	createPiProviderRuntime,
+	installPiProviderRuntime,
+	type PiProviderRuntimeController,
 } from "./runtime.ts";
-export type { ProviderKitDependencies, ProviderKitLoader } from "./runtime-config.ts";
+export type { PiProviderDependencies, PiProviderLoader } from "./runtime-config.ts";
 export {
-	getDefaultProviderKitDependencies,
-	resolveProviderKitDependencies,
-	validateProviderKitDependencies,
+	getDefaultPiProviderDependencies,
+	resolvePiProviderDependencies,
+	validatePiProviderDependencies,
 } from "./runtime-config.ts";
 export { getStatusModeCompletions } from "./status-report.ts";

package/core/host.ts

@@ -3,26 +3,26 @@ import {
 	type AdapterRegistrationEnvelope,
 	isAdapterRegistrationEnvelope,
 	isHostClaimRequest,
-	PROVIDER_KIT_ADAPTER_EVENT,
-	PROVIDER_KIT_HOST_CLAIM_EVENT,
-	PROVIDER_KIT_STARTUP_BRIDGE_EVENT,
+	PI_PROVIDER_ADAPTER_EVENT,
+	PI_PROVIDER_HOST_CLAIM_EVENT,
+	PI_PROVIDER_STARTUP_BRIDGE_EVENT,
 	type StartupBridge,
 	type StartupBridgeRequest,
 } from "./adapter-protocol.ts";
 import { validateAdapter, validateAdapterIdentity, validateProviderAdapter } from "./adapter-validation.ts";
-import { type ProviderKitDefinition, validateProviderKitDefinition } from "./definition.ts";
+import { type PiProviderDefinition, validatePiProviderDefinition } from "./definition.ts";
 import {
 	getStatusModeCompletions,
-	installProviderKitRuntime,
-	type ProviderKitRuntimeController,
+	installPiProviderRuntime,
+	type PiProviderRuntimeController,
 	prepareProviderRegistration,
 } from "./extension.ts";
 import { fetchOfficialPricing, type OfficialModelMeta, OPENROUTER_MODELS_URL } from "./official-pricing.ts";
 import type { PreflightAdapter } from "./preflight-manager.ts";
 import { refreshProviderRegistrations } from "./provider-registration.ts";
 import { scheduleModelCatalogRefresh } from "./runtime.ts";
-import type { ProviderKitDependencies } from "./runtime-config.ts";
-import { resolveProviderKitDependencies } from "./runtime-config.ts";
+import type { PiProviderDependencies } from "./runtime-config.ts";
+import { resolvePiProviderDependencies } from "./runtime-config.ts";
 import type { ProviderAdapter, ProviderModelDraft, StatusAdapter, TunerAdapter } from "./types.ts";
 
 function compareAdapterIds(left: { id: string }, right: { id: string }): number {
@@ -34,43 +34,43 @@ function adapterKindLabel(kind: AdapterRegistrationEnvelope["kind"]): string {
 }
 
 function warnAdapterIssue(message: string): void {
-	console.warn(`[provider-kit] ${message}`);
+	console.warn(`[pi-provider] ${message}`);
 }
 
 /**
- * Create the single Provider Kit Host used by the published Pi entrypoint.
+ * Create the single Pi Provider Host used by the published Pi entrypoint.
  *
  * The Host deliberately does not assemble adapters during extension factory
  * loading. Adapter factories can run before or after this factory, so the
  * event-bus envelopes are collected and assembled at the first session-level
  * operation after Pi's session_start registration barrier.
  */
-export function createProviderKitHost(dependencies: Partial<ProviderKitDependencies> = {}): (pi: ExtensionAPI) => void {
-	const runtime = resolveProviderKitDependencies(dependencies);
+export function createPiProviderHost(dependencies: Partial<PiProviderDependencies> = {}): (pi: ExtensionAPI) => void {
+	const runtime = resolvePiProviderDependencies(dependencies);
 	return (pi) => {
 		const hostToken = {};
 		const hostClaim = { token: hostToken, occupied: false };
-		const unsubscribeHostClaim = pi.events.on(PROVIDER_KIT_HOST_CLAIM_EVENT, (value) => {
+		const unsubscribeHostClaim = pi.events.on(PI_PROVIDER_HOST_CLAIM_EVENT, (value) => {
 			if (!isHostClaimRequest(value) || value.token === hostToken) return;
 			value.occupied = true;
 		});
-		pi.events.emit(PROVIDER_KIT_HOST_CLAIM_EVENT, hostClaim);
+		pi.events.emit(PI_PROVIDER_HOST_CLAIM_EVENT, hostClaim);
 		if (hostClaim.occupied) {
 			unsubscribeHostClaim();
-			warnAdapterIssue("ignored a second Provider Kit Host; only one Host is supported per Pi runtime");
+			warnAdapterIssue("ignored a second Pi Provider Host; only one Host is supported per Pi runtime");
 			return;
 		}
 
 		const registrations = new Map<object, AdapterRegistrationEnvelope>();
-		let active: ProviderKitRuntimeController | undefined;
-		let readyPromise: Promise<ProviderKitRuntimeController | undefined> | undefined;
+		let active: PiProviderRuntimeController | undefined;
+		let readyPromise: Promise<PiProviderRuntimeController | undefined> | undefined;
 		let disposed = false;
 		let lifecycleGeneration = 0;
 		let latestBackgroundPricing: Record<string, OfficialModelMeta> | undefined;
 		let installedDefinition:
 			| {
 					generation: number;
-					definition: ProviderKitDefinition;
+					definition: PiProviderDefinition;
 					providerDrafts: Map<ProviderAdapter, ProviderModelDraft[]>;
 			  }
 			| undefined;
@@ -97,7 +97,7 @@ export function createProviderKitHost(dependencies: Partial<ProviderKitDependenc
 			readyPromise = undefined;
 		};
 
-		const unsubscribeBridge = pi.events.on(PROVIDER_KIT_STARTUP_BRIDGE_EVENT, (value) => {
+		const unsubscribeBridge = pi.events.on(PI_PROVIDER_STARTUP_BRIDGE_EVENT, (value) => {
 			if (value === null || typeof value !== "object") return;
 			const request = value as StartupBridgeRequest;
 			request.bridge ??= bridge;
@@ -136,7 +136,7 @@ export function createProviderKitHost(dependencies: Partial<ProviderKitDependenc
 			if (previous === undefined) invalidateRuntime();
 		};
 
-		const unsubscribeRegistrations = pi.events.on(PROVIDER_KIT_ADAPTER_EVENT, receiveRegistration);
+		const unsubscribeRegistrations = pi.events.on(PI_PROVIDER_ADAPTER_EVENT, receiveRegistration);
 
 		const groupedWithoutConflicts = <T>(items: T[], key: (item: T) => string, label: string): T[] => {
 			const groups = new Map<string, T[]>();
@@ -173,7 +173,7 @@ export function createProviderKitHost(dependencies: Partial<ProviderKitDependenc
 		const buildDefinition = async (
 			ctx?: ExtensionContext,
 		): Promise<{
-			definition: ProviderKitDefinition;
+			definition: PiProviderDefinition;
 			providerDrafts: Map<ProviderAdapter, ProviderModelDraft[]>;
 			pricing: Record<string, OfficialModelMeta>;
 		}> => {
@@ -358,15 +358,15 @@ export function createProviderKitHost(dependencies: Partial<ProviderKitDependenc
 				preflights: preflightBindings,
 				tuners: tuners.sort(compareAdapterIds),
 			};
-			validateProviderKitDefinition(definition);
+			validatePiProviderDefinition(definition);
 			return { definition, providerDrafts, pricing };
 		};
 
-		const ensureReady = (ctx?: ExtensionContext): Promise<ProviderKitRuntimeController | undefined> => {
+		const ensureReady = (ctx?: ExtensionContext): Promise<PiProviderRuntimeController | undefined> => {
 			if (active) return Promise.resolve(active);
 			if (readyPromise) return readyPromise;
 			const generation = lifecycleGeneration;
-			const pending = (async (): Promise<ProviderKitRuntimeController | undefined> => {
+			const pending = (async (): Promise<PiProviderRuntimeController | undefined> => {
 				if (disposed || generation !== lifecycleGeneration) return undefined;
 				const { definition, providerDrafts, pricing } = await buildDefinition(ctx);
 				if (disposed || generation !== lifecycleGeneration) return undefined;
@@ -382,7 +382,7 @@ export function createProviderKitHost(dependencies: Partial<ProviderKitDependenc
 					for (const providerId of providerIds) pi.unregisterProvider(providerId);
 				}
 				if (disposed || generation !== lifecycleGeneration) return undefined;
-				const controller = installProviderKitRuntime(pi, runtime, definition, pricing, {
+				const controller = installPiProviderRuntime(pi, runtime, definition, pricing, {
 					registerHandlers: false,
 					providerDrafts,
 				});
@@ -442,7 +442,7 @@ export function createProviderKitHost(dependencies: Partial<ProviderKitDependenc
 }
 
 function fetchOfficialPricingForHost(
-	runtime: ProviderKitDependencies,
+	runtime: PiProviderDependencies,
 	onBackgroundRefresh?: (snapshot: Record<string, OfficialModelMeta>) => void,
 ) {
 	return fetchOfficialPricing(

package/core/official-pricing.ts

@@ -1,7 +1,7 @@
 import { randomUUID } from "node:crypto";
 import { mkdir, readFile, rename, unlink, writeFile } from "node:fs/promises";
-import { homedir } from "node:os";
 import { dirname, join } from "node:path";
+import { getAgentDir } from "@earendil-works/pi-coding-agent";
 import { withDeadline } from "./deadline.ts";
 import type { ModelQualityScore, ProviderCost, ProviderModel, ProviderModelDraft } from "./types.ts";
 
@@ -69,10 +69,7 @@ const pricingRequests = new Map<string, Promise<Record<string, OfficialModelMeta
 
 /** Default cache for OpenRouter metadata, not Pi's native model catalog. */
 export function getDefaultOpenRouterMetadataCachePath(): string {
-	const configuredAgentDir = process.env.PI_CODING_AGENT_DIR;
-	const agentDir =
-		configuredAgentDir && configuredAgentDir.trim() !== "" ? configuredAgentDir : join(homedir(), ".pi", "agent");
-	return join(agentDir, "provider-kit", "openrouter-model-metadata.json");
+	return join(getAgentDir(), "pi-provider", "openrouter-model-metadata.json");
 }
 
 function cloneCost(cost: ProviderCost): ProviderCost {

package/core/provider-registration.ts

@@ -1,7 +1,7 @@
 import type { ExtensionAPI, ProviderConfig } from "@earendil-works/pi-coding-agent";
 import { applyOfficialModelCosts, findOfficialMeta, type OfficialModelMeta } from "./official-pricing.ts";
 import { resolvePricingDetails } from "./pricing-adjustments.ts";
-import type { ProviderKitDependencies } from "./runtime-config.ts";
+import type { PiProviderDependencies } from "./runtime-config.ts";
 import type {
 	ProviderAdapter,
 	ProviderCost,
@@ -109,7 +109,7 @@ function selectPricingAdjustment(
 
 function resolveModelRegistration(
 	adapter: ProviderAdapter,
-	runtime: ProviderKitDependencies,
+	runtime: PiProviderDependencies,
 	modelDrafts: ProviderModelDraft[],
 	officialPricing: Record<string, OfficialModelMeta>,
 ): { models: ProviderModel[]; modelMetadata: Record<string, ProviderModelMetadata> } {
@@ -184,7 +184,7 @@ function getErrorCode(error: unknown): string {
  */
 export function prepareProviderRegistration(
 	adapter: ProviderAdapter,
-	runtime: ProviderKitDependencies,
+	runtime: PiProviderDependencies,
 	officialPricing: Record<string, OfficialModelMeta> = {},
 	modelDrafts?: ProviderModelDraft[],
 ): ProviderConfig {
@@ -239,7 +239,7 @@ export function prepareProviderRegistration(
 export function refreshProviderRegistrations(
 	pi: Pick<ExtensionAPI, "registerProvider">,
 	providers: readonly ProviderAdapter[],
-	runtime: ProviderKitDependencies,
+	runtime: PiProviderDependencies,
 	officialPricing: Record<string, OfficialModelMeta>,
 	providerDrafts?: ReadonlyMap<ProviderAdapter, ProviderModelDraft[]>,
 ): void {
@@ -251,7 +251,7 @@ export function refreshProviderRegistrations(
 export function registerProviderAdapter(
 	pi: Pick<ExtensionAPI, "registerProvider">,
 	adapter: ProviderAdapter,
-	runtime: ProviderKitDependencies,
+	runtime: PiProviderDependencies,
 	officialPricing: Record<string, OfficialModelMeta> = {},
 	modelDrafts?: ProviderModelDraft[],
 ): ProviderConfig {

package/core/runtime-config.ts

@@ -1,10 +1,10 @@
 import { isValidTimeoutMs } from "./deadline.ts";
-import type { ProviderKitDefinition } from "./definition.ts";
+import type { PiProviderDefinition } from "./definition.ts";
 import { getDefaultOpenRouterMetadataCachePath, OPENROUTER_MODELS_URL } from "./official-pricing.ts";
 import { validatePricingPolicy } from "./pricing-adjustments.ts";
 import type { ProviderPricingPolicy } from "./types.ts";
 
-export interface ProviderKitDependencies {
+export interface PiProviderDependencies {
 	fetch: typeof globalThis.fetch;
 	now: () => number;
 	modelDiscoveryTimeoutMs: number;
@@ -17,13 +17,13 @@ export interface ProviderKitDependencies {
 	/** Persistent cache for OpenRouter metadata used by the pricing fallback. */
 	openRouterMetadataCachePath: string;
 	enableOfficialPricingFallback: boolean;
-	/** Optional Provider Kit-level price policies keyed by Provider ID. */
+	/** Optional Pi Provider-level price policies keyed by Provider ID. */
 	pricingPolicies?: Record<string, ProviderPricingPolicy>;
 }
 
-export type ProviderKitLoader = (runtime: ProviderKitDependencies) => Promise<ProviderKitDefinition>;
+export type PiProviderLoader = (runtime: PiProviderDependencies) => Promise<PiProviderDefinition>;
 
-const defaultDependencies: ProviderKitDependencies = {
+const defaultDependencies: PiProviderDependencies = {
 	fetch: globalThis.fetch,
 	now: Date.now,
 	modelDiscoveryTimeoutMs: 3_000,
@@ -38,37 +38,37 @@ const defaultDependencies: ProviderKitDependencies = {
 	pricingPolicies: {},
 };
 
-export function getDefaultProviderKitDependencies(): ProviderKitDependencies {
+export function getDefaultPiProviderDependencies(): PiProviderDependencies {
 	return { ...defaultDependencies };
 }
 
-export function validateProviderKitDependencies(runtime: ProviderKitDependencies): void {
-	if (typeof runtime.fetch !== "function") throw new Error("Provider Kit fetch must be a function");
-	if (typeof runtime.now !== "function") throw new Error("Provider Kit now must be a function");
+export function validatePiProviderDependencies(runtime: PiProviderDependencies): void {
+	if (typeof runtime.fetch !== "function") throw new Error("Pi Provider fetch must be a function");
+	if (typeof runtime.now !== "function") throw new Error("Pi Provider now must be a function");
 	for (const [name, value] of [
 		["modelDiscoveryTimeoutMs", runtime.modelDiscoveryTimeoutMs],
 		["statusRequestTimeoutMs", runtime.statusRequestTimeoutMs],
 		["liveCheckRequestTimeoutMs", runtime.liveCheckRequestTimeoutMs],
 		["officialPricingTimeoutMs", runtime.officialPricingTimeoutMs],
 	] as const) {
-		if (!isValidTimeoutMs(value)) throw new Error(`Provider Kit ${name} must be a valid timeout`);
+		if (!isValidTimeoutMs(value)) throw new Error(`Pi Provider ${name} must be a valid timeout`);
 	}
 	for (const [name, value] of [
 		["officialPricingCacheTtlMs", runtime.officialPricingCacheTtlMs],
 		["officialPricingMaxStaleMs", runtime.officialPricingMaxStaleMs],
 	] as const) {
 		if (typeof value !== "number" || !Number.isFinite(value) || value < 0) {
-			throw new Error(`Provider Kit ${name} must be a finite non-negative number`);
+			throw new Error(`Pi Provider ${name} must be a finite non-negative number`);
 		}
 	}
 	if (typeof runtime.officialPricingUrl !== "string" || runtime.officialPricingUrl.trim() === "") {
-		throw new Error("Provider Kit officialPricingUrl must be a non-empty string");
+		throw new Error("Pi Provider officialPricingUrl must be a non-empty string");
 	}
 	if (typeof runtime.openRouterMetadataCachePath !== "string" || runtime.openRouterMetadataCachePath.trim() === "") {
-		throw new Error("Provider Kit openRouterMetadataCachePath must be a non-empty path");
+		throw new Error("Pi Provider openRouterMetadataCachePath must be a non-empty path");
 	}
 	if (typeof runtime.enableOfficialPricingFallback !== "boolean") {
-		throw new Error("Provider Kit enableOfficialPricingFallback must be a boolean");
+		throw new Error("Pi Provider enableOfficialPricingFallback must be a boolean");
 	}
 	if (runtime.pricingPolicies !== undefined) {
 		if (
@@ -76,20 +76,20 @@ export function validateProviderKitDependencies(runtime: ProviderKitDependencies
 			typeof runtime.pricingPolicies !== "object" ||
 			Array.isArray(runtime.pricingPolicies)
 		) {
-			throw new Error("Provider Kit pricingPolicies must be an object");
+			throw new Error("Pi Provider pricingPolicies must be an object");
 		}
 		for (const [providerId, policy] of Object.entries(runtime.pricingPolicies)) {
-			if (providerId.trim() === "") throw new Error("Provider Kit pricingPolicies has an empty Provider ID");
-			validatePricingPolicy(policy, `Provider Kit pricingPolicies.${providerId}`);
+			if (providerId.trim() === "") throw new Error("Pi Provider pricingPolicies has an empty Provider ID");
+			validatePricingPolicy(policy, `Pi Provider pricingPolicies.${providerId}`);
 		}
 	}
 }
 
-export function resolveProviderKitDependencies(
-	dependencies: Partial<ProviderKitDependencies> = {},
-): ProviderKitDependencies {
+export function resolvePiProviderDependencies(
+	dependencies: Partial<PiProviderDependencies> = {},
+): PiProviderDependencies {
 	const runtime = { ...defaultDependencies, ...dependencies };
 	if (runtime.pricingPolicies === undefined) runtime.pricingPolicies = {};
-	validateProviderKitDependencies(runtime);
+	validatePiProviderDependencies(runtime);
 	return runtime;
 }

package/core/runtime.ts

@@ -1,8 +1,8 @@
 import type { ExtensionAPI, ExtensionContext } from "@earendil-works/pi-coding-agent";
 import { readStoredCredential } from "@earendil-works/pi-coding-agent";
 import { wrapTextWithAnsi } from "@earendil-works/pi-tui";
-import type { ProviderKitDefinition } from "./definition.ts";
-import { validateProviderKitDefinition } from "./definition.ts";
+import type { PiProviderDefinition } from "./definition.ts";
+import { validatePiProviderDefinition } from "./definition.ts";
 import { LiveCheckManager, type LiveCheckResult } from "./live-check-manager.ts";
 import {
 	fetchOfficialPricing,
@@ -14,8 +14,8 @@ import {
 import type { PreflightContextLike } from "./preflight-manager.ts";
 import { PreflightManager } from "./preflight-manager.ts";
 import { refreshProviderRegistrations, registerProviderAdapter } from "./provider-registration.ts";
-import type { ProviderKitDependencies, ProviderKitLoader } from "./runtime-config.ts";
-import { resolveProviderKitDependencies } from "./runtime-config.ts";
+import type { PiProviderDependencies, PiProviderLoader } from "./runtime-config.ts";
+import { resolvePiProviderDependencies } from "./runtime-config.ts";
 import type { StatusContextLike } from "./status-manager.ts";
 import { StatusManager } from "./status-manager.ts";
 import {
@@ -39,7 +39,7 @@ type ActiveModel = NonNullable<ExtensionContext["model"]>;
 type StatusNotificationContext = Pick<ExtensionContext, "modelRegistry" | "ui"> & {
 	mode?: ExtensionContext["mode"];
 };
-const STATUS_WIDGET_KEY = "provider-kit-status";
+const STATUS_WIDGET_KEY = "pi-provider-status";
 
 function readProviderCredentialMetadata(provider: string): unknown {
 	try {
@@ -103,7 +103,7 @@ export function scheduleModelCatalogRefresh(ctx: Pick<ExtensionContext, "modelRe
 		.catch(() => undefined);
 }
 
-export interface ProviderKitRuntimeController {
+export interface PiProviderRuntimeController {
 	resetForSession(): void;
 	updateOfficialPricing?(snapshot: Record<string, OfficialModelMeta>): void;
 	shutdown(): void;
@@ -126,7 +126,7 @@ function cloneProviderCost(cost: ProviderCost): ProviderCost {
 
 function getOfficialMetadataStatus(
 	snapshot: Record<string, OfficialModelMeta>,
-	runtime: ProviderKitDependencies,
+	runtime: PiProviderDependencies,
 ): ModelMetadataStatus | undefined {
 	const source = runtime.officialPricingUrl === OPENROUTER_MODELS_URL ? "AA/OpenRouter" : "Official metadata";
 	if (!runtime.enableOfficialPricingFallback && Object.keys(snapshot).length === 0) return undefined;
@@ -185,17 +185,17 @@ function getNativeModelMetadata(
 	};
 }
 
-export function installProviderKitRuntime(
+export function installPiProviderRuntime(
 	pi: ExtensionAPI,
-	runtime: ProviderKitDependencies,
-	definition: ProviderKitDefinition,
+	runtime: PiProviderDependencies,
+	definition: PiProviderDefinition,
 	officialPricing: Record<string, OfficialModelMeta> = {},
 	options: {
 		registerHandlers?: boolean;
 		providerDrafts?: ReadonlyMap<ProviderAdapter, ProviderModelDraft[]>;
 	} = {},
-): ProviderKitRuntimeController {
-	validateProviderKitDefinition(definition);
+): PiProviderRuntimeController {
+	validatePiProviderDefinition(definition);
 	const registerHandlers = options.registerHandlers ?? true;
 	let currentOfficialPricing = officialPricing;
 	let currentOfficialMetadataStatus = getOfficialMetadataStatus(officialPricing, runtime);
@@ -387,7 +387,7 @@ export function installProviderKitRuntime(
 		liveCheckManager.clear();
 	};
 
-	const controller: ProviderKitRuntimeController = {
+	const controller: PiProviderRuntimeController = {
 		resetForSession,
 		updateOfficialPricing(snapshot) {
 			currentOfficialPricing = snapshot;
@@ -425,15 +425,15 @@ export function installProviderKitRuntime(
 	return controller;
 }
 
-export function createProviderKitRuntime(
-	loadDefinition: ProviderKitLoader,
-	dependencies: Partial<ProviderKitDependencies> = {},
+export function createPiProviderRuntime(
+	loadDefinition: PiProviderLoader,
+	dependencies: Partial<PiProviderDependencies> = {},
 ): (pi: ExtensionAPI) => Promise<void> {
-	const runtime = resolveProviderKitDependencies(dependencies);
+	const runtime = resolvePiProviderDependencies(dependencies);
 	return async (pi) => {
 		let latestBackgroundPricing: Record<string, OfficialModelMeta> | undefined;
-		let installedDefinition: ProviderKitDefinition | undefined;
-		let installedController: ProviderKitRuntimeController | undefined;
+		let installedDefinition: PiProviderDefinition | undefined;
+		let installedController: PiProviderRuntimeController | undefined;
 		let disposed = false;
 		const onBackgroundRefresh = (snapshot: Record<string, OfficialModelMeta>): void => {
 			latestBackgroundPricing = snapshot;
@@ -462,8 +462,8 @@ export function createProviderKitRuntime(
 			: Promise.resolve({});
 		const definitionPromise = loadDefinition(runtime);
 		const [officialPricing, definition] = await Promise.all([officialPricingPromise, definitionPromise]);
-		validateProviderKitDefinition(definition);
-		installedController = installProviderKitRuntime(pi, runtime, definition, officialPricing);
+		validatePiProviderDefinition(definition);
+		installedController = installPiProviderRuntime(pi, runtime, definition, officialPricing);
 		installedDefinition = definition;
 		if (latestBackgroundPricing !== undefined) onBackgroundRefresh(latestBackgroundPricing);
 		pi.on("session_shutdown", () => {

package/core/status-report.ts

@@ -264,7 +264,7 @@ function formatCatalog(
 	now: number,
 ): { lines: string[]; issue: ReportIssue } {
 	if (!adapter) {
-		if (!nativeLookupAvailable) return { lines: ["Status: not managed by Provider Kit"], issue: { level: "none" } };
+		if (!nativeLookupAvailable) return { lines: ["Status: not managed by Pi Provider"], issue: { level: "none" } };
 		if (!nativeProvider) return { lines: ["Status: unavailable in Pi"], issue: { level: "none" } };
 		const count = getNativeModelCount(nativeProvider);
 		return {
@@ -482,7 +482,7 @@ function appendLiveCheckReport(
 		return { level: "none" };
 	}
 	if (options.showScope) {
-		lines.push("Live check scope: streamSimple() · Provider Kit tuners only (other hooks not replayed)");
+		lines.push("Live check scope: streamSimple() · Pi Provider tuners only (other hooks not replayed)");
 	}
 	if (diagnostics?.pending) lines.push("Availability: checking");
 	else if (!diagnostics?.snapshot && !diagnostics?.lastError) lines.push("Availability: not checked");

package/core/types.ts

@@ -10,7 +10,7 @@ export type ThinkingLevel = ReturnType<ExtensionAPI["getThinkingLevel"]>;
 export type ProviderCost = ProviderModelConfig["cost"];
 export type ProviderModel = ProviderModelConfig;
 export type PricingSku = "input" | "output" | "cacheRead" | "cacheWrite";
-/** Pricing provenance used by Provider Kit sidecars; not added to Pi model objects. */
+/** Pricing provenance used by Pi Provider sidecars; not added to Pi model objects. */
 export type ProviderPricingSource = "provider" | "fallback" | "official";
 export type ModelPricingSource = ProviderPricingSource | "native";
 export type ModelFieldSource = ProviderPricingSource | "native" | "default";

package/index.ts

@@ -1,4 +1,7 @@
-import { createProviderKitHost } from "./core/host.ts";
+import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
+import { loadPackageAdapterExtensions } from "./core/adapter-loader.ts";
+import { createPiProviderHost } from "./core/host.ts";
+import type { PiProviderDependencies } from "./core/runtime-config.ts";
 
 export type {
 	AdapterExtensionContext,
@@ -16,22 +19,22 @@ export {
 export type { ProviderDataErrorLike } from "./core/errors.ts";
 export { isProviderDataError, ProviderDataError } from "./core/errors.ts";
 export type {
-	ProviderKitDefinition,
-	ProviderKitDependencies,
-	ProviderKitLoader,
-	ProviderKitRuntimeController,
+	PiProviderDefinition,
+	PiProviderDependencies,
+	PiProviderLoader,
+	PiProviderRuntimeController,
 } from "./core/extension.ts";
 export {
-	createProviderKitRuntime,
-	getDefaultProviderKitDependencies,
-	installProviderKitRuntime,
+	createPiProviderRuntime,
+	getDefaultPiProviderDependencies,
+	installPiProviderRuntime,
 	prepareProviderRegistration,
 	registerProviderAdapter,
-	resolveProviderKitDependencies,
-	validateProviderKitDefinition,
-	validateProviderKitDependencies,
+	resolvePiProviderDependencies,
+	validatePiProviderDefinition,
+	validatePiProviderDependencies,
 } from "./core/extension.ts";
-export { createProviderKitHost } from "./core/host.ts";
+export { createPiProviderHost } from "./core/host.ts";
 export type {
 	LiveCheckContextLike,
 	LiveCheckDiagnostics,
@@ -105,4 +108,22 @@ export type {
 	TunerContext,
 } from "./core/types.ts";
 
-export default createProviderKitHost();
+export interface PiProviderExtensionOptions {
+	/** Package root containing providers, status, preflight, and tuners directories. */
+	adapterRoot?: string;
+	/** Host runtime dependency overrides. */
+	dependencies?: Partial<PiProviderDependencies>;
+}
+
+/** Create one Pi extension that discovers the current Adapter files when it loads. */
+export function createPiProviderExtension(
+	options: PiProviderExtensionOptions = {},
+): (pi: ExtensionAPI) => Promise<void> {
+	const piProviderHost = createPiProviderHost(options.dependencies);
+	return async (pi) => {
+		piProviderHost(pi);
+		await loadPackageAdapterExtensions(pi, options.adapterRoot);
+	};
+}
+
+export default createPiProviderExtension();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hyav/pi-provider",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "Provider extension toolkit for Pi to integrate and manage custom LLM providers with dynamic models, request tuners, and account status.",
   "author": "hyav",
   "license": "MIT",
@@ -25,7 +25,7 @@
     "pi-package",
     "pi",
     "provider",
-    "provider-kit",
+    "pi-provider",
     "charm-hyper",
     "llm"
   ],
@@ -37,6 +37,7 @@
     "audit:all": "npm audit --audit-level=high",
     "artifact:check": "node scripts/check-package.mjs",
     "release:check": "node scripts/check-release.mjs",
+    "release:notes": "node scripts/write-release-notes.mjs",
     "prepublishOnly": "npm run audit:runtime && npm run audit:all && npm run release:check && npm run check && npm test && npm run artifact:check"
   },
   "engines": {
@@ -56,11 +57,7 @@
   },
   "pi": {
     "extensions": [
-      "./index.ts",
-      "./providers/*.ts",
-      "./status/*.ts",
-      "./preflight/*.ts",
-      "./tuners/*.ts"
+      "./index.ts"
     ]
   },
   "files": [
@@ -77,5 +74,8 @@
     "SECURITY.md",
     "SUPPORT.md",
     "LICENSE"
-  ]
+  ],
+  "dependencies": {
+    "jiti": "2.7.0"
+  }
 }