@itphx/synth-core 0.2.0

package/dist/engine/orchestrator.d.ts

@@ -0,0 +1,171 @@
+import type { Message, Project, Session, ProviderConfig as SharedProviderConfig } from '@itphx/synth-shared';
+import type { RouterConfig, PermissionConfig, PlanMode, SecurityConfig, LLMGatewayConfig } from '@itphx/synth-shared';
+import type { SessionManager } from '../sessions/manager.js';
+import type { EventBus } from '../events/bus.js';
+import type { LLMMessage } from '../providers/base.js';
+import { ContextBuilder } from './context/builder.js';
+import { ContextOptimizer } from './context/optimizer.js';
+import { ContextConfig } from './context/config.js';
+import type { ToolRegistry } from './tools/registry.js';
+import type { AgentRegistry } from './agents/registry.js';
+import type { McpManager } from './mcp/manager.js';
+import { AuditLogger, type SecretPatternStore } from './gateway/index.js';
+export interface ModelPricing {
+    inputPrice?: number;
+    outputPrice?: number;
+    cacheReadPrice?: number;
+    cacheWritePrice?: number;
+}
+/**
+ * Минимальный контракт project store, который использует оркестратор (AD-014):
+ * только загрузка проекта для резолва project.workspace. Позволяет передавать
+ * реализации из разных пакетов (backend/core ProjectStore) без структурной
+ * зависимости от конкретного класса.
+ */
+export interface ProjectStoreLike {
+    load(id: string): Promise<Project | null>;
+}
+export interface OrchestratorOptions {
+    sessionManager: SessionManager;
+    eventBus: EventBus;
+    contextBuilder: ContextBuilder;
+    providerLoader: (name: string) => SharedProviderConfig | null;
+    contextOptimizer?: ContextOptimizer;
+    contextConfig?: ContextConfig;
+    modelPriceLoader?: (modelName: string) => ModelPricing | null;
+    dataDir?: string;
+    toolRegistry?: ToolRegistry;
+    agentRegistry?: AgentRegistry;
+    mcpManager?: McpManager;
+    routerConfig?: RouterConfig;
+    projectStore?: ProjectStoreLike;
+    defaultWorkingDir?: string;
+    /**
+     * Корень каталога workspaces: `join(dataDir, 'workspaces')` по умолчанию
+     * (аналог resolveWorkspacesRoot). Относительные `project.workspace` резолвятся
+     * относительно этого корня (AD-014).
+     */
+    workspacesRoot?: string;
+    /** Глобальная секция permission из config.yaml (AD-029). */
+    permissionConfig?: PermissionConfig;
+    /** Строгость цикла Plan→Build по умолчанию из config.yaml session.planMode (AD-028). */
+    defaultPlanMode?: PlanMode;
+    /** Секция безопасности (защита от Indirect Prompt Injection). */
+    securityConfig?: SecurityConfig;
+    /** LLM Gateway (AD-036): глобальный тумблер и конфиг. Выключен по умолчанию. */
+    gatewayConfig?: LLMGatewayConfig;
+    /** Путь к JSONL полного лога запросов/ответов LLM ({dataDir}/audit/llm-payloads.jsonl). */
+    gatewayPayloadLogPath?: string;
+    /** Аудит LLM Gateway — если создаётся снаружи (backend/runner). Иначе создаётся внутри. */
+    gatewayAuditLogger?: AuditLogger;
+    /** Хранилище кастомных regex-паттернов детекции секретов (override ?? дефолт). */
+    gatewayPatternStore?: SecretPatternStore;
+}
+export interface ProcessMessageResult {
+    error?: string;
+    errorType?: string;
+    canRetry?: boolean;
+}
+/**
+ * ChatOrchestrator — единый оркестратор обработки чат-сообщений.
+ * Предоставляет processMessage callback для QueueProcessor.
+ */
+export declare class ChatOrchestrator {
+    private readonly _sessionManager;
+    private readonly _eventBus;
+    private readonly _contextBuilder;
+    private readonly _providerLoader;
+    private readonly _optimizer;
+    private readonly _modelPriceLoader;
+    private readonly _toolRegistry;
+    private readonly _agentRegistry;
+    private readonly _mcpManager;
+    private readonly _loadedMcpServers;
+    private readonly _cancellationTokens;
+    private readonly _router;
+    private readonly _routerConfig;
+    private readonly _microPipeline;
+    private readonly _contextConfig;
+    private readonly _projectStore;
+    private readonly _defaultWorkingDir;
+    private readonly _workspacesRoot;
+    private readonly _permissionConfig;
+    private readonly _approvalManager;
+    private readonly _defaultPlanMode;
+    private readonly _securityConfig;
+    private readonly _dictionaryStore;
+    private _gatewayConfig;
+    private _obfMapStore;
+    private _gatewayAudit;
+    private _gatewayRateLimiter;
+    private readonly _gatewayPatternStore;
+    private readonly _dataDir;
+    /** Путь к JSONL полного лога запросов/ответов LLM (передаётся в GatewayProvider). */
+    private readonly _gatewayPayloadLogPath;
+    /** Внешний audit-logger (backend/runner) — переиспользуется при live-включении gateway. */
+    private readonly _gatewayAuditExternal;
+    private _providerPool;
+    /** Публичный доступ к реестру агентов (для сериализации modeApplicable). */
+    get agentRegistry(): AgentRegistry | null;
+    constructor(options: OrchestratorOptions);
+    /**
+     * AD-036: live-переключение LLM Gateway (runtime-настройка из UI).
+     * config === null/undefined или enabled:false → выключить (убрать обвязку).
+     * enabled:true → создать ObfuscationMapStore/AuditLogger/RateLimiter, обновить
+     * фабрику ProviderPool, обновить hooks суммаризации.
+     */
+    setGatewayConfig(config: LLMGatewayConfig | null | undefined): void;
+    /** AD-036: включён ли LLM Gateway (runtime-тумблер / конфиг). */
+    isGatewayEnabled(): boolean;
+    /**
+     * AD-036: обфусцирует user-сообщение при сохранении в историю (до отправки в LLM).
+     * Карта обфускации сессии обновляется и сохраняется; в message.metadata.secrets
+     * встраиваются реальные значения для раскрытия в UI. Если gateway выключен или
+     * секретов не найдено — возвращает сообщение без изменений (обратная совместимость).
+     */
+    obfuscateUserMessageForHistory(sessionId: string, message: Message): Promise<Message>;
+    private _resolveWorkingDir;
+    /**
+     * AD-025/AD-027: добавляет в system prompt блоки режима Plan/Act и
+     * утверждённого плана. Вызывается при старте обработки и пересобирается
+     * после plan_enter/plan_exit в текущей итерации.
+     */
+    private _buildPlanSystemPrompt;
+    /**
+     * processMessage callback для QueueProcessor.
+     */
+    createProcessMessage(): (session: Session, message: Message, signal: AbortSignal, publishChunk: (event: string, data: Record<string, unknown>) => void) => Promise<ProcessMessageResult>;
+    _processMessage(session: Session, message: Message, signal: AbortSignal, publishChunk: (event: string, data: Record<string, unknown>) => void): Promise<ProcessMessageResult>;
+    cancel(streamId: string): void;
+    private _handleDebugSystemMessage;
+    private _handleSummarization;
+    private _getProvider;
+    /**
+     * AD-036: оборачивает провайдер в GatewayProvider с привязкой к сессии.
+     * Если gateway выключен — возвращает провайдер как есть (обратная совместимость).
+     */
+    private _wrapWithGateway;
+    private _getEffectiveModel;
+    /**
+     * Выбор провайдера и модели через роутер (AD-034).
+     * Если роутер недоступен — fallback на _getProvider().
+     */
+    private _routeProvider;
+    static _sessionMessagesToLlm(messages: Message[], currentAgentRole?: string, currentAuthor?: string): LLMMessage[];
+    /**
+     * AD-036: возвращает реальные значения секретов для плейсхолдеров
+     * ⟦SYNTH_SECRET_N⟧ в тексте сообщения (из карты обфускации сессии).
+     * Пустой объект если карты нет, плейсхолдеров нет или gateway выключен.
+     */
+    private _getAssistantSecrets;
+    private _saveAssistantMessage;
+    private _classifyError;
+    private _isRecoverable;
+    /**
+     * AD-029: «Разрешить в сессии» (once:false). Добавляет allow-правило для тула
+     * в permission-конфиг сессии и сохраняет его. Если у сессии не было своего
+     * конфига — наследует глобальные правила, чтобы не потерять их при оверрайде.
+     */
+    private _grantSessionToolAllow;
+}
+//# sourceMappingURL=orchestrator.d.ts.map

package/dist/engine/orchestrator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"orchestrator.d.ts","sourceRoot":"","sources":["../../src/engine/orchestrator.ts"],"names":[],"mappings":"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"}