@agentick/core 0.0.1

package/dist/core/execution-helpers.js

@@ -0,0 +1,212 @@
+/**
+ * Execution Helpers
+ *
+ * Utilities for understanding execution context - whether an execution
+ * is standalone, nested, what originated it, etc.
+ *
+ * Useful for persistence, logging, and conditional behavior based on
+ * execution hierarchy.
+ */
+import { Context } from "./context";
+import { ExecutionTracker } from "./execution-tracker";
+/**
+ * Check if this is a standalone (root) execution or nested within another.
+ *
+ * @example
+ * ```typescript
+ * if (isStandaloneExecution(ctx)) {
+ *   // Create new execution record
+ * } else {
+ *   // Link to parent execution
+ * }
+ * ```
+ */
+export function isStandaloneExecution(ctx) {
+    return !ctx.procedureNode?.parentPid;
+}
+/**
+ * Check if this execution is nested within another procedure.
+ * Opposite of isStandaloneExecution.
+ */
+export function isNestedExecution(ctx) {
+    return !!ctx.procedureNode?.parentPid;
+}
+/**
+ * Get the name of the procedure that originated this execution chain.
+ * Returns the origin's name if nested, or current procedure name if standalone.
+ *
+ * @example
+ * ```typescript
+ * const origin = getOriginName(ctx);
+ * // 'engine:stream', 'engine:execute', 'model:generate', etc.
+ * ```
+ */
+export function getOriginName(ctx) {
+    return ctx.origin?.name ?? ctx.procedureNode?.name;
+}
+/**
+ * Get the origin procedure node if this is a nested execution.
+ * Returns undefined for standalone executions.
+ */
+export function getOriginNode(ctx) {
+    return ctx.origin;
+}
+/**
+ * Check if this execution is within an engine execution (engine:execute or engine:stream).
+ * Useful for persistence to know if engine is handling top-level tracking.
+ *
+ * @example
+ * ```typescript
+ * if (isWithinEngine(ctx)) {
+ *   // Engine handles execution record - just track model-specific stuff
+ * } else {
+ *   // Standalone model call - need full tracking
+ * }
+ * ```
+ */
+export function isWithinEngine(ctx) {
+    if (!ctx.procedureGraph || !ctx.procedurePid) {
+        return false;
+    }
+    return ctx.procedureGraph.hasAncestor(ctx.procedurePid, (node) => node.name?.startsWith("engine:") ?? false);
+}
+/**
+ * Check if this execution has an ancestor with a specific procedure name.
+ *
+ * @example
+ * ```typescript
+ * if (hasAncestorNamed(ctx, 'engine:stream')) {
+ *   // We're inside a streaming execution
+ * }
+ * ```
+ */
+export function hasAncestorNamed(ctx, name) {
+    if (!ctx.procedureGraph || !ctx.procedurePid) {
+        return false;
+    }
+    return ctx.procedureGraph.hasAncestorWithName(ctx.procedurePid, name);
+}
+/**
+ * Check if this execution has an ancestor matching a predicate.
+ *
+ * @example
+ * ```typescript
+ * if (hasAncestorMatching(ctx, n => n.metadata?.type === 'agent')) {
+ *   // We're inside an agent execution
+ * }
+ * ```
+ */
+export function hasAncestorMatching(ctx, predicate) {
+    if (!ctx.procedureGraph || !ctx.procedurePid) {
+        return false;
+    }
+    return ctx.procedureGraph.hasAncestor(ctx.procedurePid, predicate);
+}
+/**
+ * Get the parent procedure node if one exists.
+ */
+export function getParentNode(ctx) {
+    return ctx.procedureNode?.getParentNode();
+}
+/**
+ * Get the parent procedure's PID if one exists.
+ */
+export function getParentPid(ctx) {
+    return ctx.procedureNode?.parentPid;
+}
+/**
+ * Get the root procedure ID (the origin of this execution chain).
+ * Returns current PID if this is a standalone execution.
+ */
+export function getRootPid(ctx) {
+    return ctx.origin?.pid ?? ctx.procedurePid;
+}
+/**
+ * Get execution hierarchy info - useful for logging and persistence.
+ *
+ * @example
+ * ```typescript
+ * const info = getExecutionInfo(ctx);
+ * // {
+ * //   pid: 'abc-123',
+ * //   parentPid: 'def-456',
+ * //   rootPid: 'ghi-789',
+ * //   name: 'model:generate',
+ * //   originName: 'engine:stream',
+ * //   isStandalone: false,
+ * //   isWithinEngine: true,
+ * //   depth: 2
+ * // }
+ * ```
+ */
+export function getExecutionInfo(ctx) {
+    // Calculate depth by traversing up
+    let depth = 0;
+    let current = ctx.procedureNode;
+    while (current?.parentPid) {
+        depth++;
+        current = current.getParentNode();
+    }
+    return {
+        pid: ctx.procedurePid,
+        parentPid: ctx.procedureNode?.parentPid,
+        rootPid: getRootPid(ctx),
+        name: ctx.procedureNode?.name,
+        originName: getOriginName(ctx),
+        isStandalone: isStandaloneExecution(ctx),
+        isWithinEngine: isWithinEngine(ctx),
+        depth,
+    };
+}
+/**
+ * Create a named execution boundary around an operation.
+ *
+ * Use this to mark semantically meaningful operations that should appear
+ * as distinct executions in DevTools. The execution will be linked as a
+ * child of the current execution (if any).
+ *
+ * @example
+ * ```typescript
+ * // Simple usage with just a name
+ * const summary = await withExecution("Summarize Context", async () => {
+ *   return model.generate(summarizePrompt);
+ * });
+ *
+ * // With options
+ * const result = await withExecution({
+ *   name: "Validate Response",
+ *   type: "validation",
+ *   metadata: { validator: "schema" },
+ * }, async () => {
+ *   return validateSchema(response);
+ * });
+ *
+ * // In a hook
+ * onAfterCompile: async (ctx) => {
+ *   await withExecution("Context Compaction", async () => {
+ *     const summary = await model.generate(compactPrompt);
+ *     ctx.updateContext(summary);
+ *   });
+ * }
+ * ```
+ *
+ * @param nameOrOptions - Execution name string or options object
+ * @param fn - The async function to execute within this boundary
+ * @returns The result of the function
+ */
+export async function withExecution(nameOrOptions, fn) {
+    const options = typeof nameOrOptions === "string" ? { name: nameOrOptions } : nameOrOptions;
+    const { name, type = "custom", metadata } = options;
+    // ExecutionTracker.track with 'child' boundary automatically:
+    // - Links to parent procedure via ctx.procedurePid
+    // - Links to parent execution via ctx.executionId
+    // - Creates new executionId for this boundary
+    // - Uses Context.fork() internally for isolation
+    return ExecutionTracker.track(Context.tryGet() ?? Context.create(), {
+        name,
+        metadata: { ...metadata, type },
+        executionBoundary: "child",
+        executionType: type,
+    }, async () => fn());
+}
+//# sourceMappingURL=execution-helpers.js.map

