@principles/core 1.83.0 → 1.84.0

package/dist/runtime-v2/runner/base-peer-runner.js

@@ -0,0 +1,516 @@
+/**
+ * BasePeerRunner — Abstract base class for all peer runners (PRI-302).
+ *
+ * Extracts the shared lease → buildContext → invoke → poll → fetch →
+ * validate → succeed/fail pipeline from 8 duplicated runner implementations.
+ *
+ * Subclasses implement:
+ *   - permanentErrorCategories (abstract getter)
+ *   - buildContext() — runner-specific context assembly
+ *   - invokeRuntime() — runner-specific LLM invocation
+ *   - validateOutput() — runner-specific output validation
+ *   - succeedTask() — runner-specific artifact commit + task success
+ *
+ * Optional hooks:
+ *   - emitSuccessTelemetry() — runner-specific success telemetry (default: no-op)
+ *   - checkLineageIntegrity() — lineage strip contract check (default: no-op)
+ *
+ * @see docs/adr/0003-peer-agent-state-machine-orchestration.md
+ * @see Linear PRI-302
+ */
+import { PDRuntimeError } from '../error-categories.js';
+import { RunnerPhase } from './runner-phase.js';
+// ── Defaults ─────────────────────────────────────────────────────────────────
+const DEFAULT_PEER_RUNNER_OPTIONS = {
+    pollIntervalMs: 5_000,
+    timeoutMs: 300_000,
+    defaultMaxAttempts: 3,
+    agentId: 'peer-runner',
+};
+function resolvePeerRunnerOptions(options, defaultAgentId) {
+    return {
+        pollIntervalMs: options.pollIntervalMs ?? DEFAULT_PEER_RUNNER_OPTIONS.pollIntervalMs,
+        timeoutMs: options.timeoutMs ?? DEFAULT_PEER_RUNNER_OPTIONS.timeoutMs,
+        defaultMaxAttempts: options.defaultMaxAttempts ?? DEFAULT_PEER_RUNNER_OPTIONS.defaultMaxAttempts,
+        owner: options.owner,
+        runtimeKind: options.runtimeKind,
+        agentId: options.agentId ?? defaultAgentId,
+    };
+}
+// ── BasePeerRunner ───────────────────────────────────────────────────────────
+/**
+ * Abstract base class for peer runners.
+ *
+ * TContext — the type returned by buildContext(). Must include contextHash.
+ * TOutput — the type of the validated LLM output.
+ */
+export class BasePeerRunner {
+    // ── Shared dependencies (protected for subclass access) ──
+    stateManager;
+    runtimeAdapter;
+    eventEmitter;
+    artifactStore;
+    resolvedOptions;
+    config;
+    phase = RunnerPhase.Idle;
+    constructor(deps, options, config) {
+        this.stateManager = deps.stateManager;
+        this.runtimeAdapter = deps.runtimeAdapter;
+        this.eventEmitter = deps.eventEmitter;
+        this.artifactStore = deps.artifactStore;
+        this.config = config;
+        this.resolvedOptions = resolvePeerRunnerOptions(options, config.defaultAgentId);
+    }
+    // ── Observability ──────────────────────────────────────────────────────────
+    /** Current internal phase. For testing/observability only. */
+    get currentPhase() {
+        return this.phase;
+    }
+    // ── Optional hooks (default no-op) ─────────────────────────────────────────
+    /** Emit runner-specific success telemetry. Called after validation passes. */
+    // eslint-disable-next-line @typescript-eslint/class-methods-use-this
+    emitSuccessTelemetry(_taskId, _output, _context) {
+        // default no-op
+    }
+    /**
+     * Check lineage strip contract. Called AFTER validation passes.
+     * Receives validated output — safe to treat as TOutput.
+     */
+    // eslint-disable-next-line @typescript-eslint/class-methods-use-this
+    checkLineageIntegrity(_taskId, _output) {
+        // default no-op
+    }
+    /**
+     * Transform output after fetch, before validation.
+     * Used by runners that need to re-inject lineage fields stripped by the adapter.
+     * Receives untrusted data — must NOT assume TOutput shape.
+     */
+    // eslint-disable-next-line @typescript-eslint/class-methods-use-this
+    postFetchTransform(_taskId, _untrustedOutput) {
+        // default no-op
+    }
+    // ── Template method: full pipeline ─────────────────────────────────────────
+    /**
+     * Execute the full peer runner lifecycle for a task.
+     *
+     * Pipeline: lease → resolveRunId → buildContext → invoke → poll →
+     *           fetch → validate → succeedTask (abstract)
+     *
+     * Each invocation is independent — no mutable state between run() calls.
+     */
+    async run(taskId) {
+        this.phase = RunnerPhase.Idle;
+        // 1. Acquire lease — isolated try/catch so lease_conflict never uses synthetic TaskRecord
+        let leasedTask;
+        try {
+            leasedTask = await this.stateManager.acquireLease({
+                taskId,
+                owner: this.resolvedOptions.owner,
+                runtimeKind: this.resolvedOptions.runtimeKind,
+            });
+        }
+        catch (error) {
+            return await this.handleLeaseOrPhaseError(taskId, error);
+        }
+        // 1b. Validate task kind
+        if (leasedTask.taskKind !== this.config.expectedTaskKind) {
+            this.emitEvent('wrong_task_kind', taskId, {
+                expectedKind: this.config.expectedTaskKind,
+                actualKind: leasedTask.taskKind,
+            });
+            await this.stateManager.markTaskFailed(taskId, 'input_invalid');
+            return {
+                status: 'failed',
+                taskId,
+                errorCategory: 'input_invalid',
+                failureReason: `Task kind must be '${this.config.expectedTaskKind}', got '${leasedTask.taskKind}'`,
+                attemptCount: leasedTask.attemptCount,
+            };
+        }
+        this.emitEvent('task_leased', taskId, {
+            taskKind: this.config.expectedTaskKind,
+            attemptCount: leasedTask.attemptCount,
+        });
+        // All subsequent errors use the real leasedTask — no synthetic TaskRecord allowed
+        try {
+            // 2. Resolve store runId
+            const storeRunId = await this.resolveStoreRunId(taskId);
+            // 3. Build context
+            this.phase = RunnerPhase.BuildingContext;
+            const context = await this.buildContext(taskId);
+            this.emitEvent('context_built', taskId, { contextHash: context.contextHash });
+            // 4. Invoke runtime
+            this.phase = RunnerPhase.Invoking;
+            const runHandle = await this.invokeRuntime(taskId, context);
+            this.emitEvent('run_started', taskId, {
+                runtimeKind: this.resolvedOptions.runtimeKind,
+            });
+            // 5. Poll until terminal
+            this.phase = RunnerPhase.Polling;
+            const finalStatus = await this.pollUntilTerminal(runHandle);
+            // 6. Handle non-success terminal states
+            if (finalStatus.status !== 'succeeded') {
+                return await this.handleRuntimeFailure(taskId, leasedTask, finalStatus);
+            }
+            // 7. Fetch output (returns unknown — untrusted LLM/runtime payload)
+            this.phase = RunnerPhase.FetchingOutput;
+            const untrustedOutput = await this.fetchAndParseOutput(runHandle.runId, taskId);
+            // 7b. Post-fetch transform on untrusted data (e.g., re-inject lineage fields).
+            // Operates on `unknown` — must NOT assume TOutput shape (ERR-001).
+            this.postFetchTransform(taskId, untrustedOutput);
+            // 8. Validate — the trust boundary. Only validated output becomes TOutput.
+            this.phase = RunnerPhase.Validating;
+            const validationResult = await this.validateOutput(untrustedOutput, taskId, context);
+            if (!validationResult.valid) {
+                return await this.handleValidationError({
+                    taskId,
+                    task: leasedTask,
+                    errors: validationResult.errors,
+                    errorCategory: validationResult.errorCategory,
+                });
+            }
+            // Validation passed — safe to treat as TOutput.
+            const output = untrustedOutput;
+            this.emitEvent('output_validated', taskId, {});
+            // 8b. Check lineage integrity (receives validated output)
+            this.checkLineageIntegrity(taskId, output);
+            // 8c. Emit success telemetry (receives validated output)
+            this.emitSuccessTelemetry(taskId, output, context);
+            // 9. Succeed task (abstract — subclass implements commit strategy)
+            return await this.succeedTask(taskId, storeRunId, output, leasedTask, context.contextHash, context);
+        }
+        catch (error) {
+            // Post-lease errors use retryOrFail with the real leasedTask
+            return await this.handlePostLeaseError(taskId, leasedTask, error);
+        }
+    }
+    // ── Telemetry ──────────────────────────────────────────────────────────────
+    /**
+     * Emit a telemetry event with the runner's name prefix.
+     * Event type: `{runnerName}_{eventType}`
+     */
+    emitEvent(eventType, taskId, payload) {
+        this.eventEmitter.emitTelemetry({
+            eventType: `${this.config.runnerName}_${eventType}`,
+            traceId: taskId,
+            timestamp: new Date().toISOString(),
+            sessionId: this.resolvedOptions.owner,
+            agentId: this.resolvedOptions.agentId,
+            payload,
+        });
+    }
+    // ── Polling ────────────────────────────────────────────────────────────────
+    async pollUntilTerminal(runHandle) {
+        const deadline = Date.now() + this.resolvedOptions.timeoutMs;
+        const terminalStatuses = ['succeeded', 'failed', 'timed_out', 'cancelled'];
+        while (Date.now() < deadline) {
+            const status = await this.runtimeAdapter.pollRun(runHandle.runId);
+            if (terminalStatuses.includes(status.status)) {
+                return status;
+            }
+            await this.sleep(this.resolvedOptions.pollIntervalMs);
+        }
+        // Timeout — cancel gracefully
+        let cancelFailed = false;
+        try {
+            await this.runtimeAdapter.cancelRun(runHandle.runId);
+        }
+        catch (cancelErr) {
+            cancelFailed = true;
+            this.emitEvent('cancel_run_failed', runHandle.runId, {
+                runId: runHandle.runId,
+                errorMessage: cancelErr instanceof Error ? cancelErr.message : String(cancelErr),
+            });
+        }
+        const cancelNote = cancelFailed ? ' (cancelRun also failed)' : '';
+        throw new PDRuntimeError('timeout', `Run ${runHandle.runId} timed out after ${this.resolvedOptions.timeoutMs}ms${cancelNote}`);
+    }
+    // ── Output fetching ────────────────────────────────────────────────────────
+    /**
+     * Fetch raw output from the runtime adapter.
+     *
+     * Returns `unknown` — the payload is untrusted LLM/runtime output.
+     * Callers MUST validate before treating as TOutput (ERR-001, ERR-005).
+     */
+    async fetchAndParseOutput(runId, taskId) {
+        let result;
+        try {
+            result = await this.runtimeAdapter.fetchOutput(runId);
+        }
+        catch (fetchErr) {
+            this.emitEvent('output_extraction_failed', taskId, {
+                runId,
+                stage: 'fetchOutput',
+                errorMessage: fetchErr instanceof Error ? fetchErr.message : String(fetchErr),
+            });
+            throw fetchErr;
+        }
+        if (!result || !result.payload) {
+            this.emitEvent('output_extraction_failed', taskId, {
+                runId,
+                stage: 'payload_missing',
+                errorMessage: `No output available for run ${runId}`,
+            });
+            throw new PDRuntimeError('output_invalid', `No output available for run ${runId}`);
+        }
+        // Structural check: payload must be a non-null object.
+        // This is NOT a type assertion — we still return `unknown`.
+        const { payload } = result;
+        if (typeof payload !== 'object' || payload === null) {
+            this.emitEvent('output_extraction_failed', taskId, {
+                runId,
+                stage: 'payload_not_object',
+                errorMessage: `Output payload is not an object for run ${runId}`,
+            });
+            throw new PDRuntimeError('output_invalid', `Output payload is not an object for run ${runId}`);
+        }
+        return payload;
+    }
+    // ── Lineage resolution ─────────────────────────────────────────────────────
+    /** Resolve artifact IDs from predecessor tasks for lineage tracking. */
+    async resolveLineageArtifactIds(taskId) {
+        const { hydratePITaskRecord } = await import('../internalization/pitask-metadata.js');
+        const task = await this.stateManager.getTask(taskId);
+        if (!task)
+            return { ids: [], hasRejected: false };
+        const piTask = hydratePITaskRecord(task);
+        const deps = piTask?.dependencyTaskIds ?? [];
+        if (deps.length === 0)
+            return { ids: [], hasRejected: false };
+        const lineageIds = [];
+        let hasRejected = false;
+        const results = await Promise.allSettled(deps.map((depId) => this.artifactStore.listBySourceTaskId(depId)));
+        for (const result of results) {
+            if (result.status === 'fulfilled') {
+                for (const artifact of result.value) {
+                    lineageIds.push(artifact.artifactId);
+                }
+            }
+            else {
+                hasRejected = true;
+            }
+        }
+        return { ids: lineageIds, hasRejected };
+    }
+    // ── Store helpers ──────────────────────────────────────────────────────────
+    async resolveStoreRunId(taskId) {
+        const runs = await this.stateManager.getRunsByTask(taskId);
+        const latestRun = runs[runs.length - 1];
+        if (!latestRun) {
+            throw new PDRuntimeError('execution_failed', `No run records found for task ${taskId} after lease acquisition`);
+        }
+        return latestRun.runId;
+    }
+    /** Compute a deterministic hash from context references (observability only). */
+    static hashContextRefs(refs) {
+        if (refs.length === 0)
+            return 'empty';
+        const str = refs.join('|');
+        let hash = 0;
+        for (let i = 0; i < str.length; i++) {
+            hash = (Math.imul(31, hash) + str.charCodeAt(i)) | 0;
+        }
+        return `ctx-${Math.abs(hash).toString(16)}`;
+    }
+    // ── Error handling ─────────────────────────────────────────────────────────
+    async handleLeaseOrPhaseError(taskId, error) {
+        const classified = this.classifyError(error);
+        // lease_conflict is concurrent-access conflict, not a state change.
+        // No mutation methods (markTaskFailed/markTaskRetryWait) are called.
+        if (classified.category === 'lease_conflict') {
+            this.emitEvent('run_failed', taskId, {
+                errorCategory: 'lease_conflict',
+                errorMessage: classified.message,
+            });
+            return {
+                status: 'failed',
+                taskId,
+                errorCategory: 'lease_conflict',
+                failureReason: classified.message,
+                attemptCount: 1,
+            };
+        }
+        // Non-lease errors (e.g., storage_unavailable before lease) must not
+        // use synthetic TaskRecord. Build one with real defaults from options.
+        this.emitEvent('run_failed', taskId, {
+            errorCategory: classified.category,
+            errorMessage: classified.message,
+        });
+        const task = {
+            taskId,
+            taskKind: this.config.expectedTaskKind,
+            status: 'leased',
+            createdAt: new Date().toISOString(),
+            updatedAt: new Date().toISOString(),
+            attemptCount: 1,
+            maxAttempts: this.resolvedOptions.defaultMaxAttempts,
+        };
+        return this.retryOrFail({ taskId, task, errorCategory: classified.category, failureReason: classified.message });
+    }
+    async handlePostLeaseError(taskId, task, error) {
+        const classified = this.classifyError(error);
+        this.emitEvent('run_failed', taskId, {
+            errorCategory: classified.category,
+            errorMessage: classified.message,
+        });
+        return this.retryOrFail({ taskId, task, errorCategory: classified.category, failureReason: classified.message });
+    }
+    async handleRuntimeFailure(taskId, task, runStatus) {
+        const errorCategory = this.mapRunStatusToErrorCategory(runStatus.status, runStatus.reason);
+        this.emitEvent('run_failed', taskId, {
+            runStatus: runStatus.status,
+            errorCategory,
+        });
+        return this.retryOrFail({
+            taskId,
+            task,
+            errorCategory,
+            failureReason: `Runtime execution ended with status: ${runStatus.status}`,
+        });
+    }
+    async handleValidationError(ctx) {
+        const category = ctx.errorCategory ?? 'output_invalid';
+        this.emitEvent('output_invalid', ctx.taskId, {
+            errorCount: ctx.errors.length,
+            errorCategory: category,
+        });
+        return this.retryOrFail({
+            taskId: ctx.taskId,
+            task: ctx.task,
+            errorCategory: category,
+            failureReason: `Validation failed: ${ctx.errors.join('; ')}`,
+        });
+    }
+    // ── Retry/fail state machine ───────────────────────────────────────────────
+    /**
+     * Core retry-or-fail decision.
+     *
+     * Uses try/catch around markTaskFailed/markTaskRetryWait for robustness.
+     * If state manager operations fail, returns storage_unavailable instead of
+     * propagating the exception (ERR-002: graceful degradation with reason).
+     */
+    async retryOrFail(ctx) {
+        // Permanent errors — never retry
+        if (this.permanentErrorCategories.has(ctx.errorCategory)) {
+            try {
+                await this.stateManager.markTaskFailed(ctx.taskId, ctx.errorCategory);
+            }
+            catch (stateErr) {
+                this.emitEvent('mark_failed_error', ctx.taskId, {
+                    errorCategory: 'storage_unavailable',
+                    attemptCount: ctx.task.attemptCount,
+                    errorMessage: stateErr instanceof Error ? stateErr.message : String(stateErr),
+                });
+                return {
+                    status: 'failed',
+                    taskId: ctx.taskId,
+                    errorCategory: 'storage_unavailable',
+                    failureReason: `State manager error: ${ctx.failureReason}`,
+                    attemptCount: ctx.task.attemptCount,
+                };
+            }
+            this.emitEvent('task_failed', ctx.taskId, {
+                errorCategory: ctx.errorCategory,
+                attemptCount: ctx.task.attemptCount,
+                failureReason: ctx.failureReason,
+            });
+            this.phase = RunnerPhase.Failed;
+            return {
+                status: 'failed',
+                taskId: ctx.taskId,
+                errorCategory: ctx.errorCategory,
+                failureReason: ctx.failureReason,
+                attemptCount: ctx.task.attemptCount,
+            };
+        }
+        // Retry policy check
+        const shouldRetry = this.stateManager.getRetryPolicy().shouldRetry(ctx.task);
+        if (shouldRetry) {
+            try {
+                await this.stateManager.markTaskRetryWait(ctx.taskId, ctx.errorCategory);
+            }
+            catch (stateErr) {
+                this.emitEvent('mark_retry_error', ctx.taskId, {
+                    errorCategory: 'storage_unavailable',
+                    attemptCount: ctx.task.attemptCount,
+                    errorMessage: stateErr instanceof Error ? stateErr.message : String(stateErr),
+                });
+                return {
+                    status: 'failed',
+                    taskId: ctx.taskId,
+                    errorCategory: 'storage_unavailable',
+                    failureReason: `State manager error: ${ctx.failureReason}`,
+                    attemptCount: ctx.task.attemptCount,
+                };
+            }
+            this.emitEvent('task_retried', ctx.taskId, {
+                errorCategory: ctx.errorCategory,
+                attemptCount: ctx.task.attemptCount,
+            });
+            this.phase = RunnerPhase.RetryWaiting;
+            return {
+                status: 'retried',
+                taskId: ctx.taskId,
+                errorCategory: ctx.errorCategory,
+                failureReason: ctx.failureReason,
+                attemptCount: ctx.task.attemptCount,
+            };
+        }
+        // Max attempts exceeded
+        try {
+            await this.stateManager.markTaskFailed(ctx.taskId, 'max_attempts_exceeded');
+        }
+        catch (stateErr) {
+            this.emitEvent('mark_failed_error', ctx.taskId, {
+                errorCategory: 'storage_unavailable',
+                attemptCount: ctx.task.attemptCount,
+                errorMessage: stateErr instanceof Error ? stateErr.message : String(stateErr),
+            });
+            return {
+                status: 'failed',
+                taskId: ctx.taskId,
+                errorCategory: 'storage_unavailable',
+                failureReason: `State manager error: ${ctx.failureReason}`,
+                attemptCount: ctx.task.attemptCount,
+            };
+        }
+        this.emitEvent('task_failed', ctx.taskId, {
+            errorCategory: 'max_attempts_exceeded',
+            attemptCount: ctx.task.attemptCount,
+            failureReason: `Max attempts exceeded: ${ctx.failureReason}`,
+        });
+        this.phase = RunnerPhase.Failed;
+        return {
+            status: 'failed',
+            taskId: ctx.taskId,
+            errorCategory: 'max_attempts_exceeded',
+            failureReason: `Max attempts exceeded: ${ctx.failureReason}`,
+            attemptCount: ctx.task.attemptCount,
+        };
+    }
+    // ── Error classification ──────────────────────────────────────────────────
+    // eslint-disable-next-line @typescript-eslint/class-methods-use-this
+    classifyError(error) {
+        if (error instanceof PDRuntimeError) {
+            return { category: error.category, message: error.message };
+        }
+        if (error instanceof Error) {
+            return { category: 'execution_failed', message: error.message };
+        }
+        return { category: 'execution_failed', message: String(error) };
+    }
+    // eslint-disable-next-line @typescript-eslint/class-methods-use-this
+    mapRunStatusToErrorCategory(status, _reason) {
+        switch (status) {
+            case 'failed': return 'execution_failed';
+            case 'timed_out': return 'timeout';
+            case 'cancelled': return 'cancelled';
+            default: return 'execution_failed';
+        }
+    }
+    // eslint-disable-next-line @typescript-eslint/class-methods-use-this
+    sleep(ms) {
+        return new Promise((resolve) => setTimeout(resolve, ms));
+    }
+}
+//# sourceMappingURL=base-peer-runner.js.map

