@principles/core 1.73.0

package/dist/runtime-v2/pain-chain-read-model.js

@@ -0,0 +1,293 @@
+/**
+ * PainChainReadModel — shared core read model for pain-to-principle chain inspection.
+ *
+ * Encapsulates the complete pain→task→run→artifact→candidate→ledger traversal
+ * so CLI commands (trace, health) do not duplicate SQL/ledger logic.
+ *
+ * PRI-14: Extract shared Runtime V2 pain-chain read model.
+ */
+import * as path from 'path';
+import { RuntimeStateManager } from './store/runtime-state-manager.js';
+import { loadLedger } from '../principle-tree-ledger.js';
+import { mapFailureCategory, isPDErrorCategory } from './error-categories.js';
+import { createDiagnosticianTaskId } from './pain-signal-bridge.js';
+function parseTaskErrorCategory(task) {
+    if (!task.lastError)
+        return null;
+    if (isPDErrorCategory(task.lastError))
+        return task.lastError;
+    try {
+        const parsed = JSON.parse(task.lastError);
+        return parsed.category ?? null;
+    }
+    catch {
+        return null;
+    }
+}
+export class PainChainReadModel {
+    workspaceDir;
+    stateManager = null;
+    injectedStateManager;
+    ownsStateManager = false;
+    constructor(opts) {
+        this.workspaceDir = opts.workspaceDir;
+        this.injectedStateManager = opts.stateManager ?? null;
+        if (this.injectedStateManager) {
+            this.stateManager = this.injectedStateManager;
+            this.ownsStateManager = false;
+        }
+    }
+    async getTotalTaskCount() {
+        try {
+            const manager = await this.getStateManager();
+            const db = manager.connection.getDb();
+            const row = db.prepare('SELECT COUNT(*) as count FROM tasks').get();
+            return row?.count ?? 0;
+        }
+        catch {
+            return 0;
+        }
+    }
+    initialized = false;
+    async getStateManager() {
+        if (!this.stateManager) {
+            this.stateManager = new RuntimeStateManager({ workspaceDir: this.workspaceDir });
+            this.ownsStateManager = true;
+        }
+        if (!this.initialized) {
+            await this.stateManager.initialize();
+            this.initialized = true;
+        }
+        return this.stateManager;
+    }
+    async traceByPainId(painId) {
+        const taskId = createDiagnosticianTaskId(painId);
+        const checkedAt = new Date().toISOString();
+        const missingLinks = [];
+        try {
+            const manager = await this.getStateManager();
+            const task = await manager.getTask(taskId);
+            if (!task) {
+                return {
+                    painId,
+                    taskId,
+                    status: 'not_found',
+                    failureCategory: 'runtime_unavailable',
+                    checkedAt,
+                    missingLinks: ['task'],
+                    candidateIds: [],
+                    ledgerEntryIds: [],
+                    latencyMs: {},
+                };
+            }
+            const runs = await manager.getRunsByTask(taskId);
+            const latestRun = runs.length > 0
+                ? runs.reduce((a, b) => (a.startedAt > b.startedAt ? a : b))
+                : undefined;
+            let artifactId = undefined;
+            let artifactCreatedAt = undefined;
+            if (latestRun) {
+                const runRows = manager.connection.getDb()
+                    .prepare('SELECT artifact_id, created_at FROM artifacts WHERE run_id = ? ORDER BY created_at DESC LIMIT 1')
+                    .get(latestRun.runId);
+                if (runRows) {
+                    artifactId = runRows.artifact_id;
+                    artifactCreatedAt = runRows.created_at;
+                }
+            }
+            const candidates = await manager.getCandidatesByTaskId(taskId);
+            const ledgerStateDir = path.join(this.workspaceDir, '.state');
+            const ledger = loadLedger(ledgerStateDir);
+            const principleEntries = Object.values(ledger.tree.principles);
+            const candidateToLedgerEntry = new Map();
+            for (const entry of principleEntries) {
+                const e = entry;
+                for (const cid of e.derivedFromPainIds ?? []) {
+                    candidateToLedgerEntry.set(cid, e.id);
+                }
+            }
+            const candidateIds = candidates.map(c => c.candidateId);
+            const ledgerEntryIds = [];
+            for (const c of candidates) {
+                const entryId = candidateToLedgerEntry.get(c.candidateId);
+                if (entryId) {
+                    ledgerEntryIds.push(entryId);
+                }
+                else if (c.status === 'consumed') {
+                    missingLinks.push(`candidate:${c.candidateId} consumed but missing from ledger`);
+                }
+            }
+            const latencyMs = {};
+            if (task.createdAt && latestRun?.startedAt) {
+                latencyMs.painToTask = Math.max(0, new Date(latestRun.startedAt).getTime() - new Date(task.createdAt).getTime());
+            }
+            if (latestRun?.startedAt && latestRun?.endedAt) {
+                latencyMs.taskToRun = Math.max(0, new Date(latestRun.endedAt).getTime() - new Date(latestRun.startedAt).getTime());
+            }
+            if (latestRun?.endedAt && artifactCreatedAt) {
+                latencyMs.runToArtifact = Math.max(0, new Date(artifactCreatedAt).getTime() - new Date(latestRun.endedAt).getTime());
+            }
+            if (artifactCreatedAt && candidates.length > 0) {
+                const [firstCandidate] = candidates;
+                if (firstCandidate) {
+                    latencyMs.artifactToCandidate = Math.max(0, new Date(firstCandidate.createdAt).getTime() - new Date(artifactCreatedAt).getTime());
+                }
+            }
+            if (candidates.length > 0 && ledgerEntryIds.length > 0) {
+                const [lastCandidate] = candidates.slice(-1);
+                if (lastCandidate) {
+                    let earliestLedgerAt = undefined;
+                    for (const entry of principleEntries) {
+                        const e = entry;
+                        if (ledgerEntryIds.includes(e.id) && e.createdAt) {
+                            if (!earliestLedgerAt || e.createdAt < earliestLedgerAt)
+                                earliestLedgerAt = e.createdAt;
+                        }
+                    }
+                    if (earliestLedgerAt) {
+                        latencyMs.candidateToLedger = Math.max(0, new Date(earliestLedgerAt).getTime() - new Date(lastCandidate.createdAt).getTime());
+                    }
+                }
+            }
+            let status = task.status;
+            let failureCategory = null;
+            if (task.status === 'failed') {
+                const errorCat = parseTaskErrorCategory(task);
+                failureCategory = mapFailureCategory(errorCat) ?? 'runtime_unavailable';
+            }
+            else if (task.status === 'succeeded') {
+                if (candidateIds.length === 0) {
+                    status = 'failed';
+                    failureCategory = 'candidate_missing';
+                    missingLinks.push('No candidates generated for succeeded task');
+                }
+                else if (ledgerEntryIds.length === 0) {
+                    status = 'degraded';
+                    failureCategory = 'ledger_write_failed';
+                    missingLinks.push('Candidates present but no matching ledger entries');
+                }
+            }
+            return {
+                painId,
+                taskId,
+                runId: latestRun?.runId,
+                artifactId,
+                candidateIds,
+                ledgerEntryIds,
+                status,
+                latencyMs,
+                failureCategory,
+                checkedAt,
+                missingLinks,
+            };
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            const isConfigError = /disk|unavailable|config|api[_\s]?key|not found in env/i.test(message);
+            return {
+                painId,
+                taskId,
+                status: 'error',
+                failureCategory: isConfigError ? 'config_missing' : 'runtime_unavailable',
+                checkedAt,
+                missingLinks: [isConfigError ? 'state_manager_init' : 'internal_error'],
+                candidateIds: [],
+                ledgerEntryIds: [],
+                latencyMs: {},
+            };
+        }
+    }
+    async getLastSuccessfulChain() {
+        try {
+            const manager = await this.getStateManager();
+            const db = manager.connection.getDb();
+            const lastSucceeded = db.prepare("SELECT task_id, input_ref, created_at FROM tasks WHERE status = 'succeeded' ORDER BY updated_at DESC LIMIT 1").get();
+            if (!lastSucceeded)
+                return undefined;
+            const painId = lastSucceeded.input_ref ?? lastSucceeded.task_id.replace('diagnosis_', '');
+            const taskId = lastSucceeded.task_id;
+            const run = db.prepare("SELECT run_id, started_at, ended_at FROM runs WHERE task_id = ? AND execution_status = 'succeeded' ORDER BY started_at DESC LIMIT 1").get(taskId);
+            if (!run)
+                return undefined;
+            const artifacts = db.prepare("SELECT artifact_id, created_at FROM artifacts WHERE run_id = ? ORDER BY created_at DESC LIMIT 1").get(run.run_id);
+            if (!artifacts)
+                return undefined;
+            const candidates = await manager.getCandidatesByTaskId(taskId);
+            if (candidates.length === 0)
+                return undefined;
+            const ledgerStateDir = path.join(this.workspaceDir, '.state');
+            const ledger = loadLedger(ledgerStateDir);
+            const principleEntries = Object.values(ledger.tree.principles);
+            const candidateToLedgerEntry = new Map();
+            for (const entry of principleEntries) {
+                const e = entry;
+                for (const cid of e.derivedFromPainIds ?? []) {
+                    candidateToLedgerEntry.set(cid, e.id);
+                }
+            }
+            const candidateIds = candidates.map(c => c.candidateId);
+            const ledgerEntryIds = [];
+            for (const c of candidates) {
+                const entryId = candidateToLedgerEntry.get(c.candidateId);
+                if (entryId)
+                    ledgerEntryIds.push(entryId);
+            }
+            const latencyMs = {};
+            if (lastSucceeded.created_at && run.started_at) {
+                latencyMs.painToTask = Math.max(0, new Date(run.started_at).getTime() - new Date(lastSucceeded.created_at).getTime());
+            }
+            if (run.started_at && run.ended_at) {
+                latencyMs.taskToRun = Math.max(0, new Date(run.ended_at).getTime() - new Date(run.started_at).getTime());
+            }
+            if (run.ended_at && artifacts.created_at) {
+                latencyMs.runToArtifact = Math.max(0, new Date(artifacts.created_at).getTime() - new Date(run.ended_at).getTime());
+            }
+            if (artifacts.created_at && candidates.length > 0) {
+                const [firstCandidate] = candidates;
+                if (firstCandidate) {
+                    latencyMs.artifactToCandidate = Math.max(0, new Date(firstCandidate.createdAt).getTime() - new Date(artifacts.created_at).getTime());
+                }
+            }
+            if (candidates.length > 0 && ledgerEntryIds.length > 0) {
+                const [lastCandidate] = candidates.slice(-1);
+                if (lastCandidate) {
+                    let earliestLedgerAt = undefined;
+                    for (const entry of principleEntries) {
+                        const e = entry;
+                        if (ledgerEntryIds.includes(e.id) && e.createdAt) {
+                            if (!earliestLedgerAt || e.createdAt < earliestLedgerAt)
+                                earliestLedgerAt = e.createdAt;
+                        }
+                    }
+                    if (earliestLedgerAt) {
+                        latencyMs.candidateToLedger = Math.max(0, new Date(earliestLedgerAt).getTime() - new Date(lastCandidate.createdAt).getTime());
+                    }
+                }
+            }
+            return {
+                painId,
+                taskId,
+                runId: run.run_id,
+                artifactId: artifacts.artifact_id,
+                candidateIds,
+                ledgerEntryIds,
+                status: 'succeeded',
+                latencyMs,
+                failureCategory: null,
+                checkedAt: new Date().toISOString(),
+                missingLinks: [],
+            };
+        }
+        catch {
+            return undefined;
+        }
+    }
+    async close() {
+        if (this.stateManager && this.ownsStateManager) {
+            await this.stateManager.close();
+        }
+        this.stateManager = null;
+        this.initialized = false;
+    }
+}
+//# sourceMappingURL=pain-chain-read-model.js.map

