@remnic/core 9.3.645 → 9.3.647

package/dist/access-cli.js

@@ -1,32 +1,32 @@
 import {
   Orchestrator
-} from "./chunk-MBT3ASYV.js";
+} from "./chunk-TA4LQ5SR.js";
 import "./chunk-DDRNDPX4.js";
 import "./chunk-7HYPN2GC.js";
 import "./chunk-666A3MOW.js";
 import "./chunk-HHLLAQGZ.js";
-import "./chunk-D2B22JDF.js";
+import "./chunk-UWK5OXUJ.js";
+import "./chunk-WEPMT6SC.js";
+import "./chunk-5VDJMYTF.js";
+import "./chunk-HP5FMB6L.js";
 import "./chunk-7N4KAIGN.js";
 import "./chunk-TPDBFYEG.js";
 import "./chunk-KCYE2MZM.js";
 import "./chunk-MAV46GWQ.js";
-import "./chunk-5VDJMYTF.js";
-import "./chunk-UWK5OXUJ.js";
 import "./chunk-TECVW3JP.js";
 import "./chunk-T2PO5MUF.js";
-import "./chunk-HP5FMB6L.js";
 import "./chunk-Z3PZRDLW.js";
 import "./chunk-DRD2Q7HQ.js";
 import "./chunk-LXOM6IQU.js";
+import "./chunk-VOUOLGIP.js";
 import "./chunk-S75M5ZRK.js";
 import "./chunk-ECZU5BJH.js";
 import "./chunk-UHGBNIOS.js";
+import "./chunk-IMWFHBG2.js";
+import "./chunk-XJNBEDFE.js";
 import "./chunk-VWT3F4IV.js";
 import "./chunk-YTWNKQ2G.js";
 import "./chunk-MDYG7VI7.js";
-import "./chunk-VOUOLGIP.js";
-import "./chunk-Y2XKJJEI.js";
-import "./chunk-XJNBEDFE.js";
 import "./chunk-MHQC2WU2.js";
 import "./chunk-OZKZ2TRP.js";
 import "./chunk-6GC5SGFE.js";
@@ -79,7 +79,8 @@ import "./chunk-UMKPSD35.js";
 import "./chunk-W4RVMTHR.js";
 import "./chunk-4BISW7RX.js";
 import "./chunk-ZRWB5D4H.js";
-import "./chunk-IHG27THY.js";
+import "./chunk-XUGQQPGO.js";
+import "./chunk-S4DDLTPX.js";
 import "./chunk-SFQ6QNL7.js";
 import "./chunk-D6WVJIS3.js";
 import "./chunk-KFY3SGN7.js";
@@ -121,10 +122,10 @@ import "./chunk-OADWQ5CR.js";
 import "./chunk-7WV3F5DQ.js";
 import {
   EngramAccessService
-} from "./chunk-W5ISYSIL.js";
+} from "./chunk-L7W5YW6Y.js";
 import "./chunk-GDASG7NC.js";
 import "./chunk-GDB4J2H3.js";
-import "./chunk-DGNQRNLL.js";
+import "./chunk-NT5TINK5.js";
 import "./chunk-IENGGY2C.js";
 import "./chunk-SOBJ6NEY.js";
 import "./chunk-BT7NVCML.js";
@@ -135,14 +136,14 @@ import "./chunk-5RIRL3XL.js";
 import "./chunk-JGSKJHF7.js";
 import "./chunk-FF4KLI5W.js";
 import "./chunk-BEMWL2FZ.js";
-import "./chunk-HRXCPKN4.js";
-import "./chunk-KVUG7FF7.js";
+import "./chunk-APWJRJFW.js";
+import "./chunk-U55D5UD5.js";
+import "./chunk-CYEPCZN5.js";
+import "./chunk-DCGT4FPP.js";
 import "./chunk-JOASJWQR.js";
 import "./chunk-RN7MUWON.js";
 import "./chunk-3MAONBX3.js";
 import "./chunk-RG3LBSGH.js";
-import "./chunk-CYEPCZN5.js";
-import "./chunk-DCGT4FPP.js";
 import "./chunk-Q4CAQGKQ.js";
 import "./chunk-CINZGPSJ.js";
 import "./chunk-ZFXCQPNO.js";
@@ -206,9 +207,9 @@ import "./chunk-TVVEYCNW.js";
 import "./chunk-RFYAYKTD.js";
 import "./chunk-LBLXEFWK.js";
 import "./chunk-VFUEZZBS.js";
-import "./chunk-VDX2J7OX.js";
+import "./chunk-BUKK5SWA.js";
 import "./chunk-WEHSQBFR.js";
