@cogitator-ai/types 0.1.0 → 0.4.0

package/dist/prompt-optimization.d.ts

@@ -0,0 +1,229 @@
+import type { Message, ToolCall } from './message';
+import type { ExecutionTrace, TraceQuery, TraceStoreStats } from './learning';
+export type ABTestVariant = 'control' | 'treatment';
+export type ABTestStatus = 'draft' | 'running' | 'paused' | 'completed' | 'cancelled';
+export type InstructionSource = 'manual' | 'optimization' | 'ab_test' | 'rollback';
+export type AlertType = 'score_drop' | 'latency_spike' | 'error_rate_increase' | 'cost_spike';
+export type AlertSeverity = 'warning' | 'critical';
+export type AlertAction = 'rollback' | 'pause_optimization' | 'alert_only';
+export interface CapturedPrompt {
+    id: string;
+    runId: string;
+    agentId: string;
+    threadId: string;
+    model: string;
+    provider: string;
+    timestamp: Date;
+    systemPrompt: string;
+    messages: Message[];
+    tools?: unknown[];
+    injectedDemos?: string;
+    injectedInsights?: string;
+    temperature?: number;
+    topP?: number;
+    maxTokens?: number;
+    promptTokens: number;
+    response?: {
+        content: string;
+        toolCalls?: ToolCall[];
+        completionTokens: number;
+        finishReason: string;
+        latencyMs: number;
+    };
+    metadata?: Record<string, unknown>;
+}
+export interface PromptQuery {
+    agentId?: string;
+    model?: string;
+    fromDate?: Date;
+    toDate?: Date;
+    hasError?: boolean;
+    minLatency?: number;
+    maxLatency?: number;
+    limit?: number;
+    offset?: number;
+}
+export interface ABTestResults {
+    sampleSize: number;
+    successRate: number;
+    avgScore: number;
+    avgLatency: number;
+    totalCost: number;
+    scores: number[];
+}
+export interface ABTest {
+    id: string;
+    agentId: string;
+    name: string;
+    description?: string;
+    status: ABTestStatus;
+    controlInstructions: string;
+    treatmentInstructions: string;
+    treatmentAllocation: number;
+    minSampleSize: number;
+    maxDuration: number;
+    confidenceLevel: number;
+    metricToOptimize: string;
+    controlResults: ABTestResults;
+    treatmentResults: ABTestResults;
+    createdAt: Date;
+    startedAt?: Date;
+    completedAt?: Date;
+}
+export interface ABTestOutcome {
+    winner: ABTestVariant | null;
+    pValue: number;
+    confidenceInterval: [number, number];
+    effectSize: number;
+    isSignificant: boolean;
+    recommendation: string;
+}
+export interface InstructionVersionMetrics {
+    runCount: number;
+    avgScore: number;
+    successRate: number;
+    avgLatency: number;
+    totalCost: number;
+}
+export interface InstructionVersion {
+    id: string;
+    agentId: string;
+    version: number;
+    instructions: string;
+    source: InstructionSource;
+    sourceId?: string;
+    deployedAt: Date;
+    retiredAt?: Date;
+    metrics: InstructionVersionMetrics;
+    parentVersionId?: string;
+}
+export interface PromptPerformanceMetrics {
+    agentId: string;
+    windowStart: Date;
+    windowEnd: Date;
+    totalRuns: number;
+    successfulRuns: number;
+    failedRuns: number;
+    avgScore: number;
+    minScore: number;
+    maxScore: number;
+    scoreP50: number;
+    scoreP95: number;
+    avgLatency: number;
+    p50Latency: number;
+    p95Latency: number;
+    p99Latency: number;
+    totalCost: number;
+    avgCostPerRun: number;
+    avgInputTokens: number;
+    avgOutputTokens: number;
+}
+export interface DegradationAlert {
+    id: string;
+    agentId: string;
+    type: AlertType;
+    severity: AlertSeverity;
+    currentValue: number;
+    baselineValue: number;
+    threshold: number;
+    percentChange: number;
+    detectedAt: Date;
+    resolvedAt?: Date;
+    autoAction?: AlertAction;
+    actionTaken?: boolean;
+}
+export interface PromptStore {
+    capture(prompt: CapturedPrompt): Promise<void>;
+    get(id: string): Promise<CapturedPrompt | null>;
+    getByRun(runId: string): Promise<CapturedPrompt[]>;
+    query(query: PromptQuery): Promise<CapturedPrompt[]>;
+    delete(id: string): Promise<boolean>;
+    prune(beforeDate: Date): Promise<number>;
+}
+export interface ABTestStore {
+    create(test: Omit<ABTest, 'id' | 'createdAt'>): Promise<ABTest>;
+    get(id: string): Promise<ABTest | null>;
+    getActive(agentId: string): Promise<ABTest | null>;
+    update(id: string, updates: Partial<ABTest>): Promise<ABTest>;
+    recordResult(testId: string, variant: ABTestVariant, score: number, latency: number, cost: number): Promise<void>;
+    list(agentId?: string, status?: ABTestStatus): Promise<ABTest[]>;
+    delete(id: string): Promise<boolean>;
+}
+export interface InstructionVersionStore {
+    save(version: Omit<InstructionVersion, 'id'>): Promise<InstructionVersion>;
+    get(id: string): Promise<InstructionVersion | null>;
+    getCurrent(agentId: string): Promise<InstructionVersion | null>;
+    getHistory(agentId: string, limit?: number): Promise<InstructionVersion[]>;
+    retire(id: string): Promise<void>;
+    updateMetrics(id: string, metrics: Partial<InstructionVersionMetrics>): Promise<void>;
+}
+export type OptimizationRunStatus = 'pending' | 'optimizing' | 'testing' | 'deploying' | 'completed' | 'failed' | 'rolled_back';
+export interface OptimizationRun {
+    id: string;
+    agentId: string;
+    status: OptimizationRunStatus;
+    optimizationResultId?: string;
+    abTestId?: string;
+    abTestOutcome?: ABTestOutcome;
+    deployedVersionId?: string;
+    startedAt: Date;
+    completedAt?: Date;
+    error?: string;
+}
+export interface ABTestingConfig {
+    defaultConfidenceLevel?: number;
+    defaultMinSampleSize?: number;
+    defaultMaxDuration?: number;
+    autoDeployWinner?: boolean;
+}
+export interface MonitoringConfig {
+    windowSize?: number;
+    scoreDropThreshold?: number;
+    latencySpikeThreshold?: number;
+    errorRateThreshold?: number;
+    enableAutoRollback?: boolean;
+    rollbackCooldown?: number;
+}
+export interface AutoOptimizationConfig {
+    enabled?: boolean;
+    triggerAfterRuns?: number;
+    minRunsForOptimization?: number;
+    requireABTest?: boolean;
+    maxOptimizationsPerDay?: number;
+}
+export interface PromptOptimizationConfig {
+    enabled: boolean;
+    capturePrompts?: boolean;
+    promptRetentionDays?: number;
+    abTesting?: ABTestingConfig;
+    monitoring?: MonitoringConfig;
+    autoOptimization?: AutoOptimizationConfig;
+}
+export declare const DEFAULT_PROMPT_OPTIMIZATION_CONFIG: PromptOptimizationConfig;
+export interface PersistentTraceStore {
+    storeTrace(trace: ExecutionTrace): Promise<void>;
+    storeTraceMany(traces: ExecutionTrace[]): Promise<void>;
+    getTrace(id: string): Promise<ExecutionTrace | null>;
+    getTraceByRunId(runId: string): Promise<ExecutionTrace | null>;
+    queryTraces(query: TraceQuery): Promise<ExecutionTrace[]>;
+    getAllTraces(agentId: string): Promise<ExecutionTrace[]>;
+    getDemos(agentId: string, limit?: number): Promise<ExecutionTrace[]>;
+    markAsDemo(id: string): Promise<void>;
+    unmarkAsDemo(id: string): Promise<void>;
+    deleteTrace(id: string): Promise<boolean>;
+    pruneTraces(agentId: string, maxTraces: number): Promise<number>;
+    clearTraces(agentId: string): Promise<void>;
+    getTraceStats(agentId: string): Promise<TraceStoreStats>;
+    connect(): Promise<void>;
+    disconnect(): Promise<void>;
+}
+export interface CombinedPersistentStore extends PersistentTraceStore, Omit<PromptStore, 'get' | 'delete'>, Omit<ABTestStore, 'get' | 'delete'>, Omit<InstructionVersionStore, 'get'> {
+    getPrompt(id: string): Promise<CapturedPrompt | null>;
+    deletePrompt(id: string): Promise<boolean>;
+    getABTest(id: string): Promise<ABTest | null>;
+    deleteABTest(id: string): Promise<boolean>;
+    getVersion(id: string): Promise<InstructionVersion | null>;
+    connect(): Promise<void>;
+    disconnect(): Promise<void>;
+}
+//# sourceMappingURL=prompt-optimization.d.ts.map

