@exaudeus/workrail 3.76.0 → 3.77.1

package/dist/daemon/workflow-enricher.js

@@ -0,0 +1,58 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EMPTY_RESULT = void 0;
+exports.createWorkflowEnricherDeps = createWorkflowEnricherDeps;
+exports.enrichTriggerContext = enrichTriggerContext;
+exports.shouldEnrich = shouldEnrich;
+const node_child_process_1 = require("node:child_process");
+const node_util_1 = require("node:util");
+const infra_js_1 = require("../context-assembly/infra.js");
+const execFileAsync = (0, node_util_1.promisify)(node_child_process_1.execFile);
+exports.EMPTY_RESULT = {
+    priorSessionNotes: [],
+    gitDiffStat: null,
+};
+function createWorkflowEnricherDeps() {
+    return {
+        execGit: async (args, cwd) => {
+            try {
+                const { stdout } = await execFileAsync('git', [...args], { cwd });
+                return { kind: 'ok', value: stdout };
+            }
+            catch (e) {
+                return { kind: 'err', error: e instanceof Error ? e.message : String(e) };
+            }
+        },
+        listRecentSessions: (0, infra_js_1.createListRecentSessions)(),
+    };
+}
+const LIST_SESSIONS_TIMEOUT_MS = 1000;
+function raceWithTimeout(promise, timeoutMs, timeoutMessage) {
+    let handle;
+    const timeout = new Promise((resolve) => {
+        handle = setTimeout(() => resolve({ kind: 'err', error: timeoutMessage }), timeoutMs);
+    });
+    return Promise.race([
+        promise.then((r) => { clearTimeout(handle); return r; }),
+        timeout,
+    ]);
+}
+const MAX_PRIOR_NOTES = 3;
+async function enrichTriggerContext(trigger, deps, policy) {
+    const notesPromise = policy === 'skip_coordinator_provided'
+        ? Promise.resolve({ kind: 'ok', value: [] })
+        : raceWithTimeout(deps.listRecentSessions(trigger.workspacePath, MAX_PRIOR_NOTES), LIST_SESSIONS_TIMEOUT_MS, 'listRecentSessions timeout (1s)');
+    const [notesResult, gitResult] = await Promise.all([
+        notesPromise,
+        deps.execGit(['diff', 'HEAD~1', '--stat'], trigger.workspacePath),
+    ]);
+    return {
+        priorSessionNotes: notesResult.kind === 'ok' ? notesResult.value : [],
+        gitDiffStat: gitResult.kind === 'ok' && gitResult.value.trim().length > 0
+            ? gitResult.value.trim()
+            : null,
+    };
+}
+function shouldEnrich(trigger) {
+    return (trigger.spawnDepth ?? 0) === 0;
+}

package/dist/daemon/workflow-runner.d.ts

@@ -1,19 +1,15 @@
 import 'reflect-metadata';
-import Anthropic from '@anthropic-ai/sdk';
-import { AnthropicBedrock } from '@anthropic-ai/bedrock-sdk';
-import { AgentLoop } from "./agent-loop.js";
-import type { AgentTool, AgentEvent, AgentLoopCallbacks } from "./agent-loop.js";
 import type { V2ToolContext } from '../mcp/types.js';
-import { executeContinueWorkflow } from '../mcp/handlers/v2-execution/index.js';
 import type { DaemonRegistry } from '../v2/infra/in-memory/daemon-registry/index.js';
-import type { ContinueTokenResolved } from '../mcp/handlers/v2-token-ops.js';
-import type { SessionEventLogReadonlyStorePortV2 } from '../v2/ports/session-event-log-store.port.js';
-import type { ToolFailure } from '../mcp/handlers/v2-execution-helpers.js';
-import type { ResultAsync } from 'neverthrow';
 import type { DaemonEventEmitter } from './daemon-events.js';
-import { type SessionScope } from './session-scope.js';
 import { ActiveSessionSet } from './active-sessions.js';
