@persql/context 0.1.0

package/dist/index.d.cts

@@ -0,0 +1,87 @@
+import { PerSQLDatabase } from '@persql/sdk';
+import { ExtractedContext, RememberInput, RecallOptions, MemoryRow, ListOptions, Entity, Edge } from './core.cjs';
+export { EXTRACTION_JSON_SCHEMA, EXTRACTION_SYSTEM_PROMPT, EdgeInput, EntityInput, MemoryKind, SCHEMA_SQL, SCHEMA_VERSION, SqlStatement, TABLE_PREFIX, buildByTag, buildEdgesAmong, buildExtractionMessages, buildForget, buildGet, buildInit, buildNeighborEntities, buildRecall, buildRecent, buildRemember, buildStats, buildSupersede, buildUpsertEdge, buildUpsertEntity, entityId, normalizeTags, toFtsQuery } from './core.cjs';
+
+/**
+ * @persql/context — shared, structured agent context on the PerSQL substrate.
+ *
+ * One store, readable and writable from every agent surface PerSQL speaks
+ * (SDK, MCP, published endpoints, CLI). Reads and structured writes are plain
+ * SQL over `@persql/sdk` — cheap, exact, lexical (FTS5). The raw-dump extract
+ * path puts the LLM on the *write* side: file once, recall by keyword forever.
+ */
+
+/** Bring-your-own-LLM extractor, or use the hosted PerSQL Context worker. */
+type Extractor = (raw: string, ctx: {
+    hint?: string;
+}) => Promise<ExtractedContext>;
+interface ContextStoreOptions {
+    /** Default extractor for `rememberRaw` (model-agnostic; you supply it). */
+    extract?: Extractor;
+    /** Default provenance label stamped on writes (e.g. "claude-code"). */
+    source?: string;
+}
+interface WriteResult {
+    memoryIds: string[];
+    entityIds: string[];
+    edgeCount: number;
+}
+interface ContextStats {
+    facts: number;
+    factsTotal: number;
+    entities: number;
+    edges: number;
+}
+declare class ContextStore {
+    private readonly db;
+    private readonly opts;
+    constructor(db: PerSQLDatabase, opts?: ContextStoreOptions);
+    /** Create the schema (idempotent). Run once before first use. */
+    init(): Promise<void>;
+    /** Store one structured fact/episode/artifact. Returns its id. */
+    remember(input: RememberInput): Promise<string>;
+    /**
+     * Extract durable context from raw text and store it. The LLM runs on the
+     * write path; pass `extract` here or to the constructor (or use the hosted
+     * Context MCP, which runs extraction server-side and meters it).
+     */
+    rememberRaw(raw: string, opts?: {
+        extract?: Extractor;
+        hint?: string;
+        source?: string;
+    }): Promise<WriteResult>;
+    /** Persist an already-extracted bundle of facts, entities, and edges. */
+    write(extracted: ExtractedContext, opts?: {
+        source?: string;
+    }): Promise<WriteResult>;
+    /** Mark older memory rows as replaced by `newId` (filtered out of recall). */
+    supersede(oldIds: string | string[], newId: string): Promise<void>;
+    /** Hard-delete a memory row. */
+    forget(id: string): Promise<void>;
+    /** Add a relationship between two entities (created if absent). */
+    link(src: string, rel: string, dst: string, opts?: {
+        source?: string;
+    }): Promise<void>;
+    /** Keyword recall, BM25-ranked, most relevant first. */
+    recall(query: string, opts?: RecallOptions): Promise<MemoryRow[]>;
+    /** Most recent memory rows. */
+    recent(opts?: ListOptions): Promise<MemoryRow[]>;
+    /** Memory rows carrying a given tag. */
+    byTag(tag: string, opts?: ListOptions): Promise<MemoryRow[]>;
+    /** Fetch one memory row by id, or null. */
+    get(id: string): Promise<MemoryRow | null>;
+    /** The subgraph around an entity: reachable entities + the edges among them. */
+    neighbors(name: string, opts?: {
+        depth?: number;
+        limit?: number;
+    }): Promise<{
+        entities: Entity[];
+        edges: Edge[];
+    }>;
+    /** Counts: current facts, total facts, entities, edges. */
+    stats(): Promise<ContextStats>;
+}
+/** Wrap a PerSQL database handle as a shared context store. */
+declare function context(db: PerSQLDatabase, opts?: ContextStoreOptions): ContextStore;
+
+export { type ContextStats, ContextStore, type ContextStoreOptions, Edge, Entity, ExtractedContext, type Extractor, ListOptions, MemoryRow, RecallOptions, RememberInput, type WriteResult, context };

