@agentick/core 0.2.1 → 0.3.0

package/dist/testing/test-environment.d.ts

@@ -0,0 +1,122 @@
+/**
+ * Test Environment Factory
+ *
+ * Creates mock ExecutionEnvironment instances for testing.
+ * Tracks all lifecycle hook invocations for assertions.
+ *
+ * @example
+ * ```typescript
+ * const { environment, tracker } = createTestEnvironment({
+ *   name: "test",
+ *   interceptTools: { my_tool: "intercepted!" },
+ * });
+ *
+ * const app = createApp(Agent, { model, environment });
+ * // ... run agent ...
+ *
+ * expect(tracker.initCalls).toHaveLength(1);
+ * expect(tracker.prepareModelInputCalls).toHaveLength(1);
+ * expect(tracker.toolCalls).toHaveLength(1);
+ * ```
+ */
+import type { ExecutionEnvironment } from "../app/types";
+import type { COMInput } from "../com/types";
+import type { ExecutableTool } from "../tool/tool";
+import type { ToolCall, ToolResult } from "@agentick/shared";
+export interface TestEnvironmentOptions {
+    /**
+     * Environment name.
+     * @default "test"
+     */
+    name?: string;
+    /**
+     * Tool names to intercept. Values are either a string (becomes the result text)
+     * or a function that receives the ToolCall and returns a ToolResult.
+     * Non-intercepted tools pass through to normal execution.
+     *
+     * @example
+     * ```typescript
+     * // Static string result
+     * interceptTools: { execute: "sandbox result" }
+     *
+     * // Dynamic function result
+     * interceptTools: {
+     *   execute: (call) => ({
+     *     id: call.id, toolUseId: call.id, name: call.name,
+     *     success: true, content: [{ type: "text", text: `ran: ${call.input.code}` }],
+     *   }),
+     * }
+     * ```
+     */
+    interceptTools?: Record<string, string | ((call: ToolCall) => ToolResult | Promise<ToolResult>)>;
+    /**
+     * Transform function for prepareModelInput.
+     * If not provided, input passes through unchanged.
+     */
+    transformInput?: (compiled: COMInput, tools: ExecutableTool[]) => COMInput | Promise<COMInput>;
+    /**
+     * Data to add to snapshot during onPersist.
+     */
+    persistData?: Record<string, unknown>;
+}
+export interface EnvironmentTracker {
+    /** All onSessionInit calls (session IDs) */
+    initCalls: string[];
+    /** All prepareModelInput calls */
+    prepareModelInputCalls: Array<{
+        tools: string[];
+    }>;
+    /** All executeToolCall calls */
+    toolCalls: Array<{
+        name: string;
+        intercepted: boolean;
+    }>;
+    /** All onPersist calls (session IDs) */
+    persistCalls: string[];
+    /** All onRestore calls (session IDs) */
+    restoreCalls: string[];
+    /** All onDestroy calls (session IDs) */
+    destroyCalls: string[];
+    /** Reset all tracked calls */
+    reset(): void;
+}
+export interface TestEnvironmentResult {
+    /** The environment instance to pass to AppOptions */
+    environment: ExecutionEnvironment;
+    /** Tracker for asserting lifecycle calls */
+    tracker: EnvironmentTracker;
+}
+/**
+ * Create a test execution environment with call tracking.
+ *
+ * @example Basic usage
+ * ```typescript
+ * const { environment, tracker } = createTestEnvironment();
+ * const app = createApp(Agent, { model, environment });
+ * const session = await app.session();
+ * await session.send({ messages: [...] }).result;
+ *
+ * expect(tracker.initCalls).toHaveLength(1);
+ * expect(tracker.prepareModelInputCalls).toHaveLength(1);
+ * ```
+ *
+ * @example Intercepting tools
+ * ```typescript
+ * const { environment, tracker } = createTestEnvironment({
+ *   interceptTools: { execute: "sandboxed!" },
+ * });
+ * // When model calls "execute" tool, it gets "sandboxed!" instead of real execution
+ * ```
+ *
+ * @example Transforming model input
+ * ```typescript
+ * const { environment } = createTestEnvironment({
+ *   transformInput: (compiled, tools) => ({
+ *     ...compiled,
+ *     tools: [], // Remove all tools from model input
+ *   }),
+ * });
+ * ```
+ */
+export declare function createTestEnvironment(options?: TestEnvironmentOptions): TestEnvironmentResult;
+//# sourceMappingURL=test-environment.d.ts.map