-import "./chunk-DQEMWVMT.js";
+import "./chunk-UVYI6VIX.js";
 import "./chunk-J4EB7DNW.js";
 import "./chunk-BJMBJZ2Y.js";
 import "./chunk-UKJAGEXH.js";

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 { resolvePluginEntry } from \"./plugin-entry-resolver.js\";\nimport { expandTildePath } from \"./utils/path.js\";\n\nconst OPENCLAW_REMNIC_PLUGIN_IDS = [\"openclaw-remnic\", \"openclaw-engram\"] as const;\n\ntype CommandName = \"browse\" | \"store\";\n\ntype ParsedArgs = {\n  command: CommandName;\n  options: Record<string, string[]>;\n  flags: Set<string>;\n};\n\ntype CommandSpec = {\n  valueOptions: ReadonlySet<string>;\n  flagOptions: ReadonlySet<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 the plugin-entry resolver 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\nfunction getOpenClawPluginEntries(raw: Record<string, unknown>): Record<string, unknown> | undefined {\n  const plugins =\n    raw[\"plugins\"] && typeof raw[\"plugins\"] === \"object\" && !Array.isArray(raw[\"plugins\"])\n      ? (raw[\"plugins\"] as Record<string, unknown>)\n      : undefined;\n  const entries =\n    plugins && plugins[\"entries\"] && typeof plugins[\"entries\"] === \"object\" && !Array.isArray(plugins[\"entries\"])\n      ? (plugins[\"entries\"] as Record<string, unknown>)\n      : undefined;\n  return entries;\n}\n\nfunction getOpenClawMemorySlotId(raw: Record<string, unknown>): string | undefined {\n  const plugins =\n    raw[\"plugins\"] && typeof raw[\"plugins\"] === \"object\" && !Array.isArray(raw[\"plugins\"])\n      ? (raw[\"plugins\"] as Record<string, unknown>)\n      : undefined;\n  const slots =\n    plugins && plugins[\"slots\"] && typeof plugins[\"slots\"] === \"object\" && !Array.isArray(plugins[\"slots\"])\n      ? (plugins[\"slots\"] as Record<string, unknown>)\n      : undefined;\n  const slotId = slots?.[\"memory\"];\n  return typeof slotId === \"string\" ? slotId : undefined;\n}\n\nfunction resolveOpenClawRemnicPluginEntry(raw: unknown, preferredId?: string): Record<string, unknown> | undefined {\n  return resolvePluginEntry(raw, {\n    candidateIds: OPENCLAW_REMNIC_PLUGIN_IDS,\n    preferredId,\n    getEntries: getOpenClawPluginEntries,\n    getSlotId: getOpenClawMemorySlotId,\n  });\n}\n\nfunction hasAllowedOpenClawRemnicPluginId(value: string): boolean {\n  return (OPENCLAW_REMNIC_PLUGIN_IDS as readonly string[]).includes(value);\n}\n\ntype UsageErrorKind =\n  | \"unsupported-command\"\n  | \"unexpected-positional\"\n  | \"unknown-option\"\n  | \"invalid-option\"\n  | \"option-does-not-take-value\"\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    readonly acceptedValues?: readonly 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 \"unknown-option\":\n      return `unknown option: --${error.optionName ?? \"unknown\"}`;\n    case \"invalid-option\": {\n      const accepted = error.acceptedValues?.length ? `. Accepted: ${error.acceptedValues.join(\", \")}.` : \"\";\n      return `invalid value for --${error.optionName ?? \"unknown\"}${accepted}`;\n    }\n    case \"option-does-not-take-value\":\n      return `option does not accept a value: --${error.optionName ?? \"unknown\"}`;\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    \"  --principal <principal>\",\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\nconst COMMAND_SPECS: Record<CommandName, CommandSpec> = {\n  browse: {\n    valueOptions: new Set([\n      \"namespace\",\n      \"principal\",\n      \"query\",\n      \"category\",\n      \"status\",\n      \"sort\",\n      \"limit\",\n      \"offset\",\n    ]),\n    flagOptions: new Set(),\n  },\n  store: {\n    valueOptions: new Set([\n      \"namespace\",\n      \"session-key\",\n      \"principal\",\n      \"content\",\n      \"content-file\",\n      \"category\",\n      \"confidence\",\n      \"tag\",\n      \"entity-ref\",\n      \"ttl\",\n      \"source-reason\",\n      \"idempotency-key\",\n    ]),\n    flagOptions: new Set([\"dry-run\"]),\n  },\n};\n\nconst BROWSE_SORT_VALUES = Object.freeze([\n  \"updated_desc\",\n  \"updated_asc\",\n  \"created_desc\",\n  \"created_asc\",\n] as const);\n\ntype BrowseSort = (typeof BROWSE_SORT_VALUES)[number];\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  const spec = COMMAND_SPECS[commandRaw];\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 rawKey = token.slice(2);\n    if (!rawKey) {\n      throw new UsageError(\"unknown-option\", rawKey);\n    }\n    const equalsIndex = rawKey.indexOf(\"=\");\n    const key = equalsIndex === -1 ? rawKey : rawKey.slice(0, equalsIndex);\n    const inlineValue = equalsIndex === -1 ? undefined : rawKey.slice(equalsIndex + 1);\n\n    if (!spec.valueOptions.has(key) && !spec.flagOptions.has(key)) {\n      throw new UsageError(\"unknown-option\", key);\n    }\n\n    if (spec.flagOptions.has(key)) {\n      if (inlineValue !== undefined) {\n        throw new UsageError(\"option-does-not-take-value\", key);\n      }\n      const next = rest[i + 1];\n      if (next && !next.startsWith(\"--\")) {\n        throw new UsageError(\"option-does-not-take-value\", key);\n      }\n      flags.add(key);\n      continue;\n    }\n\n    if (inlineValue !== undefined) {\n      if (inlineValue.length === 0) {\n        throw new UsageError(\"missing-option\", key);\n      }\n      if (!options[key]) {\n        options[key] = [];\n      }\n      options[key].push(inlineValue);\n      continue;\n    }\n\n    const next = rest[i + 1];\n    if (next === undefined || next.length === 0 || next.startsWith(\"--\")) {\n      throw new UsageError(\"missing-option\", key);\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(\n  args: ParsedArgs,\n  name: string,\n  options: { min?: number } = {},\n): number | undefined {\n  const raw = getLastOption(args, name);\n  if (!raw) return undefined;\n  const trimmed = raw.trim();\n  if (!/^[+-]?\\d+$/.test(trimmed)) {\n    throw new UsageError(\"invalid-integer\", name);\n  }\n  const value = Number(trimmed);\n  if (!Number.isSafeInteger(value)) {\n    throw new UsageError(\"invalid-integer\", name);\n  }\n  if (options.min !== undefined && value < options.min) {\n    throw new UsageError(\"invalid-option\", name, [`integer >= ${options.min}`]);\n  }\n  return value;\n}\n\nfunction parseBrowseSortOption(args: ParsedArgs, name: string): BrowseSort | undefined {\n  const raw = getLastOption(args, name);\n  if (!raw) return undefined;\n  if ((BROWSE_SORT_VALUES as readonly string[]).includes(raw)) {\n    return raw as BrowseSort;\n  }\n  throw new UsageError(\"invalid-option\", name, BROWSE_SORT_VALUES);\n}\n\nfunction parseFloatOption(\n  args: ParsedArgs,\n  name: string,\n  options: { min?: number; max?: number } = {},\n): number | undefined {\n  const raw = getLastOption(args, name);\n  if (!raw) return undefined;\n  const trimmed = raw.trim();\n  if (!/^[+-]?(?:(?:\\d+\\.?\\d*)|(?:\\.\\d+))(?:e[+-]?\\d+)?$/i.test(trimmed)) {\n    throw new UsageError(\"invalid-number\", name);\n  }\n  const value = Number(trimmed);\n  if (!Number.isFinite(value)) {\n    throw new UsageError(\"invalid-number\", name);\n  }\n  if (options.min !== undefined && value < options.min) {\n    throw new UsageError(\"invalid-number\", name);\n  }\n  if (options.max !== undefined && value > options.max) {\n    throw new UsageError(\"invalid-number\", name);\n  }\n  return value;\n}\n\nfunction loadPluginConfig(preferredId?: string): Record<string, unknown> {\n  const configPath =\n    expandOptionalPath(readEnvVar(\"OPENCLAW_CONFIG_PATH\")) ||\n    expandOptionalPath(readEnvVar(\"OPENCLAW_ENGRAM_CONFIG_PATH\")) ||\n    path.join(resolveHomeDir(), \".openclaw\", \"openclaw.json\");\n  const raw = JSON.parse(fs.readFileSync(configPath, \"utf8\"));\n  const slotId =\n    raw && typeof raw === \"object\" && !Array.isArray(raw)\n      ? getOpenClawMemorySlotId(raw as Record<string, unknown>)\n      : undefined;\n  if (typeof slotId === \"string\" && !hasAllowedOpenClawRemnicPluginId(slotId)) {\n    throw new Error(\n      `OpenClaw memory slot points to non-Remnic plugin \"${slotId}\"; refusing to use default Remnic access config.`,\n    );\n  }\n  // Delegate slot → preferredId → canonical → legacy resolution to the\n  // generic 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 = resolveOpenClawRemnicPluginEntry(raw, preferredId);\n  if (!entry) {\n    throw new Error(\n      \"OpenClaw config does not contain an allowed Remnic plugin entry; refusing to use default Remnic access config.\",\n    );\n  }\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 browseArgs = {\n    namespace: getLastOption(args, \"namespace\"),\n    principal: getLastOption(args, \"principal\"),\n    query: getLastOption(args, \"query\"),\n    category: getLastOption(args, \"category\"),\n    status: getLastOption(args, \"status\"),\n    sort: parseBrowseSortOption(args, \"sort\"),\n    limit: parseIntegerOption(args, \"limit\", { min: 1 }),\n    offset: parseIntegerOption(args, \"offset\", { min: 0 }),\n  };\n  const { config, service } = buildRuntime(preferredId);\n  const request = {\n    namespace: browseArgs.namespace,\n    authenticatedPrincipal: browseArgs.principal ?? config.agentAccessHttp.principal,\n    query: browseArgs.query,\n    category: browseArgs.category,\n    status: browseArgs.status,\n    sort: browseArgs.sort,\n    limit: browseArgs.limit,\n    offset: browseArgs.offset,\n  };\n  const result = await service.memoryBrowse(request);\n  console.log(JSON.stringify(result, null, 2));\n}\n\nasync function runStore(args: ParsedArgs, preferredId?: string): Promise<void> {\n  const contentFile = getLastOption(args, \"content-file\");\n  const inlineContent = getLastOption(args, \"content\");\n  const content = contentFile\n    ? fs.readFileSync(expandTildePath(contentFile), \"utf8\")\n    : inlineContent;\n  if (!content || content.trim().length === 0) {\n    throw new UsageError(\"missing-content\");\n  }\n  const storeArgs = {\n    namespace: getLastOption(args, \"namespace\"),\n    sessionKey: getLastOption(args, \"session-key\"),\n    content,\n    category: requireOption(args, \"category\"),\n    confidence: parseFloatOption(args, \"confidence\", { min: 0, max: 1 }),\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\n  const { config, service } = buildRuntime(preferredId);\n  const result = await service.memoryStore({\n    namespace: storeArgs.namespace,\n    sessionKey: storeArgs.sessionKey,\n    authenticatedPrincipal: getLastOption(args, \"principal\") ?? config.agentAccessHttp.principal,\n    content: storeArgs.content,\n    category: storeArgs.category,\n    confidence: storeArgs.confidence,\n    tags: storeArgs.tags,\n    entityRef: storeArgs.entityRef,\n    ttl: storeArgs.ttl,\n    sourceReason: storeArgs.sourceReason,\n    idempotencyKey: storeArgs.idempotencyKey,\n    dryRun: storeArgs.dryRun,\n  });\n  console.log(JSON.stringify(result, null, 2));\n}\n\nfunction expandOptionalPath(value: string | undefined): string | undefined {\n  return value === undefined ? undefined : expandTildePath(value);\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 sanitizeAccessCliErrorMessage(message: string): string {\n  return message.replace(\n    /\\b(openaiApiKey|localLlmApiKey)\\b(\\s*[:=]\\s*)(?:\"[^\"]*\"|'[^']*'|[^\\s,}\\]]+)/gi,\n    (_match, name: string, separator: string) => `${name}${separator}[redacted]`,\n  );\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: runtime error\");\n    process.exit(1);\n  }\n}\n"],"mappings":"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","names":["next"]}
+{"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 { resolvePluginEntry } from \"./plugin-entry-resolver.js\";\nimport { expandTildePath } from \"./utils/path.js\";\n\nconst OPENCLAW_REMNIC_PLUGIN_IDS = [\"openclaw-remnic\", \"openclaw-engram\"] as const;\n\ntype CommandName = \"browse\" | \"store\";\n\ntype ParsedArgs = {\n  command: CommandName;\n  options: Record<string, string[]>;\n  flags: Set<string>;\n};\n\ntype CommandSpec = {\n  valueOptions: ReadonlySet<string>;\n  flagOptions: ReadonlySet<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 the plugin-entry resolver 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\nfunction getOpenClawPluginEntries(raw: Record<string, unknown>): Record<string, unknown> | undefined {\n  const plugins =\n    raw[\"plugins\"] && typeof raw[\"plugins\"] === \"object\" && !Array.isArray(raw[\"plugins\"])\n      ? (raw[\"plugins\"] as Record<string, unknown>)\n      : undefined;\n  const entries =\n    plugins && plugins[\"entries\"] && typeof plugins[\"entries\"] === \"object\" && !Array.isArray(plugins[\"entries\"])\n      ? (plugins[\"entries\"] as Record<string, unknown>)\n      : undefined;\n  return entries;\n}\n\nfunction getOpenClawMemorySlotId(raw: Record<string, unknown>): string | undefined {\n  const plugins =\n    raw[\"plugins\"] && typeof raw[\"plugins\"] === \"object\" && !Array.isArray(raw[\"plugins\"])\n      ? (raw[\"plugins\"] as Record<string, unknown>)\n      : undefined;\n  const slots =\n    plugins && plugins[\"slots\"] && typeof plugins[\"slots\"] === \"object\" && !Array.isArray(plugins[\"slots\"])\n      ? (plugins[\"slots\"] as Record<string, unknown>)\n      : undefined;\n  const slotId = slots?.[\"memory\"];\n  return typeof slotId === \"string\" ? slotId : undefined;\n}\n\nfunction resolveOpenClawRemnicPluginEntry(raw: unknown, preferredId?: string): Record<string, unknown> | undefined {\n  return resolvePluginEntry(raw, {\n    candidateIds: OPENCLAW_REMNIC_PLUGIN_IDS,\n    preferredId,\n    getEntries: getOpenClawPluginEntries,\n    getSlotId: getOpenClawMemorySlotId,\n  });\n}\n\nfunction hasAllowedOpenClawRemnicPluginId(value: string): boolean {\n  return (OPENCLAW_REMNIC_PLUGIN_IDS as readonly string[]).includes(value);\n}\n\ntype UsageErrorKind =\n  | \"unsupported-command\"\n  | \"unexpected-positional\"\n  | \"unknown-option\"\n  | \"invalid-option\"\n  | \"option-does-not-take-value\"\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    readonly acceptedValues?: readonly 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 \"unknown-option\":\n      return `unknown option: --${error.optionName ?? \"unknown\"}`;\n    case \"invalid-option\": {\n      const accepted = error.acceptedValues?.length ? `. Accepted: ${error.acceptedValues.join(\", \")}.` : \"\";\n      return `invalid value for --${error.optionName ?? \"unknown\"}${accepted}`;\n    }\n    case \"option-does-not-take-value\":\n      return `option does not accept a value: --${error.optionName ?? \"unknown\"}`;\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    \"  --principal <principal>\",\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\nconst COMMAND_SPECS: Record<CommandName, CommandSpec> = {\n  browse: {\n    valueOptions: new Set([\n      \"namespace\",\n      \"principal\",\n      \"query\",\n      \"category\",\n      \"status\",\n      \"sort\",\n      \"limit\",\n      \"offset\",\n    ]),\n    flagOptions: new Set(),\n  },\n  store: {\n    valueOptions: new Set([\n      \"namespace\",\n      \"session-key\",\n      \"principal\",\n      \"content\",\n      \"content-file\",\n      \"category\",\n      \"confidence\",\n      \"tag\",\n      \"entity-ref\",\n      \"ttl\",\n      \"source-reason\",\n      \"idempotency-key\",\n    ]),\n    flagOptions: new Set([\"dry-run\"]),\n  },\n};\n\nconst BROWSE_SORT_VALUES = Object.freeze([\n  \"updated_desc\",\n  \"updated_asc\",\n  \"created_desc\",\n  \"created_asc\",\n] as const);\n\ntype BrowseSort = (typeof BROWSE_SORT_VALUES)[number];\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  const spec = COMMAND_SPECS[commandRaw];\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 rawKey = token.slice(2);\n    if (!rawKey) {\n      throw new UsageError(\"unknown-option\", rawKey);\n    }\n    const equalsIndex = rawKey.indexOf(\"=\");\n    const key = equalsIndex === -1 ? rawKey : rawKey.slice(0, equalsIndex);\n    const inlineValue = equalsIndex === -1 ? undefined : rawKey.slice(equalsIndex + 1);\n\n    if (!spec.valueOptions.has(key) && !spec.flagOptions.has(key)) {\n      throw new UsageError(\"unknown-option\", key);\n    }\n\n    if (spec.flagOptions.has(key)) {\n      if (inlineValue !== undefined) {\n        throw new UsageError(\"option-does-not-take-value\", key);\n      }\n      const next = rest[i + 1];\n      if (next && !next.startsWith(\"--\")) {\n        throw new UsageError(\"option-does-not-take-value\", key);\n      }\n      flags.add(key);\n      continue;\n    }\n\n    if (inlineValue !== undefined) {\n      if (inlineValue.length === 0) {\n        throw new UsageError(\"missing-option\", key);\n      }\n      if (!options[key]) {\n        options[key] = [];\n      }\n      options[key].push(inlineValue);\n      continue;\n    }\n\n    const next = rest[i + 1];\n    if (next === undefined || next.length === 0 || next.startsWith(\"--\")) {\n      throw new UsageError(\"missing-option\", key);\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(\n  args: ParsedArgs,\n  name: string,\n  options: { min?: number } = {},\n): number | undefined {\n  const raw = getLastOption(args, name);\n  if (!raw) return undefined;\n  const trimmed = raw.trim();\n  if (!/^[+-]?\\d+$/.test(trimmed)) {\n    throw new UsageError(\"invalid-integer\", name);\n  }\n  const value = Number(trimmed);\n  if (!Number.isSafeInteger(value)) {\n    throw new UsageError(\"invalid-integer\", name);\n  }\n  if (options.min !== undefined && value < options.min) {\n    throw new UsageError(\"invalid-option\", name, [`integer >= ${options.min}`]);\n  }\n  return value;\n}\n\nfunction parseBrowseSortOption(args: ParsedArgs, name: string): BrowseSort | undefined {\n  const raw = getLastOption(args, name);\n  if (!raw) return undefined;\n  if ((BROWSE_SORT_VALUES as readonly string[]).includes(raw)) {\n    return raw as BrowseSort;\n  }\n  throw new UsageError(\"invalid-option\", name, BROWSE_SORT_VALUES);\n}\n\nfunction parseFloatOption(\n  args: ParsedArgs,\n  name: string,\n  options: { min?: number; max?: number } = {},\n): number | undefined {\n  const raw = getLastOption(args, name);\n  if (!raw) return undefined;\n  const trimmed = raw.trim();\n  if (!/^[+-]?(?:(?:\\d+\\.?\\d*)|(?:\\.\\d+))(?:e[+-]?\\d+)?$/i.test(trimmed)) {\n    throw new UsageError(\"invalid-number\", name);\n  }\n  const value = Number(trimmed);\n  if (!Number.isFinite(value)) {\n    throw new UsageError(\"invalid-number\", name);\n  }\n  if (options.min !== undefined && value < options.min) {\n    throw new UsageError(\"invalid-number\", name);\n  }\n  if (options.max !== undefined && value > options.max) {\n    throw new UsageError(\"invalid-number\", name);\n  }\n  return value;\n}\n\nfunction loadPluginConfig(preferredId?: string): Record<string, unknown> {\n  const configPath =\n    expandOptionalPath(readEnvVar(\"OPENCLAW_CONFIG_PATH\")) ||\n    expandOptionalPath(readEnvVar(\"OPENCLAW_ENGRAM_CONFIG_PATH\")) ||\n    path.join(resolveHomeDir(), \".openclaw\", \"openclaw.json\");\n  const raw = JSON.parse(fs.readFileSync(configPath, \"utf8\"));\n  const slotId =\n    raw && typeof raw === \"object\" && !Array.isArray(raw)\n      ? getOpenClawMemorySlotId(raw as Record<string, unknown>)\n      : undefined;\n  if (typeof slotId === \"string\" && !hasAllowedOpenClawRemnicPluginId(slotId)) {\n    throw new Error(\n      `OpenClaw memory slot points to non-Remnic plugin \"${slotId}\"; refusing to use default Remnic access config.`,\n    );\n  }\n  // Delegate slot → preferredId → canonical → legacy resolution to the\n  // generic 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 = resolveOpenClawRemnicPluginEntry(raw, preferredId);\n  if (!entry) {\n    throw new Error(\n      \"OpenClaw config does not contain an allowed Remnic plugin entry; refusing to use default Remnic access config.\",\n    );\n  }\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 browseArgs = {\n    namespace: getLastOption(args, \"namespace\"),\n    principal: getLastOption(args, \"principal\"),\n    query: getLastOption(args, \"query\"),\n    category: getLastOption(args, \"category\"),\n    status: getLastOption(args, \"status\"),\n    sort: parseBrowseSortOption(args, \"sort\"),\n    limit: parseIntegerOption(args, \"limit\", { min: 1 }),\n    offset: parseIntegerOption(args, \"offset\", { min: 0 }),\n  };\n  const { config, service } = buildRuntime(preferredId);\n  const request = {\n    namespace: browseArgs.namespace,\n    authenticatedPrincipal: browseArgs.principal ?? config.agentAccessHttp.principal,\n    query: browseArgs.query,\n    category: browseArgs.category,\n    status: browseArgs.status,\n    sort: browseArgs.sort,\n    limit: browseArgs.limit,\n    offset: browseArgs.offset,\n  };\n  const result = await service.memoryBrowse(request);\n  console.log(JSON.stringify(result, null, 2));\n}\n\nasync function runStore(args: ParsedArgs, preferredId?: string): Promise<void> {\n  const contentFile = getLastOption(args, \"content-file\");\n  const inlineContent = getLastOption(args, \"content\");\n  const content = contentFile\n    ? fs.readFileSync(expandTildePath(contentFile), \"utf8\")\n    : inlineContent;\n  if (!content || content.trim().length === 0) {\n    throw new UsageError(\"missing-content\");\n  }\n  const storeArgs = {\n    namespace: getLastOption(args, \"namespace\"),\n    sessionKey: getLastOption(args, \"session-key\"),\n    content,\n    category: requireOption(args, \"category\"),\n    confidence: parseFloatOption(args, \"confidence\", { min: 0, max: 1 }),\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\n  const { config, service } = buildRuntime(preferredId);\n  const result = await service.memoryStore({\n    namespace: storeArgs.namespace,\n    sessionKey: storeArgs.sessionKey,\n    authenticatedPrincipal: getLastOption(args, \"principal\") ?? config.agentAccessHttp.principal,\n    content: storeArgs.content,\n    category: storeArgs.category,\n    confidence: storeArgs.confidence,\n    tags: storeArgs.tags,\n    entityRef: storeArgs.entityRef,\n    ttl: storeArgs.ttl,\n    sourceReason: storeArgs.sourceReason,\n    idempotencyKey: storeArgs.idempotencyKey,\n    dryRun: storeArgs.dryRun,\n  });\n  console.log(JSON.stringify(result, null, 2));\n}\n\nfunction expandOptionalPath(value: string | undefined): string | undefined {\n  return value === undefined ? undefined : expandTildePath(value);\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 sanitizeAccessCliErrorMessage(message: string): string {\n  return message.replace(\n    /\\b(openaiApiKey|localLlmApiKey)\\b(\\s*[:=]\\s*)(?:\"[^\"]*\"|'[^']*'|[^\\s,}\\]]+)/gi,\n    (_match, name: string, separator: string) => `${name}${separator}[redacted]`,\n  );\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: runtime error\");\n    process.exit(1);\n  }\n}\n"],"mappings":"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","names":["next"]}