package/dist/prompt-optimization.d.ts.map

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

package/dist/prompt-optimization.js

@@ -0,0 +1,27 @@
+export const DEFAULT_PROMPT_OPTIMIZATION_CONFIG = {
+    enabled: false,
+    capturePrompts: true,
+    promptRetentionDays: 30,
+    abTesting: {
+        defaultConfidenceLevel: 0.95,
+        defaultMinSampleSize: 50,
+        defaultMaxDuration: 7 * 24 * 60 * 60 * 1000,
+        autoDeployWinner: false,
+    },
+    monitoring: {
+        windowSize: 60 * 60 * 1000,
+        scoreDropThreshold: 0.15,
+        latencySpikeThreshold: 2.0,
+        errorRateThreshold: 0.1,
+        enableAutoRollback: false,
+        rollbackCooldown: 24 * 60 * 60 * 1000,
+    },
+    autoOptimization: {
+        enabled: false,
+        triggerAfterRuns: 100,
+        minRunsForOptimization: 20,
+        requireABTest: true,
+        maxOptimizationsPerDay: 3,
+    },
+};
+//# sourceMappingURL=prompt-optimization.js.map

package/dist/prompt-optimization.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-optimization.js","sourceRoot":"","sources":["../src/prompt-optimization.ts"],"names":[],"mappings":"AAwQA,MAAM,CAAC,MAAM,kCAAkC,GAA6B;IAC1E,OAAO,EAAE,KAAK;IACd,cAAc,EAAE,IAAI;IACpB,mBAAmB,EAAE,EAAE;IACvB,SAAS,EAAE;QACT,sBAAsB,EAAE,IAAI;QAC5B,oBAAoB,EAAE,EAAE;QACxB,kBAAkB,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI;QAC3C,gBAAgB,EAAE,KAAK;KACxB;IACD,UAAU,EAAE;QACV,UAAU,EAAE,EAAE,GAAG,EAAE,GAAG,IAAI;QAC1B,kBAAkB,EAAE,IAAI;QACxB,qBAAqB,EAAE,GAAG;QAC1B,kBAAkB,EAAE,GAAG;QACvB,kBAAkB,EAAE,KAAK;QACzB,gBAAgB,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI;KACtC;IACD,gBAAgB,EAAE;QAChB,OAAO,EAAE,KAAK;QACd,gBAAgB,EAAE,GAAG;QACrB,sBAAsB,EAAE,EAAE;QAC1B,aAAa,EAAE,IAAI;QACnB,sBAAsB,EAAE,CAAC;KAC1B;CACF,CAAC"}

