pi-harness-runtime 1.1.445 → 1.1.446

package/packages/provider-router/src/provider-router.ts

@@ -1,315 +0,0 @@
-/**
- * Enhanced Provider Router (RFC-0054)
- */
-
-import type {
-	ProviderCandidate,
-	ProviderRouter,
-	ProviderRouterEvent,
-	RoutingContext,
-	RoutingDecision,
-	RoutingOptions,
-	RoutingPolicy,
-	RoutingStrategy,
-} from "./types.js";
-import { DEFAULT_ROUTING_POLICY } from "./policy.js";
-import {
-	applyStrategy,
-	createDecision,
-	calculateWeightedScore,
-} from "./strategies.js";
-
-type EventHandler = (event: ProviderRouterEvent) => void;
-
-interface CandidateProvider {
-	providerId: string;
-	modelId: string;
-	estimatedCost?: number;
-	estimatedLatency?: "fast" | "medium" | "slow";
-	qualityScore?: number;
-}
-
-/**
- * Enhanced Provider Router with capability and cost awareness
- */
-export class EnhancedProviderRouter implements ProviderRouter {
-	private policy: RoutingPolicy;
-	private eventHandlers: Set<EventHandler> = new Set();
-
-	// Default providers for fallback
-	private defaultCandidates: CandidateProvider[] = [
-		{
-			providerId: "anthropic",
-			modelId: "claude-sonnet-4",
-			estimatedCost: 0.003, // $3/1M tokens average
-			estimatedLatency: "fast",
-			qualityScore: 90,
-		},
-		{
-			providerId: "openai",
-			modelId: "gpt-4o-mini",
-			estimatedCost: 0.0006,
-			estimatedLatency: "fast",
-			qualityScore: 82,
-		},
-		{
-			providerId: "minimax",
-			modelId: "MiniMax-Text-01",
-			estimatedCost: 0.0001,
-			estimatedLatency: "fast",
-			qualityScore: 75,
-		},
-		{
-			providerId: "google",
-			modelId: "gemini-1.5-flash",
-			estimatedCost: 0.00007,
-			estimatedLatency: "fast",
-			qualityScore: 78,
-		},
-	];
-
-	constructor(policy?: RoutingPolicy) {
-		this.policy = policy ?? DEFAULT_ROUTING_POLICY;
-	}
-
-	/**
-	 * Select the best provider for a task
-	 */
-	async selectProvider(
-		task: RoutingContext["task"],
-		context: RoutingContext,
-		options?: RoutingOptions,
-	): Promise<RoutingDecision> {
-		const candidates = this.buildCandidates(context, options);
-
-		// Filter candidates
-		const filtered = this.filterCandidates(candidates, context, options);
-
-		if (filtered.length === 0) {
-			this.emit({
-				type: "router.no_candidates",
-				taskId: task.id,
-				reason: "All candidates filtered out",
-			});
-
-			// Fallback to default
-			const fallback = this.policy.fallbackProviders[0];
-			const defaultCandidate =
-				this.defaultCandidates.find((c) => c.providerId === fallback) ??
-				this.defaultCandidates[0];
-
-			return createDecision(
-				{
-					providerId: defaultCandidate.providerId,
-					modelId: defaultCandidate.modelId,
-					capabilities: [],
-					estimatedCost: defaultCandidate.estimatedCost,
-					estimatedLatency: defaultCandidate.estimatedLatency ?? "medium",
-					qualityScore: defaultCandidate.qualityScore,
-					remainingQuotaPct:
-						context.quotaStates[defaultCandidate.providerId]?.remainingPct ?? 1,
-				},
-				`Fallback to ${defaultCandidate.providerId}`,
-			);
-		}
-
-		// Determine strategy
-		const strategy = this.determineStrategy(task, options);
-
-		// Apply strategy
-		const selected = applyStrategy(filtered, strategy, this.policy, options);
-
-		const decision = createDecision(
-			selected,
-			`Selected via ${strategy} strategy`,
-		);
-
-		this.emit({
-			type: "router.provider_selected",
-			taskId: task.id,
-			providerId: decision.providerId,
-			reason: decision.reason,
-		});
-
-		return decision;
-	}
-
-	/**
-	 * Select multiple providers
-	 */
-	async selectProviders(
-		task: RoutingContext["task"],
-		context: RoutingContext,
-		count: number,
-	): Promise<RoutingDecision[]> {
-		const candidates = this.buildCandidates(context);
-		const sorted = candidates.sort((a, b) => {
-			return (
-				calculateWeightedScore(b, this.policy) -
-				calculateWeightedScore(a, this.policy)
-			);
-		});
-
-		const selected = sorted.slice(0, count);
-
-		return selected.map((c, i) =>
-			createDecision(c, `Ranked #${i + 1} for ${task.id}`),
-		);
-	}
-
-	/**
-	 * Get current routing policy
-	 */
-	getRoutingPolicy(): RoutingPolicy {
-		return { ...this.policy };
-	}
-
-	/**
-	 * Update routing policy
-	 */
-	setRoutingPolicy(policy: RoutingPolicy): void {
-		const oldPolicy = this.policy;
-		this.policy = policy;
-
-		this.emit({
-			type: "router.policy_updated",
-			oldPolicy,
-			newPolicy: policy,
-		});
-	}
-
-	/**
-	 * Subscribe to events
-	 */
-	onEvent(handler: EventHandler): () => void {
-		this.eventHandlers.add(handler);
-		return () => this.eventHandlers.delete(handler);
-	}
-
-	/**
-	 * Build candidate list from context
-	 */
-	private buildCandidates(
-		context: RoutingContext,
-		options?: RoutingOptions,
-	): ProviderCandidate[] {
-		const candidates: ProviderCandidate[] = [];
-
-		// Add default candidates
-		for (const candidate of this.defaultCandidates) {
-			const providerState =
-				context.providerStates[candidate.providerId] ?? "unknown";
-			const quotaState = context.quotaStates[candidate.providerId];
-
-			// Skip disabled providers
-			if (providerState === "disabled") continue;
-
-			candidates.push({
-				providerId: candidate.providerId,
-				modelId: candidate.modelId,
-				capabilities: [], // Would be populated from capability registry
-				estimatedCost: candidate.estimatedCost,
-				estimatedLatency: candidate.estimatedLatency ?? "medium",
-				qualityScore: candidate.qualityScore,
-				remainingQuotaPct: quotaState?.remainingPct ?? 1,
-			});
-		}
-
-		return candidates;
-	}
-
-	/**
-	 * Filter candidates based on options and context
-	 */
-	private filterCandidates(
-		candidates: ProviderCandidate[],
-		context: RoutingContext,
-		options?: RoutingOptions,
-	): ProviderCandidate[] {
-		let filtered = [...candidates];
-
-		// Filter by cost
-		if (options?.maxCostPerTask) {
-			filtered = filtered.filter(
-				(c) => (c.estimatedCost ?? Infinity) <= options.maxCostPerTask!,
-			);
-		}
-
-		// Filter by quota
-		filtered = filtered.filter((c) => {
-			const quota = context.quotaStates[c.providerId];
-			return !quota || !quota.exhausted;
-		});
-
-		// Filter by provider state
-		filtered = filtered.filter((c) => {
-			const state = context.providerStates[c.providerId] ?? "unknown";
-			return state !== "disabled" && state !== "exhausted";
-		});
-
-		// Prefer providers
-		if (options?.preferProviders?.length) {
-			filtered.sort((a, b) => {
-				const aPreferred = options.preferProviders!.includes(a.providerId)
-					? 1
-					: 0;
-				const bPreferred = options.preferProviders!.includes(b.providerId)
-					? 1
-					: 0;
-				return bPreferred - aPreferred;
-			});
-		}
-
-		// Avoid providers
-		if (options?.avoidProviders?.length) {
-			filtered = filtered.filter(
-				(c) => !options.avoidProviders!.includes(c.providerId),
-			);
-		}
-
-		return filtered;
-	}
-
-	/**
-	 * Determine routing strategy for a task
-	 */
-	private determineStrategy(
-		task: RoutingContext["task"],
-		options?: RoutingOptions,
-	): RoutingStrategy {
-		// Check for explicit preferences
-		if (options?.preferCheapest) return "cheapest";
-		if (options?.preferFastest) return "fastest";
-		if (options?.preferHighestQuality) return "best_quality";
-
-		// Check task type override
-		if (this.policy.taskTypeOverrides[task.type]) {
-			return this.policy.taskTypeOverrides[task.type];
-		}
-
-		// Fall back to default
-		return this.policy.defaultStrategy;
-	}
-
-	/**
-	 * Emit an event
-	 */
-	private emit(event: ProviderRouterEvent): void {
-		for (const handler of this.eventHandlers) {
-			try {
-				handler(event);
-			} catch {
-				// Ignore handler errors
-			}
-		}
-	}
-}
-
-/**
- * Create a new provider router
- */
-export function createProviderRouter(
-	policy?: RoutingPolicy,
-): EnhancedProviderRouter {
-	return new EnhancedProviderRouter(policy);
-}

