@principles/core 1.73.0

package/dist/runtime-v2/trace-refiner-agent.js

@@ -0,0 +1,239 @@
+// ── Allowed Source Refs Builder ──
+function buildAllowedSourceRefs(input) {
+    const allowed = new Set();
+    for (const ref of input.fullTrace.sourceRefs) {
+        allowed.add(`${ref.kind}:${ref.id}`);
+    }
+    for (const ref of input.deterministicRefinedTrace.evidenceRefs) {
+        allowed.add(ref);
+    }
+    for (const event of input.deterministicRefinedTrace.keyEvents) {
+        for (const ref of event.evidenceRefs) {
+            allowed.add(ref);
+        }
+    }
+    return allowed;
+}
+// ── createTraceRefinerAgentInput ──
+export function createTraceRefinerAgentInput(fullTrace, deterministicRefinedTrace, objective) {
+    return {
+        fullTrace,
+        deterministicRefinedTrace,
+        objective,
+        mode: 'shadow',
+        constraints: {
+            preserveSourceRefs: true,
+            doNotInventEvidence: true,
+            redactSecrets: true,
+        },
+    };
+}
+// ── validateTraceRefinerAgentOutput ──
+export function validateTraceRefinerAgentOutput(output, input) {
+    const errors = [];
+    if (typeof output !== 'object' || output === null) {
+        return { ok: false, errors: ['TraceRefinerAgentOutput must be an object'] };
+    }
+    const o = output;
+    if (o.status !== 'refined' && o.status !== 'blocked') {
+        errors.push('status must be "refined" or "blocked"');
+    }
+    if (typeof o.refinedTrace !== 'object' || o.refinedTrace === null) {
+        errors.push('refinedTrace must be an object');
+    }
+    if (!Array.isArray(o.evidenceMap)) {
+        errors.push('evidenceMap must be an array');
+    }
+    if (!Array.isArray(o.rejectedEvidence)) {
+        errors.push('rejectedEvidence must be an array');
+    }
+    if (typeof o.confidence !== 'number' || !Number.isFinite(o.confidence) || o.confidence < 0 || o.confidence > 1) {
+        errors.push('confidence must be a finite number in [0, 1]');
+    }
+    if (typeof o.generatedAt !== 'string' || o.generatedAt.length === 0) {
+        errors.push('generatedAt must be a non-empty string');
+    }
+    if (o.status === 'blocked') {
+        if (typeof o.blockedReason !== 'string' || o.blockedReason.length === 0) {
+            errors.push('blockedReason must be a non-empty string when status is "blocked"');
+        }
+    }
+    if (errors.length > 0) {
+        return { ok: false, errors };
+    }
+    const allowedSourceRefs = buildAllowedSourceRefs(input);
+    if (Array.isArray(o.evidenceMap)) {
+        for (let i = 0; i < o.evidenceMap.length; i++) {
+            const claim = o.evidenceMap[i];
+            if (typeof claim !== 'object' || claim === null) {
+                errors.push(`evidenceMap[${i}] must be an object`);
+                continue;
+            }
+            const c = claim;
+            if (typeof c.claim !== 'string' || c.claim.length === 0) {
+                errors.push(`evidenceMap[${i}].claim must be a non-empty string`);
+            }
+            if (!Array.isArray(c.sourceRefs) || c.sourceRefs.length === 0) {
+                errors.push(`evidenceMap[${i}].sourceRefs must be a non-empty array`);
+            }
+            else {
+                for (const ref of c.sourceRefs) {
+                    if (typeof ref !== 'string') {
+                        errors.push(`evidenceMap[${i}].sourceRefs must contain only strings`);
+                    }
+                    else if (!allowedSourceRefs.has(ref)) {
+                        errors.push(`evidenceMap[${i}].sourceRefs contains invented ref "${ref}" not present in allowed source refs`);
+                    }
+                }
+            }
+        }
+    }
+    if (Array.isArray(o.rejectedEvidence)) {
+        for (let i = 0; i < o.rejectedEvidence.length; i++) {
+            const rejected = o.rejectedEvidence[i];
+            if (typeof rejected !== 'object' || rejected === null) {
+                errors.push(`rejectedEvidence[${i}] must be an object`);
+                continue;
+            }
+            const r = rejected;
+            if (typeof r.reason !== 'string' || r.reason.length === 0) {
+                errors.push(`rejectedEvidence[${i}].reason must be a non-empty string`);
+            }
+            if (!Array.isArray(r.sourceRefs)) {
+                errors.push(`rejectedEvidence[${i}].sourceRefs must be an array`);
+            }
+            else {
+                for (const ref of r.sourceRefs) {
+                    if (typeof ref !== 'string') {
+                        errors.push(`rejectedEvidence[${i}].sourceRefs must contain only strings`);
+                    }
+                    else if (!allowedSourceRefs.has(ref)) {
+                        errors.push(`rejectedEvidence[${i}].sourceRefs contains invented ref "${ref}" not present in allowed source refs`);
+                    }
+                }
+            }
+        }
+    }
+    if (typeof o.refinedTrace === 'object' && o.refinedTrace !== null) {
+        const rt = o.refinedTrace;
+        const det = input.deterministicRefinedTrace;
+        if (rt.sourceTaskId !== det.sourceTaskId) {
+            errors.push(`refinedTrace.sourceTaskId "${rt.sourceTaskId}" does not match deterministic "${det.sourceTaskId}"`);
+        }
+        if (rt.sourcePainId !== det.sourcePainId) {
+            errors.push(`refinedTrace.sourcePainId "${rt.sourcePainId}" does not match deterministic "${det.sourcePainId}"`);
+        }
+        if (!Array.isArray(rt.sourceRunIds)) {
+            errors.push('refinedTrace.sourceRunIds must be an array');
+        }
+        else {
+            for (let i = 0; i < rt.sourceRunIds.length; i++) {
+                if (typeof rt.sourceRunIds[i] !== 'string') {
+                    errors.push(`refinedTrace.sourceRunIds[${i}] must be a string, found ${typeof rt.sourceRunIds[i]}`);
+                }
+            }
+            if (rt.sourceRunIds.length !== det.sourceRunIds.length || !rt.sourceRunIds.every((id, idx) => id === det.sourceRunIds[idx])) {
+                errors.push('refinedTrace.sourceRunIds does not match deterministic sourceRunIds');
+            }
+        }
+        if (!Array.isArray(rt.evidenceRefs)) {
+            errors.push('refinedTrace.evidenceRefs must be an array');
+        }
+        else {
+            for (const ref of rt.evidenceRefs) {
+                if (typeof ref !== 'string') {
+                    errors.push(`refinedTrace.evidenceRefs must contain only strings, found ${typeof ref}`);
+                }
+                else if (!allowedSourceRefs.has(ref)) {
+                    errors.push(`refinedTrace.evidenceRefs contains invented ref "${ref}" not present in allowed source refs`);
+                }
+            }
+        }
+        if (!Array.isArray(rt.keyEvents)) {
+            errors.push('refinedTrace.keyEvents must be an array');
+        }
+        else {
+            for (let i = 0; i < rt.keyEvents.length; i++) {
+                const event = rt.keyEvents[i];
+                if (typeof event !== 'object' || event === null) {
+                    errors.push(`refinedTrace.keyEvents[${i}] must be an object`);
+                    continue;
+                }
+                const e = event;
+                if (!Array.isArray(e.evidenceRefs)) {
+                    errors.push(`refinedTrace.keyEvents[${i}].evidenceRefs must be an array`);
+                }
+                else {
+                    for (const ref of e.evidenceRefs) {
+                        if (typeof ref !== 'string') {
+                            errors.push(`refinedTrace.keyEvents[${i}].evidenceRefs must contain only strings, found ${typeof ref}`);
+                        }
+                        else if (!allowedSourceRefs.has(ref)) {
+                            errors.push(`refinedTrace.keyEvents[${i}].evidenceRefs contains invented ref "${ref}" not present in allowed source refs`);
+                        }
+                    }
+                }
+            }
+        }
+    }
+    if (errors.length > 0) {
+        return { ok: false, errors };
+    }
+    return {
+        ok: true,
+        output: {
+            status: o.status,
+            refinedTrace: o.refinedTrace,
+            evidenceMap: o.evidenceMap,
+            rejectedEvidence: o.rejectedEvidence,
+            confidence: o.confidence,
+            generatedAt: o.generatedAt,
+            ...(typeof o.blockedReason === 'string' && o.blockedReason.length > 0
+                ? { blockedReason: o.blockedReason }
+                : {}),
+        },
+    };
+}
+// ── applyTraceRefinerAgentShadowResult ──
+export function applyTraceRefinerAgentShadowResult(input, agentOutput) {
+    const validation = validateTraceRefinerAgentOutput(agentOutput, input);
+    if (!validation.ok) {
+        return {
+            mode: 'shadow',
+            selectedTrace: input.deterministicRefinedTrace,
+            deterministicRefinedTrace: input.deterministicRefinedTrace,
+            agentRefinedTrace: null,
+            acceptedAgentOutput: null,
+            telemetry: {
+                decision: 'agent_output_invalid',
+                errors: validation.errors,
+            },
+        };
+    }
+    const accepted = validation.output;
+    if (accepted.status === 'blocked') {
+        return {
+            mode: 'shadow',
+            selectedTrace: input.deterministicRefinedTrace,
+            deterministicRefinedTrace: input.deterministicRefinedTrace,
+            agentRefinedTrace: null,
+            acceptedAgentOutput: accepted,
+            telemetry: {
+                decision: 'agent_blocked',
+                errors: [],
+            },
+        };
+    }
+    return {
+        mode: 'shadow',
+        selectedTrace: input.deterministicRefinedTrace,
+        deterministicRefinedTrace: input.deterministicRefinedTrace,
+        agentRefinedTrace: accepted.refinedTrace,
+        acceptedAgentOutput: accepted,
+        telemetry: {
+            decision: 'agent_refined_recorded',
+            errors: [],
+        },
+    };
+}
+//# sourceMappingURL=trace-refiner-agent.js.map

