@exaudeus/workrail 3.75.0 → 3.77.0

package/dist/coordinators/pipeline-run-context.js

@@ -0,0 +1,114 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PipelineRunContextSchema = exports.ReviewPhaseRecordSchema = exports.CodingPhaseRecordSchema = exports.ShapingPhaseRecordSchema = exports.DiscoveryPhaseRecordSchema = exports.MIN_NOTES_LENGTH_FOR_PHASE_RESULT = void 0;
+exports.buildPhaseResult = buildPhaseResult;
+exports.parsePipelineRunContext = parsePipelineRunContext;
+const zod_1 = require("zod");
+const neverthrow_1 = require("neverthrow");
+const index_js_1 = require("../v2/durable-core/schemas/artifacts/index.js");
+exports.MIN_NOTES_LENGTH_FOR_PHASE_RESULT = 50;
+function buildPhaseResult(artifact, recapMarkdown) {
+    if (artifact !== null) {
+        const maybeConf = artifact.confidenceBand;
+        const confidenceBand = maybeConf === 'high' || maybeConf === 'medium' || maybeConf === 'low'
+            ? maybeConf
+            : null;
+        return { kind: 'full', artifact, confidenceBand, recapMarkdown };
+    }
+    if (recapMarkdown !== null && recapMarkdown.trim().length > exports.MIN_NOTES_LENGTH_FOR_PHASE_RESULT) {
+        return { kind: 'partial', recapMarkdown: recapMarkdown.trim() };
+    }
+    return { kind: 'fallback', recapMarkdown };
+}
+const PhaseResultFullDiscoverySchema = zod_1.z.object({
+    kind: zod_1.z.literal('full'),
+    artifact: index_js_1.DiscoveryHandoffArtifactV1Schema,
+    confidenceBand: zod_1.z.enum(['high', 'medium', 'low']).nullable(),
+    recapMarkdown: zod_1.z.string().nullable(),
+});
+const PhaseResultFullShapingSchema = zod_1.z.object({
+    kind: zod_1.z.literal('full'),
+    artifact: index_js_1.ShapingHandoffArtifactV1Schema,
+    confidenceBand: zod_1.z.enum(['high', 'medium', 'low']).nullable(),
+    recapMarkdown: zod_1.z.string().nullable(),
+});
+const PhaseResultFullCodingSchema = zod_1.z.object({
+    kind: zod_1.z.literal('full'),
+    artifact: index_js_1.CodingHandoffArtifactV1Schema,
+    confidenceBand: zod_1.z.enum(['high', 'medium', 'low']).nullable(),
+    recapMarkdown: zod_1.z.string().nullable(),
+});
+const PhaseResultFullReviewSchema = zod_1.z.object({
+    kind: zod_1.z.literal('full'),
+    artifact: index_js_1.ReviewVerdictArtifactV1Schema,
+    confidenceBand: zod_1.z.enum(['high', 'medium', 'low']).nullable(),
+    recapMarkdown: zod_1.z.string().nullable(),
+});
+const PhaseResultPartialSchema = zod_1.z.object({
+    kind: zod_1.z.literal('partial'),
+    recapMarkdown: zod_1.z.string(),
+});
+const PhaseResultFallbackSchema = zod_1.z.object({
+    kind: zod_1.z.literal('fallback'),
+    recapMarkdown: zod_1.z.string().nullable(),
+});
+exports.DiscoveryPhaseRecordSchema = zod_1.z.object({
+    completedAt: zod_1.z.string(),
+    sessionHandle: zod_1.z.string().min(1),
+    result: zod_1.z.discriminatedUnion('kind', [
+        PhaseResultFullDiscoverySchema,
+        PhaseResultPartialSchema,
+        PhaseResultFallbackSchema,
+    ]),
+});
+exports.ShapingPhaseRecordSchema = zod_1.z.object({
+    completedAt: zod_1.z.string(),
+    sessionHandle: zod_1.z.string().min(1),
+    result: zod_1.z.discriminatedUnion('kind', [
+        PhaseResultFullShapingSchema,
+        PhaseResultPartialSchema,
+        PhaseResultFallbackSchema,
+    ]),
+});
+exports.CodingPhaseRecordSchema = zod_1.z.object({
+    completedAt: zod_1.z.string(),
+    sessionHandle: zod_1.z.string().min(1),
+    result: zod_1.z.discriminatedUnion('kind', [
+        PhaseResultFullCodingSchema,
+        PhaseResultPartialSchema,
+        PhaseResultFallbackSchema,
+    ]),
+});
+exports.ReviewPhaseRecordSchema = zod_1.z.object({
+    completedAt: zod_1.z.string(),
+    sessionHandle: zod_1.z.string().min(1),
+    result: zod_1.z.discriminatedUnion('kind', [
+        PhaseResultFullReviewSchema,
+        PhaseResultPartialSchema,
+        PhaseResultFallbackSchema,
+    ]),
+});
+exports.PipelineRunContextSchema = zod_1.z.object({
+    runId: zod_1.z.string().min(1),
+    goal: zod_1.z.string().min(1),
+    workspace: zod_1.z.string().min(1),
+    startedAt: zod_1.z.string(),
+    pipelineMode: zod_1.z.enum(['FULL', 'IMPLEMENT', 'REVIEW_ONLY', 'QUICK_REVIEW']),
+    status: zod_1.z.enum(['in_progress', 'completed']).optional(),
+    phases: zod_1.z.object({
+        discovery: exports.DiscoveryPhaseRecordSchema.optional(),
+        shaping: exports.ShapingPhaseRecordSchema.optional(),
+        coding: exports.CodingPhaseRecordSchema.optional(),
+        review: exports.ReviewPhaseRecordSchema.optional(),
+    }),
+});
+function parsePipelineRunContext(raw) {
+    const result = exports.PipelineRunContextSchema.safeParse(raw);
+    if (!result.success) {
+        const issues = result.error.issues
+            .map((i) => `${i.path.join('.')}: ${i.message}`)
+            .join('; ');
+        return (0, neverthrow_1.err)(`PipelineRunContext parse failed: ${issues}`);
+    }
+    return (0, neverthrow_1.ok)(result.data);
+}