package/dist/index.d.ts

@@ -0,0 +1,87 @@
+import { PerSQLDatabase } from '@persql/sdk';
+import { ExtractedContext, RememberInput, RecallOptions, MemoryRow, ListOptions, Entity, Edge } from './core.js';
+export { EXTRACTION_JSON_SCHEMA, EXTRACTION_SYSTEM_PROMPT, EdgeInput, EntityInput, MemoryKind, SCHEMA_SQL, SCHEMA_VERSION, SqlStatement, TABLE_PREFIX, buildByTag, buildEdgesAmong, buildExtractionMessages, buildForget, buildGet, buildInit, buildNeighborEntities, buildRecall, buildRecent, buildRemember, buildStats, buildSupersede, buildUpsertEdge, buildUpsertEntity, entityId, normalizeTags, toFtsQuery } from './core.js';
+
+/**
+ * @persql/context — shared, structured agent context on the PerSQL substrate.
+ *
+ * One store, readable and writable from every agent surface PerSQL speaks
+ * (SDK, MCP, published endpoints, CLI). Reads and structured writes are plain
+ * SQL over `@persql/sdk` — cheap, exact, lexical (FTS5). The raw-dump extract
+ * path puts the LLM on the *write* side: file once, recall by keyword forever.
+ */
+
+/** Bring-your-own-LLM extractor, or use the hosted PerSQL Context worker. */
+type Extractor = (raw: string, ctx: {
+    hint?: string;
+}) => Promise<ExtractedContext>;
+interface ContextStoreOptions {
+    /** Default extractor for `rememberRaw` (model-agnostic; you supply it). */
+    extract?: Extractor;
+    /** Default provenance label stamped on writes (e.g. "claude-code"). */
+    source?: string;
+}
+interface WriteResult {
+    memoryIds: string[];
+    entityIds: string[];
+    edgeCount: number;
+}
+interface ContextStats {
+    facts: number;
+    factsTotal: number;
+    entities: number;
+    edges: number;
+}
+declare class ContextStore {
+    private readonly db;
+    private readonly opts;
+    constructor(db: PerSQLDatabase, opts?: ContextStoreOptions);
+    /** Create the schema (idempotent). Run once before first use. */
+    init(): Promise<void>;
+    /** Store one structured fact/episode/artifact. Returns its id. */
+    remember(input: RememberInput): Promise<string>;
+    /**
+     * Extract durable context from raw text and store it. The LLM runs on the
+     * write path; pass `extract` here or to the constructor (or use the hosted
+     * Context MCP, which runs extraction server-side and meters it).
+     */
+    rememberRaw(raw: string, opts?: {
+        extract?: Extractor;
+        hint?: string;
+        source?: string;
+    }): Promise<WriteResult>;
+    /** Persist an already-extracted bundle of facts, entities, and edges. */
+    write(extracted: ExtractedContext, opts?: {
+        source?: string;
+    }): Promise<WriteResult>;
+    /** Mark older memory rows as replaced by `newId` (filtered out of recall). */
+    supersede(oldIds: string | string[], newId: string): Promise<void>;
+    /** Hard-delete a memory row. */
+    forget(id: string): Promise<void>;
+    /** Add a relationship between two entities (created if absent). */
+    link(src: string, rel: string, dst: string, opts?: {
+        source?: string;
+    }): Promise<void>;
+    /** Keyword recall, BM25-ranked, most relevant first. */
+    recall(query: string, opts?: RecallOptions): Promise<MemoryRow[]>;
+    /** Most recent memory rows. */
+    recent(opts?: ListOptions): Promise<MemoryRow[]>;
+    /** Memory rows carrying a given tag. */
+    byTag(tag: string, opts?: ListOptions): Promise<MemoryRow[]>;
+    /** Fetch one memory row by id, or null. */
+    get(id: string): Promise<MemoryRow | null>;
+    /** The subgraph around an entity: reachable entities + the edges among them. */
+    neighbors(name: string, opts?: {
+        depth?: number;
+        limit?: number;
+    }): Promise<{
+        entities: Entity[];
+        edges: Edge[];
+    }>;
+    /** Counts: current facts, total facts, entities, edges. */
+    stats(): Promise<ContextStats>;
+}
+/** Wrap a PerSQL database handle as a shared context store. */
+declare function context(db: PerSQLDatabase, opts?: ContextStoreOptions): ContextStore;
+
+export { type ContextStats, ContextStore, type ContextStoreOptions, Edge, Entity, ExtractedContext, type Extractor, ListOptions, MemoryRow, RecallOptions, RememberInput, type WriteResult, context };