package/dist/access-http.js

@@ -1,21 +1,21 @@
 import {
   EngramAccessHttpServer
-} from "./chunk-BTRL6GG7.js";
+} from "./chunk-RAELB5NX.js";
 import "./chunk-SEDEKFYQ.js";
-import "./chunk-2QSZNTDO.js";
+import "./chunk-RKNJBZ55.js";
+import "./chunk-J64TK33U.js";
 import "./chunk-RSUYKGGZ.js";
 import "./chunk-42NQ7AVG.js";
 import "./chunk-TMSXWOBZ.js";
-import "./chunk-J64TK33U.js";
 import "./chunk-7RXCMVFQ.js";
 import "./chunk-7WV3F5DQ.js";
-import "./chunk-YOXCJP3A.js";
+import "./chunk-ZPPFKVSD.js";
 import "./chunk-T4WDJPEZ.js";
 import "./chunk-D24OXEPB.js";
-import "./chunk-W5ISYSIL.js";
+import "./chunk-L7W5YW6Y.js";
 import "./chunk-GDASG7NC.js";
 import "./chunk-GDB4J2H3.js";
-import "./chunk-DGNQRNLL.js";
+import "./chunk-NT5TINK5.js";
 import "./chunk-IENGGY2C.js";
 import "./chunk-SOBJ6NEY.js";
 import "./chunk-BT7NVCML.js";
