atlas-pipeline-mcp 1.0.16 → 1.0.17
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/providers/llm-provider.d.ts +60 -25
- package/dist/providers/llm-provider.d.ts.map +1 -1
- package/dist/providers/llm-provider.js +154 -73
- package/dist/providers/llm-provider.js.map +1 -1
- package/dist/server.js +3 -3
- package/dist/server.js.map +1 -1
- package/dist/tools/context.js.map +1 -1
- package/dist/tools/critique.d.ts.map +1 -1
- package/dist/tools/critique.js +4 -3
- package/dist/tools/critique.js.map +1 -1
- package/dist/tools/decompose.d.ts.map +1 -1
- package/dist/tools/decompose.js +40 -28
- package/dist/tools/decompose.js.map +1 -1
- package/dist/tools/intent.d.ts.map +1 -1
- package/dist/tools/intent.js +33 -20
- package/dist/tools/intent.js.map +1 -1
- package/dist/tools/optimize.d.ts.map +1 -1
- package/dist/tools/optimize.js +18 -3
- package/dist/tools/optimize.js.map +1 -1
- package/dist/tools/variants.d.ts.map +1 -1
- package/dist/tools/variants.js +41 -29
- package/dist/tools/variants.js.map +1 -1
- package/dist/types.d.ts +77 -20
- package/dist/types.d.ts.map +1 -1
- package/dist/types.js +21 -0
- package/dist/types.js.map +1 -1
- package/dist/utils.d.ts +108 -12
- package/dist/utils.d.ts.map +1 -1
- package/dist/utils.js +302 -68
- package/dist/utils.js.map +1 -1
- package/package.json +1 -2
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"variants.js","sourceRoot":"","sources":["../../src/tools/variants.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAQH,OAAO,EAAE,
|
|
1
|
+
{"version":3,"file":"variants.js","sourceRoot":"","sources":["../../src/tools/variants.ts"],"names":[],"mappings":"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"}
|
package/dist/types.d.ts
CHANGED
|
@@ -3,20 +3,55 @@
|
|
|
3
3
|
*
|
|
4
4
|
* This module defines all shared interfaces and types used across the
|
|
5
5
|
* multi-stage AI pipeline. Types are organized by domain concern.
|
|
6
|
+
*
|
|
7
|
+
* Design Principles:
|
|
8
|
+
* - Branded types for domain-specific values (IDs, scores)
|
|
9
|
+
* - Strict readonly types where mutation is not expected
|
|
10
|
+
* - Comprehensive Zod schemas for runtime validation
|
|
11
|
+
* - Type guards for safe narrowing
|
|
12
|
+
*
|
|
13
|
+
* @module types
|
|
14
|
+
* @version 2.0.0
|
|
6
15
|
*/
|
|
7
16
|
import { z } from 'zod';
|
|
17
|
+
/** Brand type for creating nominal types */
|
|
18
|
+
declare const brand: unique symbol;
|
|
19
|
+
type Brand<T, B> = T & {
|
|
20
|
+
readonly [brand]: B;
|
|
21
|
+
};
|
|
22
|
+
/** Branded type for variant IDs */
|
|
23
|
+
export type VariantId = Brand<string, 'VariantId'>;
|
|
24
|
+
/** Branded type for task IDs */
|
|
25
|
+
export type TaskId = Brand<string, 'TaskId'>;
|
|
26
|
+
/** Branded type for session IDs */
|
|
27
|
+
export type SessionId = Brand<string, 'SessionId'>;
|
|
28
|
+
/** Score between 0 and 100 */
|
|
29
|
+
export type Score = Brand<number, 'Score'>;
|
|
30
|
+
/** Confidence value between 0 and 1 */
|
|
31
|
+
export type Confidence = Brand<number, 'Confidence'>;
|
|
32
|
+
/** Helper to create a Score (clamped 0-100) */
|
|
33
|
+
export declare function createScore(value: number): Score;
|
|
34
|
+
/** Helper to create a Confidence (clamped 0-1) */
|
|
35
|
+
export declare function createConfidence(value: number): Confidence;
|
|
36
|
+
/** Helper to create a SessionId */
|
|
37
|
+
export declare function createSessionId(value: string): SessionId;
|
|
8
38
|
/**
|
|
9
39
|
* Represents the user's original request to the pipeline
|
|
40
|
+
* @immutable - Should not be mutated after creation
|
|
10
41
|
*/
|
|
11
42
|
export interface PipelineRequest {
|
|
12
43
|
/** The raw user query or instruction */
|
|
13
|
-
query: string;
|
|
44
|
+
readonly query: string;
|
|
14
45
|
/** Optional repository path for git operations */
|
|
15
|
-
repoPath?: string;
|
|
46
|
+
readonly repoPath?: string;
|
|
16
47
|
/** Additional context provided by the user */
|
|
17
|
-
userContext?: Record<string, unknown
|
|
48
|
+
readonly userContext?: Readonly<Record<string, unknown>>;
|
|
18
49
|
/** Session identifier for tracking */
|
|
19
|
-
sessionId?:
|
|
50
|
+
readonly sessionId?: SessionId;
|
|
51
|
+
/** Request timestamp for metrics */
|
|
52
|
+
readonly timestamp?: string;
|
|
53
|
+
/** Request priority (affects queue ordering) */
|
|
54
|
+
readonly priority?: 'low' | 'normal' | 'high';
|
|
20
55
|
}
|
|
21
56
|
/**
|
|
22
57
|
* The final output of the pipeline after all stages complete
|
|
@@ -33,31 +68,48 @@ export interface PipelineResponse {
|
|
|
33
68
|
}
|
|
34
69
|
/**
|
|
35
70
|
* Metadata collected during pipeline execution
|
|
71
|
+
* @immutable - Frozen after pipeline completion
|
|
36
72
|
*/
|
|
37
73
|
export interface PipelineMetadata {
|
|
38
74
|
/** Total execution time in milliseconds */
|
|
39
|
-
executionTimeMs: number;
|
|
75
|
+
readonly executionTimeMs: number;
|
|
40
76
|
/** Results from each pipeline stage */
|
|
41
|
-
stages: StageResult[];
|
|
77
|
+
readonly stages: readonly StageResult[];
|
|
42
78
|
/** The model used for generation */
|
|
43
|
-
model: string;
|
|
79
|
+
readonly model: string;
|
|
80
|
+
/** Provider used (ollama, openai, anthropic, auto) */
|
|
81
|
+
readonly provider?: string;
|
|
44
82
|
/** Timestamp when processing started */
|
|
45
|
-
startedAt: string;
|
|
83
|
+
readonly startedAt: string;
|
|
46
84
|
/** Timestamp when processing completed */
|
|
47
|
-
completedAt: string;
|
|
85
|
+
readonly completedAt: string;
|
|
86
|
+
/** Total tokens used (if available) */
|
|
87
|
+
readonly tokensUsed?: {
|
|
88
|
+
readonly prompt: number;
|
|
89
|
+
readonly completion: number;
|
|
90
|
+
readonly total: number;
|
|
91
|
+
};
|
|
92
|
+
/** Cache hit information */
|
|
93
|
+
readonly cacheHits?: number;
|
|
48
94
|
}
|
|
49
95
|
/**
|
|
50
96
|
* Result from a single pipeline stage
|
|
51
97
|
*/
|
|
52
|
-
export interface StageResult {
|
|
98
|
+
export interface StageResult<T = unknown> {
|
|
53
99
|
/** Name of the stage */
|
|
54
|
-
name: StageName;
|
|
100
|
+
readonly name: StageName;
|
|
55
101
|
/** Whether this stage succeeded */
|
|
56
|
-
success: boolean;
|
|
102
|
+
readonly success: boolean;
|
|
57
103
|
/** Execution time for this stage in milliseconds */
|
|
58
|
-
durationMs: number;
|
|
104
|
+
readonly durationMs: number;
|
|
59
105
|
/** Optional output data from the stage */
|
|
60
|
-
output?:
|
|
106
|
+
readonly output?: T;
|
|
107
|
+
/** Error message if stage failed */
|
|
108
|
+
readonly error?: string;
|
|
109
|
+
/** Whether result came from cache */
|
|
110
|
+
readonly cached?: boolean;
|
|
111
|
+
/** Retry count if retries were needed */
|
|
112
|
+
readonly retries?: number;
|
|
61
113
|
}
|
|
62
114
|
/**
|
|
63
115
|
* Names of all pipeline stages
|
|
@@ -81,17 +133,21 @@ export interface PipelineError {
|
|
|
81
133
|
*/
|
|
82
134
|
export interface IntentAnalysis {
|
|
83
135
|
/** Primary intent category */
|
|
84
|
-
primaryIntent: IntentType;
|
|
136
|
+
readonly primaryIntent: IntentType;
|
|
137
|
+
/** Secondary intent if detected */
|
|
138
|
+
readonly secondaryIntent?: IntentType;
|
|
85
139
|
/** Confidence score from 0 to 1 */
|
|
86
|
-
confidence:
|
|
140
|
+
readonly confidence: Confidence;
|
|
87
141
|
/** Extracted entities from the query */
|
|
88
|
-
entities: ExtractedEntity[];
|
|
142
|
+
readonly entities: readonly ExtractedEntity[];
|
|
89
143
|
/** Keywords identified in the query */
|
|
90
|
-
keywords: string[];
|
|
144
|
+
readonly keywords: readonly string[];
|
|
91
145
|
/** Whether the query requires clarification */
|
|
92
|
-
requiresClarification: boolean;
|
|
146
|
+
readonly requiresClarification: boolean;
|
|
93
147
|
/** Suggested clarifying questions if needed */
|
|
94
|
-
clarifyingQuestions?: string[];
|
|
148
|
+
readonly clarifyingQuestions?: readonly string[];
|
|
149
|
+
/** Raw query for reference */
|
|
150
|
+
readonly rawQuery?: string;
|
|
95
151
|
}
|
|
96
152
|
/**
|
|
97
153
|
* Types of intents the system can classify
|
|
@@ -444,4 +500,5 @@ export interface ServerConfig {
|
|
|
444
500
|
/** Enable CORS */
|
|
445
501
|
corsEnabled: boolean;
|
|
446
502
|
}
|
|
503
|
+
export {};
|
|
447
504
|
//# sourceMappingURL=types.d.ts.map
|
package/dist/types.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA
|
|
1
|
+
{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}
|
package/dist/types.js
CHANGED
|
@@ -3,8 +3,29 @@
|
|
|
3
3
|
*
|
|
4
4
|
* This module defines all shared interfaces and types used across the
|
|
5
5
|
* multi-stage AI pipeline. Types are organized by domain concern.
|
|
6
|
+
*
|
|
7
|
+
* Design Principles:
|
|
8
|
+
* - Branded types for domain-specific values (IDs, scores)
|
|
9
|
+
* - Strict readonly types where mutation is not expected
|
|
10
|
+
* - Comprehensive Zod schemas for runtime validation
|
|
11
|
+
* - Type guards for safe narrowing
|
|
12
|
+
*
|
|
13
|
+
* @module types
|
|
14
|
+
* @version 2.0.0
|
|
6
15
|
*/
|
|
7
16
|
import { z } from 'zod';
|
|
17
|
+
/** Helper to create a Score (clamped 0-100) */
|
|
18
|
+
export function createScore(value) {
|
|
19
|
+
return Math.max(0, Math.min(100, Math.round(value)));
|
|
20
|
+
}
|
|
21
|
+
/** Helper to create a Confidence (clamped 0-1) */
|
|
22
|
+
export function createConfidence(value) {
|
|
23
|
+
return Math.max(0, Math.min(1, value));
|
|
24
|
+
}
|
|
25
|
+
/** Helper to create a SessionId */
|
|
26
|
+
export function createSessionId(value) {
|
|
27
|
+
return value;
|
|
28
|
+
}
|
|
8
29
|
// ============================================================================
|
|
9
30
|
// Zod Schemas for Validation
|
|
10
31
|
// ============================================================================
|
package/dist/types.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA
|
|
1
|
+
{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAyBxB,+CAA+C;AAC/C,MAAM,UAAU,WAAW,CAAC,KAAa;IACvC,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAU,CAAC;AAChE,CAAC;AAED,kDAAkD;AAClD,MAAM,UAAU,gBAAgB,CAAC,KAAa;IAC5C,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,CAAe,CAAC;AACvD,CAAC;AAED,mCAAmC;AACnC,MAAM,UAAU,eAAe,CAAC,KAAa;IAC3C,OAAO,KAAkB,CAAC;AAC5B,CAAC;AA+eD,+EAA+E;AAC/E,6BAA6B;AAC7B,+EAA+E;AAE/E,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5C,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,mBAAmB,CAAC;IAC7C,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC/B,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE;IAC7C,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACjC,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3C,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,UAAU,EAAE,WAAW,CAAC,CAAC;IACpD,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;IACrB,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC;QACjB,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE;KACpB,CAAC;CACH,CAAC,CAAC"}
|
package/dist/utils.d.ts
CHANGED
|
@@ -2,18 +2,34 @@
|
|
|
2
2
|
* Atlas Server - Utility Functions
|
|
3
3
|
*
|
|
4
4
|
* Shared utilities for logging, timing, error handling, and common operations.
|
|
5
|
+
*
|
|
6
|
+
* Features:
|
|
7
|
+
* - High-performance logging with MCP mode support
|
|
8
|
+
* - Circuit breaker pattern for resilient external calls
|
|
9
|
+
* - LRU cache with TTL for efficient memoization
|
|
10
|
+
* - Comprehensive retry logic with exponential backoff
|
|
11
|
+
* - Type-safe error handling utilities
|
|
12
|
+
*
|
|
13
|
+
* @module utils
|
|
14
|
+
* @version 2.0.0
|
|
5
15
|
*/
|
|
6
16
|
import pino from 'pino';
|
|
7
17
|
import type { PipelineError, StageName, StageResult } from './types.js';
|
|
18
|
+
/** Default concurrency limit for parallel operations */
|
|
19
|
+
export declare const DEFAULT_CONCURRENCY = 3;
|
|
8
20
|
/**
|
|
9
21
|
* Create a configured pino logger instance
|
|
10
22
|
* In MCP mode, we disable pretty printing to avoid polluting stdio
|
|
23
|
+
* @param level - Log level (debug, info, warn, error, silent)
|
|
11
24
|
*/
|
|
12
|
-
export declare function createLogger(level?: string): pino.Logger
|
|
13
|
-
/** Default logger instance */
|
|
25
|
+
export declare function createLogger(level?: string): pino.Logger;
|
|
26
|
+
/** Default logger instance (singleton) */
|
|
14
27
|
export declare const logger: pino.Logger<never, boolean>;
|
|
15
28
|
/**
|
|
16
|
-
* Measure execution time of an async function
|
|
29
|
+
* Measure execution time of an async function with high precision
|
|
30
|
+
* @template T - Return type of the function
|
|
31
|
+
* @param fn - Async function to measure
|
|
32
|
+
* @returns Result and duration in milliseconds
|
|
17
33
|
*/
|
|
18
34
|
export declare function measureTime<T>(fn: () => Promise<T>): Promise<{
|
|
19
35
|
result: T;
|
|
@@ -21,19 +37,29 @@ export declare function measureTime<T>(fn: () => Promise<T>): Promise<{
|
|
|
21
37
|
}>;
|
|
22
38
|
/**
|
|
23
39
|
* Create a simple timer for measuring elapsed time
|
|
40
|
+
* Useful for tracking duration across multiple operations
|
|
24
41
|
*/
|
|
25
42
|
export declare function createTimer(): {
|
|
26
43
|
elapsed: () => number;
|
|
44
|
+
reset: () => void;
|
|
27
45
|
};
|
|
28
46
|
/**
|
|
29
47
|
* Safely stringify an object, handling circular references
|
|
30
48
|
*/
|
|
31
49
|
export declare function safeStringify(obj: unknown, indent?: number): string;
|
|
32
50
|
/**
|
|
33
|
-
* Create a stage result with timing
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
51
|
+
* Create a stage result with timing, error handling, and optional retry
|
|
52
|
+
* @template T - Output type of the stage function
|
|
53
|
+
* @param name - Stage name for tracking
|
|
54
|
+
* @param fn - Async function to execute
|
|
55
|
+
* @param options - Optional configuration (retries, timeout)
|
|
56
|
+
* @returns Stage result with output or error
|
|
57
|
+
*/
|
|
58
|
+
export declare function executeStage<T>(name: StageName, fn: () => Promise<T>, options?: {
|
|
59
|
+
retries?: number;
|
|
60
|
+
timeoutMs?: number;
|
|
61
|
+
}): Promise<{
|
|
62
|
+
stageResult: StageResult<T>;
|
|
37
63
|
output: T;
|
|
38
64
|
}>;
|
|
39
65
|
/**
|
|
@@ -85,6 +111,31 @@ export declare function retry<T>(fn: () => Promise<T>, options?: Partial<RetryOp
|
|
|
85
111
|
* Sleep for a specified duration
|
|
86
112
|
*/
|
|
87
113
|
export declare function sleep(ms: number): Promise<void>;
|
|
114
|
+
/**
|
|
115
|
+
* Circuit breaker states
|
|
116
|
+
*/
|
|
117
|
+
type CircuitState = 'closed' | 'open' | 'half-open';
|
|
118
|
+
/**
|
|
119
|
+
* Circuit breaker for resilient external service calls
|
|
120
|
+
* Prevents cascade failures by failing fast when service is unavailable
|
|
121
|
+
*/
|
|
122
|
+
export declare class CircuitBreaker {
|
|
123
|
+
private readonly options;
|
|
124
|
+
private state;
|
|
125
|
+
private failureCount;
|
|
126
|
+
private lastFailureTime;
|
|
127
|
+
private successCount;
|
|
128
|
+
constructor(options?: {
|
|
129
|
+
failureThreshold: number;
|
|
130
|
+
resetTimeoutMs: number;
|
|
131
|
+
halfOpenSuccesses: number;
|
|
132
|
+
});
|
|
133
|
+
execute<T>(fn: () => Promise<T>): Promise<T>;
|
|
134
|
+
private onSuccess;
|
|
135
|
+
private onFailure;
|
|
136
|
+
getState(): CircuitState;
|
|
137
|
+
reset(): void;
|
|
138
|
+
}
|
|
88
139
|
/**
|
|
89
140
|
* Safely parse JSON with error handling
|
|
90
141
|
*/
|
|
@@ -116,15 +167,60 @@ export declare function nowISO(): string;
|
|
|
116
167
|
*/
|
|
117
168
|
export declare function formatDuration(ms: number): string;
|
|
118
169
|
/**
|
|
119
|
-
* Process items in parallel with concurrency limit
|
|
170
|
+
* Process items in parallel with concurrency limit and progress tracking
|
|
171
|
+
* @template T - Input item type
|
|
172
|
+
* @template R - Result type
|
|
173
|
+
* @param items - Array of items to process
|
|
174
|
+
* @param fn - Async function to apply to each item
|
|
175
|
+
* @param options - Configuration options
|
|
176
|
+
* @returns Array of results in original order
|
|
120
177
|
*/
|
|
121
|
-
export declare function parallelMap<T, R>(items: T[], fn: (item: T, index: number) => Promise<R>,
|
|
178
|
+
export declare function parallelMap<T, R>(items: T[], fn: (item: T, index: number) => Promise<R>, options?: {
|
|
179
|
+
concurrency?: number;
|
|
180
|
+
onProgress?: (completed: number, total: number) => void;
|
|
181
|
+
stopOnError?: boolean;
|
|
182
|
+
}): Promise<R[]>;
|
|
122
183
|
/**
|
|
123
184
|
* Debounce async function calls
|
|
124
185
|
*/
|
|
125
186
|
export declare function debounce<T extends (...args: unknown[]) => Promise<unknown>>(fn: T, delayMs: number): (...args: Parameters<T>) => Promise<Awaited<ReturnType<T>>>;
|
|
126
187
|
/**
|
|
127
|
-
*
|
|
128
|
-
|
|
129
|
-
|
|
188
|
+
* LRU Cache with TTL support for efficient memoization
|
|
189
|
+
* @template K - Key type
|
|
190
|
+
* @template V - Value type
|
|
191
|
+
*/
|
|
192
|
+
export declare class LRUCache<K, V> {
|
|
193
|
+
private readonly maxSize;
|
|
194
|
+
private readonly ttlMs;
|
|
195
|
+
private cache;
|
|
196
|
+
constructor(maxSize?: number, ttlMs?: number);
|
|
197
|
+
get(key: K): V | undefined;
|
|
198
|
+
set(key: K, value: V, ttlMs?: number): void;
|
|
199
|
+
has(key: K): boolean;
|
|
200
|
+
delete(key: K): boolean;
|
|
201
|
+
clear(): void;
|
|
202
|
+
get size(): number;
|
|
203
|
+
private evictLRU;
|
|
204
|
+
/** Get cache statistics */
|
|
205
|
+
getStats(): {
|
|
206
|
+
size: number;
|
|
207
|
+
maxSize: number;
|
|
208
|
+
};
|
|
209
|
+
}
|
|
210
|
+
/**
|
|
211
|
+
* Memoize async function with LRU cache and TTL
|
|
212
|
+
* @template T - Function type
|
|
213
|
+
* @param fn - Async function to memoize
|
|
214
|
+
* @param options - Cache configuration
|
|
215
|
+
* @returns Memoized function
|
|
216
|
+
*/
|
|
217
|
+
export declare function memoizeAsync<T extends (...args: unknown[]) => Promise<unknown>>(fn: T, options?: {
|
|
218
|
+
ttlMs?: number;
|
|
219
|
+
maxCacheSize?: number;
|
|
220
|
+
keyFn?: (...args: Parameters<T>) => string;
|
|
221
|
+
}): T & {
|
|
222
|
+
cache: LRUCache<string, Awaited<ReturnType<T>>>;
|
|
223
|
+
clearCache: () => void;
|
|
224
|
+
};
|
|
225
|
+
export {};
|
|
130
226
|
//# sourceMappingURL=utils.d.ts.map
|
package/dist/utils.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA
|
|
1
|
+
{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"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"}
|