P0-P8: Full V1.0.0 Alpha implementation + audit reports
Implements 123 tasks across 9 phases (T-001..T-809) totaling 146 source files. Monorepo (P0): - 7-package Bun + Turborepo + TypeScript monorepo - dependency-cruiser enforcing 7 forbidden edges + 5 deep-import rules Contracts (P0): - 16 type files (ids/error/event/runtime/ipc/task/worker-result/tool/artifact/evidence/project/provider/permission/ui/capability/platform) Storage & Events (P1): - DatabaseManager + MigrationRunner (19 tables, 22 indexes, 5 schema_meta seeds) - 16 repositories (Repository<T,I,U> pattern, INV-1 status columns via EventStore.project only) - EventSchemaRegistry (54 durable + 7 ephemeral), EventStore, EventBus, EventIngestor - Project/Session/Artifact/Evidence stores + 8-step Recovery Tools & Permission (P2): - PathClassifier (8 categories), CommandRiskAnalyzer (10 categories), SecretRedactor - PermissionEngine 6-layer evaluation (capability→profile→task_scope→risk→credential→user_prompt) - ToolRegistry with 20+ tools across fs/shell/git/project/artifact/context/permission/doctor - CapabilityManifestValidator + CapabilityRegistry LLM & Context (P3): - ModelConfigLoader, CapabilityMatrix, AnthropicCanonicalConverter - AnthropicAdapter + OpenAICompatibleAdapter - ProviderManager facade - PromptLayerLoader (L0/L1/L3/L5), CompactionPolicy, ContextAssembler Worker IPC & Scheduler (P4): - WorkerProtocol (NDJSON), WorkerProcess (exit codes 0-5), WorkerManager (spawn/handshake) - WorkerRuntime (INV-3: IPC only, no direct fs/shell/SQLite) - 5 worker roles (Executor/Reviewer/Debugger/Compactor/ExperienceMiner) - TaskGraph, WavePlanner, RetryPlanner, AgentMonitor, WorkspaceManager - Scheduler (state machine), 8-step Recovery C++ Toolchain (P5): - DiagnosticParser, CppProjectDetector, CMakeConfigurator, CppBuilder - CppTestRunner, CppcheckRunner, ClangdClient - CppToolRegistrar + capability manifest Projection & TUI (P6): - ProjectionStore (hydrate/apply/snapshot/subscribe) - TuiApp + 8 components (Session/Task/Agent/Tool/Diff/Evidence/Permission/Blocker/Hud) - ProjectionClient in-process ref Agents & Knowledge (P7): - MainAgent, ArchitectureDesigner - DebugKnowledgeStore + LearnedMemoryStore (single-writer, outbox model) - Role integration wiring CLI & Doctor & Release (P8): - Logger + DeveloperLogEncryptor (AES-256-GCM) - DoctorService (self_bootstrap first) - RuntimeApp + ServiceRegistry - 11 CLI commands: run/init/doctor/provider/resume/compact/history/session/restore/e2e/release - CliEntrypoint + air<TODO> Audit (in AirPlan/docs/): - Deepseek开发阶段审计.md (97 findings) - Opus开发阶段审计.md (140+ findings, 18 P0 blockers) - MiniMaxM3开发阶段审计.md (18 P0 blockers, focuses on executability) - AirPlan/TODO.md (technical debt + 42 TODOs by phase) Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This commit is contained in:
AirCoding
204
packages/llm/src/ProviderManager.ts
Executable file
204
packages/llm/src/ProviderManager.ts
Executable file
@@ -0,0 +1,204 @@
|
||||
/**
|
||||
* ProviderManager - Unified facade for LLM providers
|
||||
*
|
||||
* Implements contracts §15; DD §12.1.
|
||||
* INV-4: runtime calls llm only via this facade.
|
||||
*
|
||||
* @module packages/llm/src/ProviderManager
|
||||
*/
|
||||
|
||||
// Local type definitions (contract types not yet finalized)
|
||||
type CompleteOptions = { max_tokens?: number; temperature?: number; top_p?: number; system?: string }
|
||||
type StreamEvent = { type: 'text' | 'thinking' | 'done'; content?: string; reason?: string }
|
||||
type ModelRequirement = { model: string; provider?: string; min_output_tokens?: number; prefers_thinking?: boolean; requires_tools?: boolean }
|
||||
type ModelAssignment = { provider: string; model: string; adapter: any; capabilities?: any }
|
||||
|
||||
import { ModelConfigLoader, createModelConfigLoader } from './ModelConfigLoader.js'
|
||||
import { CapabilityMatrixRegistry, createCapabilityMatrixRegistry } from './CapabilityMatrix.js'
|
||||
import { AnthropicAdapter, createAnthropicAdapter } from './adapters/AnthropicAdapter.js'
|
||||
import { OpenAICompatibleAdapter, createOpenAICompatibleAdapter } from './adapters/OpenAICompatibleAdapter.js'
|
||||
|
||||
export interface ProviderManagerConfig {
|
||||
config_loader?: ModelConfigLoader
|
||||
capability_matrix?: CapabilityMatrixRegistry
|
||||
}
|
||||
|
||||
export class ProviderManager {
|
||||
private config_loader: ModelConfigLoader
|
||||
private capability_matrix: CapabilityMatrixRegistry
|
||||
private adapters: Map<string, ProviderAdapter> = new Map()
|
||||
private current_adapter: ProviderAdapter | null = null
|
||||
private current_model: string = ''
|
||||
|
||||
constructor(config: ProviderManagerConfig = {}) {
|
||||
this.config_loader = config.config_loader || createModelConfigLoader()
|
||||
this.capability_matrix = config.capability_matrix || createCapabilityMatrixRegistry()
|
||||
|
||||
// Initialize adapters
|
||||
this.initialize_adapters()
|
||||
}
|
||||
|
||||
/**
|
||||
* Load configuration from files.
|
||||
*/
|
||||
load_config(): { ok: boolean; error?: string } {
|
||||
const result = this.config_loader.load()
|
||||
if (!result.ok) {
|
||||
return { ok: false, error: result.error }
|
||||
}
|
||||
return { ok: true }
|
||||
}
|
||||
|
||||
/**
|
||||
* Select a model based on requirements.
|
||||
* Returns a ModelAssignment.
|
||||
*/
|
||||
select_model(requirement: ModelRequirement): ModelAssignment {
|
||||
// Try to find matching model in capability matrix
|
||||
const best_model = this.capability_matrix.find_best(requirement.provider || 'anthropic', {
|
||||
min_output_tokens: requirement.min_output_tokens,
|
||||
supports_thinking: requirement.prefers_thinking,
|
||||
supports_tools: requirement.requires_tools
|
||||
})
|
||||
|
||||
const model = requirement.model || best_model || `${requirement.provider}-default`
|
||||
|
||||
// Get adapter for this provider
|
||||
const adapter = this.get_or_create_adapter(requirement.provider || 'anthropic', model)
|
||||
this.current_adapter = adapter
|
||||
this.current_model = model
|
||||
|
||||
return {
|
||||
provider: requirement.provider || 'anthropic',
|
||||
model,
|
||||
adapter,
|
||||
capabilities: this.capability_matrix.lookup(requirement.provider || 'anthropic', model)
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Complete a request with the current model.
|
||||
*/
|
||||
async complete(
|
||||
messages: unknown[],
|
||||
assignment: ModelAssignment,
|
||||
options: CompleteOptions = {}
|
||||
): Promise<{ content: string; usage?: { input_tokens: number; output_tokens: number } }> {
|
||||
const adapter = assignment.adapter || this.current_adapter
|
||||
if (!adapter) {
|
||||
throw new Error('No adapter selected. Call select_model first.')
|
||||
}
|
||||
|
||||
return adapter.complete(messages as any, { model: assignment.model }, options)
|
||||
}
|
||||
|
||||
/**
|
||||
* Stream a completion request.
|
||||
*/
|
||||
async *stream_complete(
|
||||
messages: unknown[],
|
||||
assignment: ModelAssignment,
|
||||
options: CompleteOptions = {}
|
||||
): AsyncGenerator<StreamEvent> {
|
||||
const adapter = assignment.adapter || this.current_adapter
|
||||
if (!adapter) {
|
||||
throw new Error('No adapter selected. Call select_model first.')
|
||||
}
|
||||
|
||||
yield* adapter.stream_complete(messages as any, { model: assignment.model }, options)
|
||||
}
|
||||
|
||||
/**
|
||||
* Get an adapter for a specific provider.
|
||||
*/
|
||||
adapter_for(provider: string, model: string): ProviderAdapter {
|
||||
return this.get_or_create_adapter(provider, model)
|
||||
}
|
||||
|
||||
/**
|
||||
* Get current adapter.
|
||||
*/
|
||||
get_current_adapter(): ProviderAdapter | null {
|
||||
return this.current_adapter
|
||||
}
|
||||
|
||||
/**
|
||||
* Get current model.
|
||||
*/
|
||||
get_current_model(): string {
|
||||
return this.current_model
|
||||
}
|
||||
|
||||
// ============================================================================
|
||||
// Private helpers
|
||||
// ============================================================================
|
||||
|
||||
private initialize_adapters(): void {
|
||||
// Create default adapters
|
||||
const anthropic = createAnthropicAdapter()
|
||||
this.adapters.set('anthropic', anthropic)
|
||||
|
||||
// Check for OpenAI-compatible providers in config
|
||||
const config = this.config_loader.load()
|
||||
if (config.ok && config.configs?.global) {
|
||||
for (const [name, model_config] of Object.entries(config.configs.global)) {
|
||||
if (model_config.provider === 'openai-compatible' && model_config.base_url) {
|
||||
const adapter = createOpenAICompatibleAdapter({
|
||||
base_url: model_config.base_url,
|
||||
model: model_config.model,
|
||||
api_key: model_config.api_key
|
||||
})
|
||||
this.adapters.set(name, adapter)
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
private get_or_create_adapter(provider: string, model: string): ProviderAdapter {
|
||||
// Check if we already have an adapter for this provider
|
||||
const existing = this.adapters.get(provider)
|
||||
if (existing) {
|
||||
return existing
|
||||
}
|
||||
|
||||
// Create new adapter based on provider
|
||||
let adapter: ProviderAdapter
|
||||
|
||||
if (provider === 'anthropic') {
|
||||
adapter = createAnthropicAdapter()
|
||||
} else {
|
||||
// Check config for OpenAI-compatible
|
||||
const model_config = this.config_loader.get_model(`${provider}-${model}`)
|
||||
if (model_config?.base_url) {
|
||||
adapter = createOpenAICompatibleAdapter({
|
||||
base_url: model_config.base_url,
|
||||
model: model_config.model,
|
||||
api_key: model_config.api_key
|
||||
})
|
||||
} else {
|
||||
// Default to OpenAI-compatible with default settings
|
||||
adapter = createOpenAICompatibleAdapter({
|
||||
base_url: process.env.OPENAI_BASE_URL || 'https://api.openai.com/v1',
|
||||
model: model
|
||||
})
|
||||
}
|
||||
}
|
||||
|
||||
this.adapters.set(provider, adapter)
|
||||
return adapter
|
||||
}
|
||||
}
|
||||
|
||||
export function createProviderManager(config?: ProviderManagerConfig): ProviderManager {
|
||||
return new ProviderManager(config)
|
||||
}
|
||||
|
||||
// Export facade as default instance
|
||||
let default_instance: ProviderManager | undefined
|
||||
|
||||
export function get_provider_manager(): ProviderManager {
|
||||
if (!default_instance) {
|
||||
default_instance = createProviderManager()
|
||||
}
|
||||
return default_instance
|
||||
}
|
||||
Reference in New Issue
Block a user