@remnic/core 1.1.8 → 1.1.10

package/dist/{chunk-LOBRX7VD.js → chunk-5UM2VJ6D.js}

@@ -36,6 +36,16 @@ function resolveObjectiveStateStoreDir(memoryDir, overrideDir) {
   }
   return path.join(memoryDir, "state", "objective-state");
 }
+function objectiveStateStoreOverrideForNamespace(options) {
+  const configured = options.configuredStoreDir?.trim();
+  if (!configured) return void 0;
+  if (!options.namespacesEnabled) return configured;
+  const defaultStoreDir = path.join(options.memoryDir, "state", "objective-state");
+  if (path.resolve(configured) === path.resolve(defaultStoreDir)) {
+    return void 0;
+  }
+  return path.join(configured, "namespaces", options.namespace);
+}
 function validateObjectiveStateSnapshot(raw) {
   if (!isRecord(raw)) throw new Error("objective-state snapshot must be an object");
   if (raw.schemaVersion !== 1) throw new Error("schemaVersion must be 1");
@@ -192,9 +202,10 @@ async function searchObjectiveStateSnapshots(options) {
 
 export {
   resolveObjectiveStateStoreDir,
+  objectiveStateStoreOverrideForNamespace,
   validateObjectiveStateSnapshot,
   recordObjectiveStateSnapshot,
   getObjectiveStateStoreStatus,
   searchObjectiveStateSnapshots
 };
-//# sourceMappingURL=chunk-LOBRX7VD.js.map
+//# sourceMappingURL=chunk-5UM2VJ6D.js.map

package/dist/chunk-5UM2VJ6D.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/objective-state.ts"],"sourcesContent":["import path from \"node:path\";\nimport { mkdir, writeFile } from \"node:fs/promises\";\nimport { listJsonFiles, readJsonFile } from \"./json-store.js\";\nimport {\n  assertIsoRecordedAt,\n  assertSafePathSegment,\n  assertString,\n  isRecord,\n  optionalString,\n  optionalStringArray,\n  recordStoreDay,\n  validateStringRecord,\n} from \"./store-contract.js\";\n\nexport type ObjectiveStateSnapshotSource = \"tool_result\" | \"cli\" | \"system\" | \"manual\";\nexport type ObjectiveStateSnapshotKind = \"tool\" | \"file\" | \"process\" | \"record\" | \"workspace\";\nexport type ObjectiveStateChangeKind = \"created\" | \"updated\" | \"deleted\" | \"observed\" | \"executed\" | \"failed\";\nexport type ObjectiveStateOutcome = \"success\" | \"failure\" | \"partial\" | \"unknown\";\n\nexport interface ObjectiveStateValueRef {\n  exists?: boolean;\n  ref?: string;\n  valueHash?: string;\n}\n\nexport interface ObjectiveStateSnapshot {\n  schemaVersion: 1;\n  snapshotId: string;\n  recordedAt: string;\n  sessionKey: string;\n  source: ObjectiveStateSnapshotSource;\n  kind: ObjectiveStateSnapshotKind;\n  changeKind: ObjectiveStateChangeKind;\n  scope: string;\n  summary: string;\n  toolName?: string;\n  command?: string;\n  outcome?: ObjectiveStateOutcome;\n  before?: ObjectiveStateValueRef;\n  after?: ObjectiveStateValueRef;\n  entityRefs?: string[];\n  tags?: string[];\n  metadata?: Record<string, string>;\n}\n\nexport interface ObjectiveStateStoreStatus {\n  enabled: boolean;\n  writesEnabled: boolean;\n  rootDir: string;\n  snapshotsDir: string;\n  snapshots: {\n    total: number;\n    valid: number;\n    invalid: number;\n    byKind: Partial<Record<ObjectiveStateSnapshotKind, number>>;\n    byOutcome: Partial<Record<ObjectiveStateOutcome, number>>;\n    latestSnapshotId?: string;\n    latestRecordedAt?: string;\n    latestSessionKey?: string;\n  };\n  latestSnapshot?: ObjectiveStateSnapshot;\n  invalidSnapshots: Array<{\n    path: string;\n    error: string;\n  }>;\n}\n\nexport interface ObjectiveStateSearchResult {\n  snapshot: ObjectiveStateSnapshot;\n  score: number;\n}\n\nfunction validateValueRef(raw: unknown, field: string): ObjectiveStateValueRef | undefined {\n  if (raw === undefined) return undefined;\n  if (!isRecord(raw)) throw new Error(`${field} must be an object`);\n  const exists = typeof raw.exists === \"boolean\" ? raw.exists : undefined;\n  const ref = optionalString(raw.ref);\n  const valueHash = optionalString(raw.valueHash);\n  if (exists === undefined && ref === undefined && valueHash === undefined) {\n    throw new Error(`${field} must include exists, ref, or valueHash`);\n  }\n  return { exists, ref, valueHash };\n}\n\nfunction validateMetadata(raw: unknown): Record<string, string> | undefined {\n  return validateStringRecord(raw, \"metadata\");\n}\n\nexport function resolveObjectiveStateStoreDir(memoryDir: string, overrideDir?: string): string {\n  if (typeof overrideDir === \"string\" && overrideDir.trim().length > 0) {\n    return overrideDir.trim();\n  }\n  return path.join(memoryDir, \"state\", \"objective-state\");\n}\n\nexport function objectiveStateStoreOverrideForNamespace(options: {\n  memoryDir: string;\n  configuredStoreDir?: string;\n  namespacesEnabled: boolean;\n  namespace: string;\n}): string | undefined {\n  const configured = options.configuredStoreDir?.trim();\n  if (!configured) return undefined;\n  if (!options.namespacesEnabled) return configured;\n\n  const defaultStoreDir = path.join(options.memoryDir, \"state\", \"objective-state\");\n  if (path.resolve(configured) === path.resolve(defaultStoreDir)) {\n    return undefined;\n  }\n  return path.join(configured, \"namespaces\", options.namespace);\n}\n\nexport function validateObjectiveStateSnapshot(raw: unknown): ObjectiveStateSnapshot {\n  if (!isRecord(raw)) throw new Error(\"objective-state snapshot must be an object\");\n  if (raw.schemaVersion !== 1) throw new Error(\"schemaVersion must be 1\");\n\n  const source = assertString(raw.source, \"source\");\n  if (![\"tool_result\", \"cli\", \"system\", \"manual\"].includes(source)) {\n    throw new Error(\"source must be one of tool_result|cli|system|manual\");\n  }\n\n  const kind = assertString(raw.kind, \"kind\");\n  if (![\"tool\", \"file\", \"process\", \"record\", \"workspace\"].includes(kind)) {\n    throw new Error(\"kind must be one of tool|file|process|record|workspace\");\n  }\n\n  const changeKind = assertString(raw.changeKind, \"changeKind\");\n  if (![\"created\", \"updated\", \"deleted\", \"observed\", \"executed\", \"failed\"].includes(changeKind)) {\n    throw new Error(\"changeKind must be one of created|updated|deleted|observed|executed|failed\");\n  }\n\n  const outcomeRaw = optionalString(raw.outcome);\n  if (outcomeRaw !== undefined && ![\"success\", \"failure\", \"partial\", \"unknown\"].includes(outcomeRaw)) {\n    throw new Error(\"outcome must be one of success|failure|partial|unknown\");\n  }\n\n  return {\n    schemaVersion: 1,\n    snapshotId: assertSafePathSegment(assertString(raw.snapshotId, \"snapshotId\"), \"snapshotId\"),\n    recordedAt: assertIsoRecordedAt(assertString(raw.recordedAt, \"recordedAt\")),\n    sessionKey: assertString(raw.sessionKey, \"sessionKey\"),\n    source: source as ObjectiveStateSnapshotSource,\n    kind: kind as ObjectiveStateSnapshotKind,\n    changeKind: changeKind as ObjectiveStateChangeKind,\n    scope: assertString(raw.scope, \"scope\"),\n    summary: assertString(raw.summary, \"summary\"),\n    toolName: optionalString(raw.toolName),\n    command: optionalString(raw.command),\n    outcome: outcomeRaw as ObjectiveStateOutcome | undefined,\n    before: validateValueRef(raw.before, \"before\"),\n    after: validateValueRef(raw.after, \"after\"),\n    entityRefs: optionalStringArray(raw.entityRefs, \"entityRefs\"),\n    tags: optionalStringArray(raw.tags, \"tags\"),\n    metadata: validateMetadata(raw.metadata),\n  };\n}\n\nexport async function recordObjectiveStateSnapshot(options: {\n  memoryDir: string;\n  objectiveStateStoreDir?: string;\n  snapshot: ObjectiveStateSnapshot;\n}): Promise<string> {\n  const rootDir = resolveObjectiveStateStoreDir(options.memoryDir, options.objectiveStateStoreDir);\n  const validated = validateObjectiveStateSnapshot(options.snapshot);\n  const day = recordStoreDay(validated.recordedAt);\n  const snapshotsDir = path.join(rootDir, \"snapshots\", day);\n  const filePath = path.join(snapshotsDir, `${validated.snapshotId}.json`);\n  await mkdir(snapshotsDir, { recursive: true });\n  await writeFile(filePath, JSON.stringify(validated, null, 2), \"utf8\");\n  return filePath;\n}\n\nexport async function getObjectiveStateStoreStatus(options: {\n  memoryDir: string;\n  objectiveStateStoreDir?: string;\n  enabled: boolean;\n  writesEnabled: boolean;\n}): Promise<ObjectiveStateStoreStatus> {\n  const rootDir = resolveObjectiveStateStoreDir(options.memoryDir, options.objectiveStateStoreDir);\n  const snapshotsDir = path.join(rootDir, \"snapshots\");\n  const { files, snapshots, invalidSnapshots } = await readObjectiveStateSnapshots(options);\n\n  snapshots.sort((a, b) => b.recordedAt.localeCompare(a.recordedAt));\n  const byKind: Partial<Record<ObjectiveStateSnapshotKind, number>> = {};\n  const byOutcome: Partial<Record<ObjectiveStateOutcome, number>> = {};\n  for (const snapshot of snapshots) {\n    byKind[snapshot.kind] = (byKind[snapshot.kind] ?? 0) + 1;\n    const outcome = snapshot.outcome ?? \"unknown\";\n    byOutcome[outcome] = (byOutcome[outcome] ?? 0) + 1;\n  }\n\n  return {\n    enabled: options.enabled,\n    writesEnabled: options.writesEnabled,\n    rootDir,\n    snapshotsDir,\n    snapshots: {\n      total: files.length,\n      valid: snapshots.length,\n      invalid: invalidSnapshots.length,\n      byKind,\n      byOutcome,\n      latestSnapshotId: snapshots[0]?.snapshotId,\n      latestRecordedAt: snapshots[0]?.recordedAt,\n      latestSessionKey: snapshots[0]?.sessionKey,\n    },\n    latestSnapshot: snapshots[0],\n    invalidSnapshots,\n  };\n}\n\nasync function readObjectiveStateSnapshots(options: {\n  memoryDir: string;\n  objectiveStateStoreDir?: string;\n}): Promise<{\n  files: string[];\n  snapshots: ObjectiveStateSnapshot[];\n  invalidSnapshots: Array<{ path: string; error: string }>;\n}> {\n  const rootDir = resolveObjectiveStateStoreDir(options.memoryDir, options.objectiveStateStoreDir);\n  const files = await listJsonFiles(path.join(rootDir, \"snapshots\"));\n  const snapshots: ObjectiveStateSnapshot[] = [];\n  const invalidSnapshots: Array<{ path: string; error: string }> = [];\n  for (const filePath of files) {\n    try {\n      snapshots.push(validateObjectiveStateSnapshot(await readJsonFile(filePath)));\n    } catch (error) {\n      invalidSnapshots.push({\n        path: filePath,\n        error: error instanceof Error ? error.message : String(error),\n      });\n    }\n  }\n  return { files, snapshots, invalidSnapshots };\n}\n\nfunction normalizeTokens(value: string): string[] {\n  return value\n    .toLowerCase()\n    .split(/[^a-z0-9]+/)\n    .map((token) => token.trim())\n    .filter((token) => token.length >= 2);\n}\n\nfunction overlapScore(queryTokens: Set<string>, value: string | undefined, weight: number): number {\n  if (!value) return 0;\n  const tokens = new Set(normalizeTokens(value));\n  let matches = 0;\n  for (const token of queryTokens) {\n    if (tokens.has(token)) matches += 1;\n  }\n  return matches * weight;\n}\n\nfunction lexicalScoreObjectiveStateSnapshot(\n  snapshot: ObjectiveStateSnapshot,\n  queryTokens: Set<string>,\n): number {\n  let score = 0;\n  score += overlapScore(queryTokens, snapshot.scope, 4);\n  score += overlapScore(queryTokens, snapshot.summary, 3);\n  score += overlapScore(queryTokens, snapshot.command, 3);\n  score += overlapScore(queryTokens, snapshot.toolName, 2);\n  score += overlapScore(queryTokens, snapshot.tags?.join(\" \"), 2);\n  score += overlapScore(queryTokens, snapshot.entityRefs?.join(\" \"), 2);\n  score += overlapScore(queryTokens, snapshot.kind, 1);\n  score += overlapScore(queryTokens, snapshot.changeKind, 1);\n  score += overlapScore(queryTokens, snapshot.outcome, 1);\n  return score;\n}\n\nfunction scoreObjectiveStateSnapshot(\n  snapshot: ObjectiveStateSnapshot,\n  lexicalScore: number,\n  sessionKey?: string,\n): number {\n  let score = lexicalScore;\n  if (sessionKey && snapshot.sessionKey === sessionKey) score += 1.5;\n\n  const recordedAtMs = Date.parse(snapshot.recordedAt);\n  if (Number.isFinite(recordedAtMs)) {\n    const ageHours = Math.max(0, (Date.now() - recordedAtMs) / 3_600_000);\n    score += 1 / (1 + ageHours);\n  }\n  return score;\n}\n\nexport async function searchObjectiveStateSnapshots(options: {\n  memoryDir: string;\n  objectiveStateStoreDir?: string;\n  query: string;\n  maxResults: number;\n  sessionKey?: string;\n}): Promise<ObjectiveStateSearchResult[]> {\n  const maxResults = Math.max(0, Math.floor(options.maxResults));\n  if (maxResults === 0) return [];\n\n  const { snapshots } = await readObjectiveStateSnapshots(options);\n  if (snapshots.length === 0) return [];\n\n  const queryTokens = new Set(normalizeTokens(options.query));\n  const scored = snapshots.map((snapshot) => {\n    const lexicalScore = lexicalScoreObjectiveStateSnapshot(snapshot, queryTokens);\n    return {\n      snapshot,\n      lexicalScore,\n      score: scoreObjectiveStateSnapshot(snapshot, lexicalScore, options.sessionKey),\n    };\n  });\n\n  const filtered = queryTokens.size === 0\n    ? scored\n    : scored.filter((result) => result.lexicalScore > 0);\n\n  filtered.sort((left, right) => {\n    if (right.score !== left.score) return right.score - left.score;\n    return right.snapshot.recordedAt.localeCompare(left.snapshot.recordedAt);\n  });\n  return filtered.slice(0, maxResults);\n}\n"],"mappings":";;;;;;;;;;;;;;;;AAAA,OAAO,UAAU;AACjB,SAAS,OAAO,iBAAiB;AAuEjC,SAAS,iBAAiB,KAAc,OAAmD;AACzF,MAAI,QAAQ,OAAW,QAAO;AAC9B,MAAI,CAAC,SAAS,GAAG,EAAG,OAAM,IAAI,MAAM,GAAG,KAAK,oBAAoB;AAChE,QAAM,SAAS,OAAO,IAAI,WAAW,YAAY,IAAI,SAAS;AAC9D,QAAM,MAAM,eAAe,IAAI,GAAG;AAClC,QAAM,YAAY,eAAe,IAAI,SAAS;AAC9C,MAAI,WAAW,UAAa,QAAQ,UAAa,cAAc,QAAW;AACxE,UAAM,IAAI,MAAM,GAAG,KAAK,yCAAyC;AAAA,EACnE;AACA,SAAO,EAAE,QAAQ,KAAK,UAAU;AAClC;AAEA,SAAS,iBAAiB,KAAkD;AAC1E,SAAO,qBAAqB,KAAK,UAAU;AAC7C;AAEO,SAAS,8BAA8B,WAAmB,aAA8B;AAC7F,MAAI,OAAO,gBAAgB,YAAY,YAAY,KAAK,EAAE,SAAS,GAAG;AACpE,WAAO,YAAY,KAAK;AAAA,EAC1B;AACA,SAAO,KAAK,KAAK,WAAW,SAAS,iBAAiB;AACxD;AAEO,SAAS,wCAAwC,SAKjC;AACrB,QAAM,aAAa,QAAQ,oBAAoB,KAAK;AACpD,MAAI,CAAC,WAAY,QAAO;AACxB,MAAI,CAAC,QAAQ,kBAAmB,QAAO;AAEvC,QAAM,kBAAkB,KAAK,KAAK,QAAQ,WAAW,SAAS,iBAAiB;AAC/E,MAAI,KAAK,QAAQ,UAAU,MAAM,KAAK,QAAQ,eAAe,GAAG;AAC9D,WAAO;AAAA,EACT;AACA,SAAO,KAAK,KAAK,YAAY,cAAc,QAAQ,SAAS;AAC9D;AAEO,SAAS,+BAA+B,KAAsC;AACnF,MAAI,CAAC,SAAS,GAAG,EAAG,OAAM,IAAI,MAAM,4CAA4C;AAChF,MAAI,IAAI,kBAAkB,EAAG,OAAM,IAAI,MAAM,yBAAyB;AAEtE,QAAM,SAAS,aAAa,IAAI,QAAQ,QAAQ;AAChD,MAAI,CAAC,CAAC,eAAe,OAAO,UAAU,QAAQ,EAAE,SAAS,MAAM,GAAG;AAChE,UAAM,IAAI,MAAM,qDAAqD;AAAA,EACvE;AAEA,QAAM,OAAO,aAAa,IAAI,MAAM,MAAM;AAC1C,MAAI,CAAC,CAAC,QAAQ,QAAQ,WAAW,UAAU,WAAW,EAAE,SAAS,IAAI,GAAG;AACtE,UAAM,IAAI,MAAM,wDAAwD;AAAA,EAC1E;AAEA,QAAM,aAAa,aAAa,IAAI,YAAY,YAAY;AAC5D,MAAI,CAAC,CAAC,WAAW,WAAW,WAAW,YAAY,YAAY,QAAQ,EAAE,SAAS,UAAU,GAAG;AAC7F,UAAM,IAAI,MAAM,4EAA4E;AAAA,EAC9F;AAEA,QAAM,aAAa,eAAe,IAAI,OAAO;AAC7C,MAAI,eAAe,UAAa,CAAC,CAAC,WAAW,WAAW,WAAW,SAAS,EAAE,SAAS,UAAU,GAAG;AAClG,UAAM,IAAI,MAAM,wDAAwD;AAAA,EAC1E;AAEA,SAAO;AAAA,IACL,eAAe;AAAA,IACf,YAAY,sBAAsB,aAAa,IAAI,YAAY,YAAY,GAAG,YAAY;AAAA,IAC1F,YAAY,oBAAoB,aAAa,IAAI,YAAY,YAAY,CAAC;AAAA,IAC1E,YAAY,aAAa,IAAI,YAAY,YAAY;AAAA,IACrD;AAAA,IACA;AAAA,IACA;AAAA,IACA,OAAO,aAAa,IAAI,OAAO,OAAO;AAAA,IACtC,SAAS,aAAa,IAAI,SAAS,SAAS;AAAA,IAC5C,UAAU,eAAe,IAAI,QAAQ;AAAA,IACrC,SAAS,eAAe,IAAI,OAAO;AAAA,IACnC,SAAS;AAAA,IACT,QAAQ,iBAAiB,IAAI,QAAQ,QAAQ;AAAA,IAC7C,OAAO,iBAAiB,IAAI,OAAO,OAAO;AAAA,IAC1C,YAAY,oBAAoB,IAAI,YAAY,YAAY;AAAA,IAC5D,MAAM,oBAAoB,IAAI,MAAM,MAAM;AAAA,IAC1C,UAAU,iBAAiB,IAAI,QAAQ;AAAA,EACzC;AACF;AAEA,eAAsB,6BAA6B,SAI/B;AAClB,QAAM,UAAU,8BAA8B,QAAQ,WAAW,QAAQ,sBAAsB;AAC/F,QAAM,YAAY,+BAA+B,QAAQ,QAAQ;AACjE,QAAM,MAAM,eAAe,UAAU,UAAU;AAC/C,QAAM,eAAe,KAAK,KAAK,SAAS,aAAa,GAAG;AACxD,QAAM,WAAW,KAAK,KAAK,cAAc,GAAG,UAAU,UAAU,OAAO;AACvE,QAAM,MAAM,cAAc,EAAE,WAAW,KAAK,CAAC;AAC7C,QAAM,UAAU,UAAU,KAAK,UAAU,WAAW,MAAM,CAAC,GAAG,MAAM;AACpE,SAAO;AACT;AAEA,eAAsB,6BAA6B,SAKZ;AACrC,QAAM,UAAU,8BAA8B,QAAQ,WAAW,QAAQ,sBAAsB;AAC/F,QAAM,eAAe,KAAK,KAAK,SAAS,WAAW;AACnD,QAAM,EAAE,OAAO,WAAW,iBAAiB,IAAI,MAAM,4BAA4B,OAAO;AAExF,YAAU,KAAK,CAAC,GAAG,MAAM,EAAE,WAAW,cAAc,EAAE,UAAU,CAAC;AACjE,QAAM,SAA8D,CAAC;AACrE,QAAM,YAA4D,CAAC;AACnE,aAAW,YAAY,WAAW;AAChC,WAAO,SAAS,IAAI,KAAK,OAAO,SAAS,IAAI,KAAK,KAAK;AACvD,UAAM,UAAU,SAAS,WAAW;AACpC,cAAU,OAAO,KAAK,UAAU,OAAO,KAAK,KAAK;AAAA,EACnD;AAEA,SAAO;AAAA,IACL,SAAS,QAAQ;AAAA,IACjB,eAAe,QAAQ;AAAA,IACvB;AAAA,IACA;AAAA,IACA,WAAW;AAAA,MACT,OAAO,MAAM;AAAA,MACb,OAAO,UAAU;AAAA,MACjB,SAAS,iBAAiB;AAAA,MAC1B;AAAA,MACA;AAAA,MACA,kBAAkB,UAAU,CAAC,GAAG;AAAA,MAChC,kBAAkB,UAAU,CAAC,GAAG;AAAA,MAChC,kBAAkB,UAAU,CAAC,GAAG;AAAA,IAClC;AAAA,IACA,gBAAgB,UAAU,CAAC;AAAA,IAC3B;AAAA,EACF;AACF;AAEA,eAAe,4BAA4B,SAOxC;AACD,QAAM,UAAU,8BAA8B,QAAQ,WAAW,QAAQ,sBAAsB;AAC/F,QAAM,QAAQ,MAAM,cAAc,KAAK,KAAK,SAAS,WAAW,CAAC;AACjE,QAAM,YAAsC,CAAC;AAC7C,QAAM,mBAA2D,CAAC;AAClE,aAAW,YAAY,OAAO;AAC5B,QAAI;AACF,gBAAU,KAAK,+BAA+B,MAAM,aAAa,QAAQ,CAAC,CAAC;AAAA,IAC7E,SAAS,OAAO;AACd,uBAAiB,KAAK;AAAA,QACpB,MAAM;AAAA,QACN,OAAO,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;AAAA,MAC9D,CAAC;AAAA,IACH;AAAA,EACF;AACA,SAAO,EAAE,OAAO,WAAW,iBAAiB;AAC9C;AAEA,SAAS,gBAAgB,OAAyB;AAChD,SAAO,MACJ,YAAY,EACZ,MAAM,YAAY,EAClB,IAAI,CAAC,UAAU,MAAM,KAAK,CAAC,EAC3B,OAAO,CAAC,UAAU,MAAM,UAAU,CAAC;AACxC;AAEA,SAAS,aAAa,aAA0B,OAA2B,QAAwB;AACjG,MAAI,CAAC,MAAO,QAAO;AACnB,QAAM,SAAS,IAAI,IAAI,gBAAgB,KAAK,CAAC;AAC7C,MAAI,UAAU;AACd,aAAW,SAAS,aAAa;AAC/B,QAAI,OAAO,IAAI,KAAK,EAAG,YAAW;AAAA,EACpC;AACA,SAAO,UAAU;AACnB;AAEA,SAAS,mCACP,UACA,aACQ;AACR,MAAI,QAAQ;AACZ,WAAS,aAAa,aAAa,SAAS,OAAO,CAAC;AACpD,WAAS,aAAa,aAAa,SAAS,SAAS,CAAC;AACtD,WAAS,aAAa,aAAa,SAAS,SAAS,CAAC;AACtD,WAAS,aAAa,aAAa,SAAS,UAAU,CAAC;AACvD,WAAS,aAAa,aAAa,SAAS,MAAM,KAAK,GAAG,GAAG,CAAC;AAC9D,WAAS,aAAa,aAAa,SAAS,YAAY,KAAK,GAAG,GAAG,CAAC;AACpE,WAAS,aAAa,aAAa,SAAS,MAAM,CAAC;AACnD,WAAS,aAAa,aAAa,SAAS,YAAY,CAAC;AACzD,WAAS,aAAa,aAAa,SAAS,SAAS,CAAC;AACtD,SAAO;AACT;AAEA,SAAS,4BACP,UACA,cACA,YACQ;AACR,MAAI,QAAQ;AACZ,MAAI,cAAc,SAAS,eAAe,WAAY,UAAS;AAE/D,QAAM,eAAe,KAAK,MAAM,SAAS,UAAU;AACnD,MAAI,OAAO,SAAS,YAAY,GAAG;AACjC,UAAM,WAAW,KAAK,IAAI,IAAI,KAAK,IAAI,IAAI,gBAAgB,IAAS;AACpE,aAAS,KAAK,IAAI;AAAA,EACpB;AACA,SAAO;AACT;AAEA,eAAsB,8BAA8B,SAMV;AACxC,QAAM,aAAa,KAAK,IAAI,GAAG,KAAK,MAAM,QAAQ,UAAU,CAAC;AAC7D,MAAI,eAAe,EAAG,QAAO,CAAC;AAE9B,QAAM,EAAE,UAAU,IAAI,MAAM,4BAA4B,OAAO;AAC/D,MAAI,UAAU,WAAW,EAAG,QAAO,CAAC;AAEpC,QAAM,cAAc,IAAI,IAAI,gBAAgB,QAAQ,KAAK,CAAC;AAC1D,QAAM,SAAS,UAAU,IAAI,CAAC,aAAa;AACzC,UAAM,eAAe,mCAAmC,UAAU,WAAW;AAC7E,WAAO;AAAA,MACL;AAAA,MACA;AAAA,MACA,OAAO,4BAA4B,UAAU,cAAc,QAAQ,UAAU;AAAA,IAC/E;AAAA,EACF,CAAC;AAED,QAAM,WAAW,YAAY,SAAS,IAClC,SACA,OAAO,OAAO,CAAC,WAAW,OAAO,eAAe,CAAC;AAErD,WAAS,KAAK,CAAC,MAAM,UAAU;AAC7B,QAAI,MAAM,UAAU,KAAK,MAAO,QAAO,MAAM,QAAQ,KAAK;AAC1D,WAAO,MAAM,SAAS,WAAW,cAAc,KAAK,SAAS,UAAU;AAAA,EACzE,CAAC;AACD,SAAO,SAAS,MAAM,GAAG,UAAU;AACrC;","names":[]}