package/dist/daemon/context-loader.d.ts

@@ -1,4 +1,4 @@
-import type { WorkflowTrigger } from './workflow-runner.js';
+import type { WorkflowTrigger } from './types.js';
 import type { V2ToolContext } from '../mcp/types.js';
 export interface ContextRule {
     readonly source: string;

package/dist/daemon/core/agent-client.d.ts

@@ -0,0 +1,7 @@
+import Anthropic from '@anthropic-ai/sdk';
+import { AnthropicBedrock } from '@anthropic-ai/bedrock-sdk';
+import type { WorkflowTrigger } from '../types.js';
+export declare function buildAgentClient(trigger: WorkflowTrigger, apiKey: string, env: NodeJS.ProcessEnv): {
+    agentClient: Anthropic | AnthropicBedrock;
+    modelId: string;
+};

package/dist/daemon/core/agent-client.js

@@ -0,0 +1,31 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildAgentClient = buildAgentClient;
+const sdk_1 = __importDefault(require("@anthropic-ai/sdk"));
+const bedrock_sdk_1 = require("@anthropic-ai/bedrock-sdk");
+function buildAgentClient(trigger, apiKey, env) {
+    if (trigger.agentConfig?.model) {
+        const slashIdx = trigger.agentConfig.model.indexOf('/');
+        if (slashIdx === -1) {
+            throw new Error(`agentConfig.model must be in "provider/model-id" format, got: "${trigger.agentConfig.model}"`);
+        }
+        const provider = trigger.agentConfig.model.slice(0, slashIdx);
+        const modelId = trigger.agentConfig.model.slice(slashIdx + 1);
+        const agentClient = provider === 'amazon-bedrock' ? new bedrock_sdk_1.AnthropicBedrock() : new sdk_1.default({ apiKey });
+        return { agentClient, modelId };
+    }
+    const usesBedrock = !!env['AWS_PROFILE'] || !!env['AWS_ACCESS_KEY_ID'];
+    if (usesBedrock) {
+        return {
+            agentClient: new bedrock_sdk_1.AnthropicBedrock(),
+            modelId: 'us.anthropic.claude-sonnet-4-6',
+        };
+    }
+    return {
+        agentClient: new sdk_1.default({ apiKey }),
+        modelId: 'claude-sonnet-4-6',
+    };
+}

package/dist/daemon/core/index.d.ts

@@ -0,0 +1,6 @@
+export { BASE_SYSTEM_PROMPT, buildSessionRecap, buildSystemPrompt, DAEMON_SOUL_DEFAULT } from './system-prompt.js';
+export type { SessionContext } from './session-context.js';
+export { DEFAULT_SESSION_TIMEOUT_MINUTES, DEFAULT_MAX_TURNS, DEFAULT_STALL_TIMEOUT_SECONDS, buildSessionContext, } from './session-context.js';
+export type { SidecarLifecycle } from './session-result.js';
+export { tagToStatsOutcome, sidecardLifecycleFor, buildSessionResult } from './session-result.js';
+export { buildAgentClient } from './agent-client.js';

package/dist/daemon/core/index.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildAgentClient = exports.buildSessionResult = exports.sidecardLifecycleFor = exports.tagToStatsOutcome = exports.buildSessionContext = exports.DEFAULT_STALL_TIMEOUT_SECONDS = exports.DEFAULT_MAX_TURNS = exports.DEFAULT_SESSION_TIMEOUT_MINUTES = exports.DAEMON_SOUL_DEFAULT = exports.buildSystemPrompt = exports.buildSessionRecap = exports.BASE_SYSTEM_PROMPT = void 0;
+var system_prompt_js_1 = require("./system-prompt.js");
+Object.defineProperty(exports, "BASE_SYSTEM_PROMPT", { enumerable: true, get: function () { return system_prompt_js_1.BASE_SYSTEM_PROMPT; } });
+Object.defineProperty(exports, "buildSessionRecap", { enumerable: true, get: function () { return system_prompt_js_1.buildSessionRecap; } });
+Object.defineProperty(exports, "buildSystemPrompt", { enumerable: true, get: function () { return system_prompt_js_1.buildSystemPrompt; } });
+Object.defineProperty(exports, "DAEMON_SOUL_DEFAULT", { enumerable: true, get: function () { return system_prompt_js_1.DAEMON_SOUL_DEFAULT; } });
+var session_context_js_1 = require("./session-context.js");
+Object.defineProperty(exports, "DEFAULT_SESSION_TIMEOUT_MINUTES", { enumerable: true, get: function () { return session_context_js_1.DEFAULT_SESSION_TIMEOUT_MINUTES; } });
+Object.defineProperty(exports, "DEFAULT_MAX_TURNS", { enumerable: true, get: function () { return session_context_js_1.DEFAULT_MAX_TURNS; } });
+Object.defineProperty(exports, "DEFAULT_STALL_TIMEOUT_SECONDS", { enumerable: true, get: function () { return session_context_js_1.DEFAULT_STALL_TIMEOUT_SECONDS; } });
+Object.defineProperty(exports, "buildSessionContext", { enumerable: true, get: function () { return session_context_js_1.buildSessionContext; } });
+var session_result_js_1 = require("./session-result.js");
+Object.defineProperty(exports, "tagToStatsOutcome", { enumerable: true, get: function () { return session_result_js_1.tagToStatsOutcome; } });
+Object.defineProperty(exports, "sidecardLifecycleFor", { enumerable: true, get: function () { return session_result_js_1.sidecardLifecycleFor; } });
+Object.defineProperty(exports, "buildSessionResult", { enumerable: true, get: function () { return session_result_js_1.buildSessionResult; } });
+var agent_client_js_1 = require("./agent-client.js");
+Object.defineProperty(exports, "buildAgentClient", { enumerable: true, get: function () { return agent_client_js_1.buildAgentClient; } });

package/dist/daemon/core/session-context.d.ts

@@ -0,0 +1,14 @@
+import type { WorkflowTrigger } from '../types.js';
+import type { ContextBundle } from '../context-loader.js';
+import type { EnricherResult } from '../workflow-enricher.js';
+export declare const DEFAULT_SESSION_TIMEOUT_MINUTES = 30;
+export declare const DEFAULT_MAX_TURNS = 200;
+export declare const DEFAULT_STALL_TIMEOUT_SECONDS = 120;
+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: ContextBundle, firstStepPrompt: string, effectiveWorkspacePath: string, enricherResult?: EnricherResult): SessionContext;