package/dist/runtime-v2/trace-refiner-agent.js.map

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

package/dist/runtime-v2/trace-refiner.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Deterministic TraceRefiner read model (PRI-191).
+ *
+ * Converts FullTracePayloadV2 into a compact, evidence-preserving,
+ * prompt-safe RefinedTracePayload for Diagnostician / GoldenTrace consumption.
+ *
+ * Key invariants:
+ *   - Deterministic: same input always produces deep-equal output
+ *   - No LLM calls, no I/O, no filesystem/path/process/network imports
+ *   - No plugin dependency
+ *   - Preserves sourceTaskId/sourcePainId/sourceRunIds lineage
+ *   - Preserves evidenceRefs from sourceRefs
+ *   - Bounded output: keyEvents max 20, summary max 300 chars
+ *   - Invalid input returns structured refinementNotes, never throws randomly
+ *   - Does not modify FullTracePayloadV2 contract
+ */
+import type { FullTracePayloadV2 } from './full-trace-contract.js';
+export declare const REFINED_EVENT_KINDS: readonly ["failure", "tool_use", "user_intent", "assistant_action", "system_context", "unknown"];
+export type RefinedEventKind = (typeof REFINED_EVENT_KINDS)[number];
+export declare const SEVERITY_LEVELS: readonly ["low", "medium", "high"];
+export type SeverityLevel = (typeof SEVERITY_LEVELS)[number];
+export interface RefinedTraceEvent {
+    kind: RefinedEventKind;
+    summary: string;
+    evidenceRefs: string[];
+    severity: SeverityLevel;
+    at: string | null;
+}
+export interface RefinedTracePayload {
+    sourceTaskId: string;
+    sourcePainId: string;
+    sourceRunIds: string[];
+    evidenceRefs: string[];
+    keyEvents: RefinedTraceEvent[];
+    failureSummary: string | null;
+    toolUseSummary: string[];
+    userIntentSummary: string | null;
+    ambiguityNotes: string[];
+    sanitizationNotes: string[];
+    refinementNotes: string[];
+}
+export interface TraceRefinerOptions {
+    maxKeyEvents?: number;
+    maxSummaryLength?: number;
+}
+export declare function refineFullTrace(fullTrace: FullTracePayloadV2, options?: TraceRefinerOptions): RefinedTracePayload;
+//# sourceMappingURL=trace-refiner.d.ts.map