@@ -26,14 +26,14 @@ import "./chunk-5RIRL3XL.js";
 import "./chunk-JGSKJHF7.js";
 import "./chunk-FF4KLI5W.js";
 import "./chunk-BEMWL2FZ.js";
-import "./chunk-HRXCPKN4.js";
-import "./chunk-KVUG7FF7.js";
+import "./chunk-APWJRJFW.js";
+import "./chunk-U55D5UD5.js";
+import "./chunk-CYEPCZN5.js";
+import "./chunk-DCGT4FPP.js";
 import "./chunk-JOASJWQR.js";
 import "./chunk-RN7MUWON.js";
 import "./chunk-3MAONBX3.js";
 import "./chunk-RG3LBSGH.js";
-import "./chunk-CYEPCZN5.js";
-import "./chunk-DCGT4FPP.js";
 import "./chunk-Q4CAQGKQ.js";
 import "./chunk-CINZGPSJ.js";
 import "./chunk-ZFXCQPNO.js";
@@ -92,10 +92,10 @@ import "./chunk-TVVEYCNW.js";
 import "./chunk-RFYAYKTD.js";
 import "./chunk-LBLXEFWK.js";
 import "./chunk-VFUEZZBS.js";
-import "./chunk-CDHRUNBX.js";
-import "./chunk-VDX2J7OX.js";
+import "./chunk-QKE4LHNR.js";
+import "./chunk-BUKK5SWA.js";
 import "./chunk-WEHSQBFR.js";
