@agentick/core 0.2.0 → 0.3.0

package/dist/hibernation/index.d.ts

@@ -1,126 +0,0 @@
-/**
- * V2 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 @@
-/**
- * V2 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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"}