package/dist/testing/test-environment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-environment.d.ts","sourceRoot":"","sources":["../../src/testing/test-environment.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAA+B,MAAM,cAAc,CAAC;AACtF,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAM7D,MAAM,WAAW,sBAAsB;IACrC;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;;;;;;;;;;;;;;;;;OAkBG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,CAAC,CAAC,IAAI,EAAE,QAAQ,KAAK,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;IAEjG;;;OAGG;IACH,cAAc,CAAC,EAAE,CAAC,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,cAAc,EAAE,KAAK,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IAE/F;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACvC;AAED,MAAM,WAAW,kBAAkB;IACjC,4CAA4C;IAC5C,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,kCAAkC;IAClC,sBAAsB,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC,CAAC;IACnD,gCAAgC;IAChC,SAAS,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IACzD,wCAAwC;IACxC,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,wCAAwC;IACxC,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,wCAAwC;IACxC,YAAY,EAAE,MAAM,EAAE,CAAC;IAEvB,8BAA8B;IAC9B,KAAK,IAAI,IAAI,CAAC;CACf;AAED,MAAM,WAAW,qBAAqB;IACpC,qDAAqD;IACrD,WAAW,EAAE,oBAAoB,CAAC;IAClC,4CAA4C;IAC5C,OAAO,EAAE,kBAAkB,CAAC;CAC7B;AAMD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,GAAE,sBAA2B,GAAG,qBAAqB,CAiFjG"}

package/dist/testing/test-environment.js

@@ -0,0 +1,126 @@
+/**
+ * Test Environment Factory
+ *
+ * Creates mock ExecutionEnvironment instances for testing.
+ * Tracks all lifecycle hook invocations for assertions.
+ *
+ * @example
+ * ```typescript
+ * const { environment, tracker } = createTestEnvironment({
+ *   name: "test",
+ *   interceptTools: { my_tool: "intercepted!" },
+ * });
+ *
+ * const app = createApp(Agent, { model, environment });
+ * // ... run agent ...
+ *
+ * expect(tracker.initCalls).toHaveLength(1);
+ * expect(tracker.prepareModelInputCalls).toHaveLength(1);
+ * expect(tracker.toolCalls).toHaveLength(1);
+ * ```
+ */
+// ============================================================================
+// Factory
+// ============================================================================
+/**
+ * Create a test execution environment with call tracking.
+ *
+ * @example Basic usage
+ * ```typescript
+ * const { environment, tracker } = createTestEnvironment();
+ * const app = createApp(Agent, { model, environment });
+ * const session = await app.session();
+ * await session.send({ messages: [...] }).result;
+ *
+ * expect(tracker.initCalls).toHaveLength(1);
+ * expect(tracker.prepareModelInputCalls).toHaveLength(1);
+ * ```
+ *
+ * @example Intercepting tools
+ * ```typescript
+ * const { environment, tracker } = createTestEnvironment({
+ *   interceptTools: { execute: "sandboxed!" },
+ * });
+ * // When model calls "execute" tool, it gets "sandboxed!" instead of real execution
+ * ```
+ *
+ * @example Transforming model input
+ * ```typescript
+ * const { environment } = createTestEnvironment({
+ *   transformInput: (compiled, tools) => ({
+ *     ...compiled,
+ *     tools: [], // Remove all tools from model input
+ *   }),
+ * });
+ * ```
+ */
+export function createTestEnvironment(options = {}) {
+    const { name = "test", interceptTools = {}, transformInput, persistData } = options;
+    const tracker = {
+        initCalls: [],
+        prepareModelInputCalls: [],
+        toolCalls: [],
+        persistCalls: [],
+        restoreCalls: [],
+        destroyCalls: [],
+        reset() {
+            this.initCalls = [];
+            this.prepareModelInputCalls = [];
+            this.toolCalls = [];
+            this.persistCalls = [];
+            this.restoreCalls = [];
+            this.destroyCalls = [];
+        },
+    };
+    const environment = {
+        name,
+        onSessionInit(session) {
+            tracker.initCalls.push(session.id);
+        },
+        async prepareModelInput(compiled, tools) {
+            tracker.prepareModelInputCalls.push({
+                tools: tools.map((t) => t.metadata?.name ?? "unknown"),
+            });
+            if (transformInput) {
+                return transformInput(compiled, tools);
+            }
+            return compiled;
+        },
+        async executeToolCall(call, tool, next) {
+            const interceptor = interceptTools[call.name];
+            if (interceptor !== undefined) {
+                tracker.toolCalls.push({ name: call.name, intercepted: true });
+                if (typeof interceptor === "function") {
+                    return interceptor(call);
+                }
+                return {
+                    id: call.id,
+                    toolUseId: call.id,
+                    name: call.name,
+                    success: true,
+                    content: [{ type: "text", text: interceptor }],
+                };
+            }
+            tracker.toolCalls.push({ name: call.name, intercepted: false });
+            return next();
+        },
+        onPersist(session, snapshot) {
+            tracker.persistCalls.push(session.id);
+            if (persistData) {
+                return {
+                    ...snapshot,
+                    comState: { ...snapshot.comState, ...persistData },
+                };
+            }
+            return snapshot;
+        },
+        onRestore(session, _snapshot) {
+            tracker.restoreCalls.push(session.id);
+        },
+        onDestroy(session) {
+            tracker.destroyCalls.push(session.id);
+        },
+    };
+    return { environment, tracker };
+}
+//# sourceMappingURL=test-environment.js.map

