@remnic/core 1.1.11 → 1.1.12

package/README.md

@@ -1,8 +1,8 @@
 # @remnic/core
 
-Framework-agnostic memory engine for AI agents. Orchestration, storage, extraction, search, and trust zones -- all local, all private.
+Framework-agnostic memory and context engine for user-aware agents. Orchestration, storage, extraction, search, and trust zones -- inspectable and local by default.
 
-Part of [Remnic](https://github.com/joshuaswarren/remnic), the universal memory layer for AI agents.
+Part of [Remnic](https://github.com/joshuaswarren/remnic), open-source memory and context for user-aware agents.
 
 ## Install
 
@@ -12,7 +12,7 @@ npm install @remnic/core
 
 ## What it does
 
-Remnic Core is the engine that powers persistent memory across AI agent sessions. It handles:
+Remnic Core is the engine that powers scoped memory and context across AI agent sessions. It handles:
 
 - **Memory orchestration** -- three-phase flow: recall before sessions, buffer during, extract after
 - **Storage** -- plain markdown files with YAML frontmatter on your local filesystem

package/dist/access-cli.js

@@ -1,93 +1,98 @@
 import {
   Orchestrator
-} from "./chunk-KUHRUM6B.js";
-import "./chunk-4DXC6HQQ.js";
+} from "./chunk-BZSQEPRW.js";
 import "./chunk-CK5NTM2S.js";
+import "./chunk-FQDPCE3I.js";
 import "./chunk-FSFEQI74.js";
-import "./chunk-MDYG7VI7.js";
 import "./chunk-Z5AAYHUC.js";
 import "./chunk-S75M5ZRK.js";
 import "./chunk-TPB3I2AC.js";
 import "./chunk-UHGBNIOS.js";
-import "./chunk-PHNGXFQ6.js";
+import "./chunk-7V22HTMD.js";
 import "./chunk-ETOW6ACV.js";
-import "./chunk-ZTSE2ZJ6.js";
+import "./chunk-VWT3F4IV.js";
+import "./chunk-OIGNEXKZ.js";
+import "./chunk-MDYG7VI7.js";
 import "./chunk-JR4ZC3G4.js";
-import "./chunk-K4FLSOR5.js";
-import "./chunk-V3RXWQIE.js";
 import "./chunk-5IZL4DCV.js";
-import "./chunk-X7XN6YU4.js";
 import "./chunk-5NPGSAVB.js";
 import "./chunk-C7VW7C3F.js";
+import "./chunk-OZKZ2TRP.js";
+import "./chunk-K4FLSOR5.js";
+import "./chunk-V3RXWQIE.js";
+import "./chunk-WPGJYVUH.js";
+import "./chunk-X7XN6YU4.js";
+import "./chunk-ZZTOURJI.js";
 import "./chunk-YDBIWGNI.js";
 import "./chunk-7DHTMOND.js";
-import "./chunk-WPGJYVUH.js";
 import "./chunk-YCN4BVDK.js";
-import "./chunk-ZZTOURJI.js";
 import "./chunk-D654IBA6.js";
-import "./chunk-H63EDPFJ.js";
 import "./chunk-3GPTTA4J.js";
 import "./chunk-IISBCCWR.js";
-import "./chunk-GGD5W7TB.js";
 import "./chunk-XMVFHBHT.js";
+import "./chunk-H63EDPFJ.js";
+import "./chunk-PD6O7AXF.js";
 import "./chunk-YAZNBMNF.js";
-import "./chunk-Z5S5HNGY.js";
+import "./chunk-DF3RVK3X.js";
+import "./chunk-C4SQJZAF.js";
+import "./chunk-ZG7PTKBK.js";
+import "./chunk-4RA3C3EV.js";
 import "./chunk-WW3QQF4H.js";
 import "./chunk-54V4BZWP.js";
 import "./chunk-QR3C7BKQ.js";
-import "./chunk-NN3LPQ5D.js";
-import "./chunk-S2JJBLJG.js";
-import "./chunk-74WWN7ZW.js";
-import "./chunk-DF3RVK3X.js";
-import "./chunk-C4SQJZAF.js";
+import "./chunk-HELQZFZO.js";
+import "./chunk-DB5A3NHS.js";
+import "./chunk-UVMUAWVT.js";
+import "./chunk-6NKAQ74D.js";
+import "./chunk-OAZ5MFUB.js";
+import "./chunk-PYPOFEMK.js";
 import "./chunk-3IQ2TR4N.js";
 import "./chunk-VEWZZM3H.js";
-import "./chunk-6AUUAZEX.js";
+import "./chunk-5NXIJZFX.js";
 import "./chunk-Y4FHOFJ2.js";
 import "./chunk-Z2E7VW55.js";
-import "./chunk-LIO5X3CM.js";
+import "./chunk-3PG3H5TD.js";
 import "./chunk-2NMMFZ5T.js";
-import "./chunk-SRBJUAMP.js";
+import "./chunk-CPKTBRS2.js";
+import "./chunk-EJI5XIBB.js";
+import "./chunk-FMEBPEAO.js";
 import "./chunk-PYXS46O7.js";
 import "./chunk-3QKK7QOS.js";
-import "./chunk-RXTFCYQF.js";
+import "./chunk-JESOB2HO.js";
 import "./chunk-JRNQ3RNA.js";
-import "./chunk-PB5KW5PL.js";
+import "./chunk-WEJG4TB5.js";
 import "./chunk-CULXMQJH.js";
 import "./chunk-E6K4NIEU.js";
-import "./chunk-57QNCUEZ.js";
+import "./chunk-EABGC2TL.js";
+import "./chunk-HL5LRPNA.js";
 import "./chunk-YRMVARQP.js";
-import "./chunk-P77UEOU2.js";
 import {
   resolveRemnicPluginEntry
 } from "./chunk-U66YHYC7.js";
-import "./chunk-EABGC2TL.js";
+import "./chunk-P77UEOU2.js";
 import "./chunk-4IS4SXIQ.js";
 import "./chunk-6TBWYBJ3.js";
-import "./chunk-HMDCOMYU.js";
 import "./chunk-JXS5PDQ7.js";
+import "./chunk-HMDCOMYU.js";
+import "./chunk-7SEAZFFB.js";
 import "./chunk-K6WK37A6.js";
 import "./chunk-AJU4PJGY.js";
 import "./chunk-C6QPK5GG.js";
-import "./chunk-7SEAZFFB.js";
 import "./chunk-FYIYMQ5N.js";
 import {
   parseConfig
-} from "./chunk-6Z6UH6TK.js";
+} from "./chunk-HY3L4WKC.js";
 import "./chunk-Z5LAYHGJ.js";
 import "./chunk-OZHRDTDX.js";
-import "./chunk-3PG3H5TD.js";
 import "./chunk-KVE7R4CG.js";
 import "./chunk-4WMCPJWX.js";
 import "./chunk-JBMSGZEQ.js";