package/dist/daemon/core/session-context.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_STALL_TIMEOUT_SECONDS = exports.DEFAULT_MAX_TURNS = exports.DEFAULT_SESSION_TIMEOUT_MINUTES = void 0;
+exports.buildSessionContext = buildSessionContext;
+const system_prompt_js_1 = require("./system-prompt.js");
+exports.DEFAULT_SESSION_TIMEOUT_MINUTES = 30;
+exports.DEFAULT_MAX_TURNS = 200;
+exports.DEFAULT_STALL_TIMEOUT_SECONDS = 120;
+function buildSessionContext(trigger, context, firstStepPrompt, effectiveWorkspacePath, enricherResult) {
+    const workspaceContext = context.workspaceRules[0]?.content ?? null;
+    const sessionNotes = context.sessionHistory.map((n) => n.content);
+    const sessionState = (0, system_prompt_js_1.buildSessionRecap)(sessionNotes);
+    const systemPrompt = (0, system_prompt_js_1.buildSystemPrompt)(trigger, sessionState, context.soulContent, workspaceContext, effectiveWorkspacePath, enricherResult);
+    const contextJson = trigger.context
+        ? `\n\nTrigger context:\n\`\`\`json\n${JSON.stringify(trigger.context, null, 2)}\n\`\`\``
+        : '';
+    const initialPrompt = firstStepPrompt +
+        contextJson +
+        '\n\nComplete all step work, then call complete_step with your notes to advance.';
+    const sessionTimeoutMs = (trigger.agentConfig?.maxSessionMinutes ?? exports.DEFAULT_SESSION_TIMEOUT_MINUTES) * 60 * 1000;
+    const maxTurns = trigger.agentConfig?.maxTurns ?? exports.DEFAULT_MAX_TURNS;
+    const stallTimeoutMs = (trigger.agentConfig?.stallTimeoutSeconds ?? exports.DEFAULT_STALL_TIMEOUT_SECONDS) * 1000;
+    return { systemPrompt, initialPrompt, sessionTimeoutMs, maxTurns, stallTimeoutMs };
+}

