@principles/core 1.84.0 → 1.85.0

package/dist/runtime-v2/internalization/philosopher-runner.d.ts

@@ -1,8 +1,9 @@
 /**
  * PhilosopherRunner — Second peer runner for the Internalization Engine (PRI-90).
  *
- * Reads a Dreamer artifact, invokes PDRuntimeAdapter for philosophical analysis,
- * validates output, writes Philosopher PIArtifact, and marks task succeeded.
+ * Migrated to extend BasePeerRunner (PRI-new). The shared lease → buildContext →
+ * invoke → poll → fetch → validate → succeed/fail pipeline is now in the base
+ * class. This file only contains Philosopher-specific logic.
  *
  * Key constraints (ADR-0003):
  *   - Uses PDRuntimeAdapter for all LLM execution (no direct SDK calls)
@@ -17,20 +18,25 @@
  *   3. fetch Dreamer artifact via PIArtifactStore
  *   4. startRun with outputSchemaRef: 'philosopher-output-v1'
  *   5. pollUntilTerminal
- *   6. fetchOutput → parse as PhilosopherOutputV1
- *   7. validate via PhilosopherValidator
- *   8. updateRunOutput → persist serialized output
- *   9. write PIArtifact → markTaskSucceeded with philosopher:// resultRef
+ *   6. fetchOutput → validate as unknown → cast to PhilosopherOutputV1
+ *   7. updateRunOutput → persist serialized output
+ *   8. write PIArtifact → markTaskSucceeded with philosopher:// resultRef
  *
  * @see docs/adr/0003-peer-agent-state-machine-orchestration.md
+ * @see BasePeerRunner in runner/base-peer-runner.ts
  */
-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 { RunHandle } from '../runtime-protocol.js';
 import type { PhilosopherOutputV1, PhilosopherValidator } from './philosopher-output.js';
-import type { PIArtifactStore } from './pi-artifact.js';
+import type { TaskRecord } from '../task-status.js';
 import { type PDErrorCategory } from '../error-categories.js';
-import { RunnerPhase } from '../runner/runner-phase.js';
+import { BasePeerRunner } from '../runner/base-peer-runner.js';
+import type { PeerRunnerOptions, PeerRunnerDeps, PeerRunnerResult, PeerRunnerValidationResult } from '../runner/peer-runner-types.js';
+/** Context built by PhilosopherRunner.buildContext() and consumed by invokeRuntime(). */
+interface PhilosopherContext {
+    readonly contextHash: string;
+    readonly dreamerArtifact: string;
+    readonly sourceDreamerArtifactId: string;
+}
 export type PhilosopherRunnerResultStatus = 'succeeded' | 'failed' | 'retried';
 export interface PhilosopherRunnerResult {
     readonly status: PhilosopherRunnerResultStatus;
@@ -44,14 +50,7 @@ export interface PhilosopherRunnerResult {
     readonly failureReason?: string;
     readonly attemptCount: number;
 }
-export interface PhilosopherRunnerOptions {
-    readonly pollIntervalMs?: number;
-    readonly timeoutMs?: number;
-    readonly defaultMaxAttempts?: number;
-    readonly owner: string;
-    readonly runtimeKind: string;
-    readonly agentId?: string;
-}
+export type PhilosopherRunnerOptions = PeerRunnerOptions;
 export interface ResolvedPhilosopherRunnerOptions {
     readonly pollIntervalMs: number;
     readonly timeoutMs: number;
@@ -60,44 +59,26 @@ export interface ResolvedPhilosopherRunnerOptions {
     readonly runtimeKind: string;
     readonly agentId: string;
 }
-declare const DEFAULT_PHILOSOPHER_RUNNER_OPTIONS: Readonly<Omit<ResolvedPhilosopherRunnerOptions, 'owner' | 'runtimeKind'>>;
-declare function resolvePhilosopherRunnerOptions(options: PhilosopherRunnerOptions): ResolvedPhilosopherRunnerOptions;
-export interface PhilosopherRunnerDeps {
-    readonly stateManager: RuntimeStateManager;
-    readonly runtimeAdapter: PDRuntimeAdapter;
-    readonly eventEmitter: StoreEventEmitter;
+export declare const DEFAULT_PHILOSOPHER_RUNNER_OPTIONS: Readonly<Omit<ResolvedPhilosopherRunnerOptions, 'owner' | 'runtimeKind'>>;
+export declare function resolvePhilosopherRunnerOptions(options: PhilosopherRunnerOptions): ResolvedPhilosopherRunnerOptions;
+export interface PhilosopherRunnerDeps extends PeerRunnerDeps {
     readonly validator: PhilosopherValidator;
-    readonly artifactStore: PIArtifactStore;
 }
-export declare class PhilosopherRunner {
-    private phase;
-    private readonly resolvedOptions;
-    private readonly stateManager;
-    private readonly runtimeAdapter;
-    private readonly eventEmitter;
+export declare class PhilosopherRunner extends BasePeerRunner<PhilosopherContext, PhilosopherOutputV1> {
     private readonly validator;
-    private readonly artifactStore;
-    constructor(deps: PhilosopherRunnerDeps, options: PhilosopherRunnerOptions);
-    get currentPhase(): RunnerPhase;
-    private emitPhilosopherEvent;
-    run(taskId: string): Promise<PhilosopherRunnerResult>;
-    private buildContext;
-    private static hashContextRefs;
-    private resolveStoreRunId;
-    private invokeRuntime;
-    private pollUntilTerminal;
-    private fetchAndParseOutput;
-    private succeedTask;
-    private handleRuntimeFailure;
-    private handleValidationError;
-    private handleLeaseOrPhaseError;
-    private handlePostLeaseError;
-    private retryOrFail;
-    private readonly PERMANENT_ERROR_CATEGORIES;
-    private isPermanentError;
-    private classifyError;
-    private mapRunStatusToErrorCategory;
-    private sleep;
+    constructor(deps: PhilosopherRunnerDeps, options: PeerRunnerOptions);
+    get permanentErrorCategories(): ReadonlySet<PDErrorCategory>;
+    buildContext(taskId: string): Promise<PhilosopherContext>;
+    invokeRuntime(taskId: string, context: PhilosopherContext): Promise<RunHandle>;
+    validateOutput(output: unknown, taskId: string): Promise<PeerRunnerValidationResult>;
+    succeedTask(taskId: string, runId: string, output: PhilosopherOutputV1, task: TaskRecord, contextHash: string, context: PhilosopherContext): Promise<PeerRunnerResult<PhilosopherOutputV1>>;
+    /**
+     * Re-inject taskId if stripped by stripLineageFields (PRI-272 / ERR-008).
+     * Only fill when absent via Object.hasOwn — present-but-falsy values
+     * must reach validation and fail loud (Runtime Contract Rule 3).
+     */
+    protected postFetchTransform(taskId: string, untrustedOutput: unknown): void;
+    protected emitSuccessTelemetry(taskId: string, output: PhilosopherOutputV1): void;
 }
-export { resolvePhilosopherRunnerOptions, DEFAULT_PHILOSOPHER_RUNNER_OPTIONS };
+export {};
 //# sourceMappingURL=philosopher-runner.d.ts.map

package/dist/runtime-v2/internalization/philosopher-runner.d.ts.map

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