@principles/core 1.73.0

package/dist/runtime-v2/internalization/evaluator-output.d.ts

@@ -0,0 +1,71 @@
+import { type Static } from '@sinclair/typebox';
+export interface EvaluatorEvaluation {
+    readonly decision: 'approved' | 'needs_revision' | 'rejected';
+    readonly summary: string;
+    readonly score: number;
+    readonly strengths: readonly string[];
+    readonly concerns: readonly string[];
+    readonly requiredChanges: readonly string[];
+}
+export interface EvaluatorSourceTrace {
+    readonly artificerArtifactId: string;
+    readonly scribeArtifactId?: string;
+    readonly philosopherArtifactId?: string;
+    readonly dreamerArtifactId?: string;
+}
+export interface EvaluatorOutputV1 {
+    readonly taskId: string;
+    readonly sourceArtificerArtifactId: string;
+    readonly evaluation: EvaluatorEvaluation;
+    readonly sourceTrace: EvaluatorSourceTrace;
+    readonly risks: readonly string[];
+    readonly generatedAt: string;
+}
+export declare const EVALUATOR_DECISIONS: readonly ["approved", "needs_revision", "rejected"];
+export declare const EvaluatorEvaluationSchema: import("@sinclair/typebox").TObject<{
+    decision: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"approved">, import("@sinclair/typebox").TLiteral<"needs_revision">, import("@sinclair/typebox").TLiteral<"rejected">]>;
+    summary: import("@sinclair/typebox").TString;
+    score: import("@sinclair/typebox").TNumber;
+    strengths: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>;
+    concerns: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>;
+    requiredChanges: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>;
+}>;
+export declare const EvaluatorSourceTraceSchema: import("@sinclair/typebox").TObject<{
+    artificerArtifactId: import("@sinclair/typebox").TString;
+    scribeArtifactId: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    philosopherArtifactId: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    dreamerArtifactId: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+}>;
+export declare const EvaluatorOutputV1Schema: import("@sinclair/typebox").TObject<{
+    taskId: import("@sinclair/typebox").TString;
+    sourceArtificerArtifactId: import("@sinclair/typebox").TString;
+    evaluation: import("@sinclair/typebox").TObject<{
+        decision: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"approved">, import("@sinclair/typebox").TLiteral<"needs_revision">, import("@sinclair/typebox").TLiteral<"rejected">]>;
+        summary: import("@sinclair/typebox").TString;
+        score: import("@sinclair/typebox").TNumber;
+        strengths: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>;
+        concerns: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>;
+        requiredChanges: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>;
+    }>;
+    sourceTrace: import("@sinclair/typebox").TObject<{
+        artificerArtifactId: import("@sinclair/typebox").TString;
+        scribeArtifactId: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+        philosopherArtifactId: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+        dreamerArtifactId: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    }>;
+    risks: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>;
+    generatedAt: import("@sinclair/typebox").TString;
+}>;
+export type EvaluatorOutputV1TB = Static<typeof EvaluatorOutputV1Schema>;
+export interface EvaluatorValidationResult {
+    readonly valid: boolean;
+    readonly errors: readonly string[];
+    readonly errorCategory?: string;
+}
+export interface EvaluatorValidator {
+    validate(output: EvaluatorOutputV1, taskId: string, expectedSourceArtificerArtifactId?: string): Promise<EvaluatorValidationResult>;
+}
+export declare class DefaultEvaluatorValidator implements EvaluatorValidator {
+    validate(output: EvaluatorOutputV1, taskId: string, expectedSourceArtificerArtifactId?: string): Promise<EvaluatorValidationResult>;
+}
+//# sourceMappingURL=evaluator-output.d.ts.map