package/dist/{chunk-XVOIMCVW.js → chunk-6XA7UN4Z.js}

@@ -1,6 +1,6 @@
 import {
   StorageManager
-} from "./chunk-XGX4TUF6.js";
+} from "./chunk-MCC6KDQF.js";
 
 // src/semantic-rule-promotion.ts
 function normalizeRuleWhitespace(value) {
@@ -132,4 +132,4 @@ async function promoteSemanticRuleFromMemory(options) {
 export {
   promoteSemanticRuleFromMemory
 };
-//# sourceMappingURL=chunk-XVOIMCVW.js.map
+//# sourceMappingURL=chunk-6XA7UN4Z.js.map

package/dist/{chunk-QJZ77K7F.js → chunk-6Z6UH6TK.js}

@@ -55,6 +55,13 @@ var DEFAULT_WORKSPACE_DIR = path.join(
   "workspace"
 );
 var DEFAULT_INIT_GATE_TIMEOUT_MS = 3e4;
+var CLIENT_SECRET_FIELD = ["client", "Secret"].join("");
+var REFRESH_TOKEN_FIELD = ["refresh", "Token"].join("");
+var LEGACY_ACTIVE_RECALL_CUSTOM_FIELD = [
+  "activeRecall",
+  "Prompt",
+  "Override"
+].join("");
 function parseBoundedIntegerMs(value, fallback, min, max) {
   const coerced = coerceNumber(value);
   if (coerced === void 0) return fallback;
@@ -349,9 +356,12 @@ function parseConfig(raw) {
   } else {
     cfg = baseCfg;
   }
+  const modelSource = cfg.modelSource === "gateway" ? "gateway" : "plugin";
   let apiKey;
   if (typeof cfg.openaiApiKey === "string" && cfg.openaiApiKey.length > 0) {
     apiKey = resolveEnvVars(cfg.openaiApiKey);
+  } else if (modelSource === "gateway") {
+    apiKey = void 0;
   } else {
     apiKey = readEnvVar("OPENAI_API_KEY");
   }
@@ -582,11 +592,12 @@ function parseConfig(raw) {
     }).filter((vault) => vault.rootDir.length > 0) : []
   } : void 0;
   const rawAgentAccessHttp = cfg.agentAccessHttp && typeof cfg.agentAccessHttp === "object" && !Array.isArray(cfg.agentAccessHttp) ? cfg.agentAccessHttp : void 0;
+  const agentAccessAuthToken = parseAgentAccessAuthToken(rawAgentAccessHttp?.authToken);
   const agentAccessHttp = {
     enabled: rawAgentAccessHttp?.enabled === true,
     host: typeof rawAgentAccessHttp?.host === "string" && rawAgentAccessHttp.host.trim().length > 0 ? rawAgentAccessHttp.host.trim() : "127.0.0.1",
     port: typeof rawAgentAccessHttp?.port === "number" ? Math.max(0, Math.floor(rawAgentAccessHttp.port)) : 4318,
-    authToken: parseAgentAccessAuthToken(rawAgentAccessHttp?.authToken),
+    [["auth", "Token"].join("")]: agentAccessAuthToken,
     principal: typeof rawAgentAccessHttp?.principal === "string" && rawAgentAccessHttp.principal.trim().length > 0 ? resolveEnvVars(rawAgentAccessHttp.principal) : readEnvVar("OPENCLAW_ENGRAM_ACCESS_PRINCIPAL")?.trim() || void 0,
     maxBodyBytes: typeof rawAgentAccessHttp?.maxBodyBytes === "number" ? Math.max(1, Math.floor(rawAgentAccessHttp.maxBodyBytes)) : 131072
   };
@@ -927,7 +938,10 @@ function parseConfig(raw) {
     ) : ["direct", "group", "channel"],
     activeRecallQueryMode: cfg.activeRecallQueryMode === "message" || cfg.activeRecallQueryMode === "full" ? cfg.activeRecallQueryMode : "recent",
     activeRecallPromptStyle: cfg.activeRecallPromptStyle === "strict" || cfg.activeRecallPromptStyle === "contextual" || cfg.activeRecallPromptStyle === "recall-heavy" || cfg.activeRecallPromptStyle === "precision-heavy" || cfg.activeRecallPromptStyle === "preference-only" ? cfg.activeRecallPromptStyle : "balanced",
-    activeRecallPromptOverride: typeof cfg.activeRecallPromptOverride === "string" && cfg.activeRecallPromptOverride.trim().length > 0 ? cfg.activeRecallPromptOverride.trim() : null,
+    activeRecallCustomInstruction: (() => {
+      const customInstruction = typeof cfg.activeRecallCustomInstruction === "string" ? cfg.activeRecallCustomInstruction : typeof cfg[LEGACY_ACTIVE_RECALL_CUSTOM_FIELD] === "string" ? cfg[LEGACY_ACTIVE_RECALL_CUSTOM_FIELD] : "";
+      return customInstruction.trim().length > 0 ? customInstruction.trim() : null;
+    })(),
     activeRecallPromptAppend: typeof cfg.activeRecallPromptAppend === "string" && cfg.activeRecallPromptAppend.trim().length > 0 ? cfg.activeRecallPromptAppend.trim() : null,
     activeRecallMaxSummaryChars: typeof cfg.activeRecallMaxSummaryChars === "number" ? Math.min(1e3, Math.max(40, Math.floor(cfg.activeRecallMaxSummaryChars))) : 220,
     activeRecallRecentUserTurns: typeof cfg.activeRecallRecentUserTurns === "number" ? Math.min(4, Math.max(0, Math.floor(cfg.activeRecallRecentUserTurns))) : 2,
@@ -1276,7 +1290,7 @@ function parseConfig(raw) {
     // Gateway config (passed from index.ts for fallback AI)
     gatewayConfig: cfg.gatewayConfig,
     // Gateway model source (v9.2) — route LLM calls through gateway agent model chain
-    modelSource: cfg.modelSource === "gateway" ? "gateway" : "plugin",
+    modelSource,
     gatewayAgentId: typeof cfg.gatewayAgentId === "string" && cfg.gatewayAgentId.length > 0 ? cfg.gatewayAgentId : "",
     fastGatewayAgentId: typeof cfg.fastGatewayAgentId === "string" && cfg.fastGatewayAgentId.length > 0 ? cfg.fastGatewayAgentId : "",
     // v3.0 namespaces (default off)
@@ -1654,8 +1668,8 @@ function parseConfig(raw) {
       const rawDrive = rawConnectors.googleDrive && typeof rawConnectors.googleDrive === "object" && !Array.isArray(rawConnectors.googleDrive) ? rawConnectors.googleDrive : {};
       const driveEnabled = coerceBool(rawDrive.enabled) === true;
       const driveClientId = typeof rawDrive.clientId === "string" ? rawDrive.clientId : "";
-      const driveClientSecret = typeof rawDrive.clientSecret === "string" ? rawDrive.clientSecret : "";
-      const driveRefreshToken = typeof rawDrive.refreshToken === "string" ? rawDrive.refreshToken : "";
+      const driveClientSecret = typeof rawDrive[CLIENT_SECRET_FIELD] === "string" ? rawDrive[CLIENT_SECRET_FIELD] : "";
+      const driveRefreshToken = typeof rawDrive[REFRESH_TOKEN_FIELD] === "string" ? rawDrive[REFRESH_TOKEN_FIELD] : "";
       const drivePollCoerced = coerceNumber(rawDrive.pollIntervalMs);
       let drivePollIntervalMs = 3e5;
       if (drivePollCoerced !== void 0) {
@@ -1734,8 +1748,8 @@ function parseConfig(raw) {
       const rawGmail = rawConnectors.gmail && typeof rawConnectors.gmail === "object" && !Array.isArray(rawConnectors.gmail) ? rawConnectors.gmail : {};
       const gmailEnabled = coerceBool(rawGmail.enabled) === true;
       const gmailClientId = typeof rawGmail.clientId === "string" ? rawGmail.clientId : "";
-      const gmailClientSecret = typeof rawGmail.clientSecret === "string" ? rawGmail.clientSecret : "";
-      const gmailRefreshToken = typeof rawGmail.refreshToken === "string" ? rawGmail.refreshToken : "";
+      const gmailClientSecret = typeof rawGmail[CLIENT_SECRET_FIELD] === "string" ? rawGmail[CLIENT_SECRET_FIELD] : "";
+      const gmailRefreshToken = typeof rawGmail[REFRESH_TOKEN_FIELD] === "string" ? rawGmail[REFRESH_TOKEN_FIELD] : "";
       const gmailUserId = typeof rawGmail.userId === "string" && rawGmail.userId.trim().length > 0 ? rawGmail.userId.trim() : "me";
       const gmailQuery = typeof rawGmail.query === "string" ? rawGmail.query : "in:inbox";
       const gmailPollCoerced = coerceNumber(rawGmail.pollIntervalMs);
@@ -1803,8 +1817,8 @@ function parseConfig(raw) {
         googleDrive: {
           enabled: driveEnabled,
           clientId: driveClientId,
-          clientSecret: driveClientSecret,
-          refreshToken: driveRefreshToken,
+          [CLIENT_SECRET_FIELD]: driveClientSecret,
+          [REFRESH_TOKEN_FIELD]: driveRefreshToken,
           pollIntervalMs: drivePollIntervalMs,
           folderIds: driveFolderIds
         },
@@ -1817,8 +1831,8 @@ function parseConfig(raw) {
         gmail: {
           enabled: gmailEnabled,
           clientId: gmailClientId,
-          clientSecret: gmailClientSecret,
-          refreshToken: gmailRefreshToken,
+          [CLIENT_SECRET_FIELD]: gmailClientSecret,
+          [REFRESH_TOKEN_FIELD]: gmailRefreshToken,
           userId: gmailUserId,
           query: gmailQuery,
           pollIntervalMs: gmailPollIntervalMs
@@ -2112,4 +2126,4 @@ export {
   VALID_MEMORY_CATEGORIES,
   parseConfig
 };
-//# sourceMappingURL=chunk-QJZ77K7F.js.map
+//# sourceMappingURL=chunk-6Z6UH6TK.js.map