@harness-engineering/orchestrator 0.2.13 → 0.2.15

package/dist/index.d.mts

@@ -1,5 +1,5 @@
 import { Issue, AgentEvent, WorkflowConfig, IssueTrackerClient, TokenUsage, ConcernSignal, ScopeTier, EscalationConfig, RoutingDecision, Result, WorkflowDefinition, TrackerConfig, WorkspaceConfig, HooksConfig, AgentBackend, SessionStartParams, AgentSession, AgentError, TurnParams, TurnResult } from '@harness-engineering/types';
-import { EnrichedSpec, ComplexityScore, SimulationResult, IntelligencePipeline } from '@harness-engineering/intelligence';
+import { EnrichedSpec, ComplexityScore, SimulationResult, IntelligencePipeline, WeightedRecommendation } from '@harness-engineering/intelligence';
 import { GraphStore } from '@harness-engineering/graph';
 import { execFile } from 'node:child_process';
 import { EventEmitter } from 'node:events';
@@ -362,6 +362,8 @@ interface TickEvent {
     complexityScores?: Map<string, ComplexityScore>;
     /** Pre-computed PESL simulation results from intelligence pipeline (issueId -> result) */
     simulationResults?: Map<string, SimulationResult>;
+    /** Pre-computed persona recommendations from specialization scorer (issueId -> recommendations) */
+    personaRecommendations?: Map<string, WeightedRecommendation[]>;
 }
 interface WorkerExitEvent {
     type: 'worker_exit';
@@ -381,6 +383,8 @@ interface RetryFiredEvent {
     candidates: Issue[];
     /** Caller-supplied wall clock (ms since epoch). Keeps state machine pure. */
     nowMs: number;
+    /** Pre-computed concern signals from intelligence pipeline (issueId → signals) */
+    concernSignals?: Map<string, ConcernSignal[]>;
 }
 interface StallDetectedEvent {
     type: 'stall_detected';
@@ -456,6 +460,8 @@ interface ClaimEffect {
     backend?: 'local' | 'primary';
     /** Retry attempt number, if this is a retry dispatch */
     attempt: number | null;
+    /** Persona recommended by specialization scoring, if available */
+    suggestedPersona?: string;
 }
 
 /**
@@ -1126,6 +1132,10 @@ declare class Orchestrator extends EventEmitter {
     private enrichedSpecsByIssue;
     /** Tracks recently-failed intelligence analysis to avoid re-requesting every tick */
     private analysisFailureCache;
+    /** Abort controllers and PIDs for running agent tasks — used by stopIssue to cancel in-flight work.
+     *  The PID is stored here because the running entry may be deleted by the state machine
+     *  before the stop effect executes (e.g., stall_detected removes the entry first). */
+    private abortControllers;
     /** Guards against overlapping ticks when a tick takes longer than the polling interval */
     private tickInProgress;
     /** Timestamp of the last stale branch sweep (at most once per hour) */
@@ -1148,8 +1158,8 @@ declare class Orchestrator extends EventEmitter {
     private createBackend;
     /**
      * Creates a TaskRunner for the maintenance scheduler.
-     * Provides stub implementations for check/agent/command execution.
-     * Phase 4 (PRManager) and Phase 5 (Reporter) will enhance these.
+     * CheckCommandRunner and CommandExecutor use real child_process execution.
+     * AgentDispatcher remains stubbed (requires full skill dispatch integration).
      */
     private createMaintenanceTaskRunner;
     /**
@@ -1188,6 +1198,8 @@ declare class Orchestrator extends EventEmitter {
      * and an interaction is queued so a human can create the PR manually.
      */
     private cleanWorkspaceWithGuard;
+    /** Run the beforeRemove hook for a workspace. Failures are logged but non-fatal. */
+    private runBeforeRemoveHook;
     /**
      * Delegates to PRDetector.filterCandidatesWithOpenPRs.
      * @see PRDetector#filterCandidatesWithOpenPRs

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import { Issue, AgentEvent, WorkflowConfig, IssueTrackerClient, TokenUsage, ConcernSignal, ScopeTier, EscalationConfig, RoutingDecision, Result, WorkflowDefinition, TrackerConfig, WorkspaceConfig, HooksConfig, AgentBackend, SessionStartParams, AgentSession, AgentError, TurnParams, TurnResult } from '@harness-engineering/types';
-import { EnrichedSpec, ComplexityScore, SimulationResult, IntelligencePipeline } from '@harness-engineering/intelligence';
+import { EnrichedSpec, ComplexityScore, SimulationResult, IntelligencePipeline, WeightedRecommendation } from '@harness-engineering/intelligence';
 import { GraphStore } from '@harness-engineering/graph';
 import { execFile } from 'node:child_process';
 import { EventEmitter } from 'node:events';
@@ -362,6 +362,8 @@ interface TickEvent {
     complexityScores?: Map<string, ComplexityScore>;
     /** Pre-computed PESL simulation results from intelligence pipeline (issueId -> result) */
     simulationResults?: Map<string, SimulationResult>;
+    /** Pre-computed persona recommendations from specialization scorer (issueId -> recommendations) */
+    personaRecommendations?: Map<string, WeightedRecommendation[]>;
 }
 interface WorkerExitEvent {
     type: 'worker_exit';
@@ -381,6 +383,8 @@ interface RetryFiredEvent {
     candidates: Issue[];
     /** Caller-supplied wall clock (ms since epoch). Keeps state machine pure. */
     nowMs: number;
+    /** Pre-computed concern signals from intelligence pipeline (issueId → signals) */
+    concernSignals?: Map<string, ConcernSignal[]>;
 }
 interface StallDetectedEvent {
     type: 'stall_detected';
@@ -456,6 +460,8 @@ interface ClaimEffect {
     backend?: 'local' | 'primary';
     /** Retry attempt number, if this is a retry dispatch */
     attempt: number | null;
+    /** Persona recommended by specialization scoring, if available */
+    suggestedPersona?: string;
 }
 
 /**
@@ -1126,6 +1132,10 @@ declare class Orchestrator extends EventEmitter {
     private enrichedSpecsByIssue;
     /** Tracks recently-failed intelligence analysis to avoid re-requesting every tick */
     private analysisFailureCache;
+    /** Abort controllers and PIDs for running agent tasks — used by stopIssue to cancel in-flight work.
+     *  The PID is stored here because the running entry may be deleted by the state machine
+     *  before the stop effect executes (e.g., stall_detected removes the entry first). */
+    private abortControllers;
     /** Guards against overlapping ticks when a tick takes longer than the polling interval */
     private tickInProgress;
     /** Timestamp of the last stale branch sweep (at most once per hour) */
@@ -1148,8 +1158,8 @@ declare class Orchestrator extends EventEmitter {
     private createBackend;
     /**
      * Creates a TaskRunner for the maintenance scheduler.
-     * Provides stub implementations for check/agent/command execution.
-     * Phase 4 (PRManager) and Phase 5 (Reporter) will enhance these.
+     * CheckCommandRunner and CommandExecutor use real child_process execution.
+     * AgentDispatcher remains stubbed (requires full skill dispatch integration).
      */
     private createMaintenanceTaskRunner;
     /**
@@ -1188,6 +1198,8 @@ declare class Orchestrator extends EventEmitter {
      * and an interaction is queued so a human can create the PR manually.
      */
     private cleanWorkspaceWithGuard;
+    /** Run the beforeRemove hook for a workspace. Failures are logged but non-fatal. */
+    private runBeforeRemoveHook;
     /**
      * Delegates to PRDetector.filterCandidatesWithOpenPRs.
      * @see PRDetector#filterCandidatesWithOpenPRs