@harness-engineering/orchestrator 0.7.0 → 0.8.1

package/dist/index.d.mts

@@ -1,10 +1,11 @@
 import * as _harness_engineering_types from '@harness-engineering/types';
-import { Issue, AgentEvent, WorkflowConfig, TokenUsage, ConcernSignal, ScopeTier, EscalationConfig, IssueRoutingDecision, Result, WorkflowDefinition, BackendDef, RoutingConfig, WorkspaceConfig, HooksConfig, AgentBackend, SessionStartParams, AgentSession, AgentError, TurnParams, TurnResult, CheckScriptDefinition, OutputRetentionConfig, RoutingDecision, RoutingUseCase, ContainerConfig, SecretConfig, AgentConfig, CustomTaskDefinition, TokenScope, AuthToken, AuthTokenPublic, IndexedFileKind, SessionSearchResult, ReindexStats, SessionSummarizationConfig, SessionSummary, SessionSummaryMeta, SessionsConfig, GatewayEvent, NotificationEnvelope, NotificationDeliveryResult, NotificationSinkConfig, NotificationsConfig } from '@harness-engineering/types';
+import { Issue, AgentEvent, WorkflowConfig, TokenUsage, ConcernSignal, ScopeTier, EscalationConfig, IssueRoutingDecision, Result, WorkflowDefinition, BackendDef, RoutingConfig, WorkspaceConfig, HooksConfig, AgentBackend, SessionStartParams, AgentSession, AgentError, TurnParams, TurnResult, CheckScriptDefinition, OutputRetentionConfig, RoutingDecision, RoutingUseCase, ContainerConfig, SecretConfig, AgentConfig, LocalModelStatus, CustomTaskDefinition, TokenScope, AuthToken, AuthTokenPublic, IndexedFileKind, SessionSearchResult, ReindexStats, SessionSummarizationConfig, SessionSummary, SessionSummaryMeta, SessionsConfig, GatewayEvent, NotificationEnvelope, NotificationDeliveryResult, NotificationSinkConfig, NotificationsConfig } from '@harness-engineering/types';
 import { IssueTrackerClient, Issue as Issue$1, TrackerConfig, CacheMetricsRecorder, ArchiveHooks, SkillProposal, ProposalGateFinding } from '@harness-engineering/core';
 import { EnrichedSpec, ComplexityScore, SimulationResult, IntelligencePipeline, WeightedRecommendation, AnalysisProvider } from '@harness-engineering/intelligence';
 import { GraphStore } from '@harness-engineering/graph';
 import { execFile } from 'node:child_process';
 import { EventEmitter } from 'node:events';
+import { z } from 'zod';
 
 /**
  * Run attempt lifecycle phases (internal to orchestrator).
@@ -1921,6 +1922,270 @@ interface CreateBackendOptions {
  */
 declare function createBackend(def: BackendDef, options?: CreateBackendOptions): AgentBackend;
 
