@abstractframework/monitor-active-memory 0.1.0

package/README.md

@@ -0,0 +1,76 @@
+# @abstractuic/monitor-active-memory
+
+ReactFlow-based explorer for **Knowledge Graph assertions** (`KgAssertion`) and the derived **Active Memory** text.
+
+## What you get
+
+- `KgActiveMemoryExplorer` component (see `monitor-active-memory/src/KgActiveMemoryExplorer.tsx`)
+- Graph/layout utilities (see `monitor-active-memory/src/graph.ts`):
+  - `buildKgGraph`, `shortestPath`
+  - `buildKgLayout` + force-layout helpers (`initForceSimulation`, `stepForceSimulation`, …)
+- Types / contracts (see `monitor-active-memory/src/types.ts`):
+  - `KgAssertion`, `KgQueryParams`, `KgQueryResult`
+
+## Peer dependencies
+
+Declared in `monitor-active-memory/package.json`:
+
+- `react@^18`, `react-dom@^18`
+- `reactflow@^11`
+
+## Install
+
+- Workspace: add a dependency on `@abstractuic/monitor-active-memory`
+- npm (once published): `npm i @abstractuic/monitor-active-memory`
+
+## Usage
+
+```tsx
+import { KgActiveMemoryExplorer, type KgAssertion } from "@abstractuic/monitor-active-memory";
+
+const items: KgAssertion[] = [];
+
+export function MemoryView() {
+  return (
+    <KgActiveMemoryExplorer
+      title="Active Memory"
+      items={items}
+      activeMemoryText=""
+      onQuery={async (params) => {
+        // Your host decides how to fetch/search KG assertions.
+        return { ok: true, items: [], active_memory_text: "" };
+      }}
+    />
+  );
+}
+```
+
+## Key props (host integration points)
+
+Authoritative prop types live in `monitor-active-memory/src/KgActiveMemoryExplorer.tsx` (`KgActiveMemoryExplorerProps`).
+
+- `items: KgAssertion[]` (required)
+- `activeMemoryText?: string`
+- `onQuery?: (params: KgQueryParams) => Promise<KgQueryResult>` (enables the query UI)
+- `queryMode?: "override" | "replace"` (how query results interact with `items`)
+- `onItemsReplace?: (items, meta) => void` (used when `queryMode === "replace"`)
+- `onOpenSpan?` / `onOpenTranscript?` (optional host navigation hooks)
+
+## Layout persistence
+
+The component can persist per-view layouts in `localStorage` under key `abstractuic_amx_saved_layouts_v1` (see `monitor-active-memory/src/KgActiveMemoryExplorer.tsx`).
+
+## CSS
+
+- ReactFlow base styles are **not** imported by this package. In your app:
+
+```ts
+import "reactflow/dist/style.css";
+```
+
+- This package imports `monitor-active-memory/src/styles.css` internally.
+
+## Related docs
+
+- Getting started: [`docs/getting-started.md`](../docs/getting-started.md)
+- Architecture: [`docs/architecture.md`](../docs/architecture.md)

package/dist/KgActiveMemoryExplorer.d.ts

@@ -0,0 +1,33 @@
+import type { JsonValue, KgAssertion, KgQueryParams, KgQueryResult } from './types';
+import './styles.css';
+export interface KgActiveMemoryExplorerProps {
+    title?: string;
+    resetKey?: string;
+    queryMode?: 'override' | 'replace';
+    items: KgAssertion[];
+    activeMemoryText?: string;
+    packets?: JsonValue[];
+    packetsVersion?: number;
+    packedCount?: number;
+    dropped?: number;
+    estimatedTokens?: number;
+    effort?: JsonValue;
+    warnings?: JsonValue;
+    onQuery?: (params: KgQueryParams) => Promise<KgQueryResult>;
+    onItemsReplace?: (items: KgAssertion[], meta: {
+        kind: 'live query' | 'expanded neighborhood';
+        result: KgQueryResult;
+    }) => void;
+    onOpenSpan?: (args: {
+        span_id: string;
+        run_id: string;
+        assertion: KgAssertion;
+    }) => void;
+    onOpenTranscript?: (args: {
+        run_id: string;
+        span_id?: string;
+        assertion: KgAssertion;
+    }) => void;
+}
+export declare function KgActiveMemoryExplorer({ title, resetKey, queryMode, items, activeMemoryText, packets, packetsVersion, packedCount, dropped, estimatedTokens, effort, warnings, onQuery, onItemsReplace, onOpenSpan, onOpenTranscript, }: KgActiveMemoryExplorerProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=KgActiveMemoryExplorer.d.ts.map

package/dist/KgActiveMemoryExplorer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"KgActiveMemoryExplorer.d.ts","sourceRoot":"","sources":["../src/KgActiveMemoryExplorer.tsx"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,aAAa,EAAE,aAAa,EAA4B,MAAM,SAAS,CAAC;AAC9G,OAAO,cAAc,CAAC;AAEtB,MAAM,WAAW,2BAA2B;IAC1C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,UAAU,GAAG,SAAS,CAAC;IACnC,KAAK,EAAE,WAAW,EAAE,CAAC;IACrB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,OAAO,CAAC,EAAE,SAAS,EAAE,CAAC;IACtB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,aAAa,KAAK,OAAO,CAAC,aAAa,CAAC,CAAC;IAC5D,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,WAAW,EAAE,EAAE,IAAI,EAAE;QAAE,IAAI,EAAE,YAAY,GAAG,uBAAuB,CAAC;QAAC,MAAM,EAAE,aAAa,CAAA;KAAE,KAAK,IAAI,CAAC;IAC/H,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,WAAW,CAAA;KAAE,KAAK,IAAI,CAAC;IACzF,gBAAgB,CAAC,EAAE,CAAC,IAAI,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,WAAW,CAAA;KAAE,KAAK,IAAI,CAAC;CACjG;AAgSD,wBAAgB,sBAAsB,CAAC,EACrC,KAAK,EACL,QAAQ,EACR,SAAS,EACT,KAAK,EACL,gBAAgB,EAChB,OAAO,EACP,cAAc,EACd,WAAW,EACX,OAAO,EACP,eAAe,EACf,MAAM,EACN,QAAQ,EACR,OAAO,EACP,cAAc,EACd,UAAU,EACV,gBAAgB,GACjB,EAAE,2BAA2B,2CAypD7B"}