-import "./chunk-C5HUWVH2.js";
-import "./chunk-EJI5XIBB.js";
-import "./chunk-VX2IUQFE.js";
-import "./chunk-S3IP6R6K.js";
-import "./chunk-L2EXJQJP.js";
+import "./chunk-AQJNPMOA.js";
+import "./chunk-PH4C2U43.js";
 import "./chunk-7SI52C65.js";
+import "./chunk-L2EXJQJP.js";
 import "./chunk-UZB5KHKX.js";
-import "./chunk-KWBPHZUU.js";
+import "./chunk-RK6F44Y6.js";
 import "./chunk-6HZ6AO2P.js";
 import "./chunk-JWPLJLDU.js";
 import "./chunk-N53K2EXC.js";
@@ -97,56 +102,56 @@ import "./chunk-PVGDJXVK.js";
 import "./chunk-NGAVDO7E.js";
 import {
   EngramAccessService
-} from "./chunk-WGK4VHGP.js";
-import "./chunk-QIGOEM65.js";
+} from "./chunk-MNU6ZBWT.js";
+import "./chunk-IB3BFHGN.js";
 import "./chunk-BT7NVCML.js";
-import "./chunk-O4XJUPSF.js";
-import "./chunk-SOBJ6NEY.js";
 import "./chunk-H7XKCNR6.js";
-import "./chunk-EYNQTST2.js";
+import "./chunk-E2UCDP5S.js";
+import "./chunk-SOBJ6NEY.js";
 import "./chunk-D54LZC5L.js";
-import "./chunk-EQINRHYR.js";
-import "./chunk-2YMTO4ZJ.js";
-import "./chunk-EIR5VLIH.js";
-import "./chunk-HJYHRE4S.js";
-import "./chunk-IBX3VFOM.js";
+import "./chunk-QDZ2RLEC.js";
+import "./chunk-JKDVIE52.js";
+import "./chunk-242S3I2A.js";
+import "./chunk-D4GAOFF6.js";
 import "./chunk-5UM2VJ6D.js";
+import "./chunk-4YM32CRU.js";
+import "./chunk-EIR5VLIH.js";
 import "./chunk-PCUKNJAZ.js";
 import "./chunk-EEQLFRUM.js";
 import "./chunk-NBNN5GOB.js";
 import "./chunk-OR64ZGRZ.js";
+import "./chunk-QDW3E4RD.js";
 import "./chunk-GVPWB7EY.js";
 import "./chunk-2LGMW3DJ.js";
-import "./chunk-QDW3E4RD.js";
 import "./chunk-GDFS42HT.js";
 import "./chunk-RK2Y4XOM.js";
 import "./chunk-2LSZVONP.js";
 import "./chunk-WIICJPET.js";
 import "./chunk-G2WADRQ3.js";
-import "./chunk-74EMIVE4.js";
-import "./chunk-IXEJRKCZ.js";
-import "./chunk-DT5TVLJE.js";
-import "./chunk-N5AKDXAI.js";
-import "./chunk-TBBDFYXW.js";
-import "./chunk-WTFWLUSX.js";
-import "./chunk-MCC6KDQF.js";
+import "./chunk-ZVTKDVVM.js";
+import "./chunk-3B6KIRBH.js";
 import "./chunk-YNJHCGDT.js";
 import "./chunk-NN2DKE4T.js";
-import "./chunk-VQXK37XA.js";
-import "./chunk-PFV5C235.js";
-import "./chunk-RULE4VG5.js";
+import "./chunk-23ZZK64Y.js";
 import "./chunk-SCU65EZI.js";
 import "./chunk-XJKFSSDW.js";
+import "./chunk-PFV5C235.js";
+import "./chunk-RULE4VG5.js";
 import "./chunk-DM2T26WE.js";
 import "./chunk-QSVPYQPG.js";
 import "./chunk-FVQJYWH7.js";
 import "./chunk-4DJQYKMN.js";
 import "./chunk-G7D6GZ5J.js";
 import "./chunk-FAAFWE4G.js";
+import "./chunk-IXEJRKCZ.js";
 import {
   readEnvVar,
   resolveHomeDir
 } from "./chunk-MARWOCVP.js";
+import "./chunk-74EMIVE4.js";
+import "./chunk-DT5TVLJE.js";
+import "./chunk-N5AKDXAI.js";
+import "./chunk-TBBDFYXW.js";
 import "./chunk-2ODBA7MQ.js";
 import "./chunk-DGXUHMOV.js";
 import "./chunk-LPSF4OQH.js";
@@ -154,14 +159,17 @@ import "./chunk-TVVEYCNW.js";
 import "./chunk-RFYAYKTD.js";
 import "./chunk-LBLXEFWK.js";
 import "./chunk-XKECPATV.js";
-import "./chunk-P73JTV34.js";
+import "./chunk-BBE34QBJ.js";
+import "./chunk-767ODGE6.js";
 import "./chunk-457A4P3L.js";
 import "./chunk-OA3L7BFR.js";
-import "./chunk-767ODGE6.js";
 import "./chunk-BJMBJZ2Y.js";
 import "./chunk-UKJAGEXH.js";
 import "./chunk-FP2373TW.js";
 import "./chunk-A6XUJE5D.js";
+import "./chunk-AH2JUU6X.js";
+import "./chunk-AC5LO7IU.js";
+import "./chunk-SOAU2OE2.js";
 import "./chunk-PZ5AY32C.js";
 
 // src/access-cli.ts