package/dist/core/execution-helpers.js.map

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

package/dist/core/execution-tracker.d.ts

@@ -0,0 +1,53 @@
+import { type KernelContext } from "./context";
+import { ProcedureNode } from "./procedure-graph";
+/**
+ * Execution boundary behavior configuration.
+ *
+ * - `'always'`: Always create a new root execution (no parentExecutionId)
+ * - `'child'`: Always create a new child execution (with parentExecutionId from current context)
+ * - `'auto'`: Create only if not already in an execution (default behavior)
+ * - `false`: Never create an execution boundary, inherit from parent
+ */
+export type ExecutionBoundaryConfig = "always" | "child" | "auto" | false;
+export interface ExecutionTrackerOptions {
+    name?: string;
+    metadata?: Record<string, any>;
+    parentPid?: string;
+    /**
+     * Explicit execution ID to use if this becomes a boundary.
+     * If not provided, procedurePid is used as the executionId.
+     * Useful for Engine to correlate with ExecutionHandle.pid.
+     */
+    executionId?: string;
+    /**
+     * Declarative execution boundary configuration.
+     *
+     * - `'always'`: Always create a new root execution (engine:execute, engine:stream)
+     * - `'child'`: Always create a new child execution (component_tool, harness)
+     * - `'auto'`: Create only if not already in an execution (model:generate, model:stream)
+     * - `false`: Never create an execution boundary (compile:tick, internal procedures)
+     *
+     * @default 'auto'
+     */
+    executionBoundary?: ExecutionBoundaryConfig;
+    /**
+     * Explicit execution type (e.g., 'engine', 'model', 'component_tool', 'harness').
+     * If not provided, derived from procedure name.
+     */
+    executionType?: string;
+}
+/**
+ * Unified execution tracker for procedures and hooks.
+ * Handles automatic telemetry, metrics tracking, and propagation.
+ */
+export declare class ExecutionTracker {
+    /**
+     * Track a procedure/hook execution with automatic telemetry and metrics
+     */
+    static track<T>(ctx: KernelContext, options: ExecutionTrackerOptions, fn: (node: ProcedureNode) => Promise<T>): Promise<T>;
+    /**
+     * Send metrics to telemetry system
+     */
+    private static sendMetricsToTelemetry;
+}
+//# sourceMappingURL=execution-tracker.d.ts.map