-import type { SessionHandle } from './active-sessions.js';
+import type { WorkflowTrigger, SessionSource, WorkflowRunResult } from './types.js';
+import { type WorkflowEnricherDeps } from './workflow-enricher.js';
+export { loadDaemonSoul, loadWorkspaceContext, loadSessionNotes, stripFrontmatter, MAX_SESSION_RECAP_NOTES, MAX_SESSION_NOTE_CHARS, } from './io/index.js';
+export type { PreAgentSession, PreAgentSessionResult, AgentReadySession, SessionOutcome, FinalizationContext, TurnEndSubscriberContext, } from './runner/index.js';
+export { WORKTREES_DIR } from './runner/runner-types.js';
+export { buildPreAgentSession, buildTurnEndSubscriber, buildAgentCallbacks, finalizeSession, } from './runner/index.js';
+export { runStartupRecovery, readDaemonSessionState, readAllDaemonSessions, countOrphanStepAdvances, clearQueueIssueSidecars, } from './startup-recovery.js';
 import { makeContinueWorkflowTool, makeCompleteStepTool } from './tools/continue-workflow.js';
 import { makeBashTool } from './tools/bash.js';
 import { makeReadTool, makeWriteTool, makeEditTool } from './tools/file-tools.js';
@@ -24,269 +20,9 @@ import { makeSignalCoordinatorTool } from './tools/signal-coordinator.js';
 export { DAEMON_SESSIONS_DIR, type PersistTokensError } from './tools/_shared.js';
 export { DAEMON_SIGNALS_DIR } from './tools/signal-coordinator.js';
 export { makeContinueWorkflowTool, makeCompleteStepTool, makeBashTool, makeReadTool, makeWriteTool, makeEditTool, makeGlobTool, makeGrepTool, makeSpawnAgentTool, makeReportIssueTool, makeSignalCoordinatorTool, };