package/dist/runtime-v2/trace-refiner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace-refiner.d.ts","sourceRoot":"","sources":["../../src/runtime-v2/trace-refiner.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,KAAK,EAAE,kBAAkB,EAAsC,MAAM,0BAA0B,CAAC;AAKvG,eAAO,MAAM,mBAAmB,kGAOtB,CAAC;AAEX,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,mBAAmB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEpE,eAAO,MAAM,eAAe,oCAAqC,CAAC;AAClE,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,CAAC,CAAC;AAE7D,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,gBAAgB,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,QAAQ,EAAE,aAAa,CAAC;IACxB,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;CACnB;AAID,MAAM,WAAW,mBAAmB;IAClC,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,SAAS,EAAE,iBAAiB,EAAE,CAAC;IAC/B,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,eAAe,EAAE,MAAM,EAAE,CAAC;CAC3B;AAID,MAAM,WAAW,mBAAmB;IAClC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AA+GD,wBAAgB,eAAe,CAC7B,SAAS,EAAE,kBAAkB,EAC7B,OAAO,CAAC,EAAE,mBAAmB,GAC5B,mBAAmB,CAoJrB"}

package/dist/runtime-v2/trace-refiner.js

@@ -0,0 +1,261 @@
+import { validateFullTracePayload } from './full-trace-contract.js';
+// ── Refined Trace Event ──
+export const REFINED_EVENT_KINDS = [
+    'failure',
+    'tool_use',
+    'user_intent',
+    'assistant_action',
+    'system_context',
+    'unknown',
+];
+export const SEVERITY_LEVELS = ['low', 'medium', 'high'];
+const DEFAULT_MAX_KEY_EVENTS = 20;
+const DEFAULT_MAX_SUMMARY_LENGTH = 300;
+// ── Failure Signal Detection ──
+const FAILURE_SIGNALS = [
+    'error',
+    'failed',
+    'exception',
+    'timeout',
+    'timed out',
+    'permission denied',
+    'denied',
+    'crashed',
+    'fatal',
+    'abort',
+    'unreachable',
+];
+function containsFailureSignal(text) {
+    const lower = text.toLowerCase();
+    return FAILURE_SIGNALS.some((signal) => lower.includes(signal));
+}
+function extractMetadataError(entry) {
+    if (!entry.metadata || typeof entry.metadata !== 'object')
+        return undefined;
+    const meta = entry.metadata;
+    if (typeof meta.error === 'string' && meta.error.length > 0)
+        return meta.error;
+    if (typeof meta.error === 'object' && meta.error !== null) {
+        try {
+            return JSON.stringify(meta.error);
+        }
+        catch {
+            return undefined;
+        }
+    }
+    return undefined;
+}
+function extractToolName(entry) {
+    if (!entry.metadata || typeof entry.metadata !== 'object')
+        return undefined;
+    const meta = entry.metadata;
+    if (typeof meta.toolName === 'string' && meta.toolName.length > 0)
+        return meta.toolName;
+    return undefined;
+}
+function extractToolStatus(entry) {
+    if (!entry.metadata || typeof entry.metadata !== 'object')
+        return undefined;
+    const meta = entry.metadata;
+    if (typeof meta.status === 'string' && meta.status.length > 0)
+        return meta.status;
+    return undefined;
+}
+function sourceRefToString(ref) {
+    return `${ref.kind}:${ref.id}`;
+}
+function truncateSummary(summary, maxLength) {
+    if (summary.length <= maxLength)
+        return summary;
+    return summary.slice(0, maxLength - 3) + '...';
+}
+function classifySeverity(entry, kind) {
+    if (kind === 'failure') {
+        const errorText = extractMetadataError(entry);
+        if (errorText) {
+            const lower = errorText.toLowerCase();
+            if (lower.includes('fatal') || lower.includes('crash'))
+                return 'high';
+            if (lower.includes('timeout') || lower.includes('permission denied'))
+                return 'medium';
+        }
+        return 'high';
+    }
+    if (kind === 'tool_use') {
+        const status = extractToolStatus(entry);
+        if (status) {
+            const lower = status.toLowerCase();
+            if (lower.includes('fail') || lower.includes('error'))
+                return 'high';
+            if (lower.includes('partial') || lower.includes('timeout'))
+                return 'medium';
+        }
+        return 'low';
+    }
+    if (kind === 'unknown')
+        return 'low';
+    if (kind === 'system_context')
+        return 'low';
+    return 'low';
+}
+function mapTimelineKindToRefinedKind(entry) {
+    switch (entry.kind) {
+        case 'tool_call':
+        case 'tool_result':
+            return 'tool_use';
+        case 'user_message':
+            return 'user_intent';
+        case 'assistant_message':
+            return 'assistant_action';
+        case 'system_event':
+            return 'system_context';
+        case 'unknown':
+        default:
+            return 'unknown';
+    }
+}
+function isFailureEntry(entry) {
+    if (extractMetadataError(entry))
+        return true;
+    if (containsFailureSignal(entry.summary))
+        return true;
+    if (entry.rawPreview && containsFailureSignal(entry.rawPreview))
+        return true;
+    const status = extractToolStatus(entry);
+    if (status && containsFailureSignal(status))
+        return true;
+    return false;
+}
+// ── Main Refiner Function ──
+export function refineFullTrace(fullTrace, options) {
+    const maxKeyEvents = options?.maxKeyEvents ?? DEFAULT_MAX_KEY_EVENTS;
+    const maxSummaryLength = options?.maxSummaryLength ?? DEFAULT_MAX_SUMMARY_LENGTH;
+    const refinementNotes = [];
+    if (fullTrace === null || fullTrace === undefined || typeof fullTrace !== 'object') {
+        return {
+            sourceTaskId: '',
+            sourcePainId: '',
+            sourceRunIds: [],
+            evidenceRefs: [],
+            keyEvents: [],
+            failureSummary: null,
+            toolUseSummary: [],
+            userIntentSummary: null,
+            ambiguityNotes: [],
+            sanitizationNotes: [],
+            refinementNotes: ['invalid_full_trace_input', 'validation_error: FullTracePayload must be an object'],
+        };
+    }
+    const validation = validateFullTracePayload(fullTrace);
+    if (!validation.valid) {
+        const p = fullTrace;
+        // Validate that salvaged arrays contain only string elements to maintain type contract
+        const safeSourceRunIds = Array.isArray(p.sourceRunIds)
+            ? p.sourceRunIds.filter((v) => typeof v === 'string')
+            : [];
+        const safeAmbiguityNotes = Array.isArray(p.ambiguityNotes)
+            ? p.ambiguityNotes.filter((v) => typeof v === 'string')
+            : [];
+        const safeSanitizationNotes = Array.isArray(p.sanitizationNotes)
+            ? p.sanitizationNotes.filter((v) => typeof v === 'string')
+            : [];
+        return {
+            sourceTaskId: typeof p.sourceTaskId === 'string' ? p.sourceTaskId : '',
+            sourcePainId: typeof p.sourcePainId === 'string' ? p.sourcePainId : '',
+            sourceRunIds: safeSourceRunIds,
+            evidenceRefs: [],
+            keyEvents: [],
+            failureSummary: null,
+            toolUseSummary: [],
+            userIntentSummary: null,
+            ambiguityNotes: safeAmbiguityNotes,
+            sanitizationNotes: safeSanitizationNotes,
+            refinementNotes: [
+                'invalid_full_trace_input',
+                ...validation.errors.map((e) => `validation_error: ${e}`),
+            ],
+        };
+    }
+    const { timeline } = fullTrace;
+    const evidenceRefs = fullTrace.sourceRefs.map(sourceRefToString);
+    if (timeline.length === 0) {
+        refinementNotes.push('empty_timeline');
+    }
+    const keyEvents = [];
+    const toolUseSummaries = [];
+    const failureSummaries = [];
+    let userIntentText = null;
+    for (const entry of timeline) {
+        const isFailure = isFailureEntry(entry);
+        const refinedKind = isFailure ? 'failure' : mapTimelineKindToRefinedKind(entry);
+        const severity = classifySeverity(entry, refinedKind);
+        const summary = truncateSummary(entry.summary, maxSummaryLength);
+        const entryEvidenceRefs = [];
+        const toolName = extractToolName(entry);
+        if (toolName) {
+            const runRefs = fullTrace.sourceRefs.filter((r) => r.kind === 'run');
+            for (const ref of runRefs)
+                entryEvidenceRefs.push(sourceRefToString(ref));
+        }
+        if (entryEvidenceRefs.length === 0 && evidenceRefs.length > 0) {
+            entryEvidenceRefs.push(...evidenceRefs);
+        }
+        keyEvents.push({
+            kind: refinedKind,
+            summary,
+            evidenceRefs: entryEvidenceRefs,
+            severity,
+            at: entry.at,
+        });
+        if (refinedKind === 'failure') {
+            const errorDetail = extractMetadataError(entry);
+            if (errorDetail) {
+                failureSummaries.push(truncateSummary(errorDetail, maxSummaryLength));
+            }
+            else {
+                failureSummaries.push(summary);
+            }
+        }
+        if (refinedKind === 'tool_use') {
+            const status = extractToolStatus(entry);
+            const toolSummary = toolName
+                ? (status ? `${toolName} (${status})` : toolName)
+                : (status ? `unknown_tool (${status})` : 'unknown_tool');
+            toolUseSummaries.push(truncateSummary(toolSummary, maxSummaryLength));
+        }
+        if (refinedKind === 'user_intent' && userIntentText === null) {
+            userIntentText = truncateSummary(entry.summary, maxSummaryLength);
+        }
+    }
+    if (failureSummaries.length === 0 && timeline.length > 0) {
+        refinementNotes.push('no_failure_evidence');
+    }
+    if (fullTrace.sanitizationNotes.length > 0) {
+        refinementNotes.push('sanitized_input_present');
+    }
+    if (fullTrace.ambiguityNotes.length > 0) {
+        refinementNotes.push('source_trace_ambiguous');
+    }
+    let truncatedKeyEvents = keyEvents;
+    if (keyEvents.length > maxKeyEvents) {
+        truncatedKeyEvents = keyEvents.slice(0, maxKeyEvents);
+        refinementNotes.push(`truncated_key_events: ${keyEvents.length} total, kept ${maxKeyEvents}`);
+    }
+    const failureSummary = failureSummaries.length > 0
+        ? truncateSummary(failureSummaries.join('; '), maxSummaryLength)
+        : null;
+    return {
+        sourceTaskId: fullTrace.sourceTaskId,
+        sourcePainId: fullTrace.sourcePainId,
+        sourceRunIds: [...fullTrace.sourceRunIds],
+        evidenceRefs,
+        keyEvents: truncatedKeyEvents,
+        failureSummary,
+        toolUseSummary: toolUseSummaries,
+        userIntentSummary: userIntentText,
+        ambiguityNotes: [...fullTrace.ambiguityNotes],
+        sanitizationNotes: [...fullTrace.sanitizationNotes],
+        refinementNotes,
+    };
+}
+//# sourceMappingURL=trace-refiner.js.map