package/dist/core/execution-tracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"execution-tracker.d.ts","sourceRoot":"","sources":["../../src/core/execution-tracker.ts"],"names":[],"mappings":"AAAA,OAAO,EAAW,KAAK,aAAa,EAAE,MAAM,WAAW,CAAC;AACxD,OAAO,EAAkB,aAAa,EAAwB,MAAM,mBAAmB,CAAC;AAKxF;;;;;;;GAOG;AACH,MAAM,MAAM,uBAAuB,GAAG,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,KAAK,CAAC;AAE1E,MAAM,WAAW,uBAAuB;IACtC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC/B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;;;;;;;;OASG;IACH,iBAAiB,CAAC,EAAE,uBAAuB,CAAC;IAE5C;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;;GAGG;AACH,qBAAa,gBAAgB;IAC3B;;OAEG;WACU,KAAK,CAAC,CAAC,EAClB,GAAG,EAAE,aAAa,EAClB,OAAO,EAAE,uBAAuB,EAChC,EAAE,EAAE,CAAC,IAAI,EAAE,aAAa,KAAK,OAAO,CAAC,CAAC,CAAC,GACtC,OAAO,CAAC,CAAC,CAAC;IA+Tb;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,sBAAsB;CAWtC"}

package/dist/core/execution-tracker.js