-import "./chunk-DQEMWVMT.js";
+import "./chunk-UVYI6VIX.js";
 import "./chunk-J4EB7DNW.js";
 import "./chunk-BJMBJZ2Y.js";
 import "./chunk-UKJAGEXH.js";

package/dist/access-mcp.js

@@ -1,12 +1,12 @@
 import {
   EngramMcpServer
-} from "./chunk-YOXCJP3A.js";
+} from "./chunk-ZPPFKVSD.js";
 import "./chunk-T4WDJPEZ.js";
 import "./chunk-D24OXEPB.js";
-import "./chunk-W5ISYSIL.js";
+import "./chunk-L7W5YW6Y.js";
 import "./chunk-GDASG7NC.js";
 import "./chunk-GDB4J2H3.js";
-import "./chunk-DGNQRNLL.js";
+import "./chunk-NT5TINK5.js";
 import "./chunk-IENGGY2C.js";
 import "./chunk-SOBJ6NEY.js";
 import "./chunk-BT7NVCML.js";
@@ -17,14 +17,14 @@ import "./chunk-5RIRL3XL.js";
 import "./chunk-JGSKJHF7.js";
 import "./chunk-FF4KLI5W.js";
 import "./chunk-BEMWL2FZ.js";
-import "./chunk-HRXCPKN4.js";
-import "./chunk-KVUG7FF7.js";
+import "./chunk-APWJRJFW.js";
+import "./chunk-U55D5UD5.js";
+import "./chunk-CYEPCZN5.js";
+import "./chunk-DCGT4FPP.js";
 import "./chunk-JOASJWQR.js";
 import "./chunk-RN7MUWON.js";
 import "./chunk-3MAONBX3.js";
 import "./chunk-RG3LBSGH.js";