package/dist/index.js

@@ -0,0 +1,210 @@
+import {
+  EXTRACTION_JSON_SCHEMA,
+  EXTRACTION_SYSTEM_PROMPT,
+  SCHEMA_SQL,
+  SCHEMA_VERSION,
+  TABLE_PREFIX,
+  buildByTag,
+  buildEdgesAmong,
+  buildExtractionMessages,
+  buildForget,
+  buildGet,
+  buildInit,
+  buildNeighborEntities,
+  buildRecall,
+  buildRecent,
+  buildRemember,
+  buildStats,
+  buildSupersede,
+  buildUpsertEdge,
+  buildUpsertEntity,
+  entityId,
+  normalizeTags,
+  toFtsQuery
+} from "./chunk-RMG66FDI.js";
+
+// src/index.ts
+function uid(prefix) {
+  const g = globalThis;
+  const r = g.crypto?.randomUUID?.() ?? `${Date.now().toString(36)}-${Math.floor(Math.random() * 1e9).toString(36)}`;
+  return prefix + r;
+}
+var ContextStore = class {
+  constructor(db, opts = {}) {
+    this.db = db;
+    this.opts = opts;
+  }
+  /** Create the schema (idempotent). Run once before first use. */
+  async init() {
+    await this.db.batch(buildInit());
+  }
+  // --- writes -------------------------------------------------------------
+  /** Store one structured fact/episode/artifact. Returns its id. */
+  async remember(input) {
+    const id = input.id ?? uid("m_");
+    const now = Date.now();
+    const stmts = [
+      buildRemember({ ...input, source: input.source ?? this.opts.source }, now, id)
+    ];
+    const sup = input.supersedes ? Array.isArray(input.supersedes) ? input.supersedes : [input.supersedes] : [];
+    for (const old of sup) stmts.push(buildSupersede(old, id));
+    await this.db.transaction(stmts);
+    return id;
+  }
+  /**
+   * Extract durable context from raw text and store it. The LLM runs on the
+   * write path; pass `extract` here or to the constructor (or use the hosted
+   * Context MCP, which runs extraction server-side and meters it).
+   */
+  async rememberRaw(raw, opts = {}) {
+    const extract = opts.extract ?? this.opts.extract;
+    if (!extract) {
+      throw new Error(
+        "ContextStore.rememberRaw needs an extractor: pass { extract } here or to the constructor, or use the hosted PerSQL Context MCP."
+      );
+    }
+    const extracted = await extract(raw, { hint: opts.hint });
+    return this.write(extracted, { source: opts.source });
+  }
+  /** Persist an already-extracted bundle of facts, entities, and edges. */
+  async write(extracted, opts = {}) {
+    const now = Date.now();
+    const source = opts.source ?? this.opts.source;
+    const stmts = [];
+    const memoryIds = [];
+    const entityIds = /* @__PURE__ */ new Set();
+    for (const f of extracted.facts ?? []) {
+      const id = uid("m_");
+      memoryIds.push(id);
+      stmts.push(buildRemember({ ...f, source }, now, id));
+    }
+    for (const e of extracted.entities ?? []) {
+      stmts.push(buildUpsertEntity(e, now));
+      entityIds.add(e.id ?? entityId(e.name));
+    }
+    for (const ed of extracted.edges ?? []) {
+      stmts.push(buildUpsertEntity({ name: ed.src }, now));
+      stmts.push(buildUpsertEntity({ name: ed.dst }, now));
+      stmts.push(buildUpsertEdge({ ...ed, source: ed.source ?? source }, now));
+      entityIds.add(entityId(ed.src));
+      entityIds.add(entityId(ed.dst));
+    }
+    if (stmts.length) await this.db.transaction(stmts);
+    return {
+      memoryIds,
+      entityIds: [...entityIds],
+      edgeCount: (extracted.edges ?? []).length
+    };
+  }
+  /** Mark older memory rows as replaced by `newId` (filtered out of recall). */
+  async supersede(oldIds, newId) {
+    const ids = Array.isArray(oldIds) ? oldIds : [oldIds];
+    await this.db.transaction(ids.map((o) => buildSupersede(o, newId)));
+  }
+  /** Hard-delete a memory row. */
+  async forget(id) {
+    const s = buildForget(id);
+    await this.db.query(s.sql, s.params);
+  }
+  /** Add a relationship between two entities (created if absent). */
+  async link(src, rel, dst, opts = {}) {
+    const now = Date.now();
+    await this.db.transaction([
+      buildUpsertEntity({ name: src }, now),
+      buildUpsertEntity({ name: dst }, now),
+      buildUpsertEdge(
+        { src, rel, dst, source: opts.source ?? this.opts.source },
+        now
+      )
+    ]);
+  }
+  // --- reads (no AI, pure lexical SQL) ------------------------------------
+  /** Keyword recall, BM25-ranked, most relevant first. */
+  async recall(query, opts = {}) {
+    const resolved = { ...opts };
+    if (opts.withinDays != null && opts.sinceMs == null) {
+      resolved.sinceMs = Date.now() - opts.withinDays * 864e5;
+    }
+    const s = buildRecall(query, resolved);
+    if (!s) return [];
+    const { data } = await this.db.query(s.sql, s.params);
+    return data;
+  }
+  /** Most recent memory rows. */
+  async recent(opts = {}) {
+    const s = buildRecent(opts);
+    const { data } = await this.db.query(s.sql, s.params);
+    return data;
+  }
+  /** Memory rows carrying a given tag. */
+  async byTag(tag, opts = {}) {
+    const s = buildByTag(tag, opts);
+    const { data } = await this.db.query(s.sql, s.params);
+    return data;
+  }
+  /** Fetch one memory row by id, or null. */
+  async get(id) {
+    const s = buildGet(id);
+    const { data } = await this.db.query(s.sql, s.params);
+    return data[0] ?? null;
+  }
+  /** The subgraph around an entity: reachable entities + the edges among them. */
+  async neighbors(name, opts = {}) {
+    const seed = name.startsWith("e_") ? name : entityId(name);
+    const depth = Math.min(Math.max(opts.depth ?? 1, 1), 4);
+    const entStmt = buildNeighborEntities(seed, depth, opts.limit ?? 50);
+    const { data: entities } = await this.db.query(
+      entStmt.sql,
+      entStmt.params
+    );
+    const ids = [seed, ...entities.map((e) => e.id)];
+    const edgeStmt = buildEdgesAmong(ids);
+    const { data: edges } = await this.db.query(
+      edgeStmt.sql,
+      edgeStmt.params
+    );
+    return { entities, edges };
+  }
+  /** Counts: current facts, total facts, entities, edges. */
+  async stats() {
+    const s = buildStats();
+    const { data } = await this.db.query(s.sql, s.params);
+    const r = data[0];
+    return {
+      facts: r?.facts ?? 0,
+      factsTotal: r?.facts_total ?? 0,
+      entities: r?.entities ?? 0,
+      edges: r?.edges ?? 0
+    };
+  }
+};
+function context(db, opts) {
+  return new ContextStore(db, opts);
+}
+export {
+  ContextStore,
+  EXTRACTION_JSON_SCHEMA,
+  EXTRACTION_SYSTEM_PROMPT,
+  SCHEMA_SQL,
+  SCHEMA_VERSION,
+  TABLE_PREFIX,
+  buildByTag,
+  buildEdgesAmong,
+  buildExtractionMessages,
+  buildForget,
+  buildGet,
+  buildInit,
+  buildNeighborEntities,
+  buildRecall,
+  buildRecent,
+  buildRemember,
+  buildStats,
+  buildSupersede,
+  buildUpsertEdge,
+  buildUpsertEntity,
+  context,
+  entityId,
+  normalizeTags,
+  toFtsQuery
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["/**\n * @persql/context — shared, structured agent context on the PerSQL substrate.\n *\n * One store, readable and writable from every agent surface PerSQL speaks\n * (SDK, MCP, published endpoints, CLI). Reads and structured writes are plain\n * SQL over `@persql/sdk` — cheap, exact, lexical (FTS5). The raw-dump extract\n * path puts the LLM on the *write* side: file once, recall by keyword forever.\n */\n\nimport type { PerSQLDatabase } from \"@persql/sdk\";\nimport {\n  buildInit,\n  buildRemember,\n  buildSupersede,\n  buildForget,\n  buildGet,\n  buildRecall,\n  buildRecent,\n  buildByTag,\n  buildStats,\n  buildUpsertEntity,\n  buildUpsertEdge,\n  buildNeighborEntities,\n  buildEdgesAmong,\n  entityId,\n  type RememberInput,\n  type RecallOptions,\n  type ListOptions,\n  type MemoryRow,\n  type EntityInput,\n  type Edge,\n  type Entity,\n  type ExtractedContext,\n  type SqlStatement,\n} from \"./core\";\n\nexport * from \"./core\";\n\n/** Bring-your-own-LLM extractor, or use the hosted PerSQL Context worker. */\nexport type Extractor = (\n  raw: string,\n  ctx: { hint?: string }\n) => Promise<ExtractedContext>;\n\nexport interface ContextStoreOptions {\n  /** Default extractor for `rememberRaw` (model-agnostic; you supply it). */\n  extract?: Extractor;\n  /** Default provenance label stamped on writes (e.g. \"claude-code\"). */\n  source?: string;\n}\n\nexport interface WriteResult {\n  memoryIds: string[];\n  entityIds: string[];\n  edgeCount: number;\n}\n\nexport interface ContextStats {\n  facts: number;\n  factsTotal: number;\n  entities: number;\n  edges: number;\n}\n\nfunction uid(prefix: string): string {\n  const g = globalThis as { crypto?: { randomUUID?: () => string } };\n  const r =\n    g.crypto?.randomUUID?.() ??\n    `${Date.now().toString(36)}-${Math.floor(Math.random() * 1e9).toString(36)}`;\n  return prefix + r;\n}\n\nexport class ContextStore {\n  constructor(\n    private readonly db: PerSQLDatabase,\n    private readonly opts: ContextStoreOptions = {}\n  ) {}\n\n  /** Create the schema (idempotent). Run once before first use. */\n  async init(): Promise<void> {\n    await this.db.batch(buildInit());\n  }\n\n  // --- writes -------------------------------------------------------------\n\n  /** Store one structured fact/episode/artifact. Returns its id. */\n  async remember(input: RememberInput): Promise<string> {\n    const id = input.id ?? uid(\"m_\");\n    const now = Date.now();\n    const stmts: SqlStatement[] = [\n      buildRemember({ ...input, source: input.source ?? this.opts.source }, now, id),\n    ];\n    const sup = input.supersedes\n      ? Array.isArray(input.supersedes)\n        ? input.supersedes\n        : [input.supersedes]\n      : [];\n    for (const old of sup) stmts.push(buildSupersede(old, id));\n    await this.db.transaction(stmts);\n    return id;\n  }\n\n  /**\n   * Extract durable context from raw text and store it. The LLM runs on the\n   * write path; pass `extract` here or to the constructor (or use the hosted\n   * Context MCP, which runs extraction server-side and meters it).\n   */\n  async rememberRaw(\n    raw: string,\n    opts: { extract?: Extractor; hint?: string; source?: string } = {}\n  ): Promise<WriteResult> {\n    const extract = opts.extract ?? this.opts.extract;\n    if (!extract) {\n      throw new Error(\n        \"ContextStore.rememberRaw needs an extractor: pass { extract } here or to the constructor, or use the hosted PerSQL Context MCP.\"\n      );\n    }\n    const extracted = await extract(raw, { hint: opts.hint });\n    return this.write(extracted, { source: opts.source });\n  }\n\n  /** Persist an already-extracted bundle of facts, entities, and edges. */\n  async write(\n    extracted: ExtractedContext,\n    opts: { source?: string } = {}\n  ): Promise<WriteResult> {\n    const now = Date.now();\n    const source = opts.source ?? this.opts.source;\n    const stmts: SqlStatement[] = [];\n    const memoryIds: string[] = [];\n    const entityIds = new Set<string>();\n\n    for (const f of extracted.facts ?? []) {\n      const id = uid(\"m_\");\n      memoryIds.push(id);\n      stmts.push(buildRemember({ ...f, source }, now, id));\n    }\n    for (const e of extracted.entities ?? []) {\n      stmts.push(buildUpsertEntity(e, now));\n      entityIds.add(e.id ?? entityId(e.name));\n    }\n    for (const ed of extracted.edges ?? []) {\n      // Ensure both endpoints exist before linking them.\n      stmts.push(buildUpsertEntity({ name: ed.src }, now));\n      stmts.push(buildUpsertEntity({ name: ed.dst }, now));\n      stmts.push(buildUpsertEdge({ ...ed, source: ed.source ?? source }, now));\n      entityIds.add(entityId(ed.src));\n      entityIds.add(entityId(ed.dst));\n    }\n\n    if (stmts.length) await this.db.transaction(stmts);\n    return {\n      memoryIds,\n      entityIds: [...entityIds],\n      edgeCount: (extracted.edges ?? []).length,\n    };\n  }\n\n  /** Mark older memory rows as replaced by `newId` (filtered out of recall). */\n  async supersede(oldIds: string | string[], newId: string): Promise<void> {\n    const ids = Array.isArray(oldIds) ? oldIds : [oldIds];\n    await this.db.transaction(ids.map((o) => buildSupersede(o, newId)));\n  }\n\n  /** Hard-delete a memory row. */\n  async forget(id: string): Promise<void> {\n    const s = buildForget(id);\n    await this.db.query(s.sql, s.params);\n  }\n\n  /** Add a relationship between two entities (created if absent). */\n  async link(\n    src: string,\n    rel: string,\n    dst: string,\n    opts: { source?: string } = {}\n  ): Promise<void> {\n    const now = Date.now();\n    await this.db.transaction([\n      buildUpsertEntity({ name: src }, now),\n      buildUpsertEntity({ name: dst }, now),\n      buildUpsertEdge(\n        { src, rel, dst, source: opts.source ?? this.opts.source },\n        now\n      ),\n    ]);\n  }\n\n  // --- reads (no AI, pure lexical SQL) ------------------------------------\n\n  /** Keyword recall, BM25-ranked, most relevant first. */\n  async recall(query: string, opts: RecallOptions = {}): Promise<MemoryRow[]> {\n    const resolved: RecallOptions = { ...opts };\n    if (opts.withinDays != null && opts.sinceMs == null) {\n      resolved.sinceMs = Date.now() - opts.withinDays * 86_400_000;\n    }\n    const s = buildRecall(query, resolved);\n    if (!s) return [];\n    const { data } = await this.db.query<MemoryRow>(s.sql, s.params);\n    return data;\n  }\n\n  /** Most recent memory rows. */\n  async recent(opts: ListOptions = {}): Promise<MemoryRow[]> {\n    const s = buildRecent(opts);\n    const { data } = await this.db.query<MemoryRow>(s.sql, s.params);\n    return data;\n  }\n\n  /** Memory rows carrying a given tag. */\n  async byTag(tag: string, opts: ListOptions = {}): Promise<MemoryRow[]> {\n    const s = buildByTag(tag, opts);\n    const { data } = await this.db.query<MemoryRow>(s.sql, s.params);\n    return data;\n  }\n\n  /** Fetch one memory row by id, or null. */\n  async get(id: string): Promise<MemoryRow | null> {\n    const s = buildGet(id);\n    const { data } = await this.db.query<MemoryRow>(s.sql, s.params);\n    return data[0] ?? null;\n  }\n\n  /** The subgraph around an entity: reachable entities + the edges among them. */\n  async neighbors(\n    name: string,\n    opts: { depth?: number; limit?: number } = {}\n  ): Promise<{ entities: Entity[]; edges: Edge[] }> {\n    const seed = name.startsWith(\"e_\") ? name : entityId(name);\n    const depth = Math.min(Math.max(opts.depth ?? 1, 1), 4);\n    const entStmt = buildNeighborEntities(seed, depth, opts.limit ?? 50);\n    const { data: entities } = await this.db.query<Entity>(\n      entStmt.sql,\n      entStmt.params\n    );\n    const ids = [seed, ...entities.map((e) => e.id)];\n    const edgeStmt = buildEdgesAmong(ids);\n    const { data: edges } = await this.db.query<Edge>(\n      edgeStmt.sql,\n      edgeStmt.params\n    );\n    return { entities, edges };\n  }\n\n  /** Counts: current facts, total facts, entities, edges. */\n  async stats(): Promise<ContextStats> {\n    const s = buildStats();\n    const { data } = await this.db.query<{\n      facts: number;\n      facts_total: number;\n      entities: number;\n      edges: number;\n    }>(s.sql, s.params);\n    const r = data[0];\n    return {\n      facts: r?.facts ?? 0,\n      factsTotal: r?.facts_total ?? 0,\n      entities: r?.entities ?? 0,\n      edges: r?.edges ?? 0,\n    };\n  }\n}\n\n/** Wrap a PerSQL database handle as a shared context store. */\nexport function context(\n  db: PerSQLDatabase,\n  opts?: ContextStoreOptions\n): ContextStore {\n  return new ContextStore(db, opts);\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "@persql/context",
+  "version": "0.1.0",
+  "description": "Shared, structured agent context for PerSQL — durable facts, entities, and a keyword-recallable memory graph in plain SQL. No vector database.",
+  "license": "MIT",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    },
+    "./core": {
+      "types": "./dist/core.d.ts",
+      "import": "./dist/core.js",
+      "require": "./dist/core.cjs"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "peerDependencies": {
+    "@persql/sdk": "^1.4.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.0",
+    "better-sqlite3": "^11.7.0",
+    "tsup": "^8.4.0",
+    "typescript": "^5.8.3",
+    "vitest": "^3.1.1",
+    "@persql/sdk": "1.4.0"
+  },
+  "keywords": [
+    "persql",
+    "agent",
+    "context",
+    "memory",
+    "shared-memory",
+    "fts5",
+    "sqlite",
+    "mcp"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "clean": "rm -rf dist"
+  }
+}