package/dist/runtime-v2/internalization/evaluator-output.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"evaluator-output.d.ts","sourceRoot":"","sources":["../../../src/runtime-v2/internalization/evaluator-output.ts"],"names":[],"mappings":"AAAA,OAAO,EAAQ,KAAK,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAEtD,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,QAAQ,EAAE,UAAU,GAAG,gBAAgB,GAAG,UAAU,CAAC;IAC9D,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,QAAQ,CAAC,eAAe,EAAE,SAAS,MAAM,EAAE,CAAC;CAC7C;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;IACrC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,qBAAqB,CAAC,EAAE,MAAM,CAAC;IACxC,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;CACrC;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,yBAAyB,EAAE,MAAM,CAAC;IAC3C,QAAQ,CAAC,UAAU,EAAE,mBAAmB,CAAC;IACzC,QAAQ,CAAC,WAAW,EAAE,oBAAoB,CAAC;IAC3C,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAED,eAAO,MAAM,mBAAmB,qDAAsD,CAAC;AAEvF,eAAO,MAAM,yBAAyB;;;;;;;EAWpC,CAAC;AAEH,eAAO,MAAM,0BAA0B;;;;;EAKrC,CAAC;AAEH,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;EAOlC,CAAC;AAEH,MAAM,MAAM,mBAAmB,GAAG,MAAM,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAEzE,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;CACjC;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,MAAM,EAAE,iBAAiB,EAAE,MAAM,EAAE,MAAM,EAAE,iCAAiC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,yBAAyB,CAAC,CAAC;CACrI;AAED,qBAAa,yBAA0B,YAAW,kBAAkB;IAE5D,QAAQ,CAAC,MAAM,EAAE,iBAAiB,EAAE,MAAM,EAAE,MAAM,EAAE,iCAAiC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,yBAAyB,CAAC;CA4E1I"}

package/dist/runtime-v2/internalization/evaluator-output.js