-import "./chunk-CYEPCZN5.js";
-import "./chunk-DCGT4FPP.js";
 import "./chunk-Q4CAQGKQ.js";
 import "./chunk-CINZGPSJ.js";
 import "./chunk-ZFXCQPNO.js";
@@ -83,10 +83,10 @@ import "./chunk-TVVEYCNW.js";
 import "./chunk-RFYAYKTD.js";
 import "./chunk-LBLXEFWK.js";
 import "./chunk-VFUEZZBS.js";
-import "./chunk-CDHRUNBX.js";
-import "./chunk-VDX2J7OX.js";
+import "./chunk-QKE4LHNR.js";
+import "./chunk-BUKK5SWA.js";
 import "./chunk-WEHSQBFR.js";
-import "./chunk-DQEMWVMT.js";
+import "./chunk-UVYI6VIX.js";
 import "./chunk-J4EB7DNW.js";
 import "./chunk-BJMBJZ2Y.js";
 import "./chunk-UKJAGEXH.js";

package/dist/access-schema.js

@@ -25,10 +25,10 @@ import {
   trustZoneDemoSeedRequestSchema,
   trustZonePromoteRequestSchema,
   validateRequest
-} from "./chunk-CDHRUNBX.js";
-import "./chunk-VDX2J7OX.js";
+} from "./chunk-QKE4LHNR.js";
+import "./chunk-BUKK5SWA.js";
 import "./chunk-WEHSQBFR.js";
-import "./chunk-DQEMWVMT.js";
+import "./chunk-UVYI6VIX.js";
 import "./chunk-J4EB7DNW.js";
 import "./chunk-BJMBJZ2Y.js";
 import "./chunk-UKJAGEXH.js";

package/dist/access-service.js

@@ -3,10 +3,10 @@ import {
   EngramAccessInputError,
   EngramAccessService,
   shapeMemorySummary
-} from "./chunk-W5ISYSIL.js";
+} from "./chunk-L7W5YW6Y.js";
 import "./chunk-GDASG7NC.js";
 import "./chunk-GDB4J2H3.js";
-import "./chunk-DGNQRNLL.js";
+import "./chunk-NT5TINK5.js";
 import "./chunk-IENGGY2C.js";
 import "./chunk-SOBJ6NEY.js";
 import "./chunk-BT7NVCML.js";
@@ -17,14 +17,14 @@ import "./chunk-5RIRL3XL.js";
 import "./chunk-JGSKJHF7.js";
 import "./chunk-FF4KLI5W.js";
 import "./chunk-BEMWL2FZ.js";