-export declare const DEFAULT_SESSION_TIMEOUT_MINUTES = 30;
-export declare const DEFAULT_MAX_TURNS = 200;
-export declare const DEFAULT_STALL_TIMEOUT_SECONDS = 120;
-export declare const WORKTREES_DIR: string;
-export { DAEMON_SOUL_DEFAULT, DAEMON_SOUL_TEMPLATE } from './soul-template.js';
-export type ReadFileState = {
-    content: string;
-    timestamp: number;
-    isPartialView: boolean;
-};
-export interface WorkflowTrigger {
-    readonly workflowId: string;
-    readonly goal: string;
-    readonly workspacePath: string;
-    readonly context?: Readonly<Record<string, unknown>>;
-    readonly referenceUrls?: readonly string[];
-    readonly agentConfig?: {
-        readonly model?: string;
-        readonly maxSessionMinutes?: number;
-        readonly maxTurns?: number;
-        readonly maxOutputTokens?: number;
-        readonly maxSubagentDepth?: number;
-        readonly stuckAbortPolicy?: 'abort' | 'notify_only';
-        readonly noProgressAbortEnabled?: boolean;
-        readonly stallTimeoutSeconds?: number;
-    };
-    readonly parentSessionId?: string;
-    readonly spawnDepth?: number;
-    readonly soulFile?: string;
-    readonly botIdentity?: {
-        readonly name: string;
-        readonly email: string;
-    };
-    readonly branchStrategy?: 'worktree' | 'none';
-    readonly baseBranch?: string;
-    readonly branchPrefix?: string;
-}
-export interface AllocatedSession {
-    readonly continueToken: string;
-    readonly checkpointToken?: string | null;
-    readonly firstStepPrompt: string;
-    readonly isComplete: boolean;
-    readonly triggerSource: 'daemon' | 'mcp';
-    readonly sessionWorkspacePath?: string;
-}
-export type SessionSource = {
-    readonly kind: 'allocate';
-    readonly trigger: WorkflowTrigger;
-} | {
-    readonly kind: 'pre_allocated';
-    readonly trigger: WorkflowTrigger;
-    readonly session: AllocatedSession;
-};
-export interface WorkflowRunSuccess {
-    readonly _tag: 'success';
-    readonly workflowId: string;
-    readonly stopReason: string;
-    readonly lastStepNotes?: string;
-    readonly lastStepArtifacts?: readonly unknown[];
-    readonly sessionWorkspacePath?: string;
-    readonly sessionId?: string;
-    readonly botIdentity?: {
-        readonly name: string;
-        readonly email: string;
-    };
-}
-export interface WorkflowRunError {
-    readonly _tag: 'error';
-    readonly workflowId: string;
-    readonly message: string;
-    readonly stopReason: string;
-    readonly lastStepNotes?: string;
-}
-export interface WorkflowRunTimeout {
-    readonly _tag: 'timeout';
-    readonly workflowId: string;
-    readonly reason: 'wall_clock' | 'max_turns';
-    readonly message: string;
-    readonly stopReason: string;
-}
-export interface WorkflowRunStuck {
-    readonly _tag: 'stuck';
-    readonly workflowId: string;
-    readonly reason: 'repeated_tool_call' | 'no_progress' | 'stall';
-    readonly message: string;
-    readonly stopReason: string;
-    readonly issueSummaries?: readonly string[];
-}
-export interface WorkflowDeliveryFailed {
-    readonly _tag: 'delivery_failed';
-    readonly workflowId: string;
-    readonly stopReason: string;
-    readonly deliveryError: string;
-}
-export type WorkflowRunResult = WorkflowRunSuccess | WorkflowRunError | WorkflowRunTimeout | WorkflowRunStuck | WorkflowDeliveryFailed;
-export type ChildWorkflowRunResult = WorkflowRunSuccess | WorkflowRunError | WorkflowRunTimeout | WorkflowRunStuck;
-export interface OrphanedSession {
-    readonly sessionId: string;
-    readonly continueToken: string;
-    readonly checkpointToken: string | null;
-    readonly ts: number;
-    readonly worktreePath?: string;
-    readonly workflowId?: string;
-    readonly goal?: string;
-    readonly workspacePath?: string;
-}
-export declare function readDaemonSessionState(sessionId: string): Promise<{
-    continueToken: string;
-    checkpointToken: string | null;
-} | null>;
-export declare function readAllDaemonSessions(sessionsDir?: string): Promise<OrphanedSession[]>;
-export declare function runStartupRecovery(sessionsDir?: string, execFn?: (file: string, args: string[]) => Promise<{
-    stdout: string;
-    stderr: string;
-}>, ctx?: V2ToolContext, _countStepAdvancesFn?: typeof countOrphanStepAdvances, _executeContinueWorkflowFn?: typeof executeContinueWorkflow, _runWorkflowFn?: typeof runWorkflow, apiKey?: string): Promise<void>;
-export declare function countOrphanStepAdvances(continueToken: string, ctx: V2ToolContext, _parseFn?: ((raw: string) => ResultAsync<ContinueTokenResolved, ToolFailure>) | undefined, _loadFn?: SessionEventLogReadonlyStorePortV2['loadValidatedPrefix'] | undefined): Promise<number>;
-export declare function clearQueueIssueSidecars(sessionsDir: string): Promise<void>;
-export declare function stripFrontmatter(content: string): string;
-export declare function loadWorkspaceContext(workspacePath: string): Promise<string | null>;
-export declare function loadSessionNotes(continueToken: string, ctx: V2ToolContext): Promise<readonly string[]>;
-export declare function buildSessionRecap(notes: readonly string[]): string;
-export declare function buildSystemPrompt(trigger: WorkflowTrigger, sessionState: string, soulContent: string, workspaceContext: string | null, effectiveWorkspacePath: string): string;
-export declare function tagToStatsOutcome(tag: WorkflowRunResult['_tag']): 'success' | 'error' | 'timeout' | 'stuck';
-export type SidecarLifecycle = {
-    readonly kind: 'delete_now';
-} | {
-    readonly kind: 'retain_for_delivery';
-};
-export declare function sidecardLifecycleFor(tag: WorkflowRunResult['_tag'], branchStrategy: WorkflowTrigger['branchStrategy']): SidecarLifecycle;
-export declare function buildAgentClient(trigger: WorkflowTrigger, apiKey: string, env: NodeJS.ProcessEnv): {
-    agentClient: Anthropic | AnthropicBedrock;
-    modelId: string;
-};
-export type TerminalSignal = {
-    readonly kind: 'stuck';
-    readonly reason: 'repeated_tool_call' | 'no_progress' | 'stall';
-} | {
-    readonly kind: 'timeout';
-    readonly reason: 'wall_clock' | 'max_turns';
-};
-export declare function setTerminalSignal(state: SessionState, signal: TerminalSignal): boolean;
-export interface SessionState {
-    isComplete: boolean;
-    lastStepNotes: string | undefined;
-    lastStepArtifacts: readonly unknown[] | undefined;
-    currentContinueToken: string;
-    workrailSessionId: string | null;
-    stepAdvanceCount: number;
-    lastNToolCalls: Array<{
-        toolName: string;
-        argsSummary: string;
-    }>;
-    issueSummaries: string[];
-    pendingSteerParts: string[];
-    terminalSignal: TerminalSignal | null;
-    turnCount: number;
-}
-export declare function createSessionState(initialToken: string): SessionState;
-export interface StuckConfig {
-    maxTurns: number;
-    stuckAbortPolicy: 'abort' | 'notify_only';
-    noProgressAbortEnabled: boolean;
-    stuckRepeatThreshold: number;
-}
-export type StuckSignal = {
-    kind: 'repeated_tool_call';
-    toolName: string;
-    argsSummary: string;
-} | {
-    kind: 'no_progress';
-    turnCount: number;
-    maxTurns: number;
-} | {
-    kind: 'max_turns_exceeded';
-} | {
-    kind: 'timeout_imminent';
-    timeoutReason: 'wall_clock' | 'max_turns';
-};
-export declare function evaluateStuckSignals(state: Readonly<SessionState>, config: StuckConfig): StuckSignal | null;
-export interface PreAgentSession {
-    readonly sessionId: string;
-    readonly workrailSessionId: string | null;
-    readonly continueToken: string;
-    readonly checkpointToken: string | null;
-    readonly sessionWorkspacePath: string;
-    readonly sessionWorktreePath: string | undefined;
-    readonly firstStepPrompt: string;
-    readonly state: SessionState;
-    readonly spawnCurrentDepth: number;
-    readonly spawnMaxDepth: number;
-    readonly readFileState: Map<string, ReadFileState>;
-    readonly agentClient: Anthropic | AnthropicBedrock;
-    readonly modelId: string;
-    readonly startMs: number;
-    readonly handle?: SessionHandle;
-}
-export type PreAgentSessionResult = {
-    readonly kind: 'ready';
-    readonly session: PreAgentSession;
-} | {
-    readonly kind: 'complete';
-    readonly result: WorkflowRunResult;
-    readonly workrailSessionId: string | null;
-    readonly handle: SessionHandle | undefined;
-};
-export interface AgentReadySession {
-    readonly preAgentSession: PreAgentSession;
-    readonly contextBundle: import('./context-loader.js').ContextBundle;
-    readonly scope: SessionScope;
-    readonly tools: readonly AgentTool[];
-    readonly sessionCtx: SessionContext;
-    readonly handle: import('./active-sessions.js').SessionHandle | undefined;
-    readonly sessionId: string;
-    readonly workflowId: string;
-    readonly worktreePath: string | undefined;
-    readonly agent: AgentLoop;
-    readonly stuckRepeatThreshold: number;
-}
-export type SessionOutcome = {
-    readonly kind: 'completed';
-    readonly stopReason: string;
-    readonly errorMessage?: string;
-} | {
-    readonly kind: 'aborted';
-    readonly errorMessage?: string;
-};
-export interface FinalizationContext {
-    readonly sessionId: string;
-    readonly workrailSessionId: string | null;
-    readonly startMs: number;
-    readonly stepAdvanceCount: number;
-    readonly branchStrategy: 'worktree' | 'none' | undefined;
-    readonly statsDir: string;
-    readonly sessionsDir: string;
-    readonly conversationPath: string;
-    readonly emitter: DaemonEventEmitter | undefined;
-    readonly daemonRegistry: DaemonRegistry | undefined;
-    readonly workflowId: string;
-}
-export declare function finalizeSession(result: WorkflowRunResult, ctx: FinalizationContext): Promise<void>;
-export interface SessionContext {
-    readonly systemPrompt: string;
-    readonly initialPrompt: string;
-    readonly sessionTimeoutMs: number;
-    readonly maxTurns: number;
-    readonly stallTimeoutMs: number;
-}
-export declare function buildSessionContext(trigger: WorkflowTrigger, context: import('./context-loader.js').ContextBundle, firstStepPrompt: string, effectiveWorkspacePath: string): SessionContext;
-export declare function buildPreAgentSession(trigger: WorkflowTrigger, ctx: V2ToolContext, apiKey: string, sessionId: string, startMs: number, statsDir: string, sessionsDir: string, emitter: DaemonEventEmitter | undefined, daemonRegistry: DaemonRegistry | undefined, activeSessionSet: ActiveSessionSet | undefined, source?: SessionSource): Promise<PreAgentSessionResult>;
-export interface TurnEndSubscriberContext {
-    readonly agent: AgentLoop;
-    readonly state: SessionState;
-    readonly stuckConfig: StuckConfig;
-    readonly sessionId: string;
-    readonly workflowId: string;
-    readonly emitter: DaemonEventEmitter | undefined;
-    readonly conversationPath: string;
-    readonly lastFlushedRef: {
-        count: number;
-    };
-    readonly stuckRepeatThreshold: number;
-}
-export declare function buildTurnEndSubscriber(ctx: TurnEndSubscriberContext): (event: AgentEvent) => Promise<void>;
-export declare function buildAgentCallbacks(sessionId: string, state: SessionState, modelId: string, emitter: DaemonEventEmitter | undefined, stuckRepeatThreshold: number, workflowId?: string): AgentLoopCallbacks;
-export declare function buildSessionResult(state: Readonly<SessionState>, stopReason: string, errorMessage: string | undefined, trigger: WorkflowTrigger, sessionId: string, sessionWorktreePath: string | undefined): WorkflowRunResult;
-export declare function runWorkflow(trigger: WorkflowTrigger, ctx: V2ToolContext, apiKey: string, daemonRegistry?: DaemonRegistry, emitter?: DaemonEventEmitter, activeSessionSet?: ActiveSessionSet, _statsDir?: string, _sessionsDir?: string, source?: SessionSource): Promise<WorkflowRunResult>;
+export type { ReadFileState, WorkflowTrigger, AllocatedSession, SessionSource, WorkflowRunSuccess, WorkflowRunError, WorkflowRunTimeout, WorkflowRunStuck, WorkflowDeliveryFailed, WorkflowRunResult, ChildWorkflowRunResult, OrphanedSession, } from './types.js';
+export type { SessionState, TerminalSignal, StuckConfig, StuckSignal } from './state/index.js';
+export { createSessionState, setTerminalSignal, evaluateStuckSignals, advanceStep, recordCompletion, updateToken, setSessionId, recordToolCall, } from './state/index.js';
+export type { SessionContext, SidecarLifecycle } from './core/index.js';
+export { BASE_SYSTEM_PROMPT, buildSessionRecap, buildSystemPrompt, DEFAULT_SESSION_TIMEOUT_MINUTES, DEFAULT_MAX_TURNS, DEFAULT_STALL_TIMEOUT_SECONDS, buildSessionContext, tagToStatsOutcome, sidecardLifecycleFor, buildSessionResult, buildAgentClient, } from './core/index.js';
+export declare function runWorkflow(trigger: WorkflowTrigger, ctx: V2ToolContext, apiKey: string, daemonRegistry?: DaemonRegistry, emitter?: DaemonEventEmitter, activeSessionSet?: ActiveSessionSet, _statsDir?: string, _sessionsDir?: string, source?: SessionSource, enricherDeps?: WorkflowEnricherDeps): Promise<WorkflowRunResult>;