package/packages/provider-router/src/strategies.ts

@@ -1,158 +0,0 @@
-/**
- * Routing Strategies (RFC-0054)
- */
-
-import type {
-	ProviderCandidate,
-	RoutingDecision,
-	RoutingPolicy,
-	RoutingStrategy,
-} from "./types.js";
-import { LATENCY_RANK } from "./types.js";
-
-/**
- * Apply a routing strategy to select the best candidate
- */
-export function applyStrategy(
-	candidates: ProviderCandidate[],
-	strategy: RoutingStrategy,
-	policy: RoutingPolicy,
-	options?: { preferProviders?: string[] },
-): ProviderCandidate {
-	switch (strategy) {
-		case "cheapest":
-			return selectCheapest(candidates);
-
-		case "fastest":
-			return selectFastest(candidates);
-
-		case "best_quality":
-			return selectBestQuality(candidates);
-
-		case "balanced":
-			return selectBalanced(candidates, policy);
-
-		case "quota_aware":
-			return selectQuotaAware(candidates);
-
-		default:
-			return selectBalanced(candidates, policy);
-	}
-}
-
-/**
- * Select the cheapest candidate
- */
-function selectCheapest(candidates: ProviderCandidate[]): ProviderCandidate {
-	return candidates.reduce((cheapest, current) =>
-		(current.estimatedCost ?? Infinity) < (cheapest.estimatedCost ?? Infinity)
-			? current
-			: cheapest,
-	);
-}
-
-/**
- * Select the fastest candidate
- */
-function selectFastest(candidates: ProviderCandidate[]): ProviderCandidate {
-	return candidates.reduce((fastest, current) =>
-		LATENCY_RANK[current.estimatedLatency] <
-		LATENCY_RANK[fastest.estimatedLatency]
-			? current
-			: fastest,
-	);
-}
-
-/**
- * Select the highest quality candidate
- */
-function selectBestQuality(candidates: ProviderCandidate[]): ProviderCandidate {
-	return candidates.reduce((best, current) =>
-		(current.qualityScore ?? 0) > (best.qualityScore ?? 0) ? current : best,
-	);
-}
-
-/**
- * Select based on weighted scoring
- */
-function selectBalanced(
-	candidates: ProviderCandidate[],
-	policy: RoutingPolicy,
-): ProviderCandidate {
-	return candidates.reduce((best, current) => {
-		const scoreBest = calculateWeightedScore(best, policy);
-		const scoreCurrent = calculateWeightedScore(current, policy);
-		return scoreCurrent > scoreBest ? current : best;
-	});
-}
-
-/**
- * Select based on quota availability
- */
-function selectQuotaAware(candidates: ProviderCandidate[]): ProviderCandidate {
-	return candidates.reduce((best, current) => {
-		const quotaBest = best.remainingQuotaPct ?? 0;
-		const quotaCurrent = current.remainingQuotaPct ?? 0;
-		const costBest = best.estimatedCost ?? Infinity;
-		const costCurrent = current.estimatedCost ?? Infinity;
-		// Prefer high quota / low cost
-		const ratioBest = quotaBest / (costBest || 1);
-		const ratioCurrent = quotaCurrent / (costCurrent || 1);
-		return ratioCurrent > ratioBest ? current : best;
-	});
-}
-
-/**
- * Calculate weighted score for a candidate
- */
-export function calculateWeightedScore(
-	candidate: ProviderCandidate,
-	policy: RoutingPolicy,
-): number {
-	// Cost score (inverse - lower is better)
-	const maxReasonableCost = 1; // $1 per task
-	const costScore =
-		100 -
-		Math.min(((candidate.estimatedCost ?? 0) * 100) / maxReasonableCost, 100);
-
-	// Quality score (already 0-100)
-	const qualityScore = candidate.qualityScore ?? 50;
-
-	// Latency score (inverse)
-	const latencyScore = 100 - LATENCY_RANK[candidate.estimatedLatency] * 33;
-
-	// Quota score (0-100)
-	const quotaScore = (candidate.remainingQuotaPct ?? 1) * 100;
-
-	// Normalize weights
-	const totalWeight =
-		policy.costWeight +
-		policy.qualityWeight +
-		policy.latencyWeight +
-		policy.quotaWeight;
-
-	return (
-		(costScore * policy.costWeight +
-			qualityScore * policy.qualityWeight +
-			latencyScore * policy.latencyWeight +
-			quotaScore * policy.quotaWeight) /
-		totalWeight
-	);
-}
-
-/**
- * Create a routing decision from a candidate
- */
-export function createDecision(
-	candidate: ProviderCandidate,
-	reason: string,
-): RoutingDecision {
-	return {
-		providerId: candidate.providerId,
-		modelId: candidate.modelId,
-		reason,
-		estimatedCost: candidate.estimatedCost,
-		estimatedLatency: candidate.estimatedLatency,
-		confidence: candidate.qualityScore ? candidate.qualityScore / 100 : 0.8,
-	};
-}