@@ -0,0 +1,113 @@
+import { Type } from '@sinclair/typebox';
+export const EVALUATOR_DECISIONS = ['approved', 'needs_revision', 'rejected'];
+export const EvaluatorEvaluationSchema = Type.Object({
+    decision: Type.Union([
+        Type.Literal('approved'),
+        Type.Literal('needs_revision'),
+        Type.Literal('rejected'),
+    ]),
+    summary: Type.String({ minLength: 1 }),
+    score: Type.Number({ minimum: 0, maximum: 1 }),
+    strengths: Type.Array(Type.String()),
+    concerns: Type.Array(Type.String()),
+    requiredChanges: Type.Array(Type.String()),
+});
+export const EvaluatorSourceTraceSchema = Type.Object({
+    artificerArtifactId: Type.String({ minLength: 1 }),
+    scribeArtifactId: Type.Optional(Type.String()),
+    philosopherArtifactId: Type.Optional(Type.String()),
+    dreamerArtifactId: Type.Optional(Type.String()),
+});
+export const EvaluatorOutputV1Schema = Type.Object({
+    taskId: Type.String({ minLength: 1 }),
+    sourceArtificerArtifactId: Type.String({ minLength: 1 }),
+    evaluation: EvaluatorEvaluationSchema,
+    sourceTrace: EvaluatorSourceTraceSchema,
+    risks: Type.Array(Type.String()),
+    generatedAt: Type.String({ minLength: 1 }),
+});
+export class DefaultEvaluatorValidator {
+    // eslint-disable-next-line @typescript-eslint/class-methods-use-this
+    async validate(output, taskId, expectedSourceArtificerArtifactId) {
+        const errors = [];
+        if (typeof output !== 'object' || output === null) {
+            return { valid: false, errors: ['Output is not an object'], errorCategory: 'output_invalid' };
+        }
+        if (output.taskId !== taskId) {
+            errors.push(`taskId mismatch: expected ${taskId}, got ${String(output.taskId)}`);
+        }
+        if (typeof output.sourceArtificerArtifactId !== 'string' || output.sourceArtificerArtifactId.trim() === '') {
+            errors.push('sourceArtificerArtifactId must be non-empty string');
+        }
+        else if (expectedSourceArtificerArtifactId && output.sourceArtificerArtifactId !== expectedSourceArtificerArtifactId) {
+            errors.push(`sourceArtificerArtifactId mismatch: expected ${expectedSourceArtificerArtifactId}, got ${output.sourceArtificerArtifactId}`);
+        }
+        if (typeof output.evaluation !== 'object' || output.evaluation === null) {
+            errors.push('evaluation must be an object');
+        }
+        else {
+            const ev = output.evaluation;
+            if (!EVALUATOR_DECISIONS.includes(ev.decision)) {
+                errors.push(`evaluation.decision must be one of ${EVALUATOR_DECISIONS.join('/')}, got ${String(ev.decision)}`);
+            }
+            if (typeof ev.summary !== 'string' || (ev.summary).trim() === '')
+                errors.push('evaluation.summary must be non-empty string');
+            if (typeof ev.score !== 'number' || !Number.isFinite(ev.score))
+                errors.push('evaluation.score must be number');
+            else if (ev.score < 0 || ev.score > 1)
+                errors.push('evaluation.score must be in [0, 1]');
+            if (!Array.isArray(ev.strengths))
+                errors.push('evaluation.strengths must be an array');
+            else if (!ev.strengths.every(e => typeof e === 'string'))
+                errors.push('evaluation.strengths must be an array of strings');
+            if (!Array.isArray(ev.concerns))
+                errors.push('evaluation.concerns must be an array');
+            else if (!ev.concerns.every(e => typeof e === 'string'))
+                errors.push('evaluation.concerns must be an array of strings');
+            if (!Array.isArray(ev.requiredChanges))
+                errors.push('evaluation.requiredChanges must be an array');
+            else if (!ev.requiredChanges.every(e => typeof e === 'string'))
+                errors.push('evaluation.requiredChanges must be an array of strings');
+        }
+        if (typeof output.sourceTrace !== 'object' || output.sourceTrace === null) {
+            errors.push('sourceTrace must be an object');
+        }
+        else {
+            const st = output.sourceTrace;
+            if (typeof st.artificerArtifactId !== 'string' || (st.artificerArtifactId).trim() === '') {
+                errors.push('sourceTrace.artificerArtifactId must be non-empty string');
+            }
+            else if (expectedSourceArtificerArtifactId && st.artificerArtifactId !== expectedSourceArtificerArtifactId) {
+                errors.push(`sourceTrace.artificerArtifactId mismatch: expected ${expectedSourceArtificerArtifactId}, got ${st.artificerArtifactId}`);
+            }
+            if (st.scribeArtifactId !== undefined && typeof st.scribeArtifactId !== 'string') {
+                errors.push('sourceTrace.scribeArtifactId must be string if present');
+            }
+            if (st.philosopherArtifactId !== undefined && typeof st.philosopherArtifactId !== 'string') {
+                errors.push('sourceTrace.philosopherArtifactId must be string if present');
+            }
+            if (st.dreamerArtifactId !== undefined && typeof st.dreamerArtifactId !== 'string') {
+                errors.push('sourceTrace.dreamerArtifactId must be string if present');
+            }
+        }
+        if (!Array.isArray(output.risks)) {
+            errors.push('risks must be an array');
+        }
+        else if (!output.risks.every(e => typeof e === 'string')) {
+            errors.push('risks must be an array of strings');
+        }
+        if (typeof output.sourceArtificerArtifactId === 'string' && output.sourceArtificerArtifactId.trim() !== ''
+            && typeof output.sourceTrace === 'object' && output.sourceTrace !== null
+            && typeof output.sourceTrace.artificerArtifactId === 'string'
+            && output.sourceArtificerArtifactId !== output.sourceTrace.artificerArtifactId) {
+            errors.push('sourceArtificerArtifactId and sourceTrace.artificerArtifactId must match');
+        }
+        if (typeof output.generatedAt !== 'string' || output.generatedAt.trim() === '') {
+            errors.push('generatedAt must be non-empty string');
+        }
+        return errors.length > 0
+            ? { valid: false, errors, errorCategory: 'output_invalid' }
+            : { valid: true, errors: [] };
+    }
+}
+//# sourceMappingURL=evaluator-output.js.map

package/dist/runtime-v2/internalization/evaluator-output.js.map

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

package/dist/runtime-v2/internalization/evaluator-prompt-builder.d.ts