package/dist/daemon/core/session-result.d.ts

@@ -0,0 +1,10 @@
+import type { WorkflowTrigger, WorkflowRunResult } from '../types.js';
+import type { SessionState } from '../state/session-state.js';
+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 buildSessionResult(state: Readonly<SessionState>, stopReason: string, errorMessage: string | undefined, trigger: WorkflowTrigger, sessionId: string, sessionWorktreePath: string | undefined): WorkflowRunResult;

package/dist/daemon/core/session-result.js

@@ -0,0 +1,92 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.tagToStatsOutcome = tagToStatsOutcome;
+exports.sidecardLifecycleFor = sidecardLifecycleFor;
+exports.buildSessionResult = buildSessionResult;
+const assert_never_js_1 = require("../../runtime/assert-never.js");
+const session_context_js_1 = require("./session-context.js");
+function tagToStatsOutcome(tag) {
+    switch (tag) {
+        case 'success': return 'success';
+        case 'error': return 'error';
+        case 'timeout': return 'timeout';
+        case 'stuck': return 'stuck';
+        case 'delivery_failed': return 'success';
+        default: return (0, assert_never_js_1.assertNever)(tag);
+    }
+}
+function sidecardLifecycleFor(tag, branchStrategy) {
+    switch (tag) {
+        case 'success':
+            return branchStrategy === 'worktree'
+                ? { kind: 'retain_for_delivery' }
+                : { kind: 'delete_now' };
+        case 'error':
+        case 'timeout':
+        case 'stuck':
+            return { kind: 'delete_now' };
+        case 'delivery_failed':
+            throw new Error(`sidecardLifecycleFor: delivery_failed is not a valid input (invariant 1.2)`);
+        default:
+            return (0, assert_never_js_1.assertNever)(tag);
+    }
+}
+function buildSessionResult(state, stopReason, errorMessage, trigger, sessionId, sessionWorktreePath) {
+    if (state.terminalSignal !== null) {
+        const signal = state.terminalSignal;
+        if (signal.kind === 'stuck') {
+            return {
+                _tag: 'stuck',
+                workflowId: trigger.workflowId,
+                reason: signal.reason,
+                message: `Session aborted: stuck heuristic fired (${signal.reason})`,
+                stopReason: 'aborted',
+                ...(state.issueSummaries.length > 0 ? { issueSummaries: [...state.issueSummaries] } : {}),
+            };
+        }
+        if (signal.kind === 'timeout') {
+            const limitDescription = signal.reason === 'wall_clock'
+                ? `${trigger.agentConfig?.maxSessionMinutes ?? session_context_js_1.DEFAULT_SESSION_TIMEOUT_MINUTES} minutes`
+                : `${trigger.agentConfig?.maxTurns ?? session_context_js_1.DEFAULT_MAX_TURNS} turns`;
+            return {
+                _tag: 'timeout',
+                workflowId: trigger.workflowId,
+                reason: signal.reason,
+                message: `Workflow ${signal.reason === 'wall_clock' ? 'timed out' : 'exceeded turn limit'} after ${limitDescription}`,
+                stopReason: 'aborted',
+            };
+        }
+        return (0, assert_never_js_1.assertNever)(signal);
+    }
+    if (stopReason === 'error' || errorMessage) {
+        const errMsg = errorMessage ?? 'Agent stopped with error reason';
+        const lastToolCalled = state.lastNToolCalls.length > 0 ? state.lastNToolCalls[state.lastNToolCalls.length - 1] : null;
+        const stuckMarker = `\n\nWORKTRAIN_STUCK: ${JSON.stringify({
+            reason: 'session_error',
+            error: errMsg.slice(0, 500),
+            workflowId: trigger.workflowId,
+            sessionId,
+            turnCount: state.turnCount,
+            stepAdvanceCount: state.stepAdvanceCount,
+            ...(lastToolCalled !== null && { lastToolCalled }),
+            ...(state.issueSummaries.length > 0 && { issueSummaries: state.issueSummaries }),
+        })}`;
+        return {
+            _tag: 'error',
+            workflowId: trigger.workflowId,
+            message: errMsg,
+            stopReason,
+            lastStepNotes: stuckMarker,
+        };
+    }
+    return {
+        _tag: 'success',
+        workflowId: trigger.workflowId,
+        stopReason,
+        ...(state.lastStepNotes !== undefined ? { lastStepNotes: state.lastStepNotes } : {}),
+        ...(state.lastStepArtifacts !== undefined ? { lastStepArtifacts: state.lastStepArtifacts } : {}),
+        ...(sessionWorktreePath !== undefined ? { sessionWorkspacePath: sessionWorktreePath } : {}),
+        ...(sessionWorktreePath !== undefined ? { sessionId } : {}),
+        ...(trigger.botIdentity !== undefined ? { botIdentity: trigger.botIdentity } : {}),
+    };
+}