package/packages/provider-router/src/types.ts

@@ -1,130 +0,0 @@
-/**
- * Provider Router Types (RFC-0054)
- */
-
-import type { ProviderState } from "../../types/dist/runtime-types.js";
-import type { Capability } from "../../capability-registry/dist/types.js";
-
-// Re-export Latency from here for convenience
-export type Latency = "fast" | "medium" | "slow";
-
-// --- Routing Types -----------------------------------------------------
-
-export type RoutingStrategy =
-	| "cheapest"
-	| "fastest"
-	| "best_quality"
-	| "balanced"
-	| "quota_aware";
-
-export interface RoutingPolicy {
-	defaultStrategy: RoutingStrategy;
-	costWeight: number; // 0-100
-	qualityWeight: number; // 0-100
-	latencyWeight: number; // 0-100
-	quotaWeight: number; // 0-100
-	fallbackProviders: string[];
-	taskTypeOverrides: Record<string, RoutingStrategy>;
-	providerPreferences: Record<string, number>;
-}
-
-export interface QuotaState {
-	exhausted: boolean;
-	remainingPct: number;
-}
-
-export interface RoutingContext {
-	task: {
-		id: string;
-		title: string;
-		description: string;
-		type: string;
-	};
-	requirement?: {
-		id: string;
-		description: string;
-	};
-	providerStates: Record<string, ProviderState>;
-	quotaStates: Record<string, QuotaState>;
-	costBudget?: {
-		remaining: number;
-	};
-}
-
-export interface RoutingOptions {
-	preferCheapest?: boolean;
-	preferFastest?: boolean;
-	preferHighestQuality?: boolean;
-	maxCostPerTask?: number;
-	requiredCapabilities?: Capability[];
-	preferProviders?: string[];
-	avoidProviders?: string[];
-}
-
-export interface ProviderCandidate {
-	providerId: string;
-	modelId: string;
-	capabilities: Capability[];
-	estimatedCost?: number;
-	estimatedLatency: Latency;
-	qualityScore?: number;
-	remainingQuotaPct: number;
-}
-
-export interface RoutingDecision {
-	providerId: string;
-	modelId: string;
-	reason: string;
-	estimatedCost?: number;
-	estimatedLatency?: Latency;
-	confidence: number;
-}
-
-// --- Router Interface --------------------------------------------------
-
-export interface ProviderRouter {
-	selectProvider(
-		task: RoutingContext["task"],
-		context: RoutingContext,
-		options?: RoutingOptions,
-	): Promise<RoutingDecision>;
-
-	selectProviders(
-		task: RoutingContext["task"],
-		context: RoutingContext,
-		count: number,
-	): Promise<RoutingDecision[]>;
-
-	getRoutingPolicy(): RoutingPolicy;
-	setRoutingPolicy(policy: RoutingPolicy): void;
-}
-
-// --- Event Types -----------------------------------------------------
-
-export type ProviderRouterEvent =
-	| {
-			type: "router.provider_selected";
-			taskId: string;
-			providerId: string;
-			reason: string;
-	  }
-	| { type: "router.no_candidates"; taskId: string; reason: string }
-	| {
-			type: "router.policy_updated";
-			oldPolicy: RoutingPolicy;
-			newPolicy: RoutingPolicy;
-	  }
-	| {
-			type: "router.fallback_triggered";
-			taskId: string;
-			originalProvider: string;
-			fallbackProvider: string;
-	  };
-
-// --- Latency Ranking -------------------------------------------------
-
-export const LATENCY_RANK: Record<Latency, number> = {
-	fast: 1,
-	medium: 2,
-	slow: 3,
-};