package/dist/reasoning.d.ts

@@ -0,0 +1,118 @@
+/**
+ * Tree of Thoughts (ToT) reasoning types
+ *
+ * Enables branching reasoning with:
+ * - Multiple thought candidates per step
+ * - Confidence-based branch evaluation
+ * - Beam search exploration
+ * - Backtracking on dead ends
+ */
+import type { Message, ToolResult } from './message';
+export type ExplorationStrategy = 'beam' | 'best-first' | 'dfs';
+export interface ToTConfig {
+    branchFactor: number;
+    beamWidth: number;
+    maxDepth: number;
+    explorationStrategy: ExplorationStrategy;
+    confidenceThreshold: number;
+    terminationConfidence: number;
+    maxTotalNodes: number;
+    maxIterationsPerBranch: number;
+    timeout?: number;
+    onBranchGenerated?: (node: ThoughtNode, branches: ThoughtBranch[]) => void;
+    onBranchEvaluated?: (branch: ThoughtBranch, score: BranchScore) => void;
+    onNodeExplored?: (node: ThoughtNode) => void;
+    onBacktrack?: (from: ThoughtNode, to: ThoughtNode | null) => void;
+}
+export type ProposedActionType = 'tool_call' | 'response' | 'sub_goal';
+export type ProposedAction = {
+    type: 'tool_call';
+    toolName: string;
+    arguments: Record<string, unknown>;
+} | {
+    type: 'response';
+    content: string;
+} | {
+    type: 'sub_goal';
+    goal: string;
+};
+export interface BranchScore {
+    confidence: number;
+    progress: number;
+    novelty: number;
+    composite: number;
+    reasoning: string;
+}
+export interface ThoughtBranch {
+    id: string;
+    parentId: string | null;
+    thought: string;
+    proposedAction: ProposedAction;
+    score?: BranchScore;
+    messagesSnapshot: Message[];
+}
+export type ThoughtNodeStatus = 'pending' | 'exploring' | 'completed' | 'failed' | 'pruned';
+export interface ThoughtNodeResult {
+    toolResult?: ToolResult;
+    response?: string;
+    error?: string;
+}
+export interface ThoughtNode {
+    id: string;
+    parentId: string | null;
+    depth: number;
+    branch: ThoughtBranch;
+    result?: ThoughtNodeResult;
+    messages: Message[];
+    status: ThoughtNodeStatus;
+    cumulativeScore: number;
+    children: string[];
+    createdAt: number;
+    exploredAt?: number;
+}
+export interface ToTStats {
+    totalNodes: number;
+    exploredNodes: number;
+    prunedNodes: number;
+    maxDepthReached: number;
+    backtrackCount: number;
+    duration: number;
+    llmCalls: number;
+    tokenUsage: {
+        input: number;
+        output: number;
+    };
+}
+export interface ThoughtTree {
+    id: string;
+    goal: string;
+    agentId: string;
+    root: ThoughtNode;
+    nodes: Map<string, ThoughtNode>;
+    bestPath: string[];
+    bestScore: number;
+    stats: ToTStats;
+}
+export interface ToTResult {
+    success: boolean;
+    output: string;
+    tree: ThoughtTree;
+    bestPath: ThoughtNode[];
+    stats: ToTStats;
+    runId: string;
+    agentId: string;
+    usage: {
+        inputTokens: number;
+        outputTokens: number;
+        totalTokens: number;
+        cost: number;
+        duration: number;
+    };
+}
+export interface ToTRunOptions {
+    timeout?: number;
+    abortSignal?: AbortSignal;
+    onProgress?: (stats: ToTStats) => void;
+}
+export declare const DEFAULT_TOT_CONFIG: Required<Omit<ToTConfig, 'timeout' | 'onBranchGenerated' | 'onBranchEvaluated' | 'onNodeExplored' | 'onBacktrack'>>;
+//# sourceMappingURL=reasoning.d.ts.map