+/**
+ * Zod schema for `BackendDef` (Spec 2 — multi-backend routing).
+ *
+ * Discriminated union on `type`. Per-variant validation surfaces shape
+ * mismatches (missing `model`, missing `endpoint`, etc.) at config-load
+ * time rather than at orchestrator runtime.
+ *
+ * Used in Phase 3 by `validateWorkflowConfig`; in Phase 1 it is exported
+ * for standalone unit testing.
+ */
+declare const BackendDefSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
+    type: z.ZodLiteral<"mock">;
+}, "strict", z.ZodTypeAny, {
+    type: "mock";
+}, {
+    type: "mock";
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"claude">;
+    command: z.ZodOptional<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    type: "claude";
+    command?: string | undefined;
+}, {
+    type: "claude";
+    command?: string | undefined;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"anthropic">;
+    model: z.ZodString;
+    apiKey: z.ZodOptional<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    type: "anthropic";
+    model: string;
+    apiKey?: string | undefined;
+}, {
+    type: "anthropic";
+    model: string;
+    apiKey?: string | undefined;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"openai">;
+    model: z.ZodString;
+    apiKey: z.ZodOptional<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    type: "openai";
+    model: string;
+    apiKey?: string | undefined;
+}, {
+    type: "openai";
+    model: string;
+    apiKey?: string | undefined;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"gemini">;
+    model: z.ZodString;
+    apiKey: z.ZodOptional<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    type: "gemini";
+    model: string;
+    apiKey?: string | undefined;
+}, {
+    type: "gemini";
+    model: string;
+    apiKey?: string | undefined;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"local">;
+    endpoint: z.ZodString;
+    model: z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "atleastone">]>;
+    apiKey: z.ZodOptional<z.ZodString>;
+    timeoutMs: z.ZodOptional<z.ZodNumber>;
+    probeIntervalMs: z.ZodOptional<z.ZodNumber>;
+}, "strict", z.ZodTypeAny, {
+    type: "local";
+    model: string | [string, ...string[]];
+    endpoint: string;
+    apiKey?: string | undefined;
+    timeoutMs?: number | undefined;
+    probeIntervalMs?: number | undefined;
+}, {
+    type: "local";
+    model: string | [string, ...string[]];
+    endpoint: string;
+    apiKey?: string | undefined;
+    timeoutMs?: number | undefined;
+    probeIntervalMs?: number | undefined;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"pi">;
+    endpoint: z.ZodString;
+    model: z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "atleastone">]>;
+    apiKey: z.ZodOptional<z.ZodString>;
+    timeoutMs: z.ZodOptional<z.ZodNumber>;
+    probeIntervalMs: z.ZodOptional<z.ZodNumber>;
+}, "strict", z.ZodTypeAny, {
+    type: "pi";
+    model: string | [string, ...string[]];
+    endpoint: string;
+    apiKey?: string | undefined;
+    timeoutMs?: number | undefined;
+    probeIntervalMs?: number | undefined;
+}, {
+    type: "pi";
+    model: string | [string, ...string[]];
+    endpoint: string;
+    apiKey?: string | undefined;
+    timeoutMs?: number | undefined;
+    probeIntervalMs?: number | undefined;
+}>]>;
+/**
+ * Spec B Phase 0: a routing target is either a backend name (scalar
+ * string) or a non-empty ordered fallback chain (string tuple). The
+ * scalar form is byte-compatible with pre-Spec-B configs.
+ */
+declare const RoutingValueSchema: z.ZodUnion<[z.ZodString, z.ZodReadonly<z.ZodArray<z.ZodString, "atleastone">>]>;
+/**
+ * Zod schema for `RoutingConfig`. `.strict()` rejects unknown keys at
+ * every level (per Spec 2 D7: typos in routing keys are validation
+ * errors, not silent default-fallthroughs).
+ *
+ * Spec B Phase 0: all scalar routing fields accept `RoutingValueSchema`
+ * (scalar or non-empty chain). New optional `skills` and `modes` maps
+ * accept the same.
+ *
+ * Spec B Phase 2: the `isolation` block (added to the TS interface in
+ * Hermes Phase 5 but not previously in this Zod schema) is now included
+ * here with each tier widened to `RoutingValueSchema`. This closes the
+ * Phase 0 I2 review finding (TS-vs-Zod drift) and ensures isolation
+ * chain entries are validated by the same cross-field check that
+ * covers `skills` / `modes`.
+ */
+declare const RoutingConfigSchema: z.ZodObject<{
+    default: z.ZodUnion<[z.ZodString, z.ZodReadonly<z.ZodArray<z.ZodString, "atleastone">>]>;
+    'quick-fix': z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodReadonly<z.ZodArray<z.ZodString, "atleastone">>]>>;
+    'guided-change': z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodReadonly<z.ZodArray<z.ZodString, "atleastone">>]>>;
+    'full-exploration': z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodReadonly<z.ZodArray<z.ZodString, "atleastone">>]>>;
+    diagnostic: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodReadonly<z.ZodArray<z.ZodString, "atleastone">>]>>;
+    intelligence: z.ZodOptional<z.ZodObject<{
+        sel: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodReadonly<z.ZodArray<z.ZodString, "atleastone">>]>>;
+        pesl: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodReadonly<z.ZodArray<z.ZodString, "atleastone">>]>>;
+    }, "strict", z.ZodTypeAny, {
+        sel?: string | readonly [string, ...string[]] | undefined;
+        pesl?: string | readonly [string, ...string[]] | undefined;
+    }, {
+        sel?: string | readonly [string, ...string[]] | undefined;
+        pesl?: string | readonly [string, ...string[]] | undefined;
+    }>>;
+    isolation: z.ZodOptional<z.ZodObject<{
+        none: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodReadonly<z.ZodArray<z.ZodString, "atleastone">>]>>;
+        container: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodReadonly<z.ZodArray<z.ZodString, "atleastone">>]>>;
+        'remote-sandbox': z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodReadonly<z.ZodArray<z.ZodString, "atleastone">>]>>;
+    }, "strict", z.ZodTypeAny, {
+        none?: string | readonly [string, ...string[]] | undefined;
+        container?: string | readonly [string, ...string[]] | undefined;
+        'remote-sandbox'?: string | readonly [string, ...string[]] | undefined;
+    }, {
+        none?: string | readonly [string, ...string[]] | undefined;
+        container?: string | readonly [string, ...string[]] | undefined;
+        'remote-sandbox'?: string | readonly [string, ...string[]] | undefined;
+    }>>;
+    skills: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<[z.ZodString, z.ZodReadonly<z.ZodArray<z.ZodString, "atleastone">>]>>>;
+    modes: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<[z.ZodString, z.ZodReadonly<z.ZodArray<z.ZodString, "atleastone">>]>>>;
+}, "strict", z.ZodTypeAny, {
+    default: string | readonly [string, ...string[]];
+    'quick-fix'?: string | readonly [string, ...string[]] | undefined;
+    'guided-change'?: string | readonly [string, ...string[]] | undefined;
+    'full-exploration'?: string | readonly [string, ...string[]] | undefined;
+    diagnostic?: string | readonly [string, ...string[]] | undefined;
+    intelligence?: {
+        sel?: string | readonly [string, ...string[]] | undefined;
+        pesl?: string | readonly [string, ...string[]] | undefined;
+    } | undefined;
+    isolation?: {
+        none?: string | readonly [string, ...string[]] | undefined;
+        container?: string | readonly [string, ...string[]] | undefined;
+        'remote-sandbox'?: string | readonly [string, ...string[]] | undefined;
+    } | undefined;
+    skills?: Record<string, string | readonly [string, ...string[]]> | undefined;
+    modes?: Record<string, string | readonly [string, ...string[]]> | undefined;
+}, {
+    default: string | readonly [string, ...string[]];
+    'quick-fix'?: string | readonly [string, ...string[]] | undefined;
+    'guided-change'?: string | readonly [string, ...string[]] | undefined;
+    'full-exploration'?: string | readonly [string, ...string[]] | undefined;
+    diagnostic?: string | readonly [string, ...string[]] | undefined;
+    intelligence?: {
+        sel?: string | readonly [string, ...string[]] | undefined;
+        pesl?: string | readonly [string, ...string[]] | undefined;
+    } | undefined;
+    isolation?: {
+        none?: string | readonly [string, ...string[]] | undefined;
+        container?: string | readonly [string, ...string[]] | undefined;
+        'remote-sandbox'?: string | readonly [string, ...string[]] | undefined;
+    } | undefined;
+    skills?: Record<string, string | readonly [string, ...string[]]> | undefined;
+    modes?: Record<string, string | readonly [string, ...string[]]> | undefined;
+}>;
+
+interface ResolverLogger {
+    info(message: string, context?: Record<string, unknown>): void;
+    warn(message: string, context?: Record<string, unknown>): void;
+}
+interface LocalModelResolverOptions {
+    endpoint: string;
+    apiKey?: string;
+    /** Normalized candidate list (already turned from string|string[] into string[]). */
+    configured: string[];
+    /** Probe cadence in ms; default 30_000, minimum 1_000. */
+    probeIntervalMs?: number;
+    /**
+     * Per-request timeout for the default fetch implementation, in ms.
+     * Default: 5_000. Ignored when a custom `fetchModels` is provided
+     * (custom impls own their own timeout policy). Spec §3.1 line 136
+     * enumerates timeout as a supported failure mode.
+     */
+    timeoutMs?: number;
+    /**
+     * Injectable for tests. Default: GET `${endpoint}/models` with bearer apiKey.
+     * Resolves to detected model IDs. Rejects on network/timeout/non-2xx/malformed.
+     */
+    fetchModels?: (endpoint: string, apiKey?: string) => Promise<string[]>;
+    logger?: ResolverLogger;
+}
+declare function normalizeLocalModel(input: string | string[] | undefined): string[];
+/**
+ * Default `fetchModels` — GET `${endpoint}/models` with bearer apiKey.
+ * Throws on network failure, non-2xx, malformed body, or timeout.
+ *
+ * `timeoutMs` defaults to 5_000. A timeout aborts the in-flight request and
+ * surfaces as `Error('request timeout (Nms)')` so callers can distinguish it
+ * from generic network errors.
+ */
+declare function defaultFetchModels(endpoint: string, apiKey?: string, timeoutMs?: number): Promise<string[]>;
+declare class LocalModelResolver {
+    private readonly endpoint;
+    private readonly apiKey?;
+    private readonly configured;
+    private readonly probeIntervalMs;
+    private readonly fetchModels;
+    private readonly logger;
+    private timer;
+    private listeners;
+    /**
+     * Tracks an in-flight probe so concurrent invocations (interval tick while a
+     * slow probe is running, or a manual `probe()` call mid-flight) share the
+     * existing promise instead of racing to mutate `detected/resolved/lastError/
+     * warnings` non-atomically across `await` points. Applies to both the timer
+     * callback and direct `probe()` calls — any caller that arrives during an
+     * in-flight probe gets the same promise back. Cleared in `finally` so the
+     * next tick can start a fresh probe.
+     */
+    private probeInFlight;
+    private resolved;
+    private detected;
+    private lastProbeAt;
+    private lastError;
+    private warnings;
+    private available;
+    constructor(opts: LocalModelResolverOptions);
+    resolveModel(): string | null;
+    getStatus(): LocalModelStatus;
+    onStatusChange(handler: (status: LocalModelStatus) => void): () => void;
+    probe(): Promise<LocalModelStatus>;
+    private runProbe;
+    start(): Promise<void>;
+    stop(): void;
+    private snapshotForDiff;
+}
+
 /**
  * Function signature compatible with Node's `child_process.execFile`.
  * Allows injection for testing.
@@ -2552,4 +2817,4 @@ declare function emitProposalCreated(bus: EventEmitter, proposal: SkillProposal)
 declare function emitProposalApproved(bus: EventEmitter, proposal: SkillProposal): void;
 declare function emitProposalRejected(bus: EventEmitter, proposal: SkillProposal): void;
 
-export { type AgentUpdateEvent, AnalysisArchive, type AnalysisRecord, type ApplyEventResult, type ArtifactPresence, type AttemptStats, BUILT_IN_TASKS, BackendRouter, type BackendRouterOptions, type BaseRefFallbackEvent, type BuildArchiveHooksOptions, ClaimManager, type ClaimManagerConfig, type CleanWorkspaceEffect, type CreateTokenInput, type CreateTokenResult, type CustomTaskValidationError, type DispatchEffect, type EmitLogEffect, type EscalateEffect, type ExecFileFn$1 as ExecFileFn, type FromConfigOptions, GateNotReadyError, type GateResult, GateRunError, type Highlight, type HighlightsInfo, type IndexedDoc, InteractionQueue, type LinearGraphQLExtension, LinearGraphQLStub, type LiveSession, MAX_ATTEMPTS, type MigrationResult, MockBackend, type NotificationSink, type NotificationSinkDeliverInput, ORCHESTRATOR_IDENTITY_FILE, Orchestrator, OrchestratorBackendFactory, type OrchestratorBackendFactoryOptions, type OrchestratorContext, type OrchestratorEvent, type OrchestratorState, PRDetector, type PRDetectorLogger, type PendingInteraction, type PersistedOutputEntry, PromotionError, type PromotionResult, PromptRenderer, type ProposalApprovedData, type ProposalCreatedData, type ProposalRejectedData, type PublishedIndex, type QueueInsertInput, type QueueRow, type QueueStats, RETRY_DELAYS_MS, type RateLimitSnapshot as RateLimitComputeSnapshot, type RateLimitConfig, type RateLimitSnapshot$1 as RateLimitSnapshot, type RegistryEntry, type ReleaseClaimEffect, type RetryEntry, type RetryFiredEvent, RoadmapTrackerAdapter, type RunAttemptPhase, type RunOrigin, type RunningEntry, type ScheduleRetryEffect, type SearchOptions, type SideEffect, SinkConfigError, SinkRegistry, type SkillCatalogEntry, SlackSink, type SlackSinkOptions, SqliteSearchIndex, type StallDetectedEvent, type StopEffect, type StreamManifest, StreamRecorder, type SummarizeContext, type SummarizeResult, type SyncMainOptions, type SyncMainResult, type SyncSkipReason, type TaskDefinition, TaskOutputStore, type TaskType, type TickEvent, TokenStore, type TokenTotals, type TriageConfig, type TriageDecision, type TriageSignals, type TriageSkill, type UpdateTokensEffect, type ValidateWorkflowConfigOptions, type ValidatedWorkflowConfig, WebhookQueue, type WorkerExitEvent, WorkflowLoader, WorkspaceHooks, WorkspaceManager, type WorkspaceManagerOptions, applyEvent, artifactPresenceFromIssue, buildArchiveHooks, calculateRetryDelay, canDispatch, computeRateLimitDelay, createBackend, createEmptyState, crossFieldRoutingIssues, detectScopeTier, discoverSkillCatalog, discoverSkillCatalogNames, emitProposalApproved, emitProposalCreated, emitProposalRejected, extractHighlights, extractTitlePrefix, getAvailableSlots, getDefaultConfig, getPerStateCount, indexSessionDirectory, isEligible, isSummaryEnabled, launchTUI, loadPublishedIndex, migrateAgentConfig, normalizeFts5Query, openSearchIndex, promote, reconcile, reindexFromArchive, renderAnalysisComment, renderLlmSummaryMarkdown, renderPRComment, resolveEscalationConfig, resolveOrchestratorId, routeIssue, routingWarnings, runGate, savePublishedIndex, searchIndexPath, selectCandidates, sortCandidates, summarizeArchivedSession, syncMain, triageIssue, truncateForBudget, validateCustomTasks, validateWorkflowConfig, wireNotificationSinks, wrapAsEnvelope };
+export { type AgentUpdateEvent, AnalysisArchive, type AnalysisRecord, type ApplyEventResult, type ArtifactPresence, type AttemptStats, BUILT_IN_TASKS, BackendDefSchema, BackendRouter, type BackendRouterOptions, type BaseRefFallbackEvent, type BuildArchiveHooksOptions, ClaimManager, type ClaimManagerConfig, type CleanWorkspaceEffect, type CreateTokenInput, type CreateTokenResult, type CustomTaskValidationError, type DispatchEffect, type EmitLogEffect, type EscalateEffect, type ExecFileFn$1 as ExecFileFn, type FromConfigOptions, GateNotReadyError, type GateResult, GateRunError, type Highlight, type HighlightsInfo, type IndexedDoc, InteractionQueue, type LinearGraphQLExtension, LinearGraphQLStub, type LiveSession, LocalModelResolver, type LocalModelResolverOptions, MAX_ATTEMPTS, type MigrationResult, MockBackend, type NotificationSink, type NotificationSinkDeliverInput, ORCHESTRATOR_IDENTITY_FILE, Orchestrator, OrchestratorBackendFactory, type OrchestratorBackendFactoryOptions, type OrchestratorContext, type OrchestratorEvent, type OrchestratorState, PRDetector, type PRDetectorLogger, type PendingInteraction, type PersistedOutputEntry, PromotionError, type PromotionResult, PromptRenderer, type ProposalApprovedData, type ProposalCreatedData, type ProposalRejectedData, type PublishedIndex, type QueueInsertInput, type QueueRow, type QueueStats, RETRY_DELAYS_MS, type RateLimitSnapshot as RateLimitComputeSnapshot, type RateLimitConfig, type RateLimitSnapshot$1 as RateLimitSnapshot, type RegistryEntry, type ReleaseClaimEffect, type ResolverLogger, type RetryEntry, type RetryFiredEvent, RoadmapTrackerAdapter, RoutingConfigSchema, RoutingValueSchema, type RunAttemptPhase, type RunOrigin, type RunningEntry, type ScheduleRetryEffect, type SearchOptions, type SideEffect, SinkConfigError, SinkRegistry, type SkillCatalogEntry, SlackSink, type SlackSinkOptions, SqliteSearchIndex, type StallDetectedEvent, type StopEffect, type StreamManifest, StreamRecorder, type SummarizeContext, type SummarizeResult, type SyncMainOptions, type SyncMainResult, type SyncSkipReason, type TaskDefinition, TaskOutputStore, type TaskType, type TickEvent, TokenStore, type TokenTotals, type TriageConfig, type TriageDecision, type TriageSignals, type TriageSkill, type UpdateTokensEffect, type ValidateWorkflowConfigOptions, type ValidatedWorkflowConfig, WebhookQueue, type WorkerExitEvent, WorkflowLoader, WorkspaceHooks, WorkspaceManager, type WorkspaceManagerOptions, applyEvent, artifactPresenceFromIssue, buildArchiveHooks, calculateRetryDelay, canDispatch, computeRateLimitDelay, createBackend, createEmptyState, crossFieldRoutingIssues, defaultFetchModels, detectScopeTier, discoverSkillCatalog, discoverSkillCatalogNames, emitProposalApproved, emitProposalCreated, emitProposalRejected, extractHighlights, extractTitlePrefix, getAvailableSlots, getDefaultConfig, getPerStateCount, indexSessionDirectory, isEligible, isSummaryEnabled, launchTUI, loadPublishedIndex, migrateAgentConfig, normalizeFts5Query, normalizeLocalModel, openSearchIndex, promote, reconcile, reindexFromArchive, renderAnalysisComment, renderLlmSummaryMarkdown, renderPRComment, resolveEscalationConfig, resolveOrchestratorId, routeIssue, routingWarnings, runGate, savePublishedIndex, searchIndexPath, selectCandidates, sortCandidates, summarizeArchivedSession, syncMain, triageIssue, truncateForBudget, validateCustomTasks, validateWorkflowConfig, wireNotificationSinks, wrapAsEnvelope };

package/dist/index.d.ts

@@ -1,10 +1,11 @@
 import * as _harness_engineering_types from '@harness-engineering/types';
-import { Issue, AgentEvent, WorkflowConfig, TokenUsage, ConcernSignal, ScopeTier, EscalationConfig, IssueRoutingDecision, Result, WorkflowDefinition, BackendDef, RoutingConfig, WorkspaceConfig, HooksConfig, AgentBackend, SessionStartParams, AgentSession, AgentError, TurnParams, TurnResult, CheckScriptDefinition, OutputRetentionConfig, RoutingDecision, RoutingUseCase, ContainerConfig, SecretConfig, AgentConfig, CustomTaskDefinition, TokenScope, AuthToken, AuthTokenPublic, IndexedFileKind, SessionSearchResult, ReindexStats, SessionSummarizationConfig, SessionSummary, SessionSummaryMeta, SessionsConfig, GatewayEvent, NotificationEnvelope, NotificationDeliveryResult, NotificationSinkConfig, NotificationsConfig } from '@harness-engineering/types';
+import { Issue, AgentEvent, WorkflowConfig, TokenUsage, ConcernSignal, ScopeTier, EscalationConfig, IssueRoutingDecision, Result, WorkflowDefinition, BackendDef, RoutingConfig, WorkspaceConfig, HooksConfig, AgentBackend, SessionStartParams, AgentSession, AgentError, TurnParams, TurnResult, CheckScriptDefinition, OutputRetentionConfig, RoutingDecision, RoutingUseCase, ContainerConfig, SecretConfig, AgentConfig, LocalModelStatus, CustomTaskDefinition, TokenScope, AuthToken, AuthTokenPublic, IndexedFileKind, SessionSearchResult, ReindexStats, SessionSummarizationConfig, SessionSummary, SessionSummaryMeta, SessionsConfig, GatewayEvent, NotificationEnvelope, NotificationDeliveryResult, NotificationSinkConfig, NotificationsConfig } from '@harness-engineering/types';
 import { IssueTrackerClient, Issue as Issue$1, TrackerConfig, CacheMetricsRecorder, ArchiveHooks, SkillProposal, ProposalGateFinding } from '@harness-engineering/core';
 import { EnrichedSpec, ComplexityScore, SimulationResult, IntelligencePipeline, WeightedRecommendation, AnalysisProvider } from '@harness-engineering/intelligence';
 import { GraphStore } from '@harness-engineering/graph';
 import { execFile } from 'node:child_process';
 import { EventEmitter } from 'node:events';
+import { z } from 'zod';
 
 /**
  * Run attempt lifecycle phases (internal to orchestrator).
@@ -1921,6 +1922,270 @@ interface CreateBackendOptions {
  */
 declare function createBackend(def: BackendDef, options?: CreateBackendOptions): AgentBackend;
 