@@ -0,0 +1,24 @@
+export interface EvaluatorPromptBuilderInput {
+    taskId: string;
+    contextHash: string;
+    sourceArtificerArtifactId: string;
+    artificerArtifact: unknown;
+}
+export interface EvaluatorPromptInput {
+    taskId: string;
+    contextHash: string;
+    sourceArtificerArtifactId: string;
+    artificerArtifact: unknown;
+    evaluatorInstruction: string;
+    promptContractVersion: string;
+}
+export interface EvaluatorPromptBuildResult {
+    readonly message: string;
+    readonly promptInput: EvaluatorPromptInput;
+}
+export declare const EVALUATOR_PROTOCOL_INSTRUCTION = "You are an Evaluator agent in a principle internalization pipeline. Your role is to critically review the Artificer's implementation plan and produce a structured evaluation with a decision, score, and actionable feedback.\n\nPROTOCOL:\n1. Review the artificerArtifact to understand the proposed implementation plan\n2. Evaluate the plan against quality criteria: completeness, feasibility, test coverage, risk mitigation\n3. Produce a decision: approved (plan is sound), needs_revision (plan has issues but is salvageable), or rejected (plan is fundamentally flawed)\n4. Provide a score from 0.0 to 1.0 reflecting overall quality\n5. List specific strengths, concerns, and required changes\n6. Preserve the lineage trace from artificer, scribe, philosopher, and dreamer artifacts\n7. Identify risks associated with this evaluation\n\nCRITICAL: Your ENTIRE response must be ONLY the JSON object below. Do NOT include any text before or after the JSON. Do NOT wrap the JSON in markdown code fences. Do NOT add explanatory prose. Output the raw JSON object and nothing else.\n\nCOMPLETE EXAMPLE OUTPUT (follow this exact structure):\n{\"taskId\":\"task-123\",\"sourceArtificerArtifactId\":\"pi-art-artificer-001\",\"evaluation\":{\"decision\":\"approved\",\"summary\":\"The implementation plan is well-structured and addresses the identified issues.\",\"score\":0.85,\"strengths\":[\"Clear change descriptions with specific file targets\",\"Good test coverage plan\"],\"concerns\":[\"Rollout notes could be more specific about monitoring\"],\"requiredChanges\":[]},\"sourceTrace\":{\"artificerArtifactId\":\"pi-art-artificer-001\"},\"risks\":[\"May need additional integration tests\"],\"generatedAt\":\"2026-05-11T12:00:00.000Z\"}\n\nCONSTRAINTS:\n- Output ONLY valid JSON \u2014 no markdown, no explanatory text, no code fences, no prose before or after\n- evaluation.decision MUST be one of: approved, needs_revision, rejected\n- evaluation.summary MUST be a non-empty string\n- evaluation.score MUST be a number between 0.0 and 1.0 (NOT a string, NOT a percentage)\n- evaluation.strengths MUST be an array of strings (can be empty)\n- evaluation.concerns MUST be an array of strings (can be empty)\n- evaluation.requiredChanges MUST be an array of strings (can be empty)\n- sourceArtificerArtifactId MUST be copied exactly from input.sourceArtificerArtifactId (non-empty string)\n- sourceTrace.artificerArtifactId MUST be copied exactly from input.sourceArtificerArtifactId\n- sourceTrace.scribeArtifactId is optional \u2014 include only if available from artificer artifact\n- sourceTrace.philosopherArtifactId is optional \u2014 include only if available from artificer artifact\n- sourceTrace.dreamerArtifactId is optional \u2014 include only if available from artificer artifact\n- risks MUST be an array of strings (can be empty if no risks identified)\n- generatedAt MUST be an ISO-8601 timestamp string\n";
+export declare const EVALUATOR_PROMPT_CONTRACT_VERSION = "evaluator-output-v1.prompt.v1";
+export declare class EvaluatorPromptBuilder {
+    buildPrompt(input: EvaluatorPromptBuilderInput): EvaluatorPromptBuildResult;
+}
+//# sourceMappingURL=evaluator-prompt-builder.d.ts.map

package/dist/runtime-v2/internalization/evaluator-prompt-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"evaluator-prompt-builder.d.ts","sourceRoot":"","sources":["../../../src/runtime-v2/internalization/evaluator-prompt-builder.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,2BAA2B;IAC1C,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,yBAAyB,EAAE,MAAM,CAAC;IAClC,iBAAiB,EAAE,OAAO,CAAC;CAC5B;AAED,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,yBAAyB,EAAE,MAAM,CAAC;IAClC,iBAAiB,EAAE,OAAO,CAAC;IAC3B,oBAAoB,EAAE,MAAM,CAAC;IAC7B,qBAAqB,EAAE,MAAM,CAAC;CAC/B;AAED,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,WAAW,EAAE,oBAAoB,CAAC;CAC5C;AAED,eAAO,MAAM,8BAA8B,s2FA+B1C,CAAC;AAEF,eAAO,MAAM,iCAAiC,kCAAkC,CAAC;AAEjF,qBAAa,sBAAsB;IAEjC,WAAW,CAAC,KAAK,EAAE,2BAA2B,GAAG,0BAA0B;CAc5E"}