package/dist/runtime-v2/pain-chain-read-model.js.map

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

package/dist/runtime-v2/pain-flood-simulation.d.ts

@@ -0,0 +1,62 @@
+export type PainFloodScenarioName = 'identical_flood' | 'similar_flood' | 'duplicate_submission' | 'tool_failure_flood' | 'stress_test';
+export interface PainFloodScenarioExpectation {
+    maxTaskRatio: number;
+    maxTaskCount?: number;
+    description: string;
+}
+export declare const FLOOD_SCENARIO_EXPECTATIONS: Record<PainFloodScenarioName, PainFloodScenarioExpectation>;
+export interface PainFloodStage {
+    scenarioName: PainFloodScenarioName;
+    status: 'passed' | 'failed' | 'skipped';
+    inputCount: number;
+    acceptedCount: number;
+    skippedCount: number;
+    failedCount: number;
+    taskCount: number;
+    candidateCount: number;
+    reason?: string;
+    evidence?: Record<string, unknown>;
+}
+export interface PainFloodSimulationSummary {
+    status: 'healthy' | 'degraded' | 'error';
+    workspaceMode: 'temp' | 'explicit_workspace';
+    generatedAt: string;
+    inputPainCount: number;
+    acceptedPainCount: number;
+    skippedDuplicateCount: number;
+    failedCount: number;
+    candidateCount: number;
+    taskCount: number;
+    maxEvidencePreviewLength: number;
+    contextBudgetSummary: string;
+    stages: PainFloodStage[];
+    reason?: string;
+    nextAction?: string;
+    recommendedNextIssue?: string;
+}
+export interface PainFloodSimulationOptions {
+    workspaceDir: string;
+    workspaceMode: 'temp' | 'explicit_workspace';
+    identicalCount?: number;
+    similarCount?: number;
+    stressCount?: number;
+}
+export declare function safeStringify(value: unknown): string;
+export declare function truncateReason(reason: string): string;
+export declare function boundedFloodEvidence(evidence: Record<string, unknown>): Record<string, unknown>;
+export declare function computeFloodTotals(stages: PainFloodStage[]): {
+    inputPainCount: number;
+    acceptedPainCount: number;
+    skippedDuplicateCount: number;
+    failedCount: number;
+    candidateCount: number;
+    taskCount: number;
+};
+export declare function computeFloodStatus(stages: PainFloodStage[]): 'healthy' | 'degraded' | 'error';
+export declare function computeMaxAllowedTasks(painSignals: {
+    painId: string;
+}[], expectation: PainFloodScenarioExpectation): number;
+export declare function formatContextBudgetSummary(maxPreviewLength: number): string;
+export declare function recommendFloodNextIssue(stages: PainFloodStage[]): string | undefined;
+export declare function maxEvidencePreviewLength(stages: PainFloodStage[]): number;
+//# sourceMappingURL=pain-flood-simulation.d.ts.map