package/dist/runtime-v2/runner/base-peer-runner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-peer-runner.js","sourceRoot":"","sources":["../../../src/runtime-v2/runner/base-peer-runner.ts"],"names":[],"mappings":"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"}

package/dist/runtime-v2/runner/peer-runner-types.d.ts

@@ -0,0 +1,107 @@
+/**
+ * Shared types for the BasePeerRunner abstract class (PRI-302).
+ *
+ * These types replace the per-runner duplicated interfaces:
+ *   - DreamerRunnerOptions / ScribeRunnerOptions / ...
+ *   - DreamerRunnerDeps / ScribeRunnerDeps / ...
+ *   - DreamerRunnerResult / ScribeRunnerResult / ...
+ *   - FailureContext / SucceedContext / ValidationErrorContext
+ *
+ * @see docs/adr/0003-peer-agent-state-machine-orchestration.md
+ */
+import type { PDErrorCategory } from '../error-categories.js';
+import type { RuntimeStateManager } from '../store/runtime-state-manager.js';
+import type { PDRuntimeAdapter } from '../runtime-protocol.js';
+import type { StoreEventEmitter } from '../store/event-emitter.js';
+import type { PIArtifactStore } from '../internalization/pi-artifact.js';
+import type { PeerRunnerKind } from '../internalization/peer-runner-contracts.js';
+import type { TaskRecord } from '../task-status.js';
+/** Shared runner options. All peer runners accept this shape. */
+export interface PeerRunnerOptions {
+    readonly pollIntervalMs?: number;
+    readonly timeoutMs?: number;
+    readonly defaultMaxAttempts?: number;
+    readonly owner: string;
+    readonly runtimeKind: string;
+    readonly agentId?: string;
+}
+/** Resolved options with defaults applied. */
+export interface ResolvedPeerRunnerOptions {
+    readonly pollIntervalMs: number;
+    readonly timeoutMs: number;
+    readonly defaultMaxAttempts: number;
+    readonly owner: string;
+    readonly runtimeKind: string;
+    readonly agentId: string;
+}
+/**
+ * Shared dependencies injected into all peer runners.
+ *
+ * Runners with additional dependencies (e.g. DiagnosticianRunner needs
+ * ContextAssembler + DiagnosticianCommitter) should extend this interface.
+ */
+export interface PeerRunnerDeps {
+    readonly stateManager: RuntimeStateManager;
+    readonly runtimeAdapter: PDRuntimeAdapter;
+    readonly eventEmitter: StoreEventEmitter;
+    readonly artifactStore: PIArtifactStore;
+}
+/**
+ * Runner-specific configuration passed to the BasePeerRunner constructor.
+ * Each subclass provides its own config instance.
+ */
+export interface PeerRunnerConfig {
+    /** Runner name for telemetry event prefix (e.g. 'dreamer', 'scribe'). */
+    readonly runnerName: string;
+    /** Expected taskKind for lease validation (e.g. 'dreamer'). */
+    readonly expectedTaskKind: PeerRunnerKind;
+    /** Default agentId if not provided in options. */
+    readonly defaultAgentId: string;
+    /** ResultRef prefix (e.g. 'dreamer' → 'dreamer://runId'). */
+    readonly resultRefPrefix: string;
+}
+/** Status values shared by all peer runner results. */
+export type PeerRunnerResultStatus = 'succeeded' | 'failed' | 'retried';
+/**
+ * Generic result type for all peer runners.
+ * Replaces the per-runner result interfaces (DreamerRunnerResult, etc.).
+ */
+export interface PeerRunnerResult<TOutput> {
+    readonly status: PeerRunnerResultStatus;
+    readonly taskId: string;
+    readonly runId?: string;
+    readonly artifactId?: string;
+    readonly resultRef?: string;
+    readonly contextHash?: string;
+    readonly output?: TOutput;
+    readonly errorCategory?: PDErrorCategory;
+    readonly failureReason?: string;
+    readonly attemptCount: number;
+}
+/**
+ * Validation result returned by the abstract validateOutput() method.
+ * Replaces the per-runner validation result interfaces.
+ *
+ * Note: named PeerRunnerValidationResult to avoid collision with
+ * ValidationResult from rule-code-validator.ts.
+ */
+export interface PeerRunnerValidationResult {
+    readonly valid: boolean;
+    readonly errors: readonly string[];
+    readonly errorCategory?: PDErrorCategory;
+}
+/** Context for the retryOrFail decision. */
+export interface FailureContext {
+    readonly taskId: string;
+    readonly task: TaskRecord;
+    readonly errorCategory: PDErrorCategory;
+    readonly failureReason: string;
+}
+/** Context for validation error handling. */
+export interface ValidationErrorContext {
+    readonly taskId: string;
+    readonly task: TaskRecord;
+    readonly errors: readonly string[];
+    readonly errorCategory?: PDErrorCategory;
+}
+//# sourceMappingURL=peer-runner-types.d.ts.map

package/dist/runtime-v2/runner/peer-runner-types.d.ts.map

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