package/dist/runtime-v2/internalization/evaluator-prompt-builder.js

@@ -0,0 +1,49 @@
+export const EVALUATOR_PROTOCOL_INSTRUCTION = `You are an Evaluator agent in a principle internalization pipeline. Your role is to critically review the Artificer's implementation plan and produce a structured evaluation with a decision, score, and actionable feedback.
+
+PROTOCOL:
+1. Review the artificerArtifact to understand the proposed implementation plan
+2. Evaluate the plan against quality criteria: completeness, feasibility, test coverage, risk mitigation
+3. Produce a decision: approved (plan is sound), needs_revision (plan has issues but is salvageable), or rejected (plan is fundamentally flawed)
+4. Provide a score from 0.0 to 1.0 reflecting overall quality
+5. List specific strengths, concerns, and required changes
+6. Preserve the lineage trace from artificer, scribe, philosopher, and dreamer artifacts
+7. Identify risks associated with this evaluation
+
+CRITICAL: Your ENTIRE response must be ONLY the JSON object below. Do NOT include any text before or after the JSON. Do NOT wrap the JSON in markdown code fences. Do NOT add explanatory prose. Output the raw JSON object and nothing else.
+
+COMPLETE EXAMPLE OUTPUT (follow this exact structure):
+{"taskId":"task-123","sourceArtificerArtifactId":"pi-art-artificer-001","evaluation":{"decision":"approved","summary":"The implementation plan is well-structured and addresses the identified issues.","score":0.85,"strengths":["Clear change descriptions with specific file targets","Good test coverage plan"],"concerns":["Rollout notes could be more specific about monitoring"],"requiredChanges":[]},"sourceTrace":{"artificerArtifactId":"pi-art-artificer-001"},"risks":["May need additional integration tests"],"generatedAt":"2026-05-11T12:00:00.000Z"}
+
+CONSTRAINTS:
+- Output ONLY valid JSON — no markdown, no explanatory text, no code fences, no prose before or after
+- evaluation.decision MUST be one of: approved, needs_revision, rejected
+- evaluation.summary MUST be a non-empty string
+- evaluation.score MUST be a number between 0.0 and 1.0 (NOT a string, NOT a percentage)
+- evaluation.strengths MUST be an array of strings (can be empty)
+- evaluation.concerns MUST be an array of strings (can be empty)
+- evaluation.requiredChanges MUST be an array of strings (can be empty)
+- sourceArtificerArtifactId MUST be copied exactly from input.sourceArtificerArtifactId (non-empty string)
+- sourceTrace.artificerArtifactId MUST be copied exactly from input.sourceArtificerArtifactId
+- sourceTrace.scribeArtifactId is optional — include only if available from artificer artifact
+- sourceTrace.philosopherArtifactId is optional — include only if available from artificer artifact
+- sourceTrace.dreamerArtifactId is optional — include only if available from artificer artifact
+- risks MUST be an array of strings (can be empty if no risks identified)
+- generatedAt MUST be an ISO-8601 timestamp string
+`;
+export const EVALUATOR_PROMPT_CONTRACT_VERSION = 'evaluator-output-v1.prompt.v1';
+export class EvaluatorPromptBuilder {
+    // eslint-disable-next-line @typescript-eslint/class-methods-use-this
+    buildPrompt(input) {
+        const promptInput = {
+            taskId: input.taskId,
+            contextHash: input.contextHash,
+            sourceArtificerArtifactId: input.sourceArtificerArtifactId,
+            artificerArtifact: input.artificerArtifact,
+            evaluatorInstruction: EVALUATOR_PROTOCOL_INSTRUCTION,
+            promptContractVersion: EVALUATOR_PROMPT_CONTRACT_VERSION,
+        };
+        const message = JSON.stringify(promptInput);
+        return { message, promptInput };
+    }
+}
+//# sourceMappingURL=evaluator-prompt-builder.js.map