@@ -0,0 +1,309 @@
+import { Context } from "./context";
+import { ProcedureGraph, ProcedureNode } from "./procedure-graph";
+import { Telemetry } from "./telemetry";
+import { AbortError } from "@tentickle/shared";
+import { isAsyncIterable } from "./stream";
+/**
+ * Unified execution tracker for procedures and hooks.
+ * Handles automatic telemetry, metrics tracking, and propagation.
+ */
+export class ExecutionTracker {
+    /**
+     * Track a procedure/hook execution with automatic telemetry and metrics
+     */
+    static async track(ctx, options, fn) {
+        // Initialize graph if needed
+        if (!ctx.procedureGraph) {
+            ctx.procedureGraph = new ProcedureGraph();
+        }
+        const procedurePid = crypto.randomUUID();
+        const parentPid = options.parentPid || ctx.procedurePid;
+        const effectiveName = options.name || "anonymous";
+        // Determine origin: if this is a root procedure (no parent), origin is undefined
+        // Otherwise, use existing origin or find root node
+        let origin;
+        if (!parentPid) {
+            // This is the root procedure - origin is undefined (it IS the origin)
+            origin = undefined;
+        }
+        else {
+            // Use existing origin if set, otherwise find root node
+            origin = ctx.origin;
+            if (!origin && ctx.procedureGraph) {
+                const rootNode = ctx.procedureGraph.getRoot();
+                origin = rootNode;
+            }
+        }
+        // Determine execution context (boundary detection)
+        // Use declarative executionBoundary config to decide behavior
+        const boundaryConfig = options.executionBoundary ?? "auto";
+        // Get current execution context from context (Phase 3 fields)
+        const currentExecutionId = ctx.executionId;
+        const contextHandlePid = ctx.executionHandle?.pid;
+        let executionId;
+        let isExecutionBoundary;
+        let executionType;
+        let parentExecutionId;
+        switch (boundaryConfig) {
+            case "always":
+                // Always create a new execution
+                // If ctx.parentExecutionId is set (e.g., from child execution), use it for child linking
+                // Otherwise, this is a root execution with no parent
+                executionId = options.executionId ?? contextHandlePid ?? procedurePid;
+                isExecutionBoundary = true;
+                // Use ctx.executionType (set by engine); fall back to options or derive from name
+                executionType =
+                    ctx.executionType ??
+                        options.executionType ??
+                        (effectiveName.includes(":") ? effectiveName.split(":")[0] : effectiveName);
+                parentExecutionId = ctx.parentExecutionId; // May be undefined for true roots
+                break;
+            case "child":
+                // Always create a new child execution (with parentExecutionId)
+                executionId = options.executionId ?? procedurePid;
+                isExecutionBoundary = true;
+                // Use ctx.executionType (set by engine); fall back to options or derive from name
+                executionType =
+                    ctx.executionType ??
+                        options.executionType ??
+                        (effectiveName.includes(":") ? effectiveName.split(":")[0] : effectiveName);
+                // Parent is the current execution from context
+                parentExecutionId = currentExecutionId;
+                break;
+            case "auto":
+                // Create only if not already in an execution
+                if (currentExecutionId) {
+                    // Already in an execution - inherit
+                    executionId = currentExecutionId;
+                    isExecutionBoundary = false;
+                    executionType = undefined;
+                    parentExecutionId = undefined; // Not applicable, inheriting
+                }
+                else {
+                    // Not in an execution - create new root
+                    executionId = options.executionId ?? contextHandlePid ?? procedurePid;
+                    isExecutionBoundary = true;
+                    executionType =
+                        options.executionType ??
+                            (effectiveName.includes(":") ? effectiveName.split(":")[0] : effectiveName);
+                    parentExecutionId = undefined; // Root execution
+                }
+                break;
+            case false:
+                // Never create an execution boundary - inherit from context (may be undefined)
+                executionId = currentExecutionId;
+                isExecutionBoundary = false;
+                executionType = undefined;
+                parentExecutionId = undefined;
+                break;
+        }
+        // Register procedure with execution context
+        const node = ctx.procedureGraph.register(procedurePid, parentPid, effectiveName, options.metadata, executionId, isExecutionBoundary, executionType);
+        // Start telemetry span
+        const span = Telemetry.startSpan(effectiveName);
+        span.setAttribute("procedure.pid", procedurePid);
+        span.setAttribute("procedure.execution_id", executionId);
+        if (isExecutionBoundary) {
+            span.setAttribute("procedure.is_execution_boundary", true);
+            if (executionType) {
+                span.setAttribute("procedure.execution_type", executionType);
+            }
+        }
+        if (parentPid) {
+            span.setAttribute("procedure.parent_pid", parentPid);
+        }
+        if (options.metadata) {
+            for (const [key, value] of Object.entries(options.metadata)) {
+                span.setAttribute(`procedure.metadata.${key}`, value);
+            }
+        }
+        // Create a new metrics object for this procedure's scope
+        // This prevents child procedures from modifying parent's metrics directly
+        const procedureMetrics = {};
+        // Create metrics proxy that writes to both procedure scope and node
+        // This allows existing code to write to ctx.metrics and it automatically tracks in node
+        const metricsProxy = new Proxy(procedureMetrics, {
+            set(target, key, value) {
+                const oldValue = target[key] || 0;
+                target[key] = value;
+                // Accumulate delta in node
+                const delta = value - oldValue;
+                if (delta !== 0) {
+                    node.addMetric(key, delta);
+                }
+                return true;
+            },
+            get(target, key) {
+                // Return value from procedure scope
+                return target[key] || 0;
+            },
+            ownKeys(target) {
+                return Object.keys(target);
+            },
+            has(target, key) {
+                return key in target;
+            },
+            getOwnPropertyDescriptor(target, key) {
+                return Object.getOwnPropertyDescriptor(target, key);
+            },
+        });
+        // Use Context.fork to create an isolated child context for this procedure.
+        // This prevents race conditions when parallel procedures run - each gets its own
+        // context object with its own procedurePid, procedureNode, origin, and metrics.
+        // Shared state (events, procedureGraph, channels, signal) is still accessible.
+        //
+        // If this is an execution boundary, set the execution fields in the forked context.
+        // This ensures all nested procedures inherit executionId from context.
+        return Context.fork({
+            procedurePid,
+            procedureNode: node,
+            origin,
+            metrics: metricsProxy,
+            // Execution context (Phase 3): set if boundary, otherwise inherit from parent context
+            ...(isExecutionBoundary
+                ? {
+                    executionId,
+                    executionType,
+                    parentExecutionId,
+                }
+                : {}),
+        }, async () => {
+            try {
+                // Check abort before starting
+                if (ctx.signal?.aborted) {
+                    node.cancel();
+                    const abortError = new AbortError();
+                    span.recordError(abortError);
+                    span.end();
+                    throw abortError;
+                }
+                // Emit start event with execution context
+                Context.emit("procedure:start", {
+                    pid: procedurePid,
+                    name: effectiveName,
+                    parentPid,
+                    executionId: node.executionId,
+                    isExecutionBoundary: node.isExecutionBoundary,
+                    executionType: node.executionType,
+                    parentExecutionId, // For DevTools execution tree linking
+                });
+                // Execute function
+                const result = await fn(node);
+                // If result is an AsyncIterable, wrap it to maintain context and defer procedure:end
+                if (isAsyncIterable(result)) {
+                    // Capture the forked context for use during iteration
+                    const forkedContext = Context.get();
+                    const wrappedIterable = (async function* () {
+                        const iterator = result[Symbol.asyncIterator]();
+                        try {
+                            while (true) {
+                                // Run iterator.next() inside the forked context to maintain procedurePid
+                                const next = await Context.run(forkedContext, async () => iterator.next());
+                                if (next.done)
+                                    break;
+                                // Check abort after getting next value but before yielding
+                                // This allows the producer to call abort() between yields
+                                if (ctx.signal?.aborted) {
+                                    throw new AbortError();
+                                }
+                                // Emit stream:chunk event for consumers listening to the handle
+                                // The value is emitted directly (not wrapped) - it's typically an engine event
+                                await Context.run(forkedContext, async () => {
+                                    Context.emit("stream:chunk", next.value);
+                                });
+                                yield next.value;
+                            }
+                            // Completed successfully - update status and emit end
+                            ctx.procedureGraph.updateStatus(procedurePid, "completed");
+                            ExecutionTracker.sendMetricsToTelemetry(node, span);
+                            span.end();
+                            await Context.run(forkedContext, async () => {
+                                Context.emit("procedure:end", {
+                                    pid: procedurePid,
+                                    executionId: node.executionId,
+                                    metrics: node.metrics,
+                                    durationMs: node.durationMs,
+                                });
+                            });
+                        }
+                        catch (error) {
+                            // Handle errors during iteration
+                            const isAbort = error?.name === "AbortError" ||
+                                error?.message?.includes("aborted");
+                            const status = isAbort ? "cancelled" : "failed";
+                            ctx.procedureGraph.updateStatus(procedurePid, status, error);
+                            span.recordError(error);
+                            ExecutionTracker.sendMetricsToTelemetry(node, span);
+                            span.end();
+                            await Context.run(forkedContext, async () => {
+                                Context.emit("procedure:error", {
+                                    pid: procedurePid,
+                                    executionId: node.executionId,
+                                    error,
+                                });
+                            });
+                            throw error;
+                        }
+                        finally {
+                            // Clean up iterator if it has a return method
+                            if (iterator.return) {
+                                await Context.run(forkedContext, async () => iterator.return());
+                            }
+                        }
+                    })();
+                    return wrappedIterable;
+                }
+                // Regular (non-AsyncIterable) result - complete immediately
+                ctx.procedureGraph.updateStatus(procedurePid, "completed");
+                this.sendMetricsToTelemetry(node, span);
+                span.end();
+                Context.emit("procedure:end", {
+                    pid: procedurePid,
+                    executionId: node.executionId,
+                    result,
+                    metrics: node.metrics,
+                    durationMs: node.durationMs,
+                });
+                return result;
+            }
+            catch (error) {
+                // Determine if it was an abort
+                const isAbort = error?.name === "AbortError" ||
+                    error?.message?.includes("aborted");
+                // Update status
+                const status = isAbort ? "cancelled" : "failed";
+                ctx.procedureGraph.updateStatus(procedurePid, status, error);
+                span.recordError(error);
+                this.sendMetricsToTelemetry(node, span);
+                span.end();
+                Context.emit("procedure:error", {
+                    pid: procedurePid,
+                    executionId: node.executionId,
+                    error,
+                });
+                // Preserve error name and message
+                const err = error;
+                if (isAbort && err.name !== "AbortError") {
+                    err.name = "AbortError";
+                }
+                throw err;
+            }
+            // No finally needed - Context.fork handles isolation automatically
+            // Parent context is never modified, so no restoration required
+        });
+    }
+    /**
+     * Send metrics to telemetry system
+     */
+    static sendMetricsToTelemetry(node, span) {
+        for (const [key, value] of Object.entries(node.metrics)) {
+            Telemetry.getHistogram(`procedure.${key}`).record(value, {
+                procedure: node.name || "anonymous",
+                procedure_pid: node.pid,
+                status: node.status,
+            });
+            span.setAttribute(`metrics.${key}`, value);
+        }
+    }
+}
+//# sourceMappingURL=execution-tracker.js.map