package/dist/testing/test-environment.js.map

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

package/package.json

@@ -1,13 +1,13 @@
 {
   "name": "@agentick/core",
-  "version": "0.2.1",
+  "version": "0.3.0",
   "description": "Core engine for Agentick",
   "keywords": [
     "agent",
     "ai",
     "core"
   ],
-  "license": "ISC",
+  "license": "MIT",
   "author": "Ryan Lindgren",
   "repository": {
     "type": "git",

package/dist/hibernation/index.d.ts

@@ -1,126 +0,0 @@
-/**
- * Session Hibernation
- *
- * Serialize and restore session state for persistence.
- *
- * Unlike React's hydration (which is about attaching to pre-rendered DOM),
- * this is about serializing our state and restoring it later.
- *
- * Key insight: We don't need to serialize React's fiber tree. We serialize
- * OUR state, and React rebuilds its tree from scratch on restore. Since our
- * hooks (useData, etc.) read from our caches, the render produces the same
- * output as before hibernation.
- */
-import type { FiberCompiler } from "../compiler/fiber-compiler";
-import type { TimelineEntry } from "../hooks/types";
-import type { SerializableCacheEntry } from "../hooks/runtime-context";
-/**
- * Serializable session snapshot.
- * This is what gets persisted to storage.
- */
-export interface SessionSnapshot {
-    /** Version for migration support */
-    version: 1;
-    /** Session ID */
-    sessionId: string;
-    /** Current tick number */
-    tick: number;
-    /** Conversation timeline */
-    timeline: SerializableTimelineEntry[];
-    /** COM state (key-value pairs) */
-    comState: Record<string, unknown>;
-    /** Data cache from useData */
-    dataCache: Record<string, SerializableCacheEntry>;
-    /** Timestamp when snapshot was taken */
-    createdAt: string;
-    /** Optional metadata */
-    metadata?: Record<string, unknown>;
-}
-/**
- * Timeline entry without non-serializable fields.
- */
-export interface SerializableTimelineEntry {
-    id: string;
-    role: "user" | "assistant" | "system" | "tool";
-    content: unknown;
-    createdAt: string;
-}
-export interface HibernateOptions {
-    /** Additional metadata to include in snapshot */
-    metadata?: Record<string, unknown>;
-}
-/**
- * Create a serializable snapshot of the session state.
- *
- * @example
- * ```typescript
- * const snapshot = hibernate(compiler, {
- *   sessionId: session.id,
- *   tick: session.currentTick,
- *   timeline: session.timeline,
- *   comState: session.ctx.state,
- * });
- *
- * // Store snapshot
- * await db.sessions.save(session.id, JSON.stringify(snapshot));
- * ```
- */
-export declare function hibernate(compiler: FiberCompiler, state: {
-    sessionId: string;
-    tick: number;
-    timeline: TimelineEntry[];
-    comState: Map<string, unknown>;
-}, options?: HibernateOptions): SessionSnapshot;
-export interface HydrateResult {
-    /** Session ID from snapshot */
-    sessionId: string;
-    /** Tick number to resume from */
-    tick: number;
-    /** Restored timeline */
-    timeline: TimelineEntry[];
-    /** Restored COM state */
-    comState: Map<string, unknown>;
-    /** Snapshot metadata */
-    metadata?: Record<string, unknown>;
-    /** When the snapshot was created */
-    snapshotCreatedAt: Date;
-}
-/**
- * Restore session state from a snapshot.
- *
- * This restores our caches and returns the state to apply to a session.
- * The session can then render and React will produce the same output
- * because our hooks read from the restored caches.
- *
- * @example
- * ```typescript
- * // Load snapshot from storage
- * const json = await db.sessions.get(sessionId);
- * const snapshot = JSON.parse(json) as SessionSnapshot;
- *
- * // Create compiler first
- * const compiler = new FiberCompiler(ctx);
- *
- * // Hydrate - restores data cache into compiler
- * const state = hydrate(compiler, snapshot);
- *
- * // Now create/configure session with restored state
- * session.timeline = state.timeline;
- * session.currentTick = state.tick;
- * // etc.
- * ```
- */
-export declare function hydrate(compiler: FiberCompiler, snapshot: SessionSnapshot): HydrateResult;
-/**
- * Check if a snapshot is valid.
- */
-export declare function isValidSnapshot(obj: unknown): obj is SessionSnapshot;
-/**
- * Get snapshot age in milliseconds.
- */
-export declare function getSnapshotAge(snapshot: SessionSnapshot): number;
-/**
- * Create a deep clone of a snapshot (for testing/debugging).
- */
-export declare function cloneSnapshot(snapshot: SessionSnapshot): SessionSnapshot;
-//# sourceMappingURL=index.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/hibernation/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAMvE;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,oCAAoC;IACpC,OAAO,EAAE,CAAC,CAAC;IAEX,iBAAiB;IACjB,SAAS,EAAE,MAAM,CAAC;IAElB,0BAA0B;IAC1B,IAAI,EAAE,MAAM,CAAC;IAEb,4BAA4B;IAC5B,QAAQ,EAAE,yBAAyB,EAAE,CAAC;IAEtC,kCAAkC;IAClC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAElC,8BAA8B;IAC9B,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,sBAAsB,CAAC,CAAC;IAElD,wCAAwC;IACxC,SAAS,EAAE,MAAM,CAAC;IAElB,wBAAwB;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,QAAQ,GAAG,MAAM,CAAC;IAC/C,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB;AAMD,MAAM,WAAW,gBAAgB;IAC/B,iDAAiD;IACjD,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,SAAS,CACvB,QAAQ,EAAE,aAAa,EACvB,KAAK,EAAE;IACL,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,aAAa,EAAE,CAAC;IAC1B,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC,EACD,OAAO,GAAE,gBAAqB,GAC7B,eAAe,CAgBjB;AAMD,MAAM,WAAW,aAAa;IAC5B,+BAA+B;IAC/B,SAAS,EAAE,MAAM,CAAC;IAElB,iCAAiC;IACjC,IAAI,EAAE,MAAM,CAAC;IAEb,wBAAwB;IACxB,QAAQ,EAAE,aAAa,EAAE,CAAC;IAE1B,yBAAyB;IACzB,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAE/B,wBAAwB;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAEnC,oCAAoC;IACpC,iBAAiB,EAAE,IAAI,CAAC;CACzB;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,OAAO,CAAC,QAAQ,EAAE,aAAa,EAAE,QAAQ,EAAE,eAAe,GAAG,aAAa,CA4BzF;AAMD;;GAEG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,eAAe,CAapE;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,eAAe,GAAG,MAAM,CAEhE;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,eAAe,GAAG,eAAe,CAExE"}

package/dist/hibernation/index.js

@@ -1,127 +0,0 @@
-/**
- * Session Hibernation
- *
- * Serialize and restore session state for persistence.
- *
- * Unlike React's hydration (which is about attaching to pre-rendered DOM),
- * this is about serializing our state and restoring it later.
- *
- * Key insight: We don't need to serialize React's fiber tree. We serialize
- * OUR state, and React rebuilds its tree from scratch on restore. Since our
- * hooks (useData, etc.) read from our caches, the render produces the same
- * output as before hibernation.
- */
-/**
- * Create a serializable snapshot of the session state.
- *
- * @example
- * ```typescript
- * const snapshot = hibernate(compiler, {
- *   sessionId: session.id,
- *   tick: session.currentTick,
- *   timeline: session.timeline,
- *   comState: session.ctx.state,
- * });
- *
- * // Store snapshot
- * await db.sessions.save(session.id, JSON.stringify(snapshot));
- * ```
- */
-export function hibernate(compiler, state, options = {}) {
-    return {
-        version: 1,
-        sessionId: state.sessionId,
-        tick: state.tick,
-        timeline: state.timeline.map((entry) => ({
-            id: entry.id,
-            role: entry.role,
-            content: entry.content,
-            createdAt: entry.createdAt.toISOString(),
-        })),
-        comState: Object.fromEntries(state.comState),
-        dataCache: compiler.getSerializableDataCache(),
-        createdAt: new Date().toISOString(),
-        metadata: options.metadata,
-    };
-}
-/**
- * Restore session state from a snapshot.
- *
- * This restores our caches and returns the state to apply to a session.
- * The session can then render and React will produce the same output
- * because our hooks read from the restored caches.
- *
- * @example
- * ```typescript
- * // Load snapshot from storage
- * const json = await db.sessions.get(sessionId);
- * const snapshot = JSON.parse(json) as SessionSnapshot;
- *
- * // Create compiler first
- * const compiler = new FiberCompiler(ctx);
- *
- * // Hydrate - restores data cache into compiler
- * const state = hydrate(compiler, snapshot);
- *
- * // Now create/configure session with restored state
- * session.timeline = state.timeline;
- * session.currentTick = state.tick;
- * // etc.
- * ```
- */
-export function hydrate(compiler, snapshot) {
-    // Validate version
-    if (snapshot.version !== 1) {
-        throw new Error(`Unsupported snapshot version: ${snapshot.version}`);
-    }
-    // Restore data cache into the compiler's runtime store
-    compiler.setDataCache(snapshot.dataCache);
-    // Convert timeline dates back
-    const timeline = snapshot.timeline.map((entry) => ({
-        id: entry.id,
-        role: entry.role,
-        content: entry.content,
-        createdAt: new Date(entry.createdAt),
-    }));
-    // Convert comState back to Map
-    const comState = new Map(Object.entries(snapshot.comState));
-    return {
-        sessionId: snapshot.sessionId,
-        tick: snapshot.tick,
-        timeline,
-        comState,
-        metadata: snapshot.metadata,
-        snapshotCreatedAt: new Date(snapshot.createdAt),
-    };
-}
-// ============================================================
-// Utilities
-// ============================================================
-/**
- * Check if a snapshot is valid.
- */
-export function isValidSnapshot(obj) {
-    if (!obj || typeof obj !== "object")
-        return false;
-    const s = obj;
-    return (s.version === 1 &&
-        typeof s.sessionId === "string" &&
-        typeof s.tick === "number" &&
-        Array.isArray(s.timeline) &&
-        typeof s.comState === "object" &&
-        typeof s.dataCache === "object" &&
-        typeof s.createdAt === "string");
-}
-/**
- * Get snapshot age in milliseconds.
- */
-export function getSnapshotAge(snapshot) {
-    return Date.now() - new Date(snapshot.createdAt).getTime();
-}
-/**
- * Create a deep clone of a snapshot (for testing/debugging).
- */
-export function cloneSnapshot(snapshot) {
-    return JSON.parse(JSON.stringify(snapshot));
-}
-//# sourceMappingURL=index.js.map

package/dist/hibernation/index.js.map

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