-import "./chunk-HRXCPKN4.js";
-import "./chunk-KVUG7FF7.js";
+import "./chunk-APWJRJFW.js";
+import "./chunk-U55D5UD5.js";
+import "./chunk-CYEPCZN5.js";
+import "./chunk-DCGT4FPP.js";
 import "./chunk-JOASJWQR.js";
 import "./chunk-RN7MUWON.js";
 import "./chunk-3MAONBX3.js";
 import "./chunk-RG3LBSGH.js";
-import "./chunk-CYEPCZN5.js";
-import "./chunk-DCGT4FPP.js";
 import "./chunk-Q4CAQGKQ.js";
 import "./chunk-CINZGPSJ.js";
 import "./chunk-ZFXCQPNO.js";
@@ -83,9 +83,9 @@ import "./chunk-TVVEYCNW.js";
 import "./chunk-RFYAYKTD.js";
 import "./chunk-LBLXEFWK.js";
 import "./chunk-VFUEZZBS.js";
-import "./chunk-VDX2J7OX.js";
+import "./chunk-BUKK5SWA.js";
 import "./chunk-WEHSQBFR.js";
-import "./chunk-DQEMWVMT.js";
+import "./chunk-UVYI6VIX.js";
 import "./chunk-J4EB7DNW.js";
 import "./chunk-BJMBJZ2Y.js";
 import "./chunk-UKJAGEXH.js";

package/dist/adapters/index.js

@@ -1,7 +1,10 @@
 import "../chunk-SEDEKFYQ.js";
 import {
   AdapterRegistry
-} from "../chunk-2QSZNTDO.js";
+} from "../chunk-RKNJBZ55.js";
+import {
+  ClaudeCodeAdapter
+} from "../chunk-J64TK33U.js";
 import {
   CodexAdapter
 } from "../chunk-RSUYKGGZ.js";
@@ -11,9 +14,6 @@ import {
 import {
   ReplitAdapter
 } from "../chunk-TMSXWOBZ.js";
-import {
-  ClaudeCodeAdapter
-} from "../chunk-J64TK33U.js";
 import "../chunk-7RXCMVFQ.js";
 import "../chunk-PZ5AY32C.js";
 export {

package/dist/adapters/registry.js

@@ -1,10 +1,10 @@
 import {
   AdapterRegistry
-} from "../chunk-2QSZNTDO.js";
+} from "../chunk-RKNJBZ55.js";
+import "../chunk-J64TK33U.js";
 import "../chunk-RSUYKGGZ.js";
 import "../chunk-42NQ7AVG.js";
 import "../chunk-TMSXWOBZ.js";
-import "../chunk-J64TK33U.js";
 import "../chunk-7RXCMVFQ.js";
 import "../chunk-PZ5AY32C.js";
 export {

package/dist/{capsule-crypto-YO5QJ6L3.js → capsule-crypto-GWVG7LGC.js}

@@ -3,7 +3,7 @@ import {
   decryptCapsuleFileInMemory,
   encryptCapsuleFile,
   isEncryptedCapsuleFile
-} from "./chunk-DQEMWVMT.js";
+} from "./chunk-UVYI6VIX.js";
 import "./chunk-BJMBJZ2Y.js";
 import "./chunk-UKJAGEXH.js";
 import "./chunk-FP2373TW.js";
@@ -15,4 +15,4 @@ export {
   encryptCapsuleFile,
   isEncryptedCapsuleFile
 };
-//# sourceMappingURL=capsule-crypto-YO5QJ6L3.js.map
+//# sourceMappingURL=capsule-crypto-GWVG7LGC.js.map

package/dist/{chunk-6YLJZ2EU.js → chunk-3D6L7CEP.js}

@@ -12,13 +12,7 @@ import {
 } from "./chunk-HDDRVXX4.js";
 import {
   importSqlite
-} from "./chunk-AGNBY3VG.js";
-import {
-  exportJsonBundle
-} from "./chunk-UP6MOYCB.js";
-import {
-  exportSqlite
-} from "./chunk-7VFZTJ7K.js";
+} from "./chunk-APJQ6UEA.js";
 import {
   detectImportFormat
 } from "./chunk-OZKVVUJB.js";
@@ -27,18 +21,16 @@ import {
 } from "./chunk-2DL3OFLD.js";
 import {
   backupMemoryDir
-} from "./chunk-BXLOS5AJ.js";
+} from "./chunk-OWHERGF2.js";
+import {
+  exportJsonBundle
+} from "./chunk-UP6MOYCB.js";
 import {
   exportMarkdownBundle
 } from "./chunk-765K3SAT.js";
 import {
-  buildReplayNormalizerRegistry,
-  clampBatchSize,
-  runReplay
-} from "./chunk-HOJZMQ4J.js";
-import {
-  rebuildObservations
-} from "./chunk-LZZNTPLR.js";
+  exportSqlite
+} from "./chunk-7VFZTJ7K.js";
 import {
   TailscaleHelper
 } from "./chunk-EEC4PCG5.js";
@@ -46,11 +38,10 @@ import {
   WebDavServer
 } from "./chunk-PYIFUBRK.js";
 import {
-  archiveObservations
-} from "./chunk-WMWVO45V.js";
-import {
-  migrateObservations
-} from "./chunk-D6RIFG4O.js";
+  buildReplayNormalizerRegistry,
+  clampBatchSize,
+  runReplay
+} from "./chunk-HOJZMQ4J.js";
 import {
   rebuildMemoryLifecycleLedger
 } from "./chunk-PQFUUXWK.js";
@@ -59,6 +50,15 @@ import {
   repairMemoryProjection,
   verifyMemoryProjection
 } from "./chunk-MCYT2RNT.js";