package/dist/daemon/core/system-prompt.d.ts

@@ -0,0 +1,6 @@
+import type { WorkflowTrigger } from '../types.js';
+import type { EnricherResult } from '../workflow-enricher.js';
+export { DAEMON_SOUL_DEFAULT } from '../soul-template.js';
+export declare const BASE_SYSTEM_PROMPT = "You are WorkRail Auto, an autonomous agent that executes workflows step by step. You are running unattended -- there is no user watching. Your entire job is to faithfully complete the current workflow.\n\n## What you are\nYou are highly capable. You handle ambitious, multi-step tasks that require real codebase understanding. You don't hedge, ask for permission, or stop to check in. You work.\n\n## Your oracle (consult in this order when uncertain)\n1. The daemon soul rules (## Agent Rules and Philosophy below)\n2. AGENTS.md / CLAUDE.md in the workspace (injected below under Workspace Context)\n3. The current workflow step's prompt and guidance\n4. Local code patterns in the relevant module (grep the directory, not the whole repo)\n5. Industry best practices -- only when nothing above applies\n\n## Self-directed reasoning\nAsk yourself questions to clarify your approach, then answer them yourself using tools before acting. Never wait for a human to answer -- you are the oracle.\n\nBad pattern: \"I'll analyze both layers.\" (no justification)\nGood pattern: \"Question: Should I check the middleware? Answer: The workflow step says 'trace the full call chain', and the AGENTS.md says the entry point is in the middleware layer. Yes, start there.\"\n\n## Your tools\n- `complete_step`: Mark the current step complete and advance to the next one. Call this after completing ALL work required by the step. Include your notes (min 50 characters) in the notes field. The daemon manages the session token internally -- you do NOT need a continueToken. This is the preferred advancement tool for daemon sessions.\n- `continue_workflow`: [DEPRECATED -- use complete_step instead. Do NOT pass a continueToken.] Only use this if complete_step is unavailable.\n- `Bash`: Run shell commands. Use for building, testing, running scripts.\n- `Read`: Read files.\n- `Write`: Write files.\n- `report_issue`: Record a structured issue, error, or unexpected behavior. Call this AND complete_step (unless fatal). Does not stop the session -- it creates a record for the auto-fix coordinator.\n- `spawn_agent`: Delegate a sub-task to a child WorkRail session. BLOCKS until the child completes. Returns `{ childSessionId, outcome: \"success\"|\"error\"|\"timeout\", notes: string }`. Always check `outcome` before using `notes`. IMPORTANT: your session's time limit (maxSessionMinutes) keeps running while the child executes -- ensure your parent session has enough time for both your work AND the child's work. Maximum spawn depth is 3 by default (configurable). Use only when a step explicitly asks for delegation or when a clearly separable sub-task would benefit from its own WorkRail audit trail.\n- `signal_coordinator`: Emit a structured mid-session signal to the coordinator WITHOUT advancing the workflow step. Use when the step asks you to surface a finding, request data, request approval, or report a blocking condition. Always returns immediately -- fire-and-observe. Signal kinds: \"progress\", \"finding\", \"data_needed\", \"approval_needed\", \"blocked\".\n\n## Execution contract\n1. Read the step carefully. Do ALL the work the step asks for.\n2. Call `complete_step` with your notes. No continueToken needed -- the daemon manages it.\n3. Repeat until the workflow reports it is complete.\n4. Do NOT skip steps. Do NOT call `complete_step` without completing the step's work.\n\n## The workflow is the contract\nEvery step must be fully completed before you call complete_step. The workflow step prompt is the specification of what 'done' means -- not a suggestion. Don't advance until the work is actually done.\n\nYour cognitive mode changes per step: some steps make you a researcher, others a reviewer, others an implementer. Adopt the mode the step describes. Don't bring your own agenda.\n\n## Silent failure is the worst outcome\nIf something goes wrong: call report_issue, then continue unless severity is 'fatal'. Do NOT silently retry forever, work around failures without noting them, or pretend things worked. The issue record is how the system learns and self-heals.\n\n## Tools are your hands, not your voice\nDon't narrate what you're about to do. Use the tool and report what you found. Token efficiency matters -- you have a wall-clock timeout.\n\n## You don't have a user. You have a workflow and a soul.\nIf you're unsure, consult the oracle above. If nothing answers the question, make a reasoned decision, call report_issue with kind='self_correction' to document it, and continue.\n\n## IMPORTANT: Never use continue_workflow in daemon sessions\ncomplete_step is your advancement tool. It does not require a continueToken. Do NOT call continue_workflow with a token you found in a previous message -- use complete_step instead.";
+export declare function buildSessionRecap(notes: readonly string[]): string;
+export declare function buildSystemPrompt(trigger: WorkflowTrigger, sessionState: string, soulContent: string, workspaceContext: string | null, effectiveWorkspacePath: string, enricherResult?: EnricherResult): string;