+/**
+ * Zod schema for `BackendDef` (Spec 2 — multi-backend routing).
+ *
+ * Discriminated union on `type`. Per-variant validation surfaces shape
+ * mismatches (missing `model`, missing `endpoint`, etc.) at config-load
+ * time rather than at orchestrator runtime.
+ *
+ * Used in Phase 3 by `validateWorkflowConfig`; in Phase 1 it is exported
+ * for standalone unit testing.
+ */
+declare const BackendDefSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
+    type: z.ZodLiteral<"mock">;
+}, "strict", z.ZodTypeAny, {
+    type: "mock";
+}, {
+    type: "mock";
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"claude">;
+    command: z.ZodOptional<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    type: "claude";
+    command?: string | undefined;
+}, {
+    type: "claude";
+    command?: string | undefined;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"anthropic">;
+    model: z.ZodString;
+    apiKey: z.ZodOptional<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    type: "anthropic";
+    model: string;
+    apiKey?: string | undefined;
+}, {
+    type: "anthropic";
+    model: string;
+    apiKey?: string | undefined;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"openai">;
+    model: z.ZodString;
+    apiKey: z.ZodOptional<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    type: "openai";
+    model: string;
+    apiKey?: string | undefined;
+}, {
+    type: "openai";
+    model: string;
+    apiKey?: string | undefined;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"gemini">;
+    model: z.ZodString;
+    apiKey: z.ZodOptional<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    type: "gemini";
+    model: string;
+    apiKey?: string | undefined;
+}, {
+    type: "gemini";
+    model: string;
+    apiKey?: string | undefined;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"local">;
+    endpoint: z.ZodString;
+    model: z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "atleastone">]>;
+    apiKey: z.ZodOptional<z.ZodString>;
+    timeoutMs: z.ZodOptional<z.ZodNumber>;
+    probeIntervalMs: z.ZodOptional<z.ZodNumber>;
+}, "strict", z.ZodTypeAny, {
+    type: "local";
+    model: string | [string, ...string[]];
+    endpoint: string;
+    apiKey?: string | undefined;
+    timeoutMs?: number | undefined;
+    probeIntervalMs?: number | undefined;
+}, {
+    type: "local";
+    model: string | [string, ...string[]];
+    endpoint: string;
+    apiKey?: string | undefined;
+    timeoutMs?: number | undefined;
+    probeIntervalMs?: number | undefined;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"pi">;
+    endpoint: z.ZodString;
+    model: z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "atleastone">]>;
+    apiKey: z.ZodOptional<z.ZodString>;
+    timeoutMs: z.ZodOptional<z.ZodNumber>;
+    probeIntervalMs: z.ZodOptional<z.ZodNumber>;
+}, "strict", z.ZodTypeAny, {
+    type: "pi";
+    model: string | [string, ...string[]];
+    endpoint: string;
+    apiKey?: string | undefined;
+    timeoutMs?: number | undefined;
+    probeIntervalMs?: number | undefined;
+}, {
+    type: "pi";
+    model: string | [string, ...string[]];
+    endpoint: string;
+    apiKey?: string | undefined;
+    timeoutMs?: number | undefined;
+    probeIntervalMs?: number | undefined;
+}>]>;
+/**
+ * Spec B Phase 0: a routing target is either a backend name (scalar
+ * string) or a non-empty ordered fallback chain (string tuple). The
+ * scalar form is byte-compatible with pre-Spec-B configs.
+ */
+declare const RoutingValueSchema: z.ZodUnion<[z.ZodString, z.ZodReadonly<z.ZodArray<z.ZodString, "atleastone">>]>;
+/**
+ * Zod schema for `RoutingConfig`. `.strict()` rejects unknown keys at
+ * every level (per Spec 2 D7: typos in routing keys are validation
+ * errors, not silent default-fallthroughs).
+ *
+ * Spec B Phase 0: all scalar routing fields accept `RoutingValueSchema`
+ * (scalar or non-empty chain). New optional `skills` and `modes` maps
+ * accept the same.
+ *
+ * Spec B Phase 2: the `isolation` block (added to the TS interface in
+ * Hermes Phase 5 but not previously in this Zod schema) is now included
+ * here with each tier widened to `RoutingValueSchema`. This closes the
+ * Phase 0 I2 review finding (TS-vs-Zod drift) and ensures isolation
+ * chain entries are validated by the same cross-field check that
+ * covers `skills` / `modes`.
+ */
+declare const RoutingConfigSchema: z.ZodObject<{
+    default: z.ZodUnion<[z.ZodString, z.ZodReadonly<z.ZodArray<z.ZodString, "atleastone">>]>;
+    'quick-fix': z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodReadonly<z.ZodArray<z.ZodString, "atleastone">>]>>;
+    'guided-change': z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodReadonly<z.ZodArray<z.ZodString, "atleastone">>]>>;
+    'full-exploration': z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodReadonly<z.ZodArray<z.ZodString, "atleastone">>]>>;
+    diagnostic: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodReadonly<z.ZodArray<z.ZodString, "atleastone">>]>>;
+    intelligence: z.ZodOptional<z.ZodObject<{
+        sel: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodReadonly<z.ZodArray<z.ZodString, "atleastone">>]>>;
+        pesl: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodReadonly<z.ZodArray<z.ZodString, "atleastone">>]>>;
+    }, "strict", z.ZodTypeAny, {
+        sel?: string | readonly [string, ...string[]] | undefined;
+        pesl?: string | readonly [string, ...string[]] | undefined;
+    }, {
+        sel?: string | readonly [string, ...string[]] | undefined;
+        pesl?: string | readonly [string, ...string[]] | undefined;
+    }>>;
+    isolation: z.ZodOptional<z.ZodObject<{
+        none: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodReadonly<z.ZodArray<z.ZodString, "atleastone">>]>>;
+        container: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodReadonly<z.ZodArray<z.ZodString, "atleastone">>]>>;
+        'remote-sandbox': z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodReadonly<z.ZodArray<z.ZodString, "atleastone">>]>>;
+    }, "strict", z.ZodTypeAny, {
+        none?: string | readonly [string, ...string[]] | undefined;
+        container?: string | readonly [string, ...string[]] | undefined;
+        'remote-sandbox'?: string | readonly [string, ...string[]] | undefined;
+    }, {
+        none?: string | readonly [string, ...string[]] | undefined;
+        container?: string | readonly [string, ...string[]] | undefined;
+        'remote-sandbox'?: string | readonly [string, ...string[]] | undefined;
+    }>>;
+    skills: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<[z.ZodString, z.ZodReadonly<z.ZodArray<z.ZodString, "atleastone">>]>>>;
+    modes: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<[z.ZodString, z.ZodReadonly<z.ZodArray<z.ZodString, "atleastone">>]>>>;
+}, "strict", z.ZodTypeAny, {
+    default: string | readonly [string, ...string[]];
+    'quick-fix'?: string | readonly [string, ...string[]] | undefined;
+    'guided-change'?: string | readonly [string, ...string[]] | undefined;
+    'full-exploration'?: string | readonly [string, ...string[]] | undefined;
+    diagnostic?: string | readonly [string, ...string[]] | undefined;
+    intelligence?: {
+        sel?: string | readonly [string, ...string[]] | undefined;
+        pesl?: string | readonly [string, ...string[]] | undefined;
+    } | undefined;
+    isolation?: {
+        none?: string | readonly [string, ...string[]] | undefined;
+        container?: string | readonly [string, ...string[]] | undefined;
+        'remote-sandbox'?: string | readonly [string, ...string[]] | undefined;
+    } | undefined;
+    skills?: Record<string, string | readonly [string, ...string[]]> | undefined;
+    modes?: Record<string, string | readonly [string, ...string[]]> | undefined;
+}, {
+    default: string | readonly [string, ...string[]];
+    'quick-fix'?: string | readonly [string, ...string[]] | undefined;
+    'guided-change'?: string | readonly [string, ...string[]] | undefined;
+    'full-exploration'?: string | readonly [string, ...string[]] | undefined;
+    diagnostic?: string | readonly [string, ...string[]] | undefined;
+    intelligence?: {
+        sel?: string | readonly [string, ...string[]] | undefined;
+        pesl?: string | readonly [string, ...string[]] | undefined;
+    } | undefined;
+    isolation?: {
+        none?: string | readonly [string, ...string[]] | undefined;
+        container?: string | readonly [string, ...string[]] | undefined;
+        'remote-sandbox'?: string | readonly [string, ...string[]] | undefined;
+    } | undefined;
+    skills?: Record<string, string | readonly [string, ...string[]]> | undefined;
+    modes?: Record<string, string | readonly [string, ...string[]]> | undefined;
+}>;
+
+interface ResolverLogger {
+    info(message: string, context?: Record<string, unknown>): void;
+    warn(message: string, context?: Record<string, unknown>): void;
+}
+interface LocalModelResolverOptions {
+    endpoint: string;
+    apiKey?: string;
+    /** Normalized candidate list (already turned from string|string[] into string[]). */
+    configured: string[];
+    /** Probe cadence in ms; default 30_000, minimum 1_000. */
+    probeIntervalMs?: number;
+    /**
+     * Per-request timeout for the default fetch implementation, in ms.
+     * Default: 5_000. Ignored when a custom `fetchModels` is provided
+     * (custom impls own their own timeout policy). Spec §3.1 line 136
+     * enumerates timeout as a supported failure mode.
+     */
+    timeoutMs?: number;
+    /**
+     * Injectable for tests. Default: GET `${endpoint}/models` with bearer apiKey.
+     * Resolves to detected model IDs. Rejects on network/timeout/non-2xx/malformed.
+     */
+    fetchModels?: (endpoint: string, apiKey?: string) => Promise<string[]>;
+    logger?: ResolverLogger;
+}
+declare function normalizeLocalModel(input: string | string[] | undefined): string[];
+/**
+ * Default `fetchModels` — GET `${endpoint}/models` with bearer apiKey.
+ * Throws on network failure, non-2xx, malformed body, or timeout.
+ *
+ * `timeoutMs` defaults to 5_000. A timeout aborts the in-flight request and
+ * surfaces as `Error('request timeout (Nms)')` so callers can distinguish it
+ * from generic network errors.
+ */
+declare function defaultFetchModels(endpoint: string, apiKey?: string, timeoutMs?: number): Promise<string[]>;
+declare class LocalModelResolver {
+    private readonly endpoint;
+    private readonly apiKey?;
+    private readonly configured;
+    private readonly probeIntervalMs;
+    private readonly fetchModels;
+    private readonly logger;
+    private timer;
+    private listeners;
+    /**
+     * Tracks an in-flight probe so concurrent invocations (interval tick while a
+     * slow probe is running, or a manual `probe()` call mid-flight) share the
+     * existing promise instead of racing to mutate `detected/resolved/lastError/
+     * warnings` non-atomically across `await` points. Applies to both the timer
+     * callback and direct `probe()` calls — any caller that arrives during an
+     * in-flight probe gets the same promise back. Cleared in `finally` so the
+     * next tick can start a fresh probe.
+     */
+    private probeInFlight;
+    private resolved;
+    private detected;
+    private lastProbeAt;
+    private lastError;
+    private warnings;
+    private available;
+    constructor(opts: LocalModelResolverOptions);
+    resolveModel(): string | null;
+    getStatus(): LocalModelStatus;
+    onStatusChange(handler: (status: LocalModelStatus) => void): () => void;
+    probe(): Promise<LocalModelStatus>;
+    private runProbe;
+    start(): Promise<void>;
+    stop(): void;
+    private snapshotForDiff;
+}
+
 /**
  * Function signature compatible with Node's `child_process.execFile`.
  * Allows injection for testing.
@@ -2552,4 +2817,4 @@ declare function emitProposalCreated(bus: EventEmitter, proposal: SkillProposal)
 declare function emitProposalApproved(bus: EventEmitter, proposal: SkillProposal): void;
 declare function emitProposalRejected(bus: EventEmitter, proposal: SkillProposal): void;
 
-export { type AgentUpdateEvent, AnalysisArchive, type AnalysisRecord, type ApplyEventResult, type ArtifactPresence, type AttemptStats, BUILT_IN_TASKS, BackendRouter, type BackendRouterOptions, type BaseRefFallbackEvent, type BuildArchiveHooksOptions, ClaimManager, type ClaimManagerConfig, type CleanWorkspaceEffect, type CreateTokenInput, type CreateTokenResult, type CustomTaskValidationError, type DispatchEffect, type EmitLogEffect, type EscalateEffect, type ExecFileFn$1 as ExecFileFn, type FromConfigOptions, GateNotReadyError, type GateResult, GateRunError, type Highlight, type HighlightsInfo, type IndexedDoc, InteractionQueue, type LinearGraphQLExtension, LinearGraphQLStub, type LiveSession, MAX_ATTEMPTS, type MigrationResult, MockBackend, type NotificationSink, type NotificationSinkDeliverInput, ORCHESTRATOR_IDENTITY_FILE, Orchestrator, OrchestratorBackendFactory, type OrchestratorBackendFactoryOptions, type OrchestratorContext, type OrchestratorEvent, type OrchestratorState, PRDetector, type PRDetectorLogger, type PendingInteraction, type PersistedOutputEntry, PromotionError, type PromotionResult, PromptRenderer, type ProposalApprovedData, type ProposalCreatedData, type ProposalRejectedData, type PublishedIndex, type QueueInsertInput, type QueueRow, type QueueStats, RETRY_DELAYS_MS, type RateLimitSnapshot as RateLimitComputeSnapshot, type RateLimitConfig, type RateLimitSnapshot$1 as RateLimitSnapshot, type RegistryEntry, type ReleaseClaimEffect, type RetryEntry, type RetryFiredEvent, RoadmapTrackerAdapter, type RunAttemptPhase, type RunOrigin, type RunningEntry, type ScheduleRetryEffect, type SearchOptions, type SideEffect, SinkConfigError, SinkRegistry, type SkillCatalogEntry, SlackSink, type SlackSinkOptions, SqliteSearchIndex, type StallDetectedEvent, type StopEffect, type StreamManifest, StreamRecorder, type SummarizeContext, type SummarizeResult, type SyncMainOptions, type SyncMainResult, type SyncSkipReason, type TaskDefinition, TaskOutputStore, type TaskType, type TickEvent, TokenStore, type TokenTotals, type TriageConfig, type TriageDecision, type TriageSignals, type TriageSkill, type UpdateTokensEffect, type ValidateWorkflowConfigOptions, type ValidatedWorkflowConfig, WebhookQueue, type WorkerExitEvent, WorkflowLoader, WorkspaceHooks, WorkspaceManager, type WorkspaceManagerOptions, applyEvent, artifactPresenceFromIssue, buildArchiveHooks, calculateRetryDelay, canDispatch, computeRateLimitDelay, createBackend, createEmptyState, crossFieldRoutingIssues, detectScopeTier, discoverSkillCatalog, discoverSkillCatalogNames, emitProposalApproved, emitProposalCreated, emitProposalRejected, extractHighlights, extractTitlePrefix, getAvailableSlots, getDefaultConfig, getPerStateCount, indexSessionDirectory, isEligible, isSummaryEnabled, launchTUI, loadPublishedIndex, migrateAgentConfig, normalizeFts5Query, openSearchIndex, promote, reconcile, reindexFromArchive, renderAnalysisComment, renderLlmSummaryMarkdown, renderPRComment, resolveEscalationConfig, resolveOrchestratorId, routeIssue, routingWarnings, runGate, savePublishedIndex, searchIndexPath, selectCandidates, sortCandidates, summarizeArchivedSession, syncMain, triageIssue, truncateForBudget, validateCustomTasks, validateWorkflowConfig, wireNotificationSinks, wrapAsEnvelope };
+export { type AgentUpdateEvent, AnalysisArchive, type AnalysisRecord, type ApplyEventResult, type ArtifactPresence, type AttemptStats, BUILT_IN_TASKS, BackendDefSchema, BackendRouter, type BackendRouterOptions, type BaseRefFallbackEvent, type BuildArchiveHooksOptions, ClaimManager, type ClaimManagerConfig, type CleanWorkspaceEffect, type CreateTokenInput, type CreateTokenResult, type CustomTaskValidationError, type DispatchEffect, type EmitLogEffect, type EscalateEffect, type ExecFileFn$1 as ExecFileFn, type FromConfigOptions, GateNotReadyError, type GateResult, GateRunError, type Highlight, type HighlightsInfo, type IndexedDoc, InteractionQueue, type LinearGraphQLExtension, LinearGraphQLStub, type LiveSession, LocalModelResolver, type LocalModelResolverOptions, MAX_ATTEMPTS, type MigrationResult, MockBackend, type NotificationSink, type NotificationSinkDeliverInput, ORCHESTRATOR_IDENTITY_FILE, Orchestrator, OrchestratorBackendFactory, type OrchestratorBackendFactoryOptions, type OrchestratorContext, type OrchestratorEvent, type OrchestratorState, PRDetector, type PRDetectorLogger, type PendingInteraction, type PersistedOutputEntry, PromotionError, type PromotionResult, PromptRenderer, type ProposalApprovedData, type ProposalCreatedData, type ProposalRejectedData, type PublishedIndex, type QueueInsertInput, type QueueRow, type QueueStats, RETRY_DELAYS_MS, type RateLimitSnapshot as RateLimitComputeSnapshot, type RateLimitConfig, type RateLimitSnapshot$1 as RateLimitSnapshot, type RegistryEntry, type ReleaseClaimEffect, type ResolverLogger, type RetryEntry, type RetryFiredEvent, RoadmapTrackerAdapter, RoutingConfigSchema, RoutingValueSchema, type RunAttemptPhase, type RunOrigin, type RunningEntry, type ScheduleRetryEffect, type SearchOptions, type SideEffect, SinkConfigError, SinkRegistry, type SkillCatalogEntry, SlackSink, type SlackSinkOptions, SqliteSearchIndex, type StallDetectedEvent, type StopEffect, type StreamManifest, StreamRecorder, type SummarizeContext, type SummarizeResult, type SyncMainOptions, type SyncMainResult, type SyncSkipReason, type TaskDefinition, TaskOutputStore, type TaskType, type TickEvent, TokenStore, type TokenTotals, type TriageConfig, type TriageDecision, type TriageSignals, type TriageSkill, type UpdateTokensEffect, type ValidateWorkflowConfigOptions, type ValidatedWorkflowConfig, WebhookQueue, type WorkerExitEvent, WorkflowLoader, WorkspaceHooks, WorkspaceManager, type WorkspaceManagerOptions, applyEvent, artifactPresenceFromIssue, buildArchiveHooks, calculateRetryDelay, canDispatch, computeRateLimitDelay, createBackend, createEmptyState, crossFieldRoutingIssues, defaultFetchModels, detectScopeTier, discoverSkillCatalog, discoverSkillCatalogNames, emitProposalApproved, emitProposalCreated, emitProposalRejected, extractHighlights, extractTitlePrefix, getAvailableSlots, getDefaultConfig, getPerStateCount, indexSessionDirectory, isEligible, isSummaryEnabled, launchTUI, loadPublishedIndex, migrateAgentConfig, normalizeFts5Query, normalizeLocalModel, openSearchIndex, promote, reconcile, reindexFromArchive, renderAnalysisComment, renderLlmSummaryMarkdown, renderPRComment, resolveEscalationConfig, resolveOrchestratorId, routeIssue, routingWarnings, runGate, savePublishedIndex, searchIndexPath, selectCandidates, sortCandidates, summarizeArchivedSession, syncMain, triageIssue, truncateForBudget, validateCustomTasks, validateWorkflowConfig, wireNotificationSinks, wrapAsEnvelope };

package/dist/index.js

@@ -32,12 +32,14 @@ var index_exports = {};
 __export(index_exports, {
   AnalysisArchive: () => AnalysisArchive,
   BUILT_IN_TASKS: () => BUILT_IN_TASKS,
+  BackendDefSchema: () => BackendDefSchema,
   BackendRouter: () => BackendRouter,
   ClaimManager: () => ClaimManager,
   GateNotReadyError: () => GateNotReadyError,
   GateRunError: () => GateRunError,
   InteractionQueue: () => InteractionQueue,
   LinearGraphQLStub: () => LinearGraphQLStub,
+  LocalModelResolver: () => LocalModelResolver,
   MAX_ATTEMPTS: () => MAX_ATTEMPTS,
   MockBackend: () => MockBackend,
   ORCHESTRATOR_IDENTITY_FILE: () => ORCHESTRATOR_IDENTITY_FILE,
@@ -48,6 +50,8 @@ __export(index_exports, {
   PromptRenderer: () => PromptRenderer,
   RETRY_DELAYS_MS: () => RETRY_DELAYS_MS,
   RoadmapTrackerAdapter: () => RoadmapTrackerAdapter,
+  RoutingConfigSchema: () => RoutingConfigSchema,
+  RoutingValueSchema: () => RoutingValueSchema,
   SinkConfigError: () => SinkConfigError,
   SinkRegistry: () => SinkRegistry,
   SlackSink: () => SlackSink,
@@ -68,6 +72,7 @@ __export(index_exports, {
   createBackend: () => createBackend,
   createEmptyState: () => createEmptyState,
   crossFieldRoutingIssues: () => crossFieldRoutingIssues,
+  defaultFetchModels: () => defaultFetchModels,
   detectScopeTier: () => detectScopeTier,
   discoverSkillCatalog: () => discoverSkillCatalog,
   discoverSkillCatalogNames: () => discoverSkillCatalogNames,
@@ -86,6 +91,7 @@ __export(index_exports, {
   loadPublishedIndex: () => loadPublishedIndex,
   migrateAgentConfig: () => migrateAgentConfig,
   normalizeFts5Query: () => normalizeFts5Query,
+  normalizeLocalModel: () => normalizeLocalModel,
   openSearchIndex: () => openSearchIndex,
   promote: () => promote,
   reconcile: () => reconcile,
@@ -2881,6 +2887,21 @@ var path21 = __toESM(require("path"));
 var import_node_crypto16 = require("crypto");
 var import_core14 = require("@harness-engineering/core");
 
+// src/core/stall-detector.ts
+function detectStalledIssues(running, nowMs, stallTimeoutMs) {
+  if (stallTimeoutMs <= 0) return [];
+  const stalled = [];
+  for (const [runId, entry] of running) {
+    const reference = entry.session?.lastTimestamp ?? entry.startedAt;
+    if (!reference) continue;
+    const silentMs = nowMs - new Date(reference).getTime();
+    if (silentMs >= stallTimeoutMs) {
+      stalled.push(runId);
+    }
+  }
+  return stalled;
+}
+
 // src/intelligence/pipeline-runner.ts
 var path9 = __toESM(require("path"));
 var import_intelligence = require("@harness-engineering/intelligence");
@@ -3640,6 +3661,14 @@ var DEFAULT_PROBE_INTERVAL_MS = 3e4;
 var MIN_PROBE_INTERVAL_MS = 1e3;
 var DEFAULT_API_KEY = "lm-studio";
 var DEFAULT_FETCH_TIMEOUT_MS = 5e3;
+function normalizeLocalModel(input) {
+  if (input === void 0) return [];
+  if (typeof input === "string") return [input];
+  if (input.length === 0) {
+    throw new Error("localModel array must be non-empty when provided");
+  }
+  return [...input];
+}
 var noopLogger = {
   info: () => void 0,
   warn: () => void 0
@@ -6927,7 +6956,7 @@ var ChatRequestSchema = import_zod6.z.object({
 });
 function handleChatProxyRoute(req, res, command = "claude") {
   const { method, url } = req;
-  if (method === "POST" && url === "/api/chat") {
+  if (method === "POST" && (url === "/api/chat" || url === "/api/chat-proxy")) {
     void handleChatRequest(req, res, command);
     return true;
   }
@@ -9286,7 +9315,7 @@ function requiredScopeForRoute(method, path24) {
   if (path24.startsWith("/api/maintenance")) return "trigger-job";
   if (path24.startsWith("/api/streams")) return "read-status";
   if (path24.startsWith("/api/sessions")) return "read-status";
-  if (path24.startsWith("/api/chat-proxy")) return "trigger-job";
+  if (path24 === "/api/chat" || path24.startsWith("/api/chat-proxy")) return "trigger-job";
   return null;
 }
 
@@ -12997,32 +13026,27 @@ ${messages}`);
       await this.handleEffect(effect);
     }
     const stallTimeoutMs = this.config.agent.stallTimeoutMs;
-    if (stallTimeoutMs > 0) {
-      const stalledIds = [];
-      for (const [runId, runEntry] of this.state.running) {
-        const lastTs = runEntry.session?.lastTimestamp;
-        if (!lastTs) continue;
-        const silentMs = nowMs - new Date(lastTs).getTime();
-        if (silentMs >= stallTimeoutMs) {
-          stalledIds.push(runId);
-        }
-      }
-      for (const runId of stalledIds) {
-        const runEntry = this.state.running.get(runId);
-        if (!runEntry) continue;
-        this.logger.warn(
-          `Agent stalled for ${runEntry.identifier}: ${Math.round((nowMs - new Date(runEntry.session?.lastTimestamp ?? 0).getTime()) / 1e3)}s since last event`,
-          { issueId: runId }
-        );
-        const stallEvent = {
-          type: "stall_detected",
+    const stalledIds = detectStalledIssues(this.state.running, nowMs, stallTimeoutMs);
+    for (const runId of stalledIds) {
+      const runEntry = this.state.running.get(runId);
+      if (!runEntry) continue;
+      const reference = runEntry.session?.lastTimestamp ?? runEntry.startedAt;
+      const silentSec = Math.round((nowMs - new Date(reference).getTime()) / 1e3);
+      const sinceWhat = runEntry.session?.lastTimestamp ? "last event" : "dispatch";
+      this.logger.warn(
+        `Agent stalled for ${runEntry.identifier}: ${silentSec}s since ${sinceWhat}`,
+        {
           issueId: runId
-        };
-        const stallResult = applyEvent(this.state, stallEvent, this.config);
-        this.state = stallResult.nextState;
-        for (const eff of stallResult.effects) {
-          await this.handleEffect(eff);
         }
+      );
+      const stallEvent = {
+        type: "stall_detected",
+        issueId: runId
+      };
+      const stallResult = applyEvent(this.state, stallEvent, this.config);
+      this.state = stallResult.nextState;
+      for (const eff of stallResult.effects) {
+        await this.handleEffect(eff);
       }
     }
     const openPrNumbers = [];
@@ -14689,12 +14713,14 @@ function buildArchiveHooks(opts) {
 0 && (module.exports = {
   AnalysisArchive,
   BUILT_IN_TASKS,
+  BackendDefSchema,
   BackendRouter,
   ClaimManager,
   GateNotReadyError,
   GateRunError,
   InteractionQueue,
   LinearGraphQLStub,
+  LocalModelResolver,
   MAX_ATTEMPTS,
   MockBackend,
   ORCHESTRATOR_IDENTITY_FILE,
@@ -14705,6 +14731,8 @@ function buildArchiveHooks(opts) {
   PromptRenderer,
   RETRY_DELAYS_MS,
   RoadmapTrackerAdapter,
+  RoutingConfigSchema,
+  RoutingValueSchema,
   SinkConfigError,
   SinkRegistry,
   SlackSink,
@@ -14725,6 +14753,7 @@ function buildArchiveHooks(opts) {
   createBackend,
   createEmptyState,
   crossFieldRoutingIssues,
+  defaultFetchModels,
   detectScopeTier,
   discoverSkillCatalog,
   discoverSkillCatalogNames,
@@ -14743,6 +14772,7 @@ function buildArchiveHooks(opts) {
   loadPublishedIndex,
   migrateAgentConfig,
   normalizeFts5Query,
+  normalizeLocalModel,
   openSearchIndex,
   promote,
   reconcile,

package/dist/index.mjs

@@ -2778,6 +2778,21 @@ import * as path21 from "path";
 import { randomUUID as randomUUID5 } from "crypto";
 import { writeTaint } from "@harness-engineering/core";
 
+// src/core/stall-detector.ts
+function detectStalledIssues(running, nowMs, stallTimeoutMs) {
+  if (stallTimeoutMs <= 0) return [];
+  const stalled = [];
+  for (const [runId, entry] of running) {
+    const reference = entry.session?.lastTimestamp ?? entry.startedAt;
+    if (!reference) continue;
+    const silentMs = nowMs - new Date(reference).getTime();
+    if (silentMs >= stallTimeoutMs) {
+      stalled.push(runId);
+    }
+  }
+  return stalled;
+}
+
 // src/intelligence/pipeline-runner.ts
 import * as path9 from "path";
 import { weightedRecommendPersona, refreshProfiles } from "@harness-engineering/intelligence";
@@ -3544,6 +3559,14 @@ var DEFAULT_PROBE_INTERVAL_MS = 3e4;
 var MIN_PROBE_INTERVAL_MS = 1e3;
 var DEFAULT_API_KEY = "lm-studio";
 var DEFAULT_FETCH_TIMEOUT_MS = 5e3;
+function normalizeLocalModel(input) {
+  if (input === void 0) return [];
+  if (typeof input === "string") return [input];
+  if (input.length === 0) {
+    throw new Error("localModel array must be non-empty when provided");
+  }
+  return [...input];
+}
 var noopLogger = {
   info: () => void 0,
   warn: () => void 0
@@ -6866,7 +6889,7 @@ var ChatRequestSchema = z6.object({
 });
 function handleChatProxyRoute(req, res, command = "claude") {
   const { method, url } = req;
-  if (method === "POST" && url === "/api/chat") {
+  if (method === "POST" && (url === "/api/chat" || url === "/api/chat-proxy")) {
     void handleChatRequest(req, res, command);
     return true;
   }
@@ -9255,7 +9278,7 @@ function requiredScopeForRoute(method, path24) {
   if (path24.startsWith("/api/maintenance")) return "trigger-job";
   if (path24.startsWith("/api/streams")) return "read-status";
   if (path24.startsWith("/api/sessions")) return "read-status";
-  if (path24.startsWith("/api/chat-proxy")) return "trigger-job";
+  if (path24 === "/api/chat" || path24.startsWith("/api/chat-proxy")) return "trigger-job";
   return null;
 }
 
@@ -12974,32 +12997,27 @@ ${messages}`);
       await this.handleEffect(effect);
     }
     const stallTimeoutMs = this.config.agent.stallTimeoutMs;
-    if (stallTimeoutMs > 0) {
-      const stalledIds = [];
-      for (const [runId, runEntry] of this.state.running) {
-        const lastTs = runEntry.session?.lastTimestamp;
-        if (!lastTs) continue;
-        const silentMs = nowMs - new Date(lastTs).getTime();
-        if (silentMs >= stallTimeoutMs) {
-          stalledIds.push(runId);
-        }
-      }
-      for (const runId of stalledIds) {
-        const runEntry = this.state.running.get(runId);
-        if (!runEntry) continue;
-        this.logger.warn(
-          `Agent stalled for ${runEntry.identifier}: ${Math.round((nowMs - new Date(runEntry.session?.lastTimestamp ?? 0).getTime()) / 1e3)}s since last event`,
-          { issueId: runId }
-        );
-        const stallEvent = {
-          type: "stall_detected",
+    const stalledIds = detectStalledIssues(this.state.running, nowMs, stallTimeoutMs);
+    for (const runId of stalledIds) {
+      const runEntry = this.state.running.get(runId);
+      if (!runEntry) continue;
+      const reference = runEntry.session?.lastTimestamp ?? runEntry.startedAt;
+      const silentSec = Math.round((nowMs - new Date(reference).getTime()) / 1e3);
+      const sinceWhat = runEntry.session?.lastTimestamp ? "last event" : "dispatch";
+      this.logger.warn(
+        `Agent stalled for ${runEntry.identifier}: ${silentSec}s since ${sinceWhat}`,
+        {
           issueId: runId
-        };
-        const stallResult = applyEvent(this.state, stallEvent, this.config);
-        this.state = stallResult.nextState;
-        for (const eff of stallResult.effects) {
-          await this.handleEffect(eff);
         }
+      );
+      const stallEvent = {
+        type: "stall_detected",
+        issueId: runId
+      };
+      const stallResult = applyEvent(this.state, stallEvent, this.config);
+      this.state = stallResult.nextState;
+      for (const eff of stallResult.effects) {
+        await this.handleEffect(eff);
       }
     }
     const openPrNumbers = [];
@@ -14667,12 +14685,14 @@ function buildArchiveHooks(opts) {
 export {
   AnalysisArchive,
   BUILT_IN_TASKS,
+  BackendDefSchema,
   BackendRouter,
   ClaimManager,
   GateNotReadyError,
   GateRunError,
   InteractionQueue,
   LinearGraphQLStub,
+  LocalModelResolver,
   MAX_ATTEMPTS,
   MockBackend,
   ORCHESTRATOR_IDENTITY_FILE,
@@ -14683,6 +14703,8 @@ export {
   PromptRenderer,
   RETRY_DELAYS_MS,
   RoadmapTrackerAdapter,
+  RoutingConfigSchema,
+  RoutingValueSchema,
   SinkConfigError,
   SinkRegistry,
   SlackSink,
@@ -14703,6 +14725,7 @@ export {
   createBackend,
   createEmptyState,
   crossFieldRoutingIssues,
+  defaultFetchModels,
   detectScopeTier,
   discoverSkillCatalog,
   discoverSkillCatalogNames,
@@ -14721,6 +14744,7 @@ export {
   loadPublishedIndex,
   migrateAgentConfig,
   normalizeFts5Query,
+  normalizeLocalModel,
   openSearchIndex,
   promote,
   reconcile,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@harness-engineering/orchestrator",
-  "version": "0.7.0",
+  "version": "0.8.1",
   "description": "Orchestrator daemon for dispatching coding agents to issues",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",
@@ -48,10 +48,10 @@
     "ws": "^8.21.0",
     "yaml": "^2.8.3",
     "zod": "^3.25.76",
-    "@harness-engineering/core": "0.28.1",
-    "@harness-engineering/graph": "0.10.0",
-    "@harness-engineering/intelligence": "0.2.6",
-    "@harness-engineering/types": "0.15.0"
+    "@harness-engineering/core": "0.29.0",
+    "@harness-engineering/graph": "0.11.0",
+    "@harness-engineering/intelligence": "0.2.7",
+    "@harness-engineering/types": "0.16.0"
   },
   "devDependencies": {
     "@asteasolutions/zod-to-openapi": "^7.3.0",