package/dist/reasoning.d.ts.map

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

package/dist/reasoning.js

@@ -0,0 +1,20 @@
+/**
+ * Tree of Thoughts (ToT) reasoning types
+ *
+ * Enables branching reasoning with:
+ * - Multiple thought candidates per step
+ * - Confidence-based branch evaluation
+ * - Beam search exploration
+ * - Backtracking on dead ends
+ */
+export const DEFAULT_TOT_CONFIG = {
+    branchFactor: 3,
+    beamWidth: 2,
+    maxDepth: 5,
+    explorationStrategy: 'beam',
+    confidenceThreshold: 0.3,
+    terminationConfidence: 0.8,
+    maxTotalNodes: 50,
+    maxIterationsPerBranch: 3,
+};
+//# sourceMappingURL=reasoning.js.map

package/dist/reasoning.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reasoning.js","sourceRoot":"","sources":["../src/reasoning.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAuHH,MAAM,CAAC,MAAM,kBAAkB,GAK3B;IACF,YAAY,EAAE,CAAC;IACf,SAAS,EAAE,CAAC;IACZ,QAAQ,EAAE,CAAC;IACX,mBAAmB,EAAE,MAAM;IAC3B,mBAAmB,EAAE,GAAG;IACxB,qBAAqB,EAAE,GAAG;IAC1B,aAAa,EAAE,EAAE;IACjB,sBAAsB,EAAE,CAAC;CAC1B,CAAC"}