package/dist/daemon/core/system-prompt.js

@@ -0,0 +1,151 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BASE_SYSTEM_PROMPT = exports.DAEMON_SOUL_DEFAULT = void 0;
+exports.buildSessionRecap = buildSessionRecap;
+exports.buildSystemPrompt = buildSystemPrompt;
+const types_js_1 = require("../types.js");
+var soul_template_js_1 = require("../soul-template.js");
+Object.defineProperty(exports, "DAEMON_SOUL_DEFAULT", { enumerable: true, get: function () { return soul_template_js_1.DAEMON_SOUL_DEFAULT; } });
+const MAX_ASSEMBLED_CONTEXT_BYTES = 8192;
+exports.BASE_SYSTEM_PROMPT = `\
+You are WorkRail Auto, an autonomous agent that executes workflows step by step. You are running unattended -- there is no user watching. Your entire job is to faithfully complete the current workflow.
+
+## What you are
+You are highly capable. You handle ambitious, multi-step tasks that require real codebase understanding. You don't hedge, ask for permission, or stop to check in. You work.
+
+## Your oracle (consult in this order when uncertain)
+1. The daemon soul rules (## Agent Rules and Philosophy below)
+2. AGENTS.md / CLAUDE.md in the workspace (injected below under Workspace Context)
+3. The current workflow step's prompt and guidance
+4. Local code patterns in the relevant module (grep the directory, not the whole repo)
+5. Industry best practices -- only when nothing above applies
+
+## Self-directed reasoning
+Ask yourself questions to clarify your approach, then answer them yourself using tools before acting. Never wait for a human to answer -- you are the oracle.
+
+Bad pattern: "I'll analyze both layers." (no justification)
+Good pattern: "Question: Should I check the middleware? Answer: The workflow step says 'trace the full call chain', and the AGENTS.md says the entry point is in the middleware layer. Yes, start there."
+
+## Your tools
+- \`complete_step\`: Mark the current step complete and advance to the next one. Call this after completing ALL work required by the step. Include your notes (min 50 characters) in the notes field. The daemon manages the session token internally -- you do NOT need a continueToken. This is the preferred advancement tool for daemon sessions.
+- \`continue_workflow\`: [DEPRECATED -- use complete_step instead. Do NOT pass a continueToken.] Only use this if complete_step is unavailable.
+- \`Bash\`: Run shell commands. Use for building, testing, running scripts.
+- \`Read\`: Read files.
+- \`Write\`: Write files.
+- \`report_issue\`: Record a structured issue, error, or unexpected behavior. Call this AND complete_step (unless fatal). Does not stop the session -- it creates a record for the auto-fix coordinator.
+- \`spawn_agent\`: Delegate a sub-task to a child WorkRail session. BLOCKS until the child completes. Returns \`{ childSessionId, outcome: "success"|"error"|"timeout", notes: string }\`. Always check \`outcome\` before using \`notes\`. IMPORTANT: your session's time limit (maxSessionMinutes) keeps running while the child executes -- ensure your parent session has enough time for both your work AND the child's work. Maximum spawn depth is 3 by default (configurable). Use only when a step explicitly asks for delegation or when a clearly separable sub-task would benefit from its own WorkRail audit trail.
+- \`signal_coordinator\`: Emit a structured mid-session signal to the coordinator WITHOUT advancing the workflow step. Use when the step asks you to surface a finding, request data, request approval, or report a blocking condition. Always returns immediately -- fire-and-observe. Signal kinds: "progress", "finding", "data_needed", "approval_needed", "blocked".
+
+## Execution contract
+1. Read the step carefully. Do ALL the work the step asks for.
+2. Call \`complete_step\` with your notes. No continueToken needed -- the daemon manages it.
+3. Repeat until the workflow reports it is complete.
+4. Do NOT skip steps. Do NOT call \`complete_step\` without completing the step's work.
+
+## The workflow is the contract
+Every step must be fully completed before you call complete_step. The workflow step prompt is the specification of what 'done' means -- not a suggestion. Don't advance until the work is actually done.
+
+Your cognitive mode changes per step: some steps make you a researcher, others a reviewer, others an implementer. Adopt the mode the step describes. Don't bring your own agenda.
+
+## Silent failure is the worst outcome
+If something goes wrong: call report_issue, then continue unless severity is 'fatal'. Do NOT silently retry forever, work around failures without noting them, or pretend things worked. The issue record is how the system learns and self-heals.
+
+## Tools are your hands, not your voice
+Don't narrate what you're about to do. Use the tool and report what you found. Token efficiency matters -- you have a wall-clock timeout.
+
+## You don't have a user. You have a workflow and a soul.
+If you're unsure, consult the oracle above. If nothing answers the question, make a reasoned decision, call report_issue with kind='self_correction' to document it, and continue.
+
+## IMPORTANT: Never use continue_workflow in daemon sessions
+complete_step is your advancement tool. It does not require a continueToken. Do NOT call continue_workflow with a token you found in a previous message -- use complete_step instead.\
+`;
+function truncateToByteLimit(s, maxBytes, marker) {
+    if (Buffer.byteLength(s, 'utf8') <= maxBytes)
+        return s;
+    let end = maxBytes;
+    while (end > 0 && Buffer.byteLength(s.slice(0, end), 'utf8') > maxBytes)
+        end--;
+    while (end > 0) {
+        const code = s.charCodeAt(end - 1);
+        if (code >= 0xD800 && code <= 0xDFFF) {
+            end--;
+        }
+        else {
+            break;
+        }
+    }
+    const newlineIdx = s.lastIndexOf('\n', end);
+    return (newlineIdx > 0 ? s.slice(0, newlineIdx) : s.slice(0, end)) + '\n' + marker;
+}
+function buildSessionRecap(notes) {
+    if (notes.length === 0)
+        return '';
+    const formattedNotes = notes
+        .map((note, i) => `### Prior step ${i + 1}\n${note}`)
+        .join('\n\n');
+    return `<workrail_session_state>\nThe following notes summarize prior steps from this session:\n\n${formattedNotes}\n</workrail_session_state>`;
+}
+const MAX_GIT_DIFF_STAT_BYTES = 2048;
+function sectionWorktreeScope(trigger, effectiveWorkspacePath) {
+    if (effectiveWorkspacePath === trigger.workspacePath)
+        return [];
+    return [
+        '',
+        `**Worktree session scope:** Your workspace is the isolated git worktree at \`${effectiveWorkspacePath}\`. Do not access, read, or modify the main checkout at \`${trigger.workspacePath}\`. Do not read planning docs, roadmap files, or backlog files. All Bash commands, file reads, and file writes must stay within your worktree path.`,
+    ];
+}
+function sectionWorkspaceContext(workspaceContext) {
+    if (workspaceContext === null)
+        return [];
+    return ['', '## Workspace Context (from AGENTS.md / CLAUDE.md)', workspaceContext];
+}
+function sectionAssembledContext(assembledContextSummary) {
+    if (!assembledContextSummary || assembledContextSummary.trim().length === 0)
+        return [];
+    const ctxStr = truncateToByteLimit(assembledContextSummary, MAX_ASSEMBLED_CONTEXT_BYTES, '[Prior context truncated at 8KB]');
+    return ['', '## Prior Context', ctxStr.trim()];
+}
+function sectionPriorWorkspaceNotes(assembledContextSummary, enricherResult) {
+    if (!enricherResult || enricherResult.priorSessionNotes.length === 0)
+        return [];
+    if (assembledContextSummary && assembledContextSummary.trim().length > 0)
+        return [];
+    const noteLines = enricherResult.priorSessionNotes.map((note) => {
+        const title = note.sessionTitle ?? note.sessionId.slice(0, 12);
+        const branch = note.gitBranch ? ` (${note.gitBranch})` : '';
+        const recap = note.recapSnippet ?? '(no recap)';
+        return `**${title}**${branch}: ${recap}`;
+    });
+    return ['', '## Prior Workspace Notes', ...noteLines];
+}
+function sectionChangedFiles(enricherResult) {
+    if (!enricherResult || enricherResult.gitDiffStat === null)
+        return [];
+    const diffStat = Buffer.byteLength(enricherResult.gitDiffStat, 'utf8') > MAX_GIT_DIFF_STAT_BYTES
+        ? new TextDecoder().decode(Buffer.from(enricherResult.gitDiffStat, 'utf8').subarray(0, MAX_GIT_DIFF_STAT_BYTES)) + '\n[diff stat truncated]'
+        : enricherResult.gitDiffStat;
+    return ['', '## Changed files', '```', diffStat, '```'];
+}
+function sectionReferenceUrls(trigger) {
+    if (!trigger.referenceUrls || trigger.referenceUrls.length === 0)
+        return [];
+    return [
+        '',
+        '## Reference documents',
+        'Before starting, fetch and read these reference documents: ' + trigger.referenceUrls.join(' '),
+        'If you cannot fetch any of these documents, note their unavailability and proceed.',
+    ];
+}
+function buildSystemPrompt(trigger, sessionState, soulContent, workspaceContext, effectiveWorkspacePath, enricherResult) {
+    const { assembledContextSummary } = (0, types_js_1.extractContextSlots)(trigger.context);
+    const sections = [
+        [exports.BASE_SYSTEM_PROMPT, '', `<workrail_session_state>${sessionState}</workrail_session_state>`, '', '## Agent Rules and Philosophy', soulContent, '', `## Workspace: ${effectiveWorkspacePath}`],
+        sectionWorktreeScope(trigger, effectiveWorkspacePath),
+        sectionWorkspaceContext(workspaceContext),
+        sectionAssembledContext(assembledContextSummary),
+        sectionPriorWorkspaceNotes(assembledContextSummary, enricherResult),
+        sectionChangedFiles(enricherResult),
+        sectionReferenceUrls(trigger),
+    ];
+    return sections.flat().join('\n');
+}