package/dist/runtime-v2/pain-flood-simulation.d.ts.map

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

package/dist/runtime-v2/pain-flood-simulation.js

@@ -0,0 +1,152 @@
+export const FLOOD_SCENARIO_EXPECTATIONS = {
+    identical_flood: { maxTaskRatio: 1, maxTaskCount: 1, description: 'All identical pains should produce at most 1 task' },
+    similar_flood: { maxTaskRatio: 1, description: 'Each unique pain should produce its own task' },
+    duplicate_submission: { maxTaskRatio: 0.5, maxTaskCount: 1, description: 'Duplicate pain pair should produce at most 1 task' },
+    tool_failure_flood: { maxTaskRatio: 0.2, maxTaskCount: 1, description: 'Identical tool failures should produce at most 1 task' },
+    stress_test: { maxTaskRatio: 1, description: 'Mixed unique/duplicate pains should deduplicate correctly' },
+};
+const MAX_REASON_LENGTH = 500;
+const MAX_EVIDENCE_JSON_LENGTH = 2000;
+export function safeStringify(value) {
+    try {
+        if (typeof value === 'bigint')
+            return `${value}n`;
+        if (value === undefined)
+            return 'undefined';
+        if (value === null)
+            return 'null';
+        if (typeof value === 'object' && value !== null) {
+            const proto = Object.getPrototypeOf(value);
+            if (proto === null) {
+                return JSON.stringify(Object.fromEntries(Object.entries(value)));
+            }
+        }
+        return JSON.stringify(value);
+    }
+    catch {
+        return '[unserializable]';
+    }
+}
+export function truncateReason(reason) {
+    if (reason.length <= MAX_REASON_LENGTH)
+        return reason;
+    return reason.slice(0, MAX_REASON_LENGTH - 3) + '...';
+}
+export function boundedFloodEvidence(evidence) {
+    let json = null;
+    try {
+        json = JSON.stringify(evidence);
+    }
+    catch {
+        // circular or BigInt — fall through to truncation
+    }
+    if (json !== null && json.length <= MAX_EVIDENCE_JSON_LENGTH)
+        return evidence;
+    const keys = Object.keys(evidence);
+    const truncated = {};
+    let budget = MAX_EVIDENCE_JSON_LENGTH - 2;
+    let first = true;
+    for (const key of keys) {
+        const comma = first ? 0 : 1;
+        const entry = `"${key}":${safeStringify(evidence[key])}`;
+        if (entry.length + comma <= budget) {
+            truncated[key] = safeStringify(evidence[key]);
+            budget -= entry.length + comma;
+            first = false;
+        }
+        else {
+            truncated[key] = '[truncated]';
+            break;
+        }
+    }
+    const truncatedJson = JSON.stringify(truncated);
+    if (truncatedJson.length > MAX_EVIDENCE_JSON_LENGTH) {
+        const safeKeys = keys.slice(0, 3).map(k => k.length > 50 ? k.slice(0, 47) + '...' : k);
+        return { _truncated: true, keys: safeKeys };
+    }
+    return truncated;
+}
+export function computeFloodTotals(stages) {
+    let inputPainCount = 0;
+    let acceptedPainCount = 0;
+    let skippedDuplicateCount = 0;
+    let failedCount = 0;
+    let candidateCount = 0;
+    let taskCount = 0;
+    for (const stage of stages) {
+        if (stage.status === 'skipped')
+            continue;
+        inputPainCount += stage.inputCount;
+        acceptedPainCount += stage.acceptedCount;
+        skippedDuplicateCount += stage.skippedCount;
+        failedCount += stage.failedCount;
+        candidateCount += stage.candidateCount;
+        taskCount += stage.taskCount;
+    }
+    return {
+        inputPainCount,
+        acceptedPainCount,
+        skippedDuplicateCount,
+        failedCount,
+        candidateCount,
+        taskCount,
+    };
+}
+export function computeFloodStatus(stages) {
+    const hasFailed = stages.some(s => s.status === 'failed');
+    const hasPassed = stages.some(s => s.status === 'passed');
+    if (!hasPassed)
+        return 'error';
+    if (hasFailed)
+        return 'degraded';
+    return 'healthy';
+}
+export function computeMaxAllowedTasks(painSignals, expectation) {
+    const distinctPainIdCount = new Set(painSignals.map(s => s.painId)).size;
+    const maxFromRatio = Math.ceil(distinctPainIdCount * expectation.maxTaskRatio);
+    return expectation.maxTaskCount != null
+        ? Math.min(maxFromRatio, expectation.maxTaskCount)
+        : maxFromRatio;
+}
+export function formatContextBudgetSummary(maxPreviewLength) {
+    if (maxPreviewLength <= 0)
+        return 'no evidence produced';
+    if (maxPreviewLength <= 100)
+        return `bounded (max ${maxPreviewLength} chars)`;
+    if (maxPreviewLength <= 500)
+        return `moderate (max ${maxPreviewLength} chars)`;
+    if (maxPreviewLength <= 2000)
+        return `large (max ${maxPreviewLength} chars)`;
+    return `unbounded (max ${maxPreviewLength} chars) — exceeds budget recommendation`;
+}
+export function recommendFloodNextIssue(stages) {
+    const firstFailed = stages.find(s => s.status === 'failed');
+    if (!firstFailed)
+        return undefined;
+    switch (firstFailed.scenarioName) {
+        case 'identical_flood':
+            return 'PRI-208: Identical pain dedup failed — check PainSignalBridge idempotent upsert logic';
+        case 'similar_flood':
+            return 'PRI-208: Similar pain flood caused unbounded task creation — check dedup and evidence budget';
+        case 'duplicate_submission':
+            return 'PRI-208: Duplicate pain submission not skipped — check buildExistingResult path';
+        case 'tool_failure_flood':
+            return 'PRI-208: Tool failure flood dedup failed — check error-hash-based dedup logic';
+        case 'stress_test':
+            return 'PRI-208: Stress test produced unbounded evidence — check context budget enforcement';
+        default:
+            return undefined;
+    }
+}
+export function maxEvidencePreviewLength(stages) {
+    let max = 0;
+    for (const stage of stages) {
+        if (stage.evidence) {
+            const json = JSON.stringify(stage.evidence);
+            if (json.length > max)
+                max = json.length;
+        }
+    }
+    return max;
+}
+//# sourceMappingURL=pain-flood-simulation.js.map

