@eiei114/pi-sub-core 1.5.1

package/src/providers/metadata.ts

@@ -0,0 +1,16 @@
+/**
+ * Provider metadata shared across the core.
+ */
+
+export {
+	PROVIDERS,
+	PROVIDER_METADATA,
+	PROVIDER_DISPLAY_NAMES,
+} from "@eiei114/pi-sub-shared";
+
+export type {
+	ProviderName,
+	ProviderMetadata,
+	ProviderStatusConfig,
+	ProviderDetectionConfig,
+} from "@eiei114/pi-sub-shared";

package/src/providers/registry.ts

@@ -0,0 +1,54 @@
+/**
+ * Provider registry - exports all providers
+ */
+
+export { AnthropicProvider } from "./impl/anthropic.js";
+export { CopilotProvider } from "./impl/copilot.js";
+export { GeminiProvider } from "./impl/gemini.js";
+export { AntigravityProvider } from "./impl/antigravity.js";
+export { CodexProvider } from "./impl/codex.js";
+export { KiroProvider } from "./impl/kiro.js";
+export { ZaiProvider } from "./impl/zai.js";
+
+import type { Dependencies, ProviderName } from "../types.js";
+import type { UsageProvider } from "../provider.js";
+import { PROVIDERS } from "./metadata.js";
+import { AnthropicProvider } from "./impl/anthropic.js";
+import { CopilotProvider } from "./impl/copilot.js";
+import { GeminiProvider } from "./impl/gemini.js";
+import { AntigravityProvider } from "./impl/antigravity.js";
+import { CodexProvider } from "./impl/codex.js";
+import { KiroProvider } from "./impl/kiro.js";
+import { ZaiProvider } from "./impl/zai.js";
+
+const PROVIDER_FACTORIES: Record<ProviderName, () => UsageProvider> = {
+	anthropic: () => new AnthropicProvider(),
+	copilot: () => new CopilotProvider(),
+	gemini: () => new GeminiProvider(),
+	antigravity: () => new AntigravityProvider(),
+	codex: () => new CodexProvider(),
+	kiro: () => new KiroProvider(),
+	zai: () => new ZaiProvider(),
+};
+
+/**
+ * Create a provider instance by name
+ */
+export function createProvider(name: ProviderName): UsageProvider {
+	return PROVIDER_FACTORIES[name]();
+}
+
+/**
+ * Get all provider instances
+ */
+export function getAllProviders(): UsageProvider[] {
+	return PROVIDERS.map((name) => PROVIDER_FACTORIES[name]());
+}
+
+export function hasProviderCredentials(name: ProviderName, deps: Dependencies): boolean {
+	const provider = createProvider(name);
+	if (provider.hasCredentials) {
+		return provider.hasCredentials(deps);
+	}
+	return true;
+}

package/src/providers/settings.ts

@@ -0,0 +1,109 @@
+/**
+ * Provider-specific settings helpers.
+ */
+
+import type { SettingItem } from "@mariozechner/pi-tui";
+import type { ProviderName } from "../types.js";
+import type { Settings, CoreProviderSettings } from "../settings-types.js";
+import { CUSTOM_OPTION } from "../ui/settings-list.js";
+
+function buildBaseProviderItems(ps: CoreProviderSettings): SettingItem[] {
+	const enabledValue = ps.enabled === "auto" ? "auto" : ps.enabled === true || ps.enabled === "on" ? "on" : "off";
+	return [
+		{
+			id: "enabled",
+			label: "Enabled",
+			currentValue: enabledValue,
+			values: ["auto", "on", "off"],
+			description: "Auto enables if credentials are detected.",
+		},
+		{
+			id: "fetchStatus",
+			label: "Fetch Status",
+			currentValue: ps.fetchStatus ? "on" : "off",
+			values: ["on", "off"],
+			description: "Fetch status page indicator for this provider.",
+		},
+	];
+}
+
+function resolveEnabledValue(value: string): CoreProviderSettings["enabled"] {
+	if (value === "auto") return "auto";
+	return value === "on";
+}
+
+function applyBaseProviderSetting(ps: CoreProviderSettings, id: string, value: string): boolean {
+	switch (id) {
+		case "enabled":
+			ps.enabled = resolveEnabledValue(value);
+			return true;
+		case "fetchStatus":
+			ps.fetchStatus = value === "on";
+			return true;
+		default:
+			return false;
+	}
+}
+
+/**
+ * Build settings items for a specific provider.
+ */
+export function buildProviderSettingsItems(settings: Settings, provider: ProviderName): SettingItem[] {
+	const ps = settings.providers[provider];
+	const items = buildBaseProviderItems(ps);
+
+	if (provider === "anthropic") {
+		const currencySymbol = ps.extraUsageCurrencySymbol?.trim();
+		items.push(
+			{
+				id: "extraUsageCurrencySymbol",
+				label: "Extra Usage Currency Symbol",
+				currentValue: currencySymbol ? currencySymbol : "none",
+				values: ["none", CUSTOM_OPTION],
+				description: "Prefix symbol for Extra usage amounts.",
+			},
+			{
+				id: "extraUsageDecimalSeparator",
+				label: "Extra Usage Decimal Separator",
+				currentValue: ps.extraUsageDecimalSeparator === "," ? "," : ".",
+				values: [".", ","],
+				description: "Decimal separator for Extra usage amounts.",
+			},
+		);
+	}
+
+	return items;
+}
+
+/**
+ * Apply a provider settings change in-place.
+ */
+export function applyProviderSettingsChange(
+	settings: Settings,
+	provider: ProviderName,
+	id: string,
+	value: string
+): Settings {
+	const ps = settings.providers[provider];
+	if (applyBaseProviderSetting(ps, id, value)) {
+		return settings;
+	}
+
+	switch (id) {
+		case "extraUsageCurrencySymbol":
+			if (value === CUSTOM_OPTION) {
+				return settings;
+			}
+			if (value === "none") {
+				delete ps.extraUsageCurrencySymbol;
+				return settings;
+			}
+			ps.extraUsageCurrencySymbol = value;
+			return settings;
+		case "extraUsageDecimalSeparator":
+			ps.extraUsageDecimalSeparator = value === "," ? "," : ".";
+			return settings;
+		default:
+			return settings;
+	}
+}

