opencode-flema-engram-sidebar 0.1.8 → 0.3.0

package/dist/pi.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pi.d.ts","sourceRoot":"","sources":["../src/pi.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAQzD,OAAO,EAEL,KAAK,iBAAiB,EACvB,MAAM,6BAA6B,CAAC;AAMrC,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,SAAS,KAAK,IAAI,CAAC;IAC5D,SAAS,EAAE,CACT,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,EAAE,GAAG,SAAS,EAC3B,OAAO,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,aAAa,GAAG,aAAa,CAAA;KAAE,KACpD,IAAI,CAAC;IACV,MAAM,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,KAAK,IAAI,CAAC;CACzE;AAED,MAAM,WAAW,kBAAkB;IACjC,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,OAAO,CAAC;IACf,EAAE,EAAE,aAAa,CAAC;CACnB;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,aAAa,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,CACF,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,kBAAkB,KAAK,OAAO,KAC9E,MAAM,IAAI,CAAC;IAChB,eAAe,EAAE,CACf,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE;QACP,WAAW,EAAE,MAAM,CAAC;QACpB,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,kBAAkB,KAAK,OAAO,CAAC;KACjE,KACE,IAAI,CAAC;CACX;AAED,MAAM,WAAW,6BAA6B;IAC5C,aAAa,CAAC,EAAE,MAAM,aAAa,CAAC;IACpC,cAAc,CAAC,EAAE,CAAC,OAAO,EAAE,aAAa,EAAE,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,iBAAiB,CAAC,CAAC;CACtF;AAQD,wBAAgB,uBAAuB,CACrC,YAAY,GAAE,6BAAkC,GAC/C,CAAC,EAAE,EAAE,cAAc,KAAK,IAAI,CAoF9B;6BApFO,cAAc,KAAK,IAAI;AA8H/B,wBAAyC"}

package/dist/pi.js