package/dist/runtime-v2/pain-flood-simulation.js.map

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

package/dist/runtime-v2/pain-signal-bridge.d.ts

@@ -0,0 +1,72 @@
+import type { RuntimeStateManager } from './store/runtime-state-manager.js';
+import type { DiagnosticianRunner } from './runner/diagnostician-runner.js';
+import type { CandidateIntakeService } from './candidate-intake-service.js';
+import type { LedgerAdapter } from './candidate-intake.js';
+import type { RunnerResultStatus } from './runner/runner-result.js';
+import type { PDErrorCategory } from './error-categories.js';
+import type { CandidateAdmissionResult, PainProvenance } from './admission-gate.js';
+export type { PainProvenance };
+export declare const MAX_EVIDENCE_ENTRIES = 4;
+export declare const MAX_EVIDENCE_NOTE_CHARS = 200;
+export interface PainEvidenceEntry {
+    sourceRef: string;
+    note: string;
+}
+export interface PainDetectedData {
+    painId: string;
+    painType: 'tool_failure' | 'subagent_error' | 'user_frustration';
+    source: string;
+    reason: string;
+    score?: number;
+    sessionId?: string;
+    agentId?: string;
+    taskId?: string;
+    traceId?: string;
+    provenance?: PainProvenance;
+    evidence?: PainEvidenceEntry[];
+}
+export type PainSignalBridgeStatus = 'succeeded' | 'skipped' | 'failed' | 'retried' | 'degraded';
+export interface PainSignalBridgeResult {
+    status: PainSignalBridgeStatus;
+    painId: string;
+    taskId: string;
+    runnerStatus?: RunnerResultStatus;
+    runId?: string;
+    artifactId?: string;
+    candidateIds: string[];
+    ledgerEntryIds: string[];
+    admissionResults?: CandidateAdmissionResult[];
+    errorCategory?: PDErrorCategory;
+    message?: string;
+}
+export interface PainSignalBridgeOptions {
+    stateManager: RuntimeStateManager;
+    runner: DiagnosticianRunner;
+    intakeService: CandidateIntakeService;
+    ledgerAdapter: LedgerAdapter;
+    owner?: string;
+    autoIntakeEnabled?: boolean;
+    eventEmitter?: {
+        emitTelemetry: (event: {
+            eventType: string;
+            traceId: string;
+            timestamp: string;
+            payload: Record<string, unknown>;
+        }) => void;
+    };
+}
+export declare function createDiagnosticianTaskId(painId: string): string;
+export declare class PainSignalBridge {
+    private readonly stateManager;
+    private readonly runner;
+    private readonly intakeService;
+    private readonly ledgerAdapter;
+    private readonly owner;
+    private readonly autoIntakeEnabled;
+    private readonly eventEmitter?;
+    constructor(opts: PainSignalBridgeOptions);
+    private emitAdmissionEvent;
+    onPainDetected(data: PainDetectedData): Promise<PainSignalBridgeResult>;
+    private buildExistingResult;
+}
+//# sourceMappingURL=pain-signal-bridge.d.ts.map

package/dist/runtime-v2/pain-signal-bridge.d.ts.map

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