package/dist/runtime-v2/trace-refiner.js.map

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

package/dist/runtime-v2/types/artifact-lineage.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Artifact lineage types — pure data interfaces for artifact tracking.
+ * Extracted from openclaw-plugin nocturnal-artifact-lineage.ts (PRI-51).
+ */
+export type ArtifactKind = 'behavioral-sample' | 'rule-implementation-candidate';
+export interface ArtifactLineageRecord {
+    artifactKind: ArtifactKind;
+    artifactId: string;
+    principleId: string;
+    ruleId: string | null;
+    sessionId: string;
+    sourceSnapshotRef: string;
+    sourcePainIds: string[];
+    sourceGateBlockIds: string[];
+    storagePath: string;
+    implementationId: string | null;
+    createdAt: string;
+}
+//# sourceMappingURL=artifact-lineage.d.ts.map

package/dist/runtime-v2/types/artifact-lineage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifact-lineage.d.ts","sourceRoot":"","sources":["../../../src/runtime-v2/types/artifact-lineage.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,MAAM,YAAY,GAAG,mBAAmB,GAAG,+BAA+B,CAAC;AAEjF,MAAM,WAAW,qBAAqB;IACpC,YAAY,EAAE,YAAY,CAAC;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,kBAAkB,EAAE,MAAM,EAAE,CAAC;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,SAAS,EAAE,MAAM,CAAC;CACnB"}

package/dist/runtime-v2/types/artifact-lineage.js

@@ -0,0 +1,6 @@
+/**
+ * Artifact lineage types — pure data interfaces for artifact tracking.
+ * Extracted from openclaw-plugin nocturnal-artifact-lineage.ts (PRI-51).
+ */
+export {};
+//# sourceMappingURL=artifact-lineage.js.map

package/dist/runtime-v2/types/artifact-lineage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifact-lineage.js","sourceRoot":"","sources":["../../../src/runtime-v2/types/artifact-lineage.ts"],"names":[],"mappings":"AAAA;;;GAGG"}