package/dist/access-cli.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/access-cli.ts"],"sourcesContent":["import fs from \"node:fs\";\nimport path from \"node:path\";\nimport { parseConfig } from \"./config.js\";\nimport type { PluginConfig } from \"./types.js\";\nimport { Orchestrator } from \"./orchestrator.js\";\nimport { EngramAccessService } from \"./access-service.js\";\nimport { readEnvVar, resolveHomeDir } from \"./runtime/env.js\";\nimport { resolveRemnicPluginEntry } from \"./plugin-id.js\";\n\ntype CommandName = \"browse\" | \"store\";\n\ntype ParsedArgs = {\n  command: CommandName;\n  options: Record<string, string[]>;\n  flags: Set<string>;\n};\n\ntype Runtime = {\n  config: PluginConfig;\n  service: EngramAccessService;\n};\n\nexport type AccessCliOptions = {\n  /**\n   * The calling plugin's own id (e.g. `\"openclaw-engram\"` when invoked by the\n   * shim binary).  Forwarded to {@link resolveRemnicPluginEntry} so shim CLI\n   * users target their own `plugins.entries[\"openclaw-engram\"]` block instead\n   * of accidentally resolving to the canonical `\"openclaw-remnic\"` entry when\n   * `plugins.slots.memory` is unset (#403).\n   */\n  preferredId?: string;\n};\n\ntype UsageErrorKind =\n  | \"unsupported-command\"\n  | \"unexpected-positional\"\n  | \"missing-option\"\n  | \"missing-content\"\n  | \"invalid-integer\"\n  | \"invalid-number\";\n\nclass UsageError extends Error {\n  constructor(\n    readonly kind: UsageErrorKind,\n    readonly optionName?: string,\n  ) {\n    super(\"invalid access-cli arguments\");\n  }\n}\n\nfunction formatUsageError(error: UsageError): string {\n  switch (error.kind) {\n    case \"unsupported-command\":\n      return \"unsupported command\";\n    case \"unexpected-positional\":\n      return \"unexpected positional argument\";\n    case \"missing-option\":\n      return `missing required option: --${error.optionName ?? \"unknown\"}`;\n    case \"missing-content\":\n      return \"missing required option: --content or --content-file\";\n    case \"invalid-integer\":\n      return `invalid integer for --${error.optionName ?? \"unknown\"}`;\n    case \"invalid-number\":\n      return `invalid number for --${error.optionName ?? \"unknown\"}`;\n  }\n}\n\nfunction writeCliOutput(text: string = \"\"): void {\n  process.stdout.write(`${text}\\n`);\n}\n\nfunction usage(): string {\n  return [\n    \"Usage:\",\n    \"  engram-access browse [options]\",\n    \"  engram-access store [options]\",\n    \"\",\n    \"Browse options:\",\n    \"  --namespace <name>\",\n    \"  --query <text>\",\n    \"  --category <name>\",\n    \"  --status <name>\",\n    \"  --sort <updated_desc|updated_asc|created_desc|created_asc>\",\n    \"  --limit <n>\",\n    \"  --offset <n>\",\n    \"\",\n    \"Store options:\",\n    \"  --namespace <name>\",\n    \"  --session-key <key>\",\n    \"  --principal <principal>\",\n    \"  --content <text> | --content-file <path>\",\n    \"  --category <name>\",\n    \"  --confidence <0-1>\",\n    \"  --tag <tag> (repeatable)\",\n    \"  --entity-ref <ref>\",\n    \"  --ttl <duration>\",\n    \"  --source-reason <text>\",\n    \"  --idempotency-key <key>\",\n    \"  --dry-run\",\n  ].join(\"\\n\");\n}\n\nfunction parseArgs(argv: string[]): ParsedArgs {\n  const [commandRaw, ...rest] = argv;\n  if (commandRaw !== \"browse\" && commandRaw !== \"store\") {\n    throw new UsageError(\"unsupported-command\");\n  }\n\n  const options: Record<string, string[]> = {};\n  const flags = new Set<string>();\n\n  for (let i = 0; i < rest.length; i += 1) {\n    const token = rest[i];\n    if (!token.startsWith(\"--\")) {\n      throw new UsageError(\"unexpected-positional\");\n    }\n    const key = token.slice(2);\n    const next = rest[i + 1];\n    if (!next || next.startsWith(\"--\")) {\n      flags.add(key);\n      continue;\n    }\n    if (!options[key]) {\n      options[key] = [];\n    }\n    options[key].push(next);\n    i += 1;\n  }\n\n  return {\n    command: commandRaw,\n    options,\n    flags,\n  };\n}\n\nfunction getLastOption(args: ParsedArgs, name: string): string | undefined {\n  const values = args.options[name];\n  if (!values || values.length === 0) return undefined;\n  return values[values.length - 1];\n}\n\nfunction getAllOptions(args: ParsedArgs, name: string): string[] {\n  return args.options[name] ?? [];\n}\n\nfunction requireOption(args: ParsedArgs, name: string): string {\n  const value = getLastOption(args, name);\n  if (!value || value.trim().length === 0) {\n    throw new UsageError(\"missing-option\", name);\n  }\n  return value;\n}\n\nfunction parseIntegerOption(args: ParsedArgs, name: string): number | undefined {\n  const raw = getLastOption(args, name);\n  if (!raw) return undefined;\n  const value = parseInt(raw, 10);\n  if (!Number.isFinite(value)) {\n    throw new UsageError(\"invalid-integer\", name);\n  }\n  return value;\n}\n\nfunction parseFloatOption(args: ParsedArgs, name: string): number | undefined {\n  const raw = getLastOption(args, name);\n  if (!raw) return undefined;\n  const value = Number.parseFloat(raw);\n  if (!Number.isFinite(value)) {\n    throw new UsageError(\"invalid-number\", name);\n  }\n  return value;\n}\n\nfunction loadPluginConfig(preferredId?: string): Record<string, unknown> {\n  const configPath =\n    readEnvVar(\"OPENCLAW_ENGRAM_CONFIG_PATH\") ||\n    readEnvVar(\"OPENCLAW_CONFIG_PATH\") ||\n    path.join(resolveHomeDir(), \".openclaw\", \"openclaw.json\");\n  const raw = JSON.parse(fs.readFileSync(configPath, \"utf8\"));\n  // Delegate slot → preferredId → PLUGIN_ID → LEGACY_PLUGIN_ID resolution to\n  // the shared helper so all config loaders stay in sync (#403).  Shim CLI\n  // callers pass `preferredId: \"openclaw-engram\"` so legacy shim installs\n  // target their own config block instead of falling through to the canonical\n  // \"openclaw-remnic\" entry.\n  const entry = resolveRemnicPluginEntry(raw, preferredId);\n  return (entry?.[\"config\"] as Record<string, unknown> | undefined) ?? {};\n}\n\nfunction buildRuntime(preferredId?: string): Runtime {\n  const config = parseConfig(loadPluginConfig(preferredId));\n  return {\n    config,\n    service: new EngramAccessService(new Orchestrator(config)),\n  };\n}\n\nasync function runBrowse(args: ParsedArgs, preferredId?: string): Promise<void> {\n  const { service } = buildRuntime(preferredId);\n  const result = await service.memoryBrowse({\n    namespace: getLastOption(args, \"namespace\"),\n    query: getLastOption(args, \"query\"),\n    category: getLastOption(args, \"category\"),\n    status: getLastOption(args, \"status\"),\n    sort: getLastOption(args, \"sort\") as \"updated_desc\" | \"updated_asc\" | \"created_desc\" | \"created_asc\" | undefined,\n    limit: parseIntegerOption(args, \"limit\"),\n    offset: parseIntegerOption(args, \"offset\"),\n  });\n  console.log(JSON.stringify(result, null, 2));\n}\n\nasync function runStore(args: ParsedArgs, preferredId?: string): Promise<void> {\n  const { config, service } = buildRuntime(preferredId);\n  const contentFile = getLastOption(args, \"content-file\");\n  const inlineContent = getLastOption(args, \"content\");\n  const content = contentFile ? fs.readFileSync(contentFile, \"utf8\") : inlineContent;\n  if (!content || content.trim().length === 0) {\n    throw new UsageError(\"missing-content\");\n  }\n\n  const result = await service.memoryStore({\n    namespace: getLastOption(args, \"namespace\"),\n    sessionKey: getLastOption(args, \"session-key\"),\n    authenticatedPrincipal: getLastOption(args, \"principal\") ?? config.agentAccessHttp.principal,\n    content,\n    category: requireOption(args, \"category\"),\n    confidence: parseFloatOption(args, \"confidence\"),\n    tags: getAllOptions(args, \"tag\"),\n    entityRef: getLastOption(args, \"entity-ref\"),\n    ttl: getLastOption(args, \"ttl\"),\n    sourceReason: getLastOption(args, \"source-reason\"),\n    idempotencyKey: getLastOption(args, \"idempotency-key\"),\n    dryRun: args.flags.has(\"dry-run\"),\n  });\n  console.log(JSON.stringify(result, null, 2));\n}\n\nexport async function main(\n  argv: string[] = process.argv.slice(2),\n  options: AccessCliOptions = {},\n): Promise<void> {\n  const args = parseArgs(argv);\n  if (args.command === \"browse\") {\n    await runBrowse(args, options.preferredId);\n    return;\n  }\n  await runStore(args, options.preferredId);\n}\n\nexport function printUsage(): void {\n  writeCliOutput(usage());\n}\n\nexport async function runCli(\n  argv: string[] = process.argv.slice(2),\n  options: AccessCliOptions = {},\n): Promise<void> {\n  try {\n    await main(argv, options);\n  } catch (error) {\n    if (error instanceof UsageError) {\n      writeCliOutput(formatUsageError(error));\n      writeCliOutput();\n      printUsage();\n      process.exit(1);\n    }\n\n    console.error(\"access-cli failed\");\n    process.exit(1);\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,OAAO,QAAQ;AACf,OAAO,UAAU;AAwCjB,IAAM,aAAN,cAAyB,MAAM;AAAA,EAC7B,YACW,MACA,YACT;AACA,UAAM,8BAA8B;AAH3B;AACA;AAAA,EAGX;AAAA,EAJW;AAAA,EACA;AAIb;AAEA,SAAS,iBAAiB,OAA2B;AACnD,UAAQ,MAAM,MAAM;AAAA,IAClB,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AACH,aAAO,8BAA8B,MAAM,cAAc,SAAS;AAAA,IACpE,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AACH,aAAO,yBAAyB,MAAM,cAAc,SAAS;AAAA,IAC/D,KAAK;AACH,aAAO,wBAAwB,MAAM,cAAc,SAAS;AAAA,EAChE;AACF;AAEA,SAAS,eAAe,OAAe,IAAU;AAC/C,UAAQ,OAAO,MAAM,GAAG,IAAI;AAAA,CAAI;AAClC;AAEA,SAAS,QAAgB;AACvB,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF,EAAE,KAAK,IAAI;AACb;AAEA,SAAS,UAAU,MAA4B;AAC7C,QAAM,CAAC,YAAY,GAAG,IAAI,IAAI;AAC9B,MAAI,eAAe,YAAY,eAAe,SAAS;AACrD,UAAM,IAAI,WAAW,qBAAqB;AAAA,EAC5C;AAEA,QAAM,UAAoC,CAAC;AAC3C,QAAM,QAAQ,oBAAI,IAAY;AAE9B,WAAS,IAAI,GAAG,IAAI,KAAK,QAAQ,KAAK,GAAG;AACvC,UAAM,QAAQ,KAAK,CAAC;AACpB,QAAI,CAAC,MAAM,WAAW,IAAI,GAAG;AAC3B,YAAM,IAAI,WAAW,uBAAuB;AAAA,IAC9C;AACA,UAAM,MAAM,MAAM,MAAM,CAAC;AACzB,UAAM,OAAO,KAAK,IAAI,CAAC;AACvB,QAAI,CAAC,QAAQ,KAAK,WAAW,IAAI,GAAG;AAClC,YAAM,IAAI,GAAG;AACb;AAAA,IACF;AACA,QAAI,CAAC,QAAQ,GAAG,GAAG;AACjB,cAAQ,GAAG,IAAI,CAAC;AAAA,IAClB;AACA,YAAQ,GAAG,EAAE,KAAK,IAAI;AACtB,SAAK;AAAA,EACP;AAEA,SAAO;AAAA,IACL,SAAS;AAAA,IACT;AAAA,IACA;AAAA,EACF;AACF;AAEA,SAAS,cAAc,MAAkB,MAAkC;AACzE,QAAM,SAAS,KAAK,QAAQ,IAAI;AAChC,MAAI,CAAC,UAAU,OAAO,WAAW,EAAG,QAAO;AAC3C,SAAO,OAAO,OAAO,SAAS,CAAC;AACjC;AAEA,SAAS,cAAc,MAAkB,MAAwB;AAC/D,SAAO,KAAK,QAAQ,IAAI,KAAK,CAAC;AAChC;AAEA,SAAS,cAAc,MAAkB,MAAsB;AAC7D,QAAM,QAAQ,cAAc,MAAM,IAAI;AACtC,MAAI,CAAC,SAAS,MAAM,KAAK,EAAE,WAAW,GAAG;AACvC,UAAM,IAAI,WAAW,kBAAkB,IAAI;AAAA,EAC7C;AACA,SAAO;AACT;AAEA,SAAS,mBAAmB,MAAkB,MAAkC;AAC9E,QAAM,MAAM,cAAc,MAAM,IAAI;AACpC,MAAI,CAAC,IAAK,QAAO;AACjB,QAAM,QAAQ,SAAS,KAAK,EAAE;AAC9B,MAAI,CAAC,OAAO,SAAS,KAAK,GAAG;AAC3B,UAAM,IAAI,WAAW,mBAAmB,IAAI;AAAA,EAC9C;AACA,SAAO;AACT;AAEA,SAAS,iBAAiB,MAAkB,MAAkC;AAC5E,QAAM,MAAM,cAAc,MAAM,IAAI;AACpC,MAAI,CAAC,IAAK,QAAO;AACjB,QAAM,QAAQ,OAAO,WAAW,GAAG;AACnC,MAAI,CAAC,OAAO,SAAS,KAAK,GAAG;AAC3B,UAAM,IAAI,WAAW,kBAAkB,IAAI;AAAA,EAC7C;AACA,SAAO;AACT;AAEA,SAAS,iBAAiB,aAA+C;AACvE,QAAM,aACJ,WAAW,6BAA6B,KACxC,WAAW,sBAAsB,KACjC,KAAK,KAAK,eAAe,GAAG,aAAa,eAAe;AAC1D,QAAM,MAAM,KAAK,MAAM,GAAG,aAAa,YAAY,MAAM,CAAC;AAM1D,QAAM,QAAQ,yBAAyB,KAAK,WAAW;AACvD,SAAQ,QAAQ,QAAQ,KAA6C,CAAC;AACxE;AAEA,SAAS,aAAa,aAA+B;AACnD,QAAM,SAAS,YAAY,iBAAiB,WAAW,CAAC;AACxD,SAAO;AAAA,IACL;AAAA,IACA,SAAS,IAAI,oBAAoB,IAAI,aAAa,MAAM,CAAC;AAAA,EAC3D;AACF;AAEA,eAAe,UAAU,MAAkB,aAAqC;AAC9E,QAAM,EAAE,QAAQ,IAAI,aAAa,WAAW;AAC5C,QAAM,SAAS,MAAM,QAAQ,aAAa;AAAA,IACxC,WAAW,cAAc,MAAM,WAAW;AAAA,IAC1C,OAAO,cAAc,MAAM,OAAO;AAAA,IAClC,UAAU,cAAc,MAAM,UAAU;AAAA,IACxC,QAAQ,cAAc,MAAM,QAAQ;AAAA,IACpC,MAAM,cAAc,MAAM,MAAM;AAAA,IAChC,OAAO,mBAAmB,MAAM,OAAO;AAAA,IACvC,QAAQ,mBAAmB,MAAM,QAAQ;AAAA,EAC3C,CAAC;AACD,UAAQ,IAAI,KAAK,UAAU,QAAQ,MAAM,CAAC,CAAC;AAC7C;AAEA,eAAe,SAAS,MAAkB,aAAqC;AAC7E,QAAM,EAAE,QAAQ,QAAQ,IAAI,aAAa,WAAW;AACpD,QAAM,cAAc,cAAc,MAAM,cAAc;AACtD,QAAM,gBAAgB,cAAc,MAAM,SAAS;AACnD,QAAM,UAAU,cAAc,GAAG,aAAa,aAAa,MAAM,IAAI;AACrE,MAAI,CAAC,WAAW,QAAQ,KAAK,EAAE,WAAW,GAAG;AAC3C,UAAM,IAAI,WAAW,iBAAiB;AAAA,EACxC;AAEA,QAAM,SAAS,MAAM,QAAQ,YAAY;AAAA,IACvC,WAAW,cAAc,MAAM,WAAW;AAAA,IAC1C,YAAY,cAAc,MAAM,aAAa;AAAA,IAC7C,wBAAwB,cAAc,MAAM,WAAW,KAAK,OAAO,gBAAgB;AAAA,IACnF;AAAA,IACA,UAAU,cAAc,MAAM,UAAU;AAAA,IACxC,YAAY,iBAAiB,MAAM,YAAY;AAAA,IAC/C,MAAM,cAAc,MAAM,KAAK;AAAA,IAC/B,WAAW,cAAc,MAAM,YAAY;AAAA,IAC3C,KAAK,cAAc,MAAM,KAAK;AAAA,IAC9B,cAAc,cAAc,MAAM,eAAe;AAAA,IACjD,gBAAgB,cAAc,MAAM,iBAAiB;AAAA,IACrD,QAAQ,KAAK,MAAM,IAAI,SAAS;AAAA,EAClC,CAAC;AACD,UAAQ,IAAI,KAAK,UAAU,QAAQ,MAAM,CAAC,CAAC;AAC7C;AAEA,eAAsB,KACpB,OAAiB,QAAQ,KAAK,MAAM,CAAC,GACrC,UAA4B,CAAC,GACd;AACf,QAAM,OAAO,UAAU,IAAI;AAC3B,MAAI,KAAK,YAAY,UAAU;AAC7B,UAAM,UAAU,MAAM,QAAQ,WAAW;AACzC;AAAA,EACF;AACA,QAAM,SAAS,MAAM,QAAQ,WAAW;AAC1C;AAEO,SAAS,aAAmB;AACjC,iBAAe,MAAM,CAAC;AACxB;AAEA,eAAsB,OACpB,OAAiB,QAAQ,KAAK,MAAM,CAAC,GACrC,UAA4B,CAAC,GACd;AACf,MAAI;AACF,UAAM,KAAK,MAAM,OAAO;AAAA,EAC1B,SAAS,OAAO;AACd,QAAI,iBAAiB,YAAY;AAC/B,qBAAe,iBAAiB,KAAK,CAAC;AACtC,qBAAe;AACf,iBAAW;AACX,cAAQ,KAAK,CAAC;AAAA,IAChB;AAEA,YAAQ,MAAM,mBAAmB;AACjC,YAAQ,KAAK,CAAC;AAAA,EAChB;AACF;","names":[]}
+{"version":3,"sources":["../src/access-cli.ts"],"sourcesContent":["import fs from \"node:fs\";\nimport path from \"node:path\";\nimport { parseConfig } from \"./config.js\";\nimport type { PluginConfig } from \"./types.js\";\nimport { Orchestrator } from \"./orchestrator.js\";\nimport { EngramAccessService } from \"./access-service.js\";\nimport { readEnvVar, resolveHomeDir } from \"./runtime/env.js\";\nimport { resolveRemnicPluginEntry } from \"./plugin-id.js\";\n\ntype CommandName = \"browse\" | \"store\";\n\ntype ParsedArgs = {\n  command: CommandName;\n  options: Record<string, string[]>;\n  flags: Set<string>;\n};\n\ntype Runtime = {\n  config: PluginConfig;\n  service: EngramAccessService;\n};\n\nexport type AccessCliOptions = {\n  /**\n   * The calling plugin's own id (e.g. `\"openclaw-engram\"` when invoked by the\n   * shim binary).  Forwarded to {@link resolveRemnicPluginEntry} so shim CLI\n   * users target their own `plugins.entries[\"openclaw-engram\"]` block instead\n   * of accidentally resolving to the canonical `\"openclaw-remnic\"` entry when\n   * `plugins.slots.memory` is unset (#403).\n   */\n  preferredId?: string;\n};\n\ntype UsageErrorKind =\n  | \"unsupported-command\"\n  | \"unexpected-positional\"\n  | \"missing-option\"\n  | \"missing-content\"\n  | \"invalid-integer\"\n  | \"invalid-number\";\n\nclass UsageError extends Error {\n  constructor(\n    readonly kind: UsageErrorKind,\n    readonly optionName?: string,\n  ) {\n    super(\"invalid access-cli arguments\");\n  }\n}\n\nfunction formatUsageError(error: UsageError): string {\n  switch (error.kind) {\n    case \"unsupported-command\":\n      return \"unsupported command\";\n    case \"unexpected-positional\":\n      return \"unexpected positional argument\";\n    case \"missing-option\":\n      return `missing required option: --${error.optionName ?? \"unknown\"}`;\n    case \"missing-content\":\n      return \"missing required option: --content or --content-file\";\n    case \"invalid-integer\":\n      return `invalid integer for --${error.optionName ?? \"unknown\"}`;\n    case \"invalid-number\":\n      return `invalid number for --${error.optionName ?? \"unknown\"}`;\n  }\n}\n\nfunction writeCliOutput(text: string = \"\"): void {\n  process.stdout.write(`${text}\\n`);\n}\n\nfunction usage(): string {\n  return [\n    \"Usage:\",\n    \"  engram-access browse [options]\",\n    \"  engram-access store [options]\",\n    \"\",\n    \"Browse options:\",\n    \"  --namespace <name>\",\n    \"  --query <text>\",\n    \"  --category <name>\",\n    \"  --status <name>\",\n    \"  --sort <updated_desc|updated_asc|created_desc|created_asc>\",\n    \"  --limit <n>\",\n    \"  --offset <n>\",\n    \"\",\n    \"Store options:\",\n    \"  --namespace <name>\",\n    \"  --session-key <key>\",\n    \"  --principal <principal>\",\n    \"  --content <text> | --content-file <path>\",\n    \"  --category <name>\",\n    \"  --confidence <0-1>\",\n    \"  --tag <tag> (repeatable)\",\n    \"  --entity-ref <ref>\",\n    \"  --ttl <duration>\",\n    \"  --source-reason <text>\",\n    \"  --idempotency-key <key>\",\n    \"  --dry-run\",\n  ].join(\"\\n\");\n}\n\nfunction parseArgs(argv: string[]): ParsedArgs {\n  const [commandRaw, ...rest] = argv;\n  if (commandRaw !== \"browse\" && commandRaw !== \"store\") {\n    throw new UsageError(\"unsupported-command\");\n  }\n\n  const options: Record<string, string[]> = {};\n  const flags = new Set<string>();\n\n  for (let i = 0; i < rest.length; i += 1) {\n    const token = rest[i];\n    if (!token.startsWith(\"--\")) {\n      throw new UsageError(\"unexpected-positional\");\n    }\n    const key = token.slice(2);\n    const next = rest[i + 1];\n    if (!next || next.startsWith(\"--\")) {\n      flags.add(key);\n      continue;\n    }\n    if (!options[key]) {\n      options[key] = [];\n    }\n    options[key].push(next);\n    i += 1;\n  }\n\n  return {\n    command: commandRaw,\n    options,\n    flags,\n  };\n}\n\nfunction getLastOption(args: ParsedArgs, name: string): string | undefined {\n  const values = args.options[name];\n  if (!values || values.length === 0) return undefined;\n  return values[values.length - 1];\n}\n\nfunction getAllOptions(args: ParsedArgs, name: string): string[] {\n  return args.options[name] ?? [];\n}\n\nfunction requireOption(args: ParsedArgs, name: string): string {\n  const value = getLastOption(args, name);\n  if (!value || value.trim().length === 0) {\n    throw new UsageError(\"missing-option\", name);\n  }\n  return value;\n}\n\nfunction parseIntegerOption(args: ParsedArgs, name: string): number | undefined {\n  const raw = getLastOption(args, name);\n  if (!raw) return undefined;\n  const value = parseInt(raw, 10);\n  if (!Number.isFinite(value)) {\n    throw new UsageError(\"invalid-integer\", name);\n  }\n  return value;\n}\n\nfunction parseFloatOption(args: ParsedArgs, name: string): number | undefined {\n  const raw = getLastOption(args, name);\n  if (!raw) return undefined;\n  const value = Number.parseFloat(raw);\n  if (!Number.isFinite(value)) {\n    throw new UsageError(\"invalid-number\", name);\n  }\n  return value;\n}\n\nfunction loadPluginConfig(preferredId?: string): Record<string, unknown> {\n  const configPath =\n    readEnvVar(\"OPENCLAW_ENGRAM_CONFIG_PATH\") ||\n    readEnvVar(\"OPENCLAW_CONFIG_PATH\") ||\n    path.join(resolveHomeDir(), \".openclaw\", \"openclaw.json\");\n  const raw = JSON.parse(fs.readFileSync(configPath, \"utf8\"));\n  // Delegate slot → preferredId → PLUGIN_ID → LEGACY_PLUGIN_ID resolution to\n  // the shared helper so all config loaders stay in sync (#403).  Shim CLI\n  // callers pass `preferredId: \"openclaw-engram\"` so legacy shim installs\n  // target their own config block instead of falling through to the canonical\n  // \"openclaw-remnic\" entry.\n  const entry = resolveRemnicPluginEntry(raw, preferredId);\n  return (entry?.[\"config\"] as Record<string, unknown> | undefined) ?? {};\n}\n\nfunction buildRuntime(preferredId?: string): Runtime {\n  const config = parseConfig(loadPluginConfig(preferredId));\n  return {\n    config,\n    service: new EngramAccessService(new Orchestrator(config)),\n  };\n}\n\nasync function runBrowse(args: ParsedArgs, preferredId?: string): Promise<void> {\n  const { service } = buildRuntime(preferredId);\n  const result = await service.memoryBrowse({\n    namespace: getLastOption(args, \"namespace\"),\n    query: getLastOption(args, \"query\"),\n    category: getLastOption(args, \"category\"),\n    status: getLastOption(args, \"status\"),\n    sort: getLastOption(args, \"sort\") as \"updated_desc\" | \"updated_asc\" | \"created_desc\" | \"created_asc\" | undefined,\n    limit: parseIntegerOption(args, \"limit\"),\n    offset: parseIntegerOption(args, \"offset\"),\n  });\n  console.log(JSON.stringify(result, null, 2));\n}\n\nasync function runStore(args: ParsedArgs, preferredId?: string): Promise<void> {\n  const { config, service } = buildRuntime(preferredId);\n  const contentFile = getLastOption(args, \"content-file\");\n  const inlineContent = getLastOption(args, \"content\");\n  const content = contentFile ? fs.readFileSync(contentFile, \"utf8\") : inlineContent;\n  if (!content || content.trim().length === 0) {\n    throw new UsageError(\"missing-content\");\n  }\n\n  const result = await service.memoryStore({\n    namespace: getLastOption(args, \"namespace\"),\n    sessionKey: getLastOption(args, \"session-key\"),\n    authenticatedPrincipal: getLastOption(args, \"principal\") ?? config.agentAccessHttp.principal,\n    content,\n    category: requireOption(args, \"category\"),\n    confidence: parseFloatOption(args, \"confidence\"),\n    tags: getAllOptions(args, \"tag\"),\n    entityRef: getLastOption(args, \"entity-ref\"),\n    ttl: getLastOption(args, \"ttl\"),\n    sourceReason: getLastOption(args, \"source-reason\"),\n    idempotencyKey: getLastOption(args, \"idempotency-key\"),\n    dryRun: args.flags.has(\"dry-run\"),\n  });\n  console.log(JSON.stringify(result, null, 2));\n}\n\nexport async function main(\n  argv: string[] = process.argv.slice(2),\n  options: AccessCliOptions = {},\n): Promise<void> {\n  const args = parseArgs(argv);\n  if (args.command === \"browse\") {\n    await runBrowse(args, options.preferredId);\n    return;\n  }\n  await runStore(args, options.preferredId);\n}\n\nexport function printUsage(): void {\n  writeCliOutput(usage());\n}\n\nexport async function runCli(\n  argv: string[] = process.argv.slice(2),\n  options: AccessCliOptions = {},\n): Promise<void> {\n  try {\n    await main(argv, options);\n  } catch (error) {\n    if (error instanceof UsageError) {\n      writeCliOutput(formatUsageError(error));\n      writeCliOutput();\n      printUsage();\n      process.exit(1);\n    }\n\n    console.error(\"access-cli failed\");\n    process.exit(1);\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/access-http.d.ts

@@ -1,19 +1,21 @@
 import { IncomingMessage } from 'node:http';
-import { E as EngramAccessService } from './access-service-BkXt3di1.js';
+import { E as EngramAccessService } from './access-service-DDjzFALq.js';
 import './storage.js';
 import './page-versioning.js';
 import './consolidation-operator.js';
 import './types.js';
-import './index-1qIcnbG1.js';
+import './index-DJ9QWMw-.js';
 import './memory-projection-store-CY8TU40w.js';
 import 'better-sqlite3';
-import './recall-xray.js';
 import './recall-explain-renderer.js';
 import './recall-state.js';
+import './recall-xray.js';
+import './memory-provenance.js';
+import './user-model.js';
 import './recall-audit-anomaly.js';
 import './recall-audit.js';
 import './explicit-capture.js';
-import './orchestrator-AOQMo7QI.js';
+import './orchestrator-DDMPqU6R.js';
 import './buffer.js';
 import './port-B6VEDIkC.js';
 import './transcript.js';
@@ -40,6 +42,7 @@ import './graph.js';
 import './trust-zones.js';
 import './memory-worth-outcomes.js';
 import './capsule-cli.js';
+import './action-confidence.js';
 
 /**
  * Adapter interface for external system identity resolution.

package/dist/access-http.js

@@ -1,55 +1,56 @@
 import {
   EngramAccessHttpServer
-} from "./chunk-36CTNQY7.js";
-import "./chunk-Y5KDIOKF.js";
+} from "./chunk-RVPLBATS.js";
+import "./chunk-XAMBKFQS.js";
+import "./chunk-C5BCH4ZS.js";
 import "./chunk-IQT3XTKW.js";
-import "./chunk-WGK4VHGP.js";
-import "./chunk-QIGOEM65.js";
+import "./chunk-MNU6ZBWT.js";
+import "./chunk-IB3BFHGN.js";
 import "./chunk-BT7NVCML.js";
-import "./chunk-O4XJUPSF.js";
-import "./chunk-SOBJ6NEY.js";
 import "./chunk-H7XKCNR6.js";
-import "./chunk-EYNQTST2.js";
+import "./chunk-E2UCDP5S.js";
+import "./chunk-SOBJ6NEY.js";
 import "./chunk-D54LZC5L.js";
-import "./chunk-EQINRHYR.js";
-import "./chunk-2YMTO4ZJ.js";
-import "./chunk-EIR5VLIH.js";
-import "./chunk-HJYHRE4S.js";
-import "./chunk-IBX3VFOM.js";
+import "./chunk-QDZ2RLEC.js";
+import "./chunk-JKDVIE52.js";
+import "./chunk-242S3I2A.js";
+import "./chunk-D4GAOFF6.js";
 import "./chunk-5UM2VJ6D.js";
+import "./chunk-4YM32CRU.js";
+import "./chunk-EIR5VLIH.js";
 import "./chunk-PCUKNJAZ.js";
 import "./chunk-EEQLFRUM.js";
 import "./chunk-NBNN5GOB.js";
 import "./chunk-OR64ZGRZ.js";
+import "./chunk-QDW3E4RD.js";
 import "./chunk-GVPWB7EY.js";
 import "./chunk-2LGMW3DJ.js";
-import "./chunk-QDW3E4RD.js";
 import "./chunk-GDFS42HT.js";
 import "./chunk-RK2Y4XOM.js";
 import "./chunk-2LSZVONP.js";
 import "./chunk-WIICJPET.js";
 import "./chunk-G2WADRQ3.js";
-import "./chunk-74EMIVE4.js";
-import "./chunk-IXEJRKCZ.js";
-import "./chunk-DT5TVLJE.js";
-import "./chunk-N5AKDXAI.js";
-import "./chunk-TBBDFYXW.js";
-import "./chunk-WTFWLUSX.js";
-import "./chunk-MCC6KDQF.js";
+import "./chunk-ZVTKDVVM.js";
+import "./chunk-3B6KIRBH.js";
 import "./chunk-YNJHCGDT.js";
 import "./chunk-NN2DKE4T.js";
-import "./chunk-VQXK37XA.js";
-import "./chunk-PFV5C235.js";
-import "./chunk-RULE4VG5.js";
+import "./chunk-23ZZK64Y.js";
 import "./chunk-SCU65EZI.js";
 import "./chunk-XJKFSSDW.js";
+import "./chunk-PFV5C235.js";
+import "./chunk-RULE4VG5.js";
 import "./chunk-DM2T26WE.js";
 import "./chunk-QSVPYQPG.js";
 import "./chunk-FVQJYWH7.js";
 import "./chunk-4DJQYKMN.js";
 import "./chunk-G7D6GZ5J.js";
 import "./chunk-FAAFWE4G.js";
+import "./chunk-IXEJRKCZ.js";
 import "./chunk-MARWOCVP.js";
+import "./chunk-74EMIVE4.js";
+import "./chunk-DT5TVLJE.js";
+import "./chunk-N5AKDXAI.js";
+import "./chunk-TBBDFYXW.js";
 import "./chunk-2ODBA7MQ.js";
 import "./chunk-DGXUHMOV.js";
 import "./chunk-LPSF4OQH.js";
@@ -57,15 +58,18 @@ import "./chunk-TVVEYCNW.js";
 import "./chunk-RFYAYKTD.js";
 import "./chunk-LBLXEFWK.js";
 import "./chunk-XKECPATV.js";
-import "./chunk-A4ACKWIW.js";
-import "./chunk-P73JTV34.js";
+import "./chunk-U5JMRGKX.js";
+import "./chunk-BBE34QBJ.js";
+import "./chunk-767ODGE6.js";
 import "./chunk-457A4P3L.js";
 import "./chunk-OA3L7BFR.js";
-import "./chunk-767ODGE6.js";
 import "./chunk-BJMBJZ2Y.js";
 import "./chunk-UKJAGEXH.js";
 import "./chunk-FP2373TW.js";
 import "./chunk-A6XUJE5D.js";
+import "./chunk-AH2JUU6X.js";
+import "./chunk-AC5LO7IU.js";
+import "./chunk-SOAU2OE2.js";
 import "./chunk-PZ5AY32C.js";
 export {
   EngramAccessHttpServer

package/dist/access-mcp.d.ts

@@ -1,19 +1,21 @@
 import { Readable, Writable } from 'node:stream';
-import { E as EngramAccessService } from './access-service-BkXt3di1.js';
+import { E as EngramAccessService } from './access-service-DDjzFALq.js';
 import './storage.js';
 import './page-versioning.js';
 import './consolidation-operator.js';
 import './types.js';
-import './index-1qIcnbG1.js';
+import './index-DJ9QWMw-.js';
 import './memory-projection-store-CY8TU40w.js';
 import 'better-sqlite3';
-import './recall-xray.js';
 import './recall-explain-renderer.js';
 import './recall-state.js';
+import './recall-xray.js';
+import './memory-provenance.js';
+import './user-model.js';
 import './recall-audit-anomaly.js';
 import './recall-audit.js';
 import './explicit-capture.js';
-import './orchestrator-AOQMo7QI.js';
+import './orchestrator-DDMPqU6R.js';
 import './buffer.js';
 import './port-B6VEDIkC.js';
 import './transcript.js';
@@ -40,6 +42,7 @@ import './graph.js';
 import './trust-zones.js';
 import './memory-worth-outcomes.js';
 import './capsule-cli.js';
+import './action-confidence.js';
 
 type JsonRpcId = string | number | null;
 type JsonRpcRequest = {
@@ -53,6 +56,8 @@ declare class EngramMcpServer {
     private buffer;
     private flushTask;
     private readonly tools;
+    private readonly resources;
+    private readonly resourceTextByUri;
     private readonly authenticatedPrincipal?;
     /**
      * MCP client info keyed by server-assigned session ID. On each `initialize`

package/dist/access-mcp.js

@@ -1,54 +1,55 @@
 import {
   EngramMcpServer
-} from "./chunk-Y5KDIOKF.js";
+} from "./chunk-XAMBKFQS.js";
+import "./chunk-C5BCH4ZS.js";
 import "./chunk-IQT3XTKW.js";
-import "./chunk-WGK4VHGP.js";
-import "./chunk-QIGOEM65.js";
+import "./chunk-MNU6ZBWT.js";
+import "./chunk-IB3BFHGN.js";
 import "./chunk-BT7NVCML.js";
-import "./chunk-O4XJUPSF.js";
-import "./chunk-SOBJ6NEY.js";
 import "./chunk-H7XKCNR6.js";
-import "./chunk-EYNQTST2.js";
+import "./chunk-E2UCDP5S.js";
+import "./chunk-SOBJ6NEY.js";
 import "./chunk-D54LZC5L.js";
-import "./chunk-EQINRHYR.js";
-import "./chunk-2YMTO4ZJ.js";
-import "./chunk-EIR5VLIH.js";
-import "./chunk-HJYHRE4S.js";
-import "./chunk-IBX3VFOM.js";
+import "./chunk-QDZ2RLEC.js";
+import "./chunk-JKDVIE52.js";
+import "./chunk-242S3I2A.js";
+import "./chunk-D4GAOFF6.js";
 import "./chunk-5UM2VJ6D.js";
+import "./chunk-4YM32CRU.js";
+import "./chunk-EIR5VLIH.js";
 import "./chunk-PCUKNJAZ.js";
 import "./chunk-EEQLFRUM.js";
 import "./chunk-NBNN5GOB.js";
 import "./chunk-OR64ZGRZ.js";
+import "./chunk-QDW3E4RD.js";
 import "./chunk-GVPWB7EY.js";
 import "./chunk-2LGMW3DJ.js";
-import "./chunk-QDW3E4RD.js";
 import "./chunk-GDFS42HT.js";
 import "./chunk-RK2Y4XOM.js";
 import "./chunk-2LSZVONP.js";
 import "./chunk-WIICJPET.js";
 import "./chunk-G2WADRQ3.js";
-import "./chunk-74EMIVE4.js";
-import "./chunk-IXEJRKCZ.js";
-import "./chunk-DT5TVLJE.js";
-import "./chunk-N5AKDXAI.js";
-import "./chunk-TBBDFYXW.js";
-import "./chunk-WTFWLUSX.js";
-import "./chunk-MCC6KDQF.js";
+import "./chunk-ZVTKDVVM.js";
+import "./chunk-3B6KIRBH.js";
 import "./chunk-YNJHCGDT.js";
 import "./chunk-NN2DKE4T.js";
-import "./chunk-VQXK37XA.js";
-import "./chunk-PFV5C235.js";
-import "./chunk-RULE4VG5.js";
+import "./chunk-23ZZK64Y.js";
 import "./chunk-SCU65EZI.js";
 import "./chunk-XJKFSSDW.js";
+import "./chunk-PFV5C235.js";
+import "./chunk-RULE4VG5.js";
 import "./chunk-DM2T26WE.js";
 import "./chunk-QSVPYQPG.js";
 import "./chunk-FVQJYWH7.js";
 import "./chunk-4DJQYKMN.js";
 import "./chunk-G7D6GZ5J.js";
 import "./chunk-FAAFWE4G.js";
+import "./chunk-IXEJRKCZ.js";
 import "./chunk-MARWOCVP.js";
+import "./chunk-74EMIVE4.js";
+import "./chunk-DT5TVLJE.js";
+import "./chunk-N5AKDXAI.js";
+import "./chunk-TBBDFYXW.js";
 import "./chunk-2ODBA7MQ.js";
 import "./chunk-DGXUHMOV.js";
 import "./chunk-LPSF4OQH.js";
@@ -56,15 +57,18 @@ import "./chunk-TVVEYCNW.js";
 import "./chunk-RFYAYKTD.js";
 import "./chunk-LBLXEFWK.js";
 import "./chunk-XKECPATV.js";
-import "./chunk-A4ACKWIW.js";
-import "./chunk-P73JTV34.js";
+import "./chunk-U5JMRGKX.js";
+import "./chunk-BBE34QBJ.js";
+import "./chunk-767ODGE6.js";
 import "./chunk-457A4P3L.js";
 import "./chunk-OA3L7BFR.js";
-import "./chunk-767ODGE6.js";
 import "./chunk-BJMBJZ2Y.js";
 import "./chunk-UKJAGEXH.js";
 import "./chunk-FP2373TW.js";
 import "./chunk-A6XUJE5D.js";
+import "./chunk-AH2JUU6X.js";
+import "./chunk-AC5LO7IU.js";
+import "./chunk-SOAU2OE2.js";
 import "./chunk-PZ5AY32C.js";
 export {
   EngramMcpServer