package/src/providers/status.ts

@@ -0,0 +1,25 @@
+/**
+ * Provider status handling helpers.
+ */
+
+import type { Dependencies, ProviderName, ProviderStatus } from "../types.js";
+import { fetchProviderStatus } from "../status.js";
+import { PROVIDER_METADATA } from "./metadata.js";
+
+export function providerHasStatus(
+	provider: ProviderName,
+	providerInstance?: { fetchStatus?: (deps: Dependencies) => Promise<ProviderStatus> }
+): boolean {
+	return Boolean(providerInstance?.fetchStatus) || Boolean(PROVIDER_METADATA[provider]?.status);
+}
+
+export async function fetchProviderStatusWithFallback(
+	provider: ProviderName,
+	providerInstance: { fetchStatus?: (deps: Dependencies) => Promise<ProviderStatus> },
+	deps: Dependencies
+): Promise<ProviderStatus> {
+	if (providerInstance.fetchStatus) {
+		return providerInstance.fetchStatus(deps);
+	}
+	return fetchProviderStatus(provider, deps);
+}

package/src/settings/behavior.ts

@@ -0,0 +1,58 @@
+/**
+ * Behavior settings UI helpers.
+ */
+
+import type { SettingItem } from "@mariozechner/pi-tui";
+import type { BehaviorSettings } from "../settings-types.js";
+import { CUSTOM_OPTION } from "../ui/settings-list.js";
+
+export function buildRefreshItems(settings: BehaviorSettings): SettingItem[] {
+	return [
+		{
+			id: "refreshInterval",
+			label: "Auto-refresh Interval",
+			currentValue: settings.refreshInterval === 0 ? "off" : `${settings.refreshInterval}s`,
+			values: ["off", "15s", "30s", "60s", "120s", "300s", CUSTOM_OPTION],
+			description: "How often to refresh automatically.",
+		},
+		{
+			id: "minRefreshInterval",
+			label: "Minimum Refresh Interval",
+			currentValue: settings.minRefreshInterval === 0 ? "off" : `${settings.minRefreshInterval}s`,
+			values: ["off", "5s", "10s", "15s", "30s", "60s", "120s", CUSTOM_OPTION],
+			description: "Cap refreshes even when triggered each turn.",
+		},
+		{
+			id: "refreshOnTurnStart",
+			label: "Refresh on Turn Start",
+			currentValue: settings.refreshOnTurnStart ? "on" : "off",
+			values: ["on", "off"],
+			description: "Refresh when a new turn starts.",
+		},
+		{
+			id: "refreshOnToolResult",
+			label: "Refresh on Tool Result",
+			currentValue: settings.refreshOnToolResult ? "on" : "off",
+			values: ["on", "off"],
+			description: "Refresh after tool executions.",
+		},
+	];
+}
+
+export function applyRefreshChange(settings: BehaviorSettings, id: string, value: string): BehaviorSettings {
+	switch (id) {
+		case "refreshInterval":
+			settings.refreshInterval = value === "off" ? 0 : parseInt(value, 10);
+			break;
+		case "minRefreshInterval":
+			settings.minRefreshInterval = value === "off" ? 0 : parseInt(value, 10);
+			break;
+		case "refreshOnTurnStart":
+			settings.refreshOnTurnStart = value === "on";
+			break;
+		case "refreshOnToolResult":
+			settings.refreshOnToolResult = value === "on";
+			break;
+	}
+	return settings;
+}