package/dist/reflection.d.ts

@@ -0,0 +1,108 @@
+/**
+ * Reflection types for self-analyzing agents
+ *
+ * Enables agents to:
+ * - Analyze their actions and outcomes
+ * - Extract learnings from successes and failures
+ * - Store insights for future use
+ * - Improve over time
+ */
+export type ReflectionActionType = 'tool_call' | 'response' | 'decision' | 'error';
+export type InsightType = 'pattern' | 'mistake' | 'success' | 'tip' | 'warning';
+export interface ReflectionAction {
+    type: ReflectionActionType;
+    toolName?: string;
+    input?: unknown;
+    output?: unknown;
+    error?: string;
+    duration?: number;
+}
+export interface ReflectionAnalysis {
+    wasSuccessful: boolean;
+    confidence: number;
+    reasoning: string;
+    alternativesConsidered?: string[];
+    whatCouldImprove?: string;
+}
+export interface Insight {
+    id: string;
+    type: InsightType;
+    content: string;
+    context: string;
+    confidence: number;
+    usageCount: number;
+    createdAt: Date;
+    lastUsedAt: Date;
+    agentId: string;
+    source: {
+        runId: string;
+        reflectionId: string;
+    };
+}
+export interface Reflection {
+    id: string;
+    runId: string;
+    agentId: string;
+    timestamp: Date;
+    action: ReflectionAction;
+    analysis: ReflectionAnalysis;
+    insights: Insight[];
+    goal?: string;
+    iterationIndex: number;
+}
+export interface ReflectionConfig {
+    enabled: boolean;
+    reflectAfterToolCall?: boolean;
+    reflectAfterError?: boolean;
+    reflectAtEnd?: boolean;
+    storeInsights?: boolean;
+    maxInsightsPerAgent?: number;
+    minConfidenceToStore?: number;
+    useSmallModelForReflection?: boolean;
+    reflectionModel?: string;
+}
+export interface InsightQuery {
+    agentId?: string;
+    types?: InsightType[];
+    minConfidence?: number;
+    limit?: number;
+    context?: string;
+}
+export interface InsightStore {
+    store(insight: Insight): Promise<void>;
+    storeMany(insights: Insight[]): Promise<void>;
+    findRelevant(agentId: string, context: string, limit?: number): Promise<Insight[]>;
+    getAll(agentId: string): Promise<Insight[]>;
+    getById(id: string): Promise<Insight | null>;
+    markUsed(id: string): Promise<void>;
+    prune(agentId: string, maxInsights: number): Promise<number>;
+    delete(id: string): Promise<boolean>;
+    clear(agentId: string): Promise<void>;
+}
+export interface ReflectionResult {
+    reflection: Reflection;
+    shouldAdjustStrategy: boolean;
+    suggestedAction?: string;
+}
+export interface AgentContext {
+    agentId: string;
+    agentName: string;
+    runId: string;
+    threadId: string;
+    goal: string;
+    iterationIndex: number;
+    previousActions: ReflectionAction[];
+    availableTools: string[];
+}
+export interface ReflectionEngineConfig extends ReflectionConfig {
+    insightStore: InsightStore;
+}
+export interface ReflectionSummary {
+    totalReflections: number;
+    successRate: number;
+    averageConfidence: number;
+    topInsights: Insight[];
+    commonMistakes: string[];
+    learnedPatterns: string[];
+}
+//# sourceMappingURL=reflection.d.ts.map