package/dist/runtime-v2/internalization/evaluator-prompt-builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"evaluator-prompt-builder.js","sourceRoot":"","sources":["../../../src/runtime-v2/internalization/evaluator-prompt-builder.ts"],"names":[],"mappings":"AAqBA,MAAM,CAAC,MAAM,8BAA8B,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA+B7C,CAAC;AAEF,MAAM,CAAC,MAAM,iCAAiC,GAAG,+BAA+B,CAAC;AAEjF,MAAM,OAAO,sBAAsB;IACjC,qEAAqE;IACrE,WAAW,CAAC,KAAkC;QAC5C,MAAM,WAAW,GAAyB;YACxC,MAAM,EAAE,KAAK,CAAC,MAAM;YACpB,WAAW,EAAE,KAAK,CAAC,WAAW;YAC9B,yBAAyB,EAAE,KAAK,CAAC,yBAAyB;YAC1D,iBAAiB,EAAE,KAAK,CAAC,iBAAiB;YAC1C,oBAAoB,EAAE,8BAA8B;YACpD,qBAAqB,EAAE,iCAAiC;SACzD,CAAC;QAEF,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;QAE5C,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC;IAClC,CAAC;CACF"}

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

@@ -0,0 +1,80 @@
+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 { EvaluatorOutputV1, EvaluatorValidator } from './evaluator-output.js';
+import type { PIArtifactStore } from './pi-artifact.js';
+import { type PDErrorCategory } from '../error-categories.js';
+import { RunnerPhase } from '../runner/runner-phase.js';
+export type EvaluatorRunnerResultStatus = 'succeeded' | 'failed' | 'retried';
+export interface EvaluatorRunnerResult {
+    readonly status: EvaluatorRunnerResultStatus;
+    readonly taskId: string;
+    readonly runId?: string;
+    readonly artifactId?: string;
+    readonly resultRef?: string;
+    readonly contextHash?: string;
+    readonly output?: EvaluatorOutputV1;
+    readonly errorCategory?: PDErrorCategory;
+    readonly failureReason?: string;
+    readonly attemptCount: number;
+}
+export interface EvaluatorRunnerOptions {
+    readonly pollIntervalMs?: number;
+    readonly timeoutMs?: number;
+    readonly defaultMaxAttempts?: number;
+    readonly owner: string;
+    readonly runtimeKind: string;
+    readonly agentId?: string;
+}
+export interface ResolvedEvaluatorRunnerOptions {
+    readonly pollIntervalMs: number;
+    readonly timeoutMs: number;
+    readonly defaultMaxAttempts: number;
+    readonly owner: string;
+    readonly runtimeKind: string;
+    readonly agentId: string;
+}
+declare const DEFAULT_EVALUATOR_RUNNER_OPTIONS: Readonly<Omit<ResolvedEvaluatorRunnerOptions, 'owner' | 'runtimeKind'>>;
+export declare function resolveEvaluatorRunnerOptions(options: EvaluatorRunnerOptions): ResolvedEvaluatorRunnerOptions;
+export interface EvaluatorRunnerDeps {
+    readonly stateManager: RuntimeStateManager;
+    readonly runtimeAdapter: PDRuntimeAdapter;
+    readonly eventEmitter: StoreEventEmitter;
+    readonly validator: EvaluatorValidator;
+    readonly artifactStore: PIArtifactStore;
+}
+export declare class EvaluatorRunner {
+    private phase;
+    private readonly resolvedOptions;
+    private readonly stateManager;
+    private readonly runtimeAdapter;
+    private readonly eventEmitter;
+    private readonly validator;
+    private readonly artifactStore;
+    constructor(deps: EvaluatorRunnerDeps, options: EvaluatorRunnerOptions);
+    get currentPhase(): RunnerPhase;
+    private emitEvaluatorEvent;
+    run(taskId: string): Promise<EvaluatorRunnerResult>;
+    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 isPermanentError;
+    private classifyError;
+    private mapRunStatusToErrorCategory;
+    private resolvePrincipleBearerArtifact;
+    private resolveLineageArtifactIds;
+    private hasPrincipleDraftContent;
+    private static isRecord;
+    private sleep;
+}
+export { DEFAULT_EVALUATOR_RUNNER_OPTIONS };
+//# sourceMappingURL=evaluator-runner.d.ts.map

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

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