+import {
+  rebuildObservations
+} from "./chunk-LZZNTPLR.js";
+import {
+  archiveObservations
+} from "./chunk-WMWVO45V.js";
+import {
+  migrateObservations
+} from "./chunk-D6RIFG4O.js";
 import {
   getBulkImportSource,
   listBulkImportSources,
@@ -68,6 +68,10 @@ import {
 import {
   runCompatChecks
 } from "./chunk-GQL52GQ5.js";
+import {
+  migrateSessionTranscripts,
+  planSessionTranscriptMigration
+} from "./chunk-EVWIEEKZ.js";
 import {
   promoteSemanticRuleFromMemory
 } from "./chunk-OTC2KOZ2.js";
@@ -75,7 +79,7 @@ import {
   buildResumeBundleFromState,
   getResumeBundleStatus,
   recordResumeBundle
-} from "./chunk-3SF7QNKF.js";
+} from "./chunk-6BNFVP7Y.js";
 import {
   parseXrayCliOptions
 } from "./chunk-WLGE6KEO.js";
@@ -89,12 +93,12 @@ import {
   runOperatorInventory,
   runOperatorRepair,
   runOperatorSetup
-} from "./chunk-T22TZJWJ.js";
+} from "./chunk-DC66QVL2.js";
 import {
   listNamespaces,
   runNamespaceMigration,
   verifyNamespaces
-} from "./chunk-IZXOO6NP.js";
+} from "./chunk-FAYDM5WD.js";
 import {
   collectPatternMemories,
   explainPatternMemory,
@@ -209,16 +213,16 @@ import {
 } from "./chunk-OADWQ5CR.js";
 import {
   EngramAccessHttpServer
-} from "./chunk-BTRL6GG7.js";
+} from "./chunk-RAELB5NX.js";
 import {
   WearablesInputError
 } from "./chunk-7WV3F5DQ.js";
 import {
   EngramMcpServer
-} from "./chunk-YOXCJP3A.js";
+} from "./chunk-ZPPFKVSD.js";
 import {
   EngramAccessService
-} from "./chunk-W5ISYSIL.js";
+} from "./chunk-L7W5YW6Y.js";
 import {
   WorkStorage
 } from "./chunk-GDB4J2H3.js";
@@ -3519,7 +3523,7 @@ function registerCli(api, orchestrator, registerOptions = {}) {
           }
         }
         if (sourceArchive.endsWith(".enc")) {
-          const { isEncryptedCapsuleFile } = await import("./capsule-crypto-YO5QJ6L3.js");
+          const { isEncryptedCapsuleFile } = await import("./capsule-crypto-GWVG7LGC.js");
           const encDetected = await isEncryptedCapsuleFile(sourceArchive).catch(() => true);
           if (encDetected) {
             throw new Error(
@@ -3682,7 +3686,7 @@ function registerCli(api, orchestrator, registerOptions = {}) {
           const { parseExportBundle } = await import("./transfer/types.js");
           let decryptedBuf;
           try {
-            const { decryptCapsuleFileInMemory } = await import("./capsule-crypto-YO5QJ6L3.js");
+            const { decryptCapsuleFileInMemory } = await import("./capsule-crypto-GWVG7LGC.js");
             decryptedBuf = await decryptCapsuleFileInMemory(archivePath, memoryDir);
           } catch (decErr) {
             const msg = decErr instanceof Error ? decErr.message : String(decErr);
@@ -6337,6 +6341,65 @@ Semantic consolidation complete. clusters=${result.clustersFound}, consolidated=
           console.log(formatTranscript(entries));
         }
       });
+      const sessionsCmd = cmd.command("sessions").description("Inspect and migrate session transcript storage");
+      sessionsCmd.command("migrate-transcripts").description(
+        "Split conflated other/default transcripts into first-class session/<hash> dirs"
+      ).option("--dry-run", "Report the migration plan without moving files (default)").option("--apply", "Apply the migration (move files; default is dry-run)").action(async (...args) => {
+        const options = args[0] ?? {};
+        const dryRunFlag = options.dryRun === true;
+        const applyFlag = options.apply === true;
+        if (dryRunFlag && applyFlag) {
+          console.error("Cannot pass both --dry-run and --apply. Choose one.");
+          process.exit(1);
+        }
+        const apply = applyFlag;
+        const memoryDir = orchestrator.config.memoryDir;
+        if (!apply) {
+          const plan = await planSessionTranscriptMigration({ memoryDir });
+          console.log("=== Session Transcript Migration (DRY RUN) ===\n");
+          if (!dryRunFlag && !applyFlag) {
+            console.log("No flag given \u2014 defaulting to --dry-run. Pass --apply to migrate.\n");
+          }
+          console.log(`transcripts dir: ${plan.transcriptsDir}`);
+          console.log(`files to migrate: ${plan.files.length}`);
+          console.log(`distinct sessions: ${plan.distinctSessions}`);
+          console.log(`entries to move: ${plan.movedEntries}`);
+          if (plan.files.length > 0) {
+            console.log("\nPlanned splits:");
+            for (const file of plan.files) {
+              console.log(`- ${file.sourceRelPath}`);
+              for (const group of file.groups) {
+                console.log(
+                  `    ${group.entryCount} entr${group.entryCount === 1 ? "y" : "ies"} \u2192 ${group.destDir} (${group.legacy ? "legacy" : "session"})`
+                );
+              }
+              if (file.unmovableLines > 0) {
+                console.log(`    ${file.unmovableLines} unmovable line(s) retained in source`);
+              }
+            }
+          }
+          console.log("\nDRY RUN \u2014 no files changed.");
+          return;
+        }
+        const result = await migrateSessionTranscripts({ memoryDir, apply: true });
+        console.log("=== Session Transcript Migration (APPLY) ===\n");
+        console.log(`files rewritten: ${result.filesRewritten}`);
+        console.log(`files removed: ${result.filesRemoved}`);
+        console.log(`distinct sessions: ${result.plan.distinctSessions}`);
+        console.log(`entries moved: ${result.plan.movedEntries}`);
+        if (result.manifestPath) {
+          console.log(`manifest: ${result.manifestPath}`);
+        }
+        if (result.errors.length > 0) {
+          console.log("\nErrors:");
+          for (const err of result.errors) {
+            console.log(`- ${err}`);
+          }
+          process.exitCode = 1;
+          return;
+        }
+        console.log("\nOK");
+      });
       cmd.command("checkpoint").description("View current compaction checkpoint (if any)").action(async () => {
         const checkpoint = await orchestrator.transcript.loadCheckpoint();
         if (!checkpoint) {
@@ -7152,4 +7215,4 @@ export {
   resolveMemoryDirForNamespace,
   registerCli
 };
-//# sourceMappingURL=chunk-6YLJZ2EU.js.map
+//# sourceMappingURL=chunk-3D6L7CEP.js.map