package/dist/reflection.d.ts.map

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

package/dist/reflection.js

@@ -0,0 +1,11 @@
+/**
+ * Reflection types for self-analyzing agents
+ *
+ * Enables agents to:
+ * - Analyze their actions and outcomes
+ * - Extract learnings from successes and failures
+ * - Store insights for future use
+ * - Improve over time
+ */
+export {};
+//# sourceMappingURL=reflection.js.map

package/dist/reflection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reflection.js","sourceRoot":"","sources":["../src/reflection.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG"}

package/dist/runtime.d.ts

@@ -5,6 +5,11 @@ import type { Message, ToolCall, ToolResult } from './message';
 import type { LLMProvider } from './llm';
 import type { MemoryConfig } from './memory';
 import type { SandboxManagerConfig } from './sandbox';
+import type { ReflectionConfig, Reflection, ReflectionSummary } from './reflection';
+import type { GuardrailConfig } from './constitutional';
+import type { CostRoutingConfig } from './cost-routing';
+import type { PromptOptimizationConfig } from './prompt-optimization';
+import type { KnowledgeGraphConfig } from './knowledge-graph';
 export interface CogitatorConfig {
     llm?: {
         defaultProvider?: LLMProvider;
@@ -36,6 +41,16 @@ export interface CogitatorConfig {
     memory?: MemoryConfig;
     /** Sandbox configuration for isolated tool execution */
     sandbox?: SandboxManagerConfig;
+    /** Reflection configuration for self-analyzing agents */
+    reflection?: ReflectionConfig;
+    /** Constitutional AI guardrails configuration */
+    guardrails?: GuardrailConfig;
+    /** Cost-aware model routing configuration */
+    costRouting?: CostRoutingConfig;
+    /** Knowledge graph memory configuration */
+    knowledgeGraph?: KnowledgeGraphConfig;
+    /** Prompt inspection and auto-optimization configuration */
+    promptOptimization?: PromptOptimizationConfig;
 }
 export interface RunOptions {
     input: string;
@@ -65,26 +80,32 @@ export interface RunOptions {
     onRunError?: (error: Error, runId: string) => void;
     /** Callback when a span is created */
     onSpan?: (span: Span) => void;
+    /** Callback when memory operation fails */
+    onMemoryError?: (error: Error, operation: 'save' | 'load') => void;
 }
 export interface RunResult {
-    output: string;
-    structured?: unknown;
-    runId: string;
-    agentId: string;
-    threadId: string;
-    usage: {
-        inputTokens: number;
-        outputTokens: number;
-        totalTokens: number;
-        cost: number;
-        duration: number;
+    readonly output: string;
+    readonly structured?: unknown;
+    readonly runId: string;
+    readonly agentId: string;
+    readonly threadId: string;
+    /** Actual model used (may differ from agent.model if cost routing is enabled) */
+    readonly modelUsed?: string;
+    readonly usage: {
+        readonly inputTokens: number;
+        readonly outputTokens: number;
+        readonly totalTokens: number;
+        readonly cost: number;
+        readonly duration: number;
     };
-    toolCalls: ToolCall[];
-    messages: Message[];
-    trace: {
-        traceId: string;
-        spans: Span[];
+    readonly toolCalls: readonly ToolCall[];
+    readonly messages: readonly Message[];
+    readonly trace: {
+        readonly traceId: string;
+        readonly spans: readonly Span[];
     };
+    readonly reflections?: readonly Reflection[];
+    readonly reflectionSummary?: ReflectionSummary;
 }
 export interface Span {
     id: string;

package/dist/runtime.d.ts.map

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