package/src/settings/menu.ts

@@ -0,0 +1,83 @@
+/**
+ * Settings menu item builders.
+ */
+
+import type { SelectItem } from "@mariozechner/pi-tui";
+import type { Settings } from "../settings-types.js";
+import type { ProviderName } from "../types.js";
+import { PROVIDER_DISPLAY_NAMES } from "../providers/metadata.js";
+
+export type TooltipSelectItem = SelectItem & { tooltip?: string };
+
+export function buildMainMenuItems(settings: Settings): TooltipSelectItem[] {
+	const enabledCount = Object.values(settings.providers).filter((p) => p.enabled !== "off" && p.enabled !== false).length;
+	const totalCount = Object.keys(settings.providers).length;
+	const toolEnabledCount = [settings.tools.usageTool, settings.tools.allUsageTool].filter(Boolean).length;
+	const toolTotalCount = 2;
+
+	return [
+		{
+			value: "providers",
+			label: "Provider Settings",
+			description: `${enabledCount}/${totalCount} enabled`,
+			tooltip: "Enable providers, toggle status fetch, and adjust provider settings.",
+		},
+		{
+			value: "behavior",
+			label: "Usage Refresh Settings",
+			description: `refresh ${settings.behavior.refreshInterval}s`,
+			tooltip: "Control usage refresh interval and triggers.",
+		},
+		{
+			value: "status-refresh",
+			label: "Status Refresh Settings",
+			description: `refresh ${settings.statusRefresh.refreshInterval}s`,
+			tooltip: "Control status refresh interval and triggers.",
+		},
+		{
+			value: "tools",
+			label: "Tool Settings",
+			description: `${toolEnabledCount}/${toolTotalCount} enabled`,
+			tooltip: "Enable sub-core tools (requires /reload to take effect).",
+		},
+		{
+			value: "provider-order",
+			label: "Provider Order",
+			description: settings.providerOrder.slice(0, 3).join(", ") + "...",
+			tooltip: "Reorder providers for cycling and auto-selection.",
+		},
+		{
+			value: "reset",
+			label: "Reset to Defaults",
+			description: "restore all settings",
+			tooltip: "Restore all sub-core settings to defaults.",
+		},
+	];
+}
+
+export function buildProviderListItems(settings: Settings): TooltipSelectItem[] {
+	return settings.providerOrder.map((provider) => {
+		const ps = settings.providers[provider];
+		const enabledValue = ps.enabled === "auto" ? "auto" : ps.enabled === true || ps.enabled === "on" ? "on" : "off";
+		const statusIcon = ps.fetchStatus ? ", status fetch on" : "";
+		return {
+			value: `provider-${provider}`,
+			label: PROVIDER_DISPLAY_NAMES[provider],
+			description: `enabled ${enabledValue}${statusIcon}`,
+			tooltip: `Enable ${PROVIDER_DISPLAY_NAMES[provider]} and configure status fetching.`,
+		};
+	});
+}
+
+export function buildProviderOrderItems(settings: Settings): TooltipSelectItem[] {
+	const activeProviders = settings.providerOrder.filter((provider) => {
+		const enabled = settings.providers[provider].enabled;
+		return enabled !== "off" && enabled !== false;
+	});
+	return activeProviders.map((provider, index) => ({
+		value: provider,
+		label: `${index + 1}. ${PROVIDER_DISPLAY_NAMES[provider]}`,
+		tooltip: "Reorder enabled providers (Space to toggle move mode).",
+	}));
+}
+

package/src/settings/tools.ts

@@ -0,0 +1,38 @@
+/**
+ * Tool settings UI helpers.
+ */
+
+import type { SettingItem } from "@mariozechner/pi-tui";
+import type { Settings, ToolSettings } from "../settings-types.js";
+
+export function buildToolItems(settings: ToolSettings): SettingItem[] {
+	return [
+		{
+			id: "usageTool",
+			label: "Usage Tool",
+			currentValue: settings.usageTool ? "on" : "off",
+			values: ["on", "off"],
+			description: "Expose sub_get_usage/get_current_usage (requires /reload).",
+		},
+		{
+			id: "allUsageTool",
+			label: "All Usage Tool",
+			currentValue: settings.allUsageTool ? "on" : "off",
+			values: ["on", "off"],
+			description: "Expose sub_get_all_usage/get_all_usage (requires /reload).",
+		},
+	];
+}
+
+export function applyToolChange(settings: Settings, id: string, value: string): Settings {
+	const enabled = value === "on";
+	switch (id) {
+		case "usageTool":
+			settings.tools.usageTool = enabled;
+			break;
+		case "allUsageTool":
+			settings.tools.allUsageTool = enabled;
+			break;
+	}
+	return settings;
+}