@@ -0,0 +1,123 @@
+import { createConfiguredAdapter } from "./adapters/factory.js";
+import { createEngramReadController, } from "./viewer/core.js";
+import { resolveProject as resolveValidatedProject, } from "./utils/project-resolver.js";
+const UI_KEY = "flema-engram";
+const REFRESH_COMMAND = "engram-refresh";
+const MEMORY_SAVE_TOOLS = new Set(["mem_save", "save_memory"]);
+export function createPiEngramExtension(dependencies = {}) {
+    const createAdapter = dependencies.createAdapter ?? (() => createConfiguredAdapter());
+    const resolveProject = dependencies.resolveProject
+        ?? ((adapter, cwd) => resolveValidatedProject(adapter, cwd));
+    return (pi) => {
+        let active;
+        let sessionToken;
+        const clearUi = (context) => {
+            if (!context.hasUI)
+                return;
+            context.ui.setStatus(UI_KEY, undefined);
+            context.ui.setWidget(UI_KEY, undefined);
+        };
+        const stopActive = () => {
+            if (!active)
+                return;
+            active.controller.dispose();
+            clearUi(active.context);
+            active = undefined;
+        };
+        const renderUnavailable = (context) => {
+            context.ui.setStatus(UI_KEY, "Engram unavailable");
+            context.ui.setWidget(UI_KEY, ["Engram unavailable"], { placement: "belowEditor" });
+        };
+        const refreshActive = async () => {
+            const current = active;
+            if (!current)
+                return undefined;
+            const outcome = await current.controller.refresh();
+            return active?.token === current.token ? outcome : undefined;
+        };
+        pi.on("session_start", async (_event, context) => {
+            stopActive();
+            const token = Symbol("pi-engram-session");
+            sessionToken = token;
+            if (!context.hasUI)
+                return;
+            try {
+                const adapter = createAdapter();
+                const controller = createEngramReadController(adapter, {
+                    resolveProject: () => resolveProject(adapter, context.cwd),
+                    onState: (state) => {
+                        if (active?.token !== token)
+                            return;
+                        renderState(context, state);
+                    },
+                });
+                active = { controller, context, token };
+                await refreshActive();
+            }
+            catch {
+                if (sessionToken !== token)
+                    return;
+                stopActive();
+                renderUnavailable(context);
+            }
+        });
+        pi.on("tool_result", async (event, _context) => {
+            if (!isPiToolResultEvent(event) || event.isError || !MEMORY_SAVE_TOOLS.has(event.toolName))
+                return;
+            await refreshActive();
+        });
+        pi.on("session_shutdown", (_event, _context) => {
+            sessionToken = undefined;
+            stopActive();
+        });
+        pi.registerCommand(REFRESH_COMMAND, {
+            description: "Refresh the Flema Engram status and widget",
+            handler: async (_args, context) => {
+                if (!active) {
+                    context.ui.notify("Engram viewer is not active", "warning");
+                    return;
+                }
+                const outcome = await refreshActive();
+                if (outcome?.status === "success") {
+                    context.ui.notify("Engram refreshed", "info");
+                }
+                else {
+                    context.ui.notify("Engram refresh incomplete", "warning");
+                }
+            },
+        });
+    };
+}
+function isPiToolResultEvent(event) {
+    return typeof event.toolName === "string" && typeof event.isError === "boolean";
+}
+function renderState(context, state) {
+    const health = state.health.toUpperCase();
+    const project = state.projectName ?? "unresolved project";
+    const progress = aggregateOddProgress(state);
+    const blockerCount = state.blockers.length + progress.blocked;
+    const statusParts = [`Engram ${health}`, project];
+    if (progress.total > 0)
+        statusParts.push(`ODD ${progress.done}/${progress.total}`);
+    if (blockerCount > 0)
+        statusParts.push(`${blockerCount} blocked`);
+    context.ui.setStatus(UI_KEY, statusParts.join(" · "));
+    const lines = [`Engram · ${project} [${health}]`];
+    lines.push(progress.total > 0
+        ? `ODD ${progress.done}/${progress.total} done · ${progress.inProgress} active · ${blockerCount} blocked`
+        : "ODD no tracked feature");
+    const latest = state.recentActivity[0];
+    if (latest)
+        lines.push(`Latest: ${latest.title}`);
+    context.ui.setWidget(UI_KEY, lines, { placement: "belowEditor" });
+}
+function aggregateOddProgress(state) {
+    return (state.odd?.features ?? []).reduce((total, feature) => ({
+        total: total.total + feature.progress.total,
+        done: total.done + feature.progress.done,
+        inProgress: total.inProgress + feature.progress.in_progress,
+        blocked: total.blocked + feature.progress.blocked,
+    }), { total: 0, done: 0, inProgress: 0, blocked: 0 });
+}
+export default createPiEngramExtension();
+//# sourceMappingURL=pi.js.map

package/dist/pi.js.map

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

package/dist/schemas/health.d.ts