package/dist/daemon/io/conversation-log.d.ts

@@ -0,0 +1,2 @@
+import type { AgentInternalMessage } from '../agent-loop.js';
+export declare function appendConversationMessages(filePath: string, messages: ReadonlyArray<AgentInternalMessage>): Promise<void>;

package/dist/daemon/io/conversation-log.js

@@ -0,0 +1,45 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.appendConversationMessages = appendConversationMessages;
+const fs = __importStar(require("node:fs/promises"));
+const path = __importStar(require("node:path"));
+async function appendConversationMessages(filePath, messages) {
+    if (messages.length === 0)
+        return;
+    const lines = messages.map((m) => JSON.stringify(m)).join('\n') + '\n';
+    await fs.mkdir(path.dirname(filePath), { recursive: true });
+    await fs.appendFile(filePath, lines, 'utf8');
+}

package/dist/daemon/io/execution-stats.d.ts

@@ -0,0 +1,7 @@
+export declare const DAEMON_STATS_DIR: string;
+export declare function writeExecutionStats(statsDir: string, sessionId: string, workflowId: string, startMs: number, outcome: 'success' | 'error' | 'timeout' | 'stuck' | 'unknown', stepCount: number): void;
+export declare function writeStuckOutboxEntry(opts: {
+    workflowId: string;
+    reason: 'repeated_tool_call' | 'no_progress' | 'stall';
+    issueSummaries?: readonly string[];
+}): Promise<void>;