package/dist/core/execution-tracker.js.map

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

package/dist/core/index.d.ts

@@ -0,0 +1,58 @@
+/**
+ * # Tentickle Kernel
+ *
+ * Low-level execution primitives for the Tentickle framework. The kernel provides
+ * the foundational infrastructure that all other Tentickle packages build upon.
+ *
+ * ## Core Primitives
+ *
+ * - **Procedures** - Async function wrappers with middleware, context, and telemetry
+ * - **Context** - Request-scoped state with automatic propagation
+ * - **Channels** - Async generators for streaming with backpressure
+ * - **Telemetry** - Execution tracking, spans, and metrics
+ * - **Logger** - Structured logging with configurable levels
+ *
+ * ## When to Use Kernel Directly
+ *
+ * Most applications should use the higher-level `tentickle` package. Use kernel directly when:
+ *
+ * - Building custom execution infrastructure
+ * - Creating new Tentickle adapters or integrations
+ * - Need fine-grained control over procedure execution
+ *
+ * ## Example
+ *
+ * ```typescript
+ * import { createProcedure, Context } from './core';
+ *
+ * const myProcedure = createProcedure(
+ *   { name: 'my-operation' },
+ *   async (input: string) => {
+ *     return { result: input.toUpperCase() };
+ *   }
+ * );
+ *
+ * const result = await myProcedure.exec('hello');
+ * ```
+ *
+ * @see {@link Procedure} - The core procedure abstraction
+ * @see {@link KernelContext} - Request-scoped context
+ * @see {@link Channel} - Streaming primitive
+ * @see {@link Telemetry} - Execution tracking
+ *
+ * @module @tentickle/kernel
+ */
+export * from "./context";
+export * from "./telemetry";
+export * from "./otel-provider";
+export * from "./procedure-graph";
+export * from "./execution-tracker";
+export * from "./execution-helpers";
+export * from "./metrics-helpers";
+export * from "./stream";
+export * from "./channel";
+export * from "./channel-helpers";
+export * from "./procedure";
+export * from "./logger";
+export * from "./event-buffer";
+//# sourceMappingURL=index.d.ts.map

package/dist/core/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AAEH,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAClC,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,cAAc,mBAAmB,CAAC;AAClC,cAAc,aAAa,CAAC;AAC5B,cAAc,UAAU,CAAC;AACzB,cAAc,gBAAgB,CAAC"}