@@ -5,12 +5,12 @@ export declare const localHealthResponseSchema: z.ZodObject<{
     version: z.ZodString;
 }, "strip", z.ZodTypeAny, {
     status: string;
-    service: string;
     version: string;
+    service: string;
 }, {
     status: string;
-    service: string;
     version: string;
+    service: string;
 }>;
 export type LocalHealthResponse = z.infer<typeof localHealthResponseSchema>;
 export declare const cloudHealthResponseSchema: z.ZodObject<{
@@ -19,12 +19,12 @@ export declare const cloudHealthResponseSchema: z.ZodObject<{
     version: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
     status: string;
-    service?: string | undefined;
     version?: string | undefined;
+    service?: string | undefined;
 }, {
     status: string;
-    service?: string | undefined;
     version?: string | undefined;
+    service?: string | undefined;
 }>;
 export type CloudHealthResponse = z.infer<typeof cloudHealthResponseSchema>;
 //# sourceMappingURL=health.d.ts.map

package/dist/schemas/observation.d.ts

@@ -11,9 +11,9 @@ export declare const observationSchema: z.ZodObject<{
     created_at: z.ZodEffects<z.ZodString, string, unknown>;
 }, "strip", z.ZodTypeAny, {
     project: string;
-    type: string;
     id: number;
     title: string;
+    type: string;
     topic_key: string;
     content: string;
     scope: "project" | "personal";
@@ -21,9 +21,9 @@ export declare const observationSchema: z.ZodObject<{
     created_at: string;
 }, {
     project: string;
-    type: string;
     id: number;
     title: string;
+    type: string;
     content: string;
     scope: "project" | "personal";
     topic_key?: string | undefined;

package/dist/schemas/odd-state.d.ts

@@ -5,13 +5,13 @@ export declare const oddTaskSchema: z.ZodObject<{
     title: z.ZodString;
     status: z.ZodEnum<["pending", "in_progress", "blocked", "done", "cancelled"]>;
 }, "strip", z.ZodTypeAny, {
-    status: "pending" | "in_progress" | "blocked" | "done" | "cancelled";
     id: string;
     title: string;
+    status: "pending" | "done" | "in_progress" | "blocked" | "cancelled";
 }, {
-    status: "pending" | "in_progress" | "blocked" | "done" | "cancelled";
     id: string;
     title: string;
+    status: "pending" | "done" | "in_progress" | "blocked" | "cancelled";
 }>;
 export declare const oddProvenanceSchema: z.ZodObject<{
     observationId: z.ZodNumber;
@@ -38,13 +38,13 @@ export declare const oddFeatureSchema: z.ZodObject<{
         title: z.ZodString;
         status: z.ZodEnum<["pending", "in_progress", "blocked", "done", "cancelled"]>;
     }, "strip", z.ZodTypeAny, {
-        status: "pending" | "in_progress" | "blocked" | "done" | "cancelled";
         id: string;
         title: string;
+        status: "pending" | "done" | "in_progress" | "blocked" | "cancelled";
     }, {
-        status: "pending" | "in_progress" | "blocked" | "done" | "cancelled";
         id: string;
         title: string;
+        status: "pending" | "done" | "in_progress" | "blocked" | "cancelled";
     }>, "many">;
     progress: z.ZodObject<{
         total: z.ZodNumber;
@@ -55,16 +55,16 @@ export declare const oddFeatureSchema: z.ZodObject<{
         cancelled: z.ZodNumber;
     }, "strip", z.ZodTypeAny, {
         pending: number;
+        done: number;
         in_progress: number;
         blocked: number;
-        done: number;
         cancelled: number;
         total: number;
     }, {
         pending: number;
+        done: number;
         in_progress: number;
         blocked: number;
-        done: number;
         cancelled: number;
         total: number;
     }>;
@@ -85,19 +85,19 @@ export declare const oddFeatureSchema: z.ZodObject<{
         updatedAt: string;
     }>;
 }, "strip", z.ZodTypeAny, {
-    title: string;
-    version: 1;
-    featureId: string;
     tasks: {
-        status: "pending" | "in_progress" | "blocked" | "done" | "cancelled";
         id: string;
         title: string;
+        status: "pending" | "done" | "in_progress" | "blocked" | "cancelled";
     }[];
+    title: string;
+    version: 1;
+    featureId: string;
     progress: {
         pending: number;
+        done: number;
         in_progress: number;
         blocked: number;
-        done: number;
         cancelled: number;
         total: number;
     };
@@ -108,19 +108,19 @@ export declare const oddFeatureSchema: z.ZodObject<{
         updatedAt: string;
     };
 }, {
-    title: string;
-    version: 1;
-    featureId: string;
     tasks: {
-        status: "pending" | "in_progress" | "blocked" | "done" | "cancelled";
         id: string;
         title: string;
+        status: "pending" | "done" | "in_progress" | "blocked" | "cancelled";
     }[];
+    title: string;
+    version: 1;
+    featureId: string;
     progress: {
         pending: number;
+        done: number;
         in_progress: number;
         blocked: number;
-        done: number;
         cancelled: number;
         total: number;
     };
@@ -183,13 +183,13 @@ export declare const oddStateSchema: z.ZodObject<{
             title: z.ZodString;
             status: z.ZodEnum<["pending", "in_progress", "blocked", "done", "cancelled"]>;
         }, "strip", z.ZodTypeAny, {
-            status: "pending" | "in_progress" | "blocked" | "done" | "cancelled";
             id: string;
             title: string;
+            status: "pending" | "done" | "in_progress" | "blocked" | "cancelled";
         }, {
-            status: "pending" | "in_progress" | "blocked" | "done" | "cancelled";
             id: string;
             title: string;
+            status: "pending" | "done" | "in_progress" | "blocked" | "cancelled";
         }>, "many">;
         progress: z.ZodObject<{
             total: z.ZodNumber;
@@ -200,16 +200,16 @@ export declare const oddStateSchema: z.ZodObject<{
             cancelled: z.ZodNumber;
         }, "strip", z.ZodTypeAny, {
             pending: number;
+            done: number;
             in_progress: number;
             blocked: number;
-            done: number;
             cancelled: number;
             total: number;
         }, {
             pending: number;
+            done: number;
             in_progress: number;
             blocked: number;
-            done: number;
             cancelled: number;
             total: number;
         }>;
@@ -230,19 +230,19 @@ export declare const oddStateSchema: z.ZodObject<{
             updatedAt: string;
         }>;
     }, "strip", z.ZodTypeAny, {
-        title: string;
-        version: 1;
-        featureId: string;
         tasks: {
-            status: "pending" | "in_progress" | "blocked" | "done" | "cancelled";
             id: string;
             title: string;
+            status: "pending" | "done" | "in_progress" | "blocked" | "cancelled";
         }[];
+        title: string;
+        version: 1;
+        featureId: string;
         progress: {
             pending: number;
+            done: number;
             in_progress: number;
             blocked: number;
-            done: number;
             cancelled: number;
             total: number;
         };
@@ -253,19 +253,19 @@ export declare const oddStateSchema: z.ZodObject<{
             updatedAt: string;
         };
     }, {
-        title: string;
-        version: 1;
-        featureId: string;
         tasks: {
-            status: "pending" | "in_progress" | "blocked" | "done" | "cancelled";
             id: string;
             title: string;
+            status: "pending" | "done" | "in_progress" | "blocked" | "cancelled";
         }[];
+        title: string;
+        version: 1;
+        featureId: string;
         progress: {
             pending: number;
+            done: number;
             in_progress: number;
             blocked: number;
-            done: number;
             cancelled: number;
             total: number;
         };
@@ -320,19 +320,19 @@ export declare const oddStateSchema: z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     bounded: true;
     features: {
-        title: string;
-        version: 1;
-        featureId: string;
         tasks: {
-            status: "pending" | "in_progress" | "blocked" | "done" | "cancelled";
             id: string;
             title: string;
+            status: "pending" | "done" | "in_progress" | "blocked" | "cancelled";
         }[];
+        title: string;
+        version: 1;
+        featureId: string;
         progress: {
             pending: number;
+            done: number;
             in_progress: number;
             blocked: number;
-            done: number;
             cancelled: number;
             total: number;
         };
@@ -357,19 +357,19 @@ export declare const oddStateSchema: z.ZodObject<{
 }, {
     bounded: true;
     features: {
-        title: string;
-        version: 1;
-        featureId: string;
         tasks: {
-            status: "pending" | "in_progress" | "blocked" | "done" | "cancelled";
             id: string;
             title: string;
+            status: "pending" | "done" | "in_progress" | "blocked" | "cancelled";
         }[];
+        title: string;
+        version: 1;
+        featureId: string;
         progress: {
             pending: number;
+            done: number;
             in_progress: number;
             blocked: number;
-            done: number;
             cancelled: number;
             total: number;
         };

package/dist/schemas/project.d.ts

@@ -5,14 +5,14 @@ export declare const projectSchema: z.ZodObject<{
     lastActiveAt: z.ZodString;
     scopes: z.ZodArray<z.ZodEnum<["project", "personal"]>, "many">;
 }, "strip", z.ZodTypeAny, {
+    name: string;
     observationCount: number;
     lastActiveAt: string;
-    name: string;
     scopes: ("project" | "personal")[];
 }, {
+    name: string;
     observationCount: number;
     lastActiveAt: string;
-    name: string;
     scopes: ("project" | "personal")[];
 }>;
 export type ProjectSchema = z.infer<typeof projectSchema>;

package/dist/schemas/session.d.ts

@@ -45,9 +45,9 @@ export declare const sessionWithObservationsSchema: z.ZodEffects<z.ZodObject<{
         created_at: z.ZodEffects<z.ZodString, string, unknown>;
     }, "strip", z.ZodTypeAny, {
         project: string;
-        type: string;
         id: number;
         title: string;
+        type: string;
         topic_key: string;
         content: string;
         scope: "project" | "personal";
@@ -55,9 +55,9 @@ export declare const sessionWithObservationsSchema: z.ZodEffects<z.ZodObject<{
         created_at: string;
     }, {
         project: string;
-        type: string;
         id: number;
         title: string;
+        type: string;
         content: string;
         scope: "project" | "personal";
         topic_key?: string | undefined;
@@ -72,71 +72,71 @@ export declare const sessionWithObservationsSchema: z.ZodEffects<z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     project: string;
     id: string;
-    started_at: string;
-    observation_count: number;
     observations: {
         project: string;
-        type: string;
         id: number;
         title: string;
+        type: string;
         topic_key: string;
         content: string;
         scope: "project" | "personal";
         updated_at: string;
         created_at: string;
     }[];
+    started_at: string;
+    observation_count: number;
     updated_at?: string | undefined;
 }, {
     project: string;
     id: string;
-    observation_count: number;
     observations: {
         project: string;
-        type: string;
         id: number;
         title: string;
+        type: string;
         content: string;
         scope: "project" | "personal";
         topic_key?: string | undefined;
         updated_at?: unknown;
         created_at?: unknown;
     }[];
+    observation_count: number;
     updated_at?: unknown;
     started_at?: unknown;
 }>, Omit<{
     project: string;
     id: string;
-    started_at: string;
-    observation_count: number;
     observations: {
         project: string;
-        type: string;
         id: number;
         title: string;
+        type: string;
         topic_key: string;
         content: string;
         scope: "project" | "personal";
         updated_at: string;
         created_at: string;
     }[];
+    started_at: string;
+    observation_count: number;
     updated_at?: string | undefined;
 }, "updated_at"> & {
     updated_at: string;
 }, {
     project: string;
     id: string;
-    observation_count: number;
     observations: {
         project: string;
-        type: string;
         id: number;
         title: string;
+        type: string;
         content: string;
         scope: "project" | "personal";
         topic_key?: string | undefined;
         updated_at?: unknown;
         created_at?: unknown;
     }[];
+    observation_count: number;
     updated_at?: unknown;
     started_at?: unknown;
 }>;

package/dist/sidebar/hooks/use-engram.d.ts

@@ -1,89 +1,11 @@
 import { type Accessor } from "solid-js";
-import type { EngramAdapter, EngramTargets, HealthStatus, Observation, Project } from "../../adapters/types.js";
-import { type SDDChange } from "../../utils/sdd-detector.js";
-import type { ODDState } from "../../schemas/odd-state.js";
-import type { ProjectResolution } from "../../utils/project-resolver.js";
-export type SidebarHealth = "loading" | "ok" | "stale" | "error" | "offline";
-export type SidebarWorkflowMode = "odd" | "legacy-sdd";
-export interface SidebarViewModel {
-    workflowMode?: SidebarWorkflowMode;
-    projectName?: string;
-    project?: Project;
-    resolution?: ProjectResolution;
-    changes: SDDChange[];
-    odd?: ODDState;
-    observations?: Observation[];
-    blockers: Observation[];
-    recentActivity: Observation[];
-    health: SidebarHealth;
-    loading: boolean;
-    lastRefreshAt?: Date;
-    error?: string;
-    terminal?: SidebarTerminalState;
-    targets?: EngramTargets;
-}
-export interface SidebarTerminalState {
-    status: "loading" | SidebarRefreshOutcomeStatus;
-    stage: SidebarOperationStage | "mounted" | "refresh";
-    health: SidebarHealth;
-    observationCount: number;
-}
-export interface UseEngramOptions {
-    projectName?: string;
-    resolution?: ProjectResolution;
-    initialError?: string;
-    pollInterval?: number;
-    enabled?: boolean;
-    autoRefresh?: boolean;
-    resolveProject?: () => Promise<ProjectResolution>;
-    now?: () => Date;
-    stageTimeoutMs?: number;
-}
+import type { EngramAdapter } from "../../adapters/types.js";
+import { type SidebarRefreshOutcome, type SidebarViewModel, type SidebarWorkflowMode, type UseEngramOptions } from "../../viewer/core.js";
+export * from "../../viewer/core.js";
 export interface UseEngramReturn {
     state: Accessor<SidebarViewModel>;
     refresh: () => Promise<SidebarRefreshOutcome>;
     setWorkflowMode: (mode: SidebarWorkflowMode) => void;
 }
-export interface SidebarRefreshInput {
-    health?: HealthStatus;
-    projects?: Project[];
-    observations?: Observation[];
-    projectName?: string;
-    resolution?: ProjectResolution;
-    errors?: unknown[];
-    failures?: SidebarRefreshFailure[];
-    warnings?: string[];
-    stages?: SidebarStageTransition[];
-    targets?: EngramTargets;
-    now: Date;
-}
-export type SidebarRefreshStage = "project-resolution" | "health" | "projects" | "observations" | "refresh";
-export interface SidebarRefreshFailure {
-    stage: SidebarRefreshStage;
-    endpoint?: string;
-    reason: unknown;
-}
-export type SidebarRefreshOutcomeStatus = "success" | "partial" | "failed";
-export type SidebarTransitionStatus = "started" | SidebarRefreshOutcomeStatus | "skipped";
-export type SidebarOperationStage = "project-resolution" | "health" | "projects" | "filtered-observations" | "fallback-observations" | "reducing" | "terminal";
-export interface SidebarStageTransition {
-    stage: SidebarOperationStage;
-    status: SidebarTransitionStatus;
-    endpoint?: string;
-    count?: number;
-    message?: string;
-}
-export interface SidebarRefreshOutcome {
-    status: SidebarRefreshOutcomeStatus;
-    summary: string;
-    failures: SidebarRefreshFailure[];
-    warnings: string[];
-    stages: SidebarStageTransition[];
-}
-export declare function reduceSidebarRefresh(current: SidebarViewModel, input: SidebarRefreshInput): SidebarViewModel;
-export declare function fetchSidebarRefresh(adapter: EngramAdapter, options?: Pick<UseEngramOptions, "projectName" | "resolution" | "resolveProject" | "now" | "stageTimeoutMs"> & {
-    onTransition?: (transition: SidebarStageTransition) => void;
-}): Promise<SidebarRefreshInput>;
 export declare function useEngram(adapter: EngramAdapter, options?: UseEngramOptions): UseEngramReturn;
-export declare function outcomeFor(input: SidebarRefreshInput): SidebarRefreshOutcome;
 //# sourceMappingURL=use-engram.d.ts.map

package/dist/sidebar/hooks/use-engram.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-engram.d.ts","sourceRoot":"","sources":["../../../src/sidebar/hooks/use-engram.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"use-engram.d.ts","sourceRoot":"","sources":["../../../src/sidebar/hooks/use-engram.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoC,KAAK,QAAQ,EAAE,MAAM,UAAU,CAAC;AAC3E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAEL,KAAK,qBAAqB,EAC1B,KAAK,gBAAgB,EACrB,KAAK,mBAAmB,EACxB,KAAK,gBAAgB,EACtB,MAAM,sBAAsB,CAAC;AAE9B,cAAc,sBAAsB,CAAC;AAErC,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,QAAQ,CAAC,gBAAgB,CAAC,CAAC;IAClC,OAAO,EAAE,MAAM,OAAO,CAAC,qBAAqB,CAAC,CAAC;IAC9C,eAAe,EAAE,CAAC,IAAI,EAAE,mBAAmB,KAAK,IAAI,CAAC;CACtD;AAID,wBAAgB,SAAS,CACvB,OAAO,EAAE,aAAa,EACtB,OAAO,GAAE,gBAAqB,GAC7B,eAAe,CAuDjB"}