package/dist/daemon/io/execution-stats.js

@@ -0,0 +1,86 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DAEMON_STATS_DIR = void 0;
+exports.writeExecutionStats = writeExecutionStats;
+exports.writeStuckOutboxEntry = writeStuckOutboxEntry;
+const fs = __importStar(require("node:fs/promises"));
+const path = __importStar(require("node:path"));
+const os = __importStar(require("node:os"));
+const node_crypto_1 = require("node:crypto");
+const stats_summary_js_1 = require("../stats-summary.js");
+exports.DAEMON_STATS_DIR = path.join(os.homedir(), '.workrail', 'data');
+function writeExecutionStats(statsDir, sessionId, workflowId, startMs, outcome, stepCount) {
+    const endMs = Date.now();
+    const statsPath = path.join(statsDir, 'execution-stats.jsonl');
+    fs.mkdir(statsDir, { recursive: true })
+        .then(() => fs.appendFile(statsPath, JSON.stringify({
+        sessionId,
+        workflowId,
+        startMs,
+        endMs,
+        durationMs: endMs - startMs,
+        outcome,
+        stepCount,
+        ts: new Date().toISOString(),
+    }) + '\n', 'utf8'))
+        .then(() => { (0, stats_summary_js_1.writeStatsSummary)(statsDir).catch(() => { }); })
+        .catch(() => { });
+}
+async function writeStuckOutboxEntry(opts) {
+    try {
+        const outboxPath = path.join(os.homedir(), '.workrail', 'outbox.jsonl');
+        await fs.mkdir(path.dirname(outboxPath), { recursive: true });
+        const entry = JSON.stringify({
+            id: (0, node_crypto_1.randomUUID)(),
+            kind: 'stuck',
+            message: `Session stuck (${opts.reason}): workflowId=${opts.workflowId}` +
+                (opts.issueSummaries && opts.issueSummaries.length > 0
+                    ? ` -- issues: ${opts.issueSummaries.join('; ')}`
+                    : ''),
+            timestamp: new Date().toISOString(),
+            workflowId: opts.workflowId,
+            reason: opts.reason,
+            ...(opts.issueSummaries && opts.issueSummaries.length > 0
+                ? { issueSummaries: opts.issueSummaries }
+                : {}),
+        });
+        await fs.appendFile(outboxPath, entry + '\n');
+    }
+    catch (err) {
+        console.warn(`[WorkflowRunner] Could not write stuck outbox entry: ` +
+            `${err instanceof Error ? err.message : String(err)}`);
+    }
+}