package/packages/provider-selector/dist/index.d.ts

@@ -1,6 +0,0 @@
-/**
- * Provider Selector — Main Entry (RFC-0012)
- */
-export { selectProvider, rank, compareCost, compareLatency, filterByCapability, filterByRegion, } from "./selector.js";
-export type * from "./types.js";
-//# sourceMappingURL=index.d.ts.map

package/packages/provider-selector/dist/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACN,cAAc,EACd,IAAI,EACJ,WAAW,EACX,cAAc,EACd,kBAAkB,EAClB,cAAc,GACd,MAAM,eAAe,CAAC;AACvB,mBAAmB,YAAY,CAAC"}

package/packages/provider-selector/dist/index.js

@@ -1,5 +0,0 @@
-/**
- * Provider Selector — Main Entry (RFC-0012)
- */
-export { selectProvider, rank, compareCost, compareLatency, filterByCapability, filterByRegion, } from "./selector.js";
-//# sourceMappingURL=index.js.map

package/packages/provider-selector/dist/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACN,cAAc,EACd,IAAI,EACJ,WAAW,EACX,cAAc,EACd,kBAAkB,EAClB,cAAc,GACd,MAAM,eAAe,CAAC"}

package/packages/provider-selector/dist/selector.d.ts

@@ -1,17 +0,0 @@
-/**
- * Provider Selector — multi-criteria provider ranking and selection (RFC-0012)
- */
-import type { Provider, SelectionCriteria, SelectionResult } from "./types.js";
-/** Select the best provider based on criteria. */
-export declare function selectProvider(providers: Provider[], criteria?: SelectionCriteria): SelectionResult | null;
-/** Rank all providers by score. */
-export declare function rank(providers: Provider[], criteria?: SelectionCriteria): Provider[];
-/** Compare two providers by cost. Returns negative if a is cheaper. */
-export declare function compareCost(a: Provider, b: Provider): number;
-/** Compare two providers by latency. Returns negative if a is faster. */
-export declare function compareLatency(a: Provider, b: Provider): number;
-/** Filter providers by capability. */
-export declare function filterByCapability(providers: Provider[], capability: Provider["capabilities"][number]): Provider[];
-/** Filter providers by region. */
-export declare function filterByRegion(providers: Provider[], region: Provider["region"]): Provider[];
-//# sourceMappingURL=selector.d.ts.map

package/packages/provider-selector/dist/selector.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"selector.d.ts","sourceRoot":"","sources":["../src/selector.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAoD/E,kDAAkD;AAClD,wBAAgB,cAAc,CAC7B,SAAS,EAAE,QAAQ,EAAE,EACrB,QAAQ,GAAE,iBAA8B,GACtC,eAAe,GAAG,IAAI,CAkBxB;AAED,mCAAmC;AACnC,wBAAgB,IAAI,CACnB,SAAS,EAAE,QAAQ,EAAE,EACrB,QAAQ,GAAE,iBAA8B,GACtC,QAAQ,EAAE,CAMZ;AAED,uEAAuE;AACvE,wBAAgB,WAAW,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,QAAQ,GAAG,MAAM,CAI5D;AAED,yEAAyE;AACzE,wBAAgB,cAAc,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,QAAQ,GAAG,MAAM,CAE/D;AAED,sCAAsC;AACtC,wBAAgB,kBAAkB,CACjC,SAAS,EAAE,QAAQ,EAAE,EACrB,UAAU,EAAE,QAAQ,CAAC,cAAc,CAAC,CAAC,MAAM,CAAC,GAC1C,QAAQ,EAAE,CAEZ;AAED,kCAAkC;AAClC,wBAAgB,cAAc,CAC7B,SAAS,EAAE,QAAQ,EAAE,EACrB,MAAM,EAAE,QAAQ,CAAC,QAAQ,CAAC,GACxB,QAAQ,EAAE,CAGZ"}