@remnic/core 1.0.0

package/dist/chunk-KT4NEUNF.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/fallback-llm.ts"],"sourcesContent":["import { log } from \"./logger.js\";\nimport type { GatewayConfig, ModelProviderConfig, AgentPersona } from \"./types.js\";\nimport { extractJsonCandidates } from \"./json-extract.js\";\nimport {\n  buildChatCompletionTokenLimit,\n  shouldAssumeOpenAiChatCompletions,\n} from \"./openai-chat-compat.js\";\nimport { resolveProviderApiKey } from \"./resolve-provider-secret.js\";\n\nexport interface FallbackLlmOptions {\n  temperature?: number;\n  maxTokens?: number;\n  timeoutMs?: number;\n  /** Override which agent persona's model chain to use (by ID from agents.list[]). */\n  agentId?: string;\n}\n\nexport interface FallbackLlmResponse {\n  content: string;\n  modelUsed: string;\n  usage?: {\n    inputTokens?: number;\n    outputTokens?: number;\n    totalTokens?: number;\n  };\n}\n\ninterface ModelRef {\n  providerId: string;\n  modelId: string;\n  providerConfig: ModelProviderConfig;\n  modelString: string;\n}\n\n/**\n * Generic fallback LLM client that uses the gateway's default AI configuration\n * and walks through the full fallback chain (primary + fallbacks).\n * Supports OpenAI and Anthropic API formats.\n */\nexport class FallbackLlmClient {\n  private gatewayConfig: GatewayConfig | undefined;\n\n  constructor(gatewayConfig?: GatewayConfig) {\n    this.gatewayConfig = gatewayConfig;\n  }\n\n  /**\n   * Check if fallback is available (gateway config has at least one model).\n   */\n  isAvailable(agentId?: string): boolean {\n    const models = this.getModelChain(agentId);\n    return models.length > 0;\n  }\n\n  /**\n   * Make a chat completion request using the gateway's default AI chain.\n   * Tries primary first, then each fallback in order.\n   * When agentId is provided, uses that agent persona's model chain instead of defaults.\n   */\n  async chatCompletion(\n    messages: Array<{ role: \"system\" | \"user\" | \"assistant\"; content: string }>,\n    options: FallbackLlmOptions = {},\n  ): Promise<FallbackLlmResponse | null> {\n    const models = this.getModelChain(options.agentId);\n    if (models.length === 0) {\n      log.warn(\"fallback LLM: no models configured in gateway\");\n      return null;\n    }\n\n    const runChain = async (): Promise<FallbackLlmResponse | null> => {\n      // Try each model in the chain\n      for (let i = 0; i < models.length; i++) {\n        const model = models[i];\n        const isFallback = i > 0;\n\n        try {\n          const result = await this.tryModel(model, messages, options);\n          if (result) {\n            if (isFallback) {\n              log.debug(`fallback LLM: succeeded using ${model.modelString} (fallback ${i})`);\n            }\n            return {\n              content: result.content,\n              modelUsed: model.modelString,\n              usage: result.usage,\n            };\n          }\n        } catch (err) {\n          const errorMsg = err instanceof Error ? err.message : String(err);\n          log.debug(`fallback LLM: ${model.modelString} failed (${errorMsg}), trying next...`);\n          // Continue to next model in chain\n        }\n      }\n\n      log.warn(`fallback LLM: all ${models.length} models in chain failed`);\n      return null;\n    };\n\n    if (typeof options.timeoutMs === \"number\") {\n      if (options.timeoutMs <= 0) {\n        log.warn(\"fallback LLM: timed out before request started\");\n        return null;\n      }\n      let timeoutHandle: ReturnType<typeof setTimeout> | undefined;\n      try {\n        return await Promise.race([\n          runChain(),\n          new Promise<null>((resolve) => {\n            timeoutHandle = setTimeout(() => {\n              log.warn(`fallback LLM: timed out after ${options.timeoutMs}ms`);\n              resolve(null);\n            }, options.timeoutMs);\n          }),\n        ]);\n      } finally {\n        if (timeoutHandle) clearTimeout(timeoutHandle);\n      }\n    }\n\n    return await runChain();\n  }\n\n  /**\n   * Make a request with structured output (Zod schema).\n   * Returns parsed JSON or null on failure.\n   */\n  async parseWithSchema<T>(\n    messages: Array<{ role: \"system\" | \"user\" | \"assistant\"; content: string }>,\n    schema: { parse: (data: unknown) => T },\n    options: FallbackLlmOptions = {},\n  ): Promise<T | null> {\n    const detailed = await this.parseWithSchemaDetailed(messages, schema, options);\n    return detailed?.result ?? null;\n  }\n\n  /**\n   * Like parseWithSchema but also returns the model that was used,\n   * so callers can emit accurate trace events.\n   */\n  async parseWithSchemaDetailed<T>(\n    messages: Array<{ role: \"system\" | \"user\" | \"assistant\"; content: string }>,\n    schema: { parse: (data: unknown) => T },\n    options: FallbackLlmOptions = {},\n  ): Promise<{ result: T; modelUsed: string } | null> {\n    const response = await this.chatCompletion(messages, options);\n    if (!response?.content) return null;\n\n    try {\n      const candidates = extractJsonCandidates(response.content);\n      for (const c of candidates) {\n        try {\n          const parsed = JSON.parse(c);\n          return { result: schema.parse(parsed), modelUsed: response.modelUsed };\n        } catch {\n          // keep trying other candidates\n        }\n      }\n      return null;\n    } catch (err) {\n      log.warn(\"fallback LLM: failed to parse structured output:\", err);\n      return null;\n    }\n  }\n\n  /**\n   * Get the full model chain from gateway config.\n   * Returns array of models in order: [primary, fallback1, fallback2, ...]\n   *\n   * When agentId is provided, looks up the matching entry in agents.list[]\n   * and uses that persona's model chain. Falls back to agents.defaults.model\n   * if agentId is not found or not provided.\n   */\n  private getModelChain(agentId?: string): ModelRef[] {\n    const chain: ModelRef[] = [];\n    const providers = this.gatewayConfig?.models?.providers;\n\n    if (!providers) return chain;\n\n    // Resolve the model config: agent persona chain or global defaults\n    let modelConfig: { primary?: string; fallbacks?: string[] } | undefined;\n\n    if (agentId) {\n      const persona = this.gatewayConfig?.agents?.list?.find(\n        (a) => a.id === agentId,\n      );\n      if (persona?.model) {\n        modelConfig = persona.model;\n        log.debug(`fallback LLM: using agent persona \"${agentId}\" model chain`);\n      } else {\n        log.warn(\n          `fallback LLM: agent persona \"${agentId}\" not found or has no model config, falling back to defaults`,\n        );\n      }\n    }\n\n    if (!modelConfig) {\n      modelConfig = this.gatewayConfig?.agents?.defaults?.model;\n    }\n\n    // Build list of model strings: primary + fallbacks\n    const modelStrings: string[] = [];\n\n    if (modelConfig?.primary) {\n      modelStrings.push(modelConfig.primary);\n    }\n\n    if (Array.isArray(modelConfig?.fallbacks)) {\n      for (const fb of modelConfig.fallbacks) {\n        if (typeof fb === \"string\" && !modelStrings.includes(fb)) {\n          modelStrings.push(fb);\n        }\n      }\n    }\n\n    // Parse each model string and look up provider config\n    for (const modelString of modelStrings) {\n      const modelRef = this.parseModelString(modelString, providers);\n      if (modelRef) {\n        chain.push(modelRef);\n      }\n    }\n\n    return chain;\n  }\n\n  /**\n   * Parse a \"provider/model\" string and look up its config.\n   */\n  private parseModelString(\n    modelString: string,\n    providers: Record<string, ModelProviderConfig>,\n  ): ModelRef | null {\n    // Parse \"provider/model\" format (e.g., \"openai/gpt-5.2\", \"anthropic/claude-opus-4-6\")\n    const parts = modelString.split(\"/\");\n    if (parts.length < 2) {\n      log.warn(`fallback LLM: invalid model format: ${modelString}`);\n      return null;\n    }\n\n    const providerId = parts[0];\n    const modelId = parts.slice(1).join(\"/\"); // Handle cases like \"openai/gpt-5.2-turbo\"\n\n    const providerConfig = providers[providerId];\n    if (!providerConfig) {\n      log.warn(`fallback LLM: provider not found: ${providerId}`);\n      return null;\n    }\n\n    return { providerId, modelId, providerConfig, modelString };\n  }\n\n  /**\n   * Resolve the API key for a provider, handling OpenClaw secret ref formats.\n   * Results are cached per provider so exec calls only happen once.\n   */\n  private async resolveApiKey(\n    providerId: string,\n    providerConfig: ModelProviderConfig,\n  ): Promise<string | undefined> {\n    return resolveProviderApiKey(providerId, providerConfig.apiKey, this.gatewayConfig);\n  }\n\n  /**\n   * Try to call a single model.\n   */\n  private async tryModel(\n    model: ModelRef,\n    messages: Array<{ role: \"system\" | \"user\" | \"assistant\"; content: string }>,\n    options: FallbackLlmOptions,\n  ): Promise<{ content: string; usage?: FallbackLlmResponse[\"usage\"] } | null> {\n    // Resolve the API key from secret refs before making the call.\n    // If the raw key looks like an unresolved secret ref and resolution fails,\n    // skip this provider entirely so the chain falls through to the next.\n    const rawKey = model.providerConfig.apiKey;\n    const needsResolution = rawKey === \"secretref-managed\"\n      || (typeof rawKey === \"object\" && rawKey !== null);\n    const resolvedApiKey = await this.resolveApiKey(model.providerId, model.providerConfig);\n\n    if (needsResolution && !resolvedApiKey) {\n      throw new Error(`API key for provider \"${model.providerId}\" could not be resolved from secret ref`);\n    }\n\n    const configWithResolvedKey = resolvedApiKey\n      ? { ...model.providerConfig, apiKey: resolvedApiKey }\n      : model.providerConfig;\n\n    switch (model.providerConfig.api) {\n      case \"anthropic-messages\":\n        return await this.callAnthropic(configWithResolvedKey, model.modelId, messages, options);\n      case \"openai-completions\":\n      default:\n        return await this.callOpenAI(\n          configWithResolvedKey,\n          model.modelId,\n          messages,\n          options,\n          shouldAssumeOpenAiChatCompletions(model.providerConfig.baseUrl),\n        );\n    }\n  }\n\n  /**\n   * Call OpenAI-compatible API.\n   */\n  private async callOpenAI(\n    config: ModelProviderConfig,\n    modelId: string,\n    messages: Array<{ role: \"system\" | \"user\" | \"assistant\"; content: string }>,\n    options: FallbackLlmOptions,\n    assumeOpenAI: boolean,\n  ): Promise<{ content: string; usage?: FallbackLlmResponse[\"usage\"] } | null> {\n    const base = config.baseUrl.replace(/\\/$/, \"\");\n    const url = base.endsWith(\"/v1\")\n      ? `${base}/chat/completions`\n      : `${base}/v1/chat/completions`;\n\n    const headers: Record<string, string> = {\n      \"Content-Type\": \"application/json\",\n      ...config.headers,\n    };\n\n    // Handle auth — apiKey is already resolved to a string by tryModel()\n    if (config.apiKey && typeof config.apiKey === \"string\") {\n      if (config.authHeader !== false) {\n        headers[\"Authorization\"] = `Bearer ${config.apiKey}`;\n      }\n    }\n\n    const body = {\n      model: modelId,\n      messages,\n      temperature: options.temperature ?? 0.3,\n      ...buildChatCompletionTokenLimit(modelId, options.maxTokens ?? 4096, {\n        assumeOpenAI,\n      }),\n    };\n\n    const response = await fetch(url, {\n      method: \"POST\",\n      headers,\n      body: JSON.stringify(body),\n    });\n\n    if (!response.ok) {\n      const error = await response.text();\n      throw new Error(`OpenAI API error: ${response.status} ${error}`);\n    }\n\n    const data = (await response.json()) as {\n      choices: Array<{\n        message: {\n          content: string;\n        };\n      }>;\n      usage?: {\n        prompt_tokens?: number;\n        completion_tokens?: number;\n        total_tokens?: number;\n      };\n    };\n\n    const content = data.choices?.[0]?.message?.content;\n    if (!content) {\n      throw new Error(\"Empty response from OpenAI API\");\n    }\n\n    return {\n      content,\n      usage: data.usage\n        ? {\n            inputTokens: data.usage.prompt_tokens,\n            outputTokens: data.usage.completion_tokens,\n            totalTokens: data.usage.total_tokens,\n          }\n        : undefined,\n    };\n  }\n\n  /**\n   * Call Anthropic Messages API.\n   */\n  private async callAnthropic(\n    config: ModelProviderConfig,\n    modelId: string,\n    messages: Array<{ role: \"system\" | \"user\" | \"assistant\"; content: string }>,\n    options: FallbackLlmOptions,\n  ): Promise<{ content: string; usage?: FallbackLlmResponse[\"usage\"] } | null> {\n    const url = `${config.baseUrl.replace(/\\/$/, \"\")}/messages`;\n\n    const headers: Record<string, string> = {\n      \"Content-Type\": \"application/json\",\n      \"anthropic-version\": \"2023-06-01\",\n      ...config.headers,\n    };\n\n    // Handle auth - Anthropic uses x-api-key header (apiKey resolved by tryModel)\n    if (config.apiKey && typeof config.apiKey === \"string\") {\n      headers[\"x-api-key\"] = config.apiKey;\n    }\n\n    // Extract system message (Anthropic handles it separately)\n    const systemMessage = messages.find((m) => m.role === \"system\")?.content;\n    const nonSystemMessages = messages.filter((m) => m.role !== \"system\");\n\n    // Convert messages to Anthropic format\n    const anthropicMessages = nonSystemMessages.map((m) => ({\n      role: m.role,\n      content: m.content,\n    }));\n\n    const body: Record<string, unknown> = {\n      model: modelId,\n      messages: anthropicMessages,\n      max_tokens: options.maxTokens ?? 4096,\n      temperature: options.temperature ?? 0.3,\n    };\n\n    if (systemMessage) {\n      body.system = systemMessage;\n    }\n\n    const response = await fetch(url, {\n      method: \"POST\",\n      headers,\n      body: JSON.stringify(body),\n    });\n\n    if (!response.ok) {\n      const error = await response.text();\n      throw new Error(`Anthropic API error: ${response.status} ${error}`);\n    }\n\n    const data = (await response.json()) as {\n      content: Array<{\n        type: string;\n        text: string;\n      }>;\n      usage?: {\n        input_tokens?: number;\n        output_tokens?: number;\n      };\n    };\n\n    const content = data.content?.[0]?.text;\n    if (!content) {\n      throw new Error(\"Empty response from Anthropic API\");\n    }\n\n    return {\n      content,\n      usage: data.usage\n        ? {\n            inputTokens: data.usage.input_tokens,\n            outputTokens: data.usage.output_tokens,\n            totalTokens: (data.usage.input_tokens ?? 0) + (data.usage.output_tokens ?? 0),\n          }\n        : undefined,\n    };\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/chunk-KWBU5S5U.js

@@ -0,0 +1,42 @@
+// src/logger.ts
+var NOOP_LOGGER = {
+  info() {
+  },
+  warn() {
+  },
+  error() {
+  },
+  debug() {
+  }
+};
+var _backend = NOOP_LOGGER;
+var _debug = false;
+function initLogger(backend, debug) {
+  _backend = backend;
+  _debug = debug;
+}
+var log = {
+  info(msg, ...args) {
+    _backend.info(`remnic: ${msg}`, ...args);
+  },
+  warn(msg, ...args) {
+    _backend.warn(`remnic: ${msg}`, ...args);
+  },
+  error(msg, err) {
+    const detail = err instanceof Error ? err.message : err ? String(err) : "";
+    _backend.error(
+      `remnic: ${msg}${detail ? ` \u2014 ${detail}` : ""}`
+    );
+  },
+  debug(msg, ...args) {
+    if (!_debug) return;
+    const fn = _backend.debug ?? _backend.info;
+    fn(`remnic [debug]: ${msg}`, ...args);
+  }
+};
+
+export {
+  initLogger,
+  log
+};
+//# sourceMappingURL=chunk-KWBU5S5U.js.map

package/dist/chunk-KWBU5S5U.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/logger.ts"],"sourcesContent":["export interface LoggerBackend {\n  info(msg: string, ...args: unknown[]): void;\n  warn(msg: string, ...args: unknown[]): void;\n  error(msg: string, ...args: unknown[]): void;\n  debug?(msg: string, ...args: unknown[]): void;\n}\n\nconst NOOP_LOGGER: LoggerBackend = {\n  info() {},\n  warn() {},\n  error() {},\n  debug() {},\n};\n\nlet _backend: LoggerBackend = NOOP_LOGGER;\nlet _debug = false;\n\nexport function initLogger(backend: LoggerBackend, debug: boolean): void {\n  _backend = backend;\n  _debug = debug;\n}\n\nexport const log = {\n  info(msg: string, ...args: unknown[]): void {\n    _backend.info(`remnic: ${msg}`, ...args);\n  },\n  warn(msg: string, ...args: unknown[]): void {\n    _backend.warn(`remnic: ${msg}`, ...args);\n  },\n  error(msg: string, err?: unknown): void {\n    const detail =\n      err instanceof Error ? err.message : err ? String(err) : \"\";\n    _backend.error(\n      `remnic: ${msg}${detail ? ` — ${detail}` : \"\"}`,\n    );\n  },\n  debug(msg: string, ...args: unknown[]): void {\n    if (!_debug) return;\n    const fn = _backend.debug ?? _backend.info;\n    fn(`remnic [debug]: ${msg}`, ...args);\n  },\n};\n"],"mappings":";AAOA,IAAM,cAA6B;AAAA,EACjC,OAAO;AAAA,EAAC;AAAA,EACR,OAAO;AAAA,EAAC;AAAA,EACR,QAAQ;AAAA,EAAC;AAAA,EACT,QAAQ;AAAA,EAAC;AACX;AAEA,IAAI,WAA0B;AAC9B,IAAI,SAAS;AAEN,SAAS,WAAW,SAAwB,OAAsB;AACvE,aAAW;AACX,WAAS;AACX;AAEO,IAAM,MAAM;AAAA,EACjB,KAAK,QAAgB,MAAuB;AAC1C,aAAS,KAAK,WAAW,GAAG,IAAI,GAAG,IAAI;AAAA,EACzC;AAAA,EACA,KAAK,QAAgB,MAAuB;AAC1C,aAAS,KAAK,WAAW,GAAG,IAAI,GAAG,IAAI;AAAA,EACzC;AAAA,EACA,MAAM,KAAa,KAAqB;AACtC,UAAM,SACJ,eAAe,QAAQ,IAAI,UAAU,MAAM,OAAO,GAAG,IAAI;AAC3D,aAAS;AAAA,MACP,WAAW,GAAG,GAAG,SAAS,WAAM,MAAM,KAAK,EAAE;AAAA,IAC/C;AAAA,EACF;AAAA,EACA,MAAM,QAAgB,MAAuB;AAC3C,QAAI,CAAC,OAAQ;AACb,UAAM,KAAK,SAAS,SAAS,SAAS;AACtC,OAAG,mBAAmB,GAAG,IAAI,GAAG,IAAI;AAAA,EACtC;AACF;","names":[]}

package/dist/chunk-L5RPWGFK.js

@@ -0,0 +1,59 @@
+import {
+  log
+} from "./chunk-KWBU5S5U.js";
+
+// src/recall-qos.ts
+function defaultTiming(metric) {
+  if (typeof metric.timing === "string" && metric.timing.length > 0) {
+    return metric.timing;
+  }
+  if (metric.source === "skip") {
+    return "skip";
+  }
+  return `${Math.max(0, Math.round(metric.durationMs))}ms`;
+}
+function formatRecallSectionMetric(metric) {
+  const payload = {
+    section: metric.section,
+    priority: metric.priority,
+    durationMs: metric.durationMs,
+    deadlineMs: metric.deadlineMs,
+    source: metric.source,
+    success: metric.success
+  };
+  return {
+    message: "recall section metric",
+    payload,
+    level: metric.priority === "core" && metric.success && metric.source !== "skip" ? "info" : "debug",
+    timing: defaultTiming(metric)
+  };
+}
+function createRecallSectionMetricRecorder(options = {}) {
+  const logger = options.logger ?? log;
+  return (metric) => {
+    const entry = formatRecallSectionMetric(metric);
+    if (options.timings) {
+      options.timings[metric.section] = entry.timing;
+    }
+    if (entry.level === "info") {
+      if (typeof logger.info === "function") {
+        logger.info(entry.message, entry.payload);
+      } else {
+        log.info(entry.message, entry.payload);
+      }
+    } else {
+      if (typeof logger.debug === "function") {
+        logger.debug(entry.message, entry.payload);
+      } else {
+        log.debug(entry.message, entry.payload);
+      }
+    }
+    return entry;
+  };
+}
+
+export {
+  formatRecallSectionMetric,
+  createRecallSectionMetricRecorder
+};
+//# sourceMappingURL=chunk-L5RPWGFK.js.map

package/dist/chunk-L5RPWGFK.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/recall-qos.ts"],"sourcesContent":["import { log, type LoggerBackend } from \"./logger.js\";\n\nexport type RecallSectionPriority = \"core\" | \"enrichment\";\nexport type RecallSectionSource = \"fresh\" | \"stale\" | \"skip\";\n\nexport interface RecallSectionMetric {\n  section: string;\n  priority: RecallSectionPriority;\n  durationMs: number;\n  deadlineMs: number;\n  source: RecallSectionSource;\n  success: boolean;\n  timing?: string;\n}\n\nexport interface RecallSectionMetricLog {\n  message: string;\n  payload: {\n    section: string;\n    priority: RecallSectionPriority;\n    durationMs: number;\n    deadlineMs: number;\n    source: RecallSectionSource;\n    success: boolean;\n  };\n  level: \"info\" | \"debug\";\n  timing: string;\n}\n\nfunction defaultTiming(metric: RecallSectionMetric): string {\n  if (typeof metric.timing === \"string\" && metric.timing.length > 0) {\n    return metric.timing;\n  }\n  if (metric.source === \"skip\") {\n    return \"skip\";\n  }\n  return `${Math.max(0, Math.round(metric.durationMs))}ms`;\n}\n\nexport function formatRecallSectionMetric(metric: RecallSectionMetric): RecallSectionMetricLog {\n  const payload = {\n    section: metric.section,\n    priority: metric.priority,\n    durationMs: metric.durationMs,\n    deadlineMs: metric.deadlineMs,\n    source: metric.source,\n    success: metric.success,\n  };\n  return {\n    message: \"recall section metric\",\n    payload,\n    level: metric.priority === \"core\" && metric.success && metric.source !== \"skip\" ? \"info\" : \"debug\",\n    timing: defaultTiming(metric),\n  };\n}\n\nexport function createRecallSectionMetricRecorder(options: {\n  timings?: Record<string, string>;\n  logger?: Pick<LoggerBackend, \"info\" | \"debug\">;\n} = {}) {\n  const logger = options.logger ?? log;\n  return (metric: RecallSectionMetric): RecallSectionMetricLog => {\n    const entry = formatRecallSectionMetric(metric);\n    if (options.timings) {\n      options.timings[metric.section] = entry.timing;\n    }\n    if (entry.level === \"info\") {\n      if (typeof logger.info === \"function\") {\n        logger.info(entry.message, entry.payload);\n      } else {\n        log.info(entry.message, entry.payload);\n      }\n    } else {\n      if (typeof logger.debug === \"function\") {\n        logger.debug(entry.message, entry.payload);\n      } else {\n        log.debug(entry.message, entry.payload);\n      }\n    }\n    return entry;\n  };\n}\n"],"mappings":";;;;;AA6BA,SAAS,cAAc,QAAqC;AAC1D,MAAI,OAAO,OAAO,WAAW,YAAY,OAAO,OAAO,SAAS,GAAG;AACjE,WAAO,OAAO;AAAA,EAChB;AACA,MAAI,OAAO,WAAW,QAAQ;AAC5B,WAAO;AAAA,EACT;AACA,SAAO,GAAG,KAAK,IAAI,GAAG,KAAK,MAAM,OAAO,UAAU,CAAC,CAAC;AACtD;AAEO,SAAS,0BAA0B,QAAqD;AAC7F,QAAM,UAAU;AAAA,IACd,SAAS,OAAO;AAAA,IAChB,UAAU,OAAO;AAAA,IACjB,YAAY,OAAO;AAAA,IACnB,YAAY,OAAO;AAAA,IACnB,QAAQ,OAAO;AAAA,IACf,SAAS,OAAO;AAAA,EAClB;AACA,SAAO;AAAA,IACL,SAAS;AAAA,IACT;AAAA,IACA,OAAO,OAAO,aAAa,UAAU,OAAO,WAAW,OAAO,WAAW,SAAS,SAAS;AAAA,IAC3F,QAAQ,cAAc,MAAM;AAAA,EAC9B;AACF;AAEO,SAAS,kCAAkC,UAG9C,CAAC,GAAG;AACN,QAAM,SAAS,QAAQ,UAAU;AACjC,SAAO,CAAC,WAAwD;AAC9D,UAAM,QAAQ,0BAA0B,MAAM;AAC9C,QAAI,QAAQ,SAAS;AACnB,cAAQ,QAAQ,OAAO,OAAO,IAAI,MAAM;AAAA,IAC1C;AACA,QAAI,MAAM,UAAU,QAAQ;AAC1B,UAAI,OAAO,OAAO,SAAS,YAAY;AACrC,eAAO,KAAK,MAAM,SAAS,MAAM,OAAO;AAAA,MAC1C,OAAO;AACL,YAAI,KAAK,MAAM,SAAS,MAAM,OAAO;AAAA,MACvC;AAAA,IACF,OAAO;AACL,UAAI,OAAO,OAAO,UAAU,YAAY;AACtC,eAAO,MAAM,MAAM,SAAS,MAAM,OAAO;AAAA,MAC3C,OAAO;AACL,YAAI,MAAM,MAAM,SAAS,MAAM,OAAO;AAAA,MACxC;AAAA,IACF;AACA,WAAO;AAAA,EACT;AACF;","names":[]}

package/dist/chunk-L7WO3MZ4.js

@@ -0,0 +1,128 @@
+import {
+  StorageManager
+} from "./chunk-QWUUMMIK.js";
+
+// src/semantic-rule-promotion.ts
+function normalizeRuleWhitespace(value) {
+  return value.replace(/\s+/g, " ").trim();
+}
+function stripTrailingClausePunctuation(value) {
+  return value.replace(/[,:;]+$/g, "").trim();
+}
+function canonicalizeRuleContent(value) {
+  return extractExplicitIfThenRule(value) ?? normalizeRuleWhitespace(value);
+}
+function canonicalizeRuleKey(value) {
+  return canonicalizeRuleContent(value).toLowerCase();
+}
+function extractExplicitIfThenRule(content) {
+  const match = content.match(/\bif\b([\s\S]+?)\bthen\b([\s\S]+?)(?:[.!?](?:\s|$)|$)/i);
+  if (!match) return null;
+  const condition = stripTrailingClausePunctuation(normalizeRuleWhitespace(match[1] ?? ""));
+  const outcome = stripTrailingClausePunctuation(normalizeRuleWhitespace(match[2] ?? ""));
+  if (condition.length === 0 || outcome.length === 0) return null;
+  return `IF ${condition} THEN ${outcome}.`;
+}
+function promotionConfidence(memory) {
+  const base = Number.isFinite(memory.frontmatter.confidence) ? memory.frontmatter.confidence : 0.8;
+  return Math.max(0.6, Math.min(0.98, base));
+}
+function promotionTags(memory) {
+  return Array.from(/* @__PURE__ */ new Set([...memory.frontmatter.tags ?? [], "semantic-rule", "promoted-rule"]));
+}
+function buildSupportLinks(sourceMemoryId, confidence) {
+  return [
+    {
+      targetId: sourceMemoryId,
+      linkType: "supports",
+      strength: confidence,
+      reason: "Promoted from verified episodic memory"
+    }
+  ];
+}
+async function promoteSemanticRuleFromMemory(options) {
+  const report = {
+    enabled: options.enabled,
+    dryRun: options.dryRun === true,
+    promoted: [],
+    skipped: []
+  };
+  if (!options.enabled) {
+    report.skipped.push({
+      sourceMemoryId: options.sourceMemoryId,
+      reason: "disabled"
+    });
+    return report;
+  }
+  const storage = new StorageManager(options.memoryDir);
+  const sourceMemory = await storage.getMemoryById(options.sourceMemoryId);
+  if (!sourceMemory) {
+    report.skipped.push({
+      sourceMemoryId: options.sourceMemoryId,
+      reason: "source-memory-missing"
+    });
+    return report;
+  }
+  if (sourceMemory.frontmatter.status === "archived" || sourceMemory.frontmatter.memoryKind !== "episode") {
+    report.skipped.push({
+      sourceMemoryId: options.sourceMemoryId,
+      reason: "source-memory-not-episode"
+    });
+    return report;
+  }
+  const content = extractExplicitIfThenRule(sourceMemory.content);
+  if (!content) {
+    report.skipped.push({
+      sourceMemoryId: options.sourceMemoryId,
+      reason: "no-explicit-rule"
+    });
+    return report;
+  }
+  const ruleKey = canonicalizeRuleKey(content);
+  const existingRule = (await storage.readAllMemories()).find(
+    (memory) => memory.frontmatter.category === "rule" && memory.frontmatter.status !== "archived" && canonicalizeRuleKey(memory.content) === ruleKey
+  );
+  if (existingRule) {
+    report.skipped.push({
+      sourceMemoryId: options.sourceMemoryId,
+      reason: "duplicate-rule",
+      existingRuleId: existingRule.frontmatter.id
+    });
+    return report;
+  }
+  const confidence = promotionConfidence(sourceMemory);
+  const candidateBase = {
+    sourceMemoryId: options.sourceMemoryId,
+    content,
+    confidence,
+    tags: promotionTags(sourceMemory),
+    memoryKind: "note",
+    lineage: [options.sourceMemoryId]
+  };
+  if (options.dryRun === true) {
+    report.promoted.push({
+      id: `dry-run:${options.sourceMemoryId}`,
+      ...candidateBase
+    });
+    return report;
+  }
+  const id = await storage.writeMemory("rule", content, {
+    confidence,
+    tags: candidateBase.tags,
+    source: "semantic-rule-promotion",
+    lineage: candidateBase.lineage,
+    sourceMemoryId: options.sourceMemoryId,
+    memoryKind: "note",
+    links: buildSupportLinks(options.sourceMemoryId, confidence)
+  });
+  report.promoted.push({
+    id,
+    ...candidateBase
+  });
+  return report;
+}
+
+export {
+  promoteSemanticRuleFromMemory
+};
+//# sourceMappingURL=chunk-L7WO3MZ4.js.map

package/dist/chunk-L7WO3MZ4.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/semantic-rule-promotion.ts"],"sourcesContent":["import { StorageManager } from \"./storage.js\";\nimport type { MemoryFile, MemoryLink } from \"./types.js\";\n\nexport interface SemanticRulePromotionCandidate {\n  id: string;\n  sourceMemoryId: string;\n  content: string;\n  confidence: number;\n  tags: string[];\n  memoryKind: \"note\";\n  lineage: string[];\n}\n\nexport interface SemanticRulePromotionSkip {\n  sourceMemoryId: string;\n  reason:\n    | \"disabled\"\n    | \"source-memory-missing\"\n    | \"source-memory-not-episode\"\n    | \"no-explicit-rule\"\n    | \"duplicate-rule\";\n  existingRuleId?: string;\n}\n\nexport interface SemanticRulePromotionReport {\n  enabled: boolean;\n  dryRun: boolean;\n  promoted: SemanticRulePromotionCandidate[];\n  skipped: SemanticRulePromotionSkip[];\n}\n\nfunction normalizeRuleWhitespace(value: string): string {\n  return value.replace(/\\s+/g, \" \").trim();\n}\n\nfunction stripTrailingClausePunctuation(value: string): string {\n  return value.replace(/[,:;]+$/g, \"\").trim();\n}\n\nfunction canonicalizeRuleContent(value: string): string {\n  return extractExplicitIfThenRule(value) ?? normalizeRuleWhitespace(value);\n}\n\nfunction canonicalizeRuleKey(value: string): string {\n  return canonicalizeRuleContent(value).toLowerCase();\n}\n\nfunction extractExplicitIfThenRule(content: string): string | null {\n  const match = content.match(/\\bif\\b([\\s\\S]+?)\\bthen\\b([\\s\\S]+?)(?:[.!?](?:\\s|$)|$)/i);\n  if (!match) return null;\n  const condition = stripTrailingClausePunctuation(normalizeRuleWhitespace(match[1] ?? \"\"));\n  const outcome = stripTrailingClausePunctuation(normalizeRuleWhitespace(match[2] ?? \"\"));\n  if (condition.length === 0 || outcome.length === 0) return null;\n  return `IF ${condition} THEN ${outcome}.`;\n}\n\nfunction promotionConfidence(memory: MemoryFile): number {\n  const base = Number.isFinite(memory.frontmatter.confidence) ? memory.frontmatter.confidence : 0.8;\n  return Math.max(0.6, Math.min(0.98, base));\n}\n\nfunction promotionTags(memory: MemoryFile): string[] {\n  return Array.from(new Set([...(memory.frontmatter.tags ?? []), \"semantic-rule\", \"promoted-rule\"]));\n}\n\nfunction buildSupportLinks(sourceMemoryId: string, confidence: number): MemoryLink[] {\n  return [\n    {\n      targetId: sourceMemoryId,\n      linkType: \"supports\",\n      strength: confidence,\n      reason: \"Promoted from verified episodic memory\",\n    },\n  ];\n}\n\nexport async function promoteSemanticRuleFromMemory(options: {\n  memoryDir: string;\n  enabled: boolean;\n  sourceMemoryId: string;\n  dryRun?: boolean;\n}): Promise<SemanticRulePromotionReport> {\n  const report: SemanticRulePromotionReport = {\n    enabled: options.enabled,\n    dryRun: options.dryRun === true,\n    promoted: [],\n    skipped: [],\n  };\n  if (!options.enabled) {\n    report.skipped.push({\n      sourceMemoryId: options.sourceMemoryId,\n      reason: \"disabled\",\n    });\n    return report;\n  }\n\n  const storage = new StorageManager(options.memoryDir);\n  const sourceMemory = await storage.getMemoryById(options.sourceMemoryId);\n  if (!sourceMemory) {\n    report.skipped.push({\n      sourceMemoryId: options.sourceMemoryId,\n      reason: \"source-memory-missing\",\n    });\n    return report;\n  }\n  if (sourceMemory.frontmatter.status === \"archived\" || sourceMemory.frontmatter.memoryKind !== \"episode\") {\n    report.skipped.push({\n      sourceMemoryId: options.sourceMemoryId,\n      reason: \"source-memory-not-episode\",\n    });\n    return report;\n  }\n\n  const content = extractExplicitIfThenRule(sourceMemory.content);\n  if (!content) {\n    report.skipped.push({\n      sourceMemoryId: options.sourceMemoryId,\n      reason: \"no-explicit-rule\",\n    });\n    return report;\n  }\n\n  const ruleKey = canonicalizeRuleKey(content);\n  const existingRule = (await storage.readAllMemories()).find(\n    (memory) =>\n      memory.frontmatter.category === \"rule\" &&\n      memory.frontmatter.status !== \"archived\" &&\n      canonicalizeRuleKey(memory.content) === ruleKey,\n  );\n  if (existingRule) {\n    report.skipped.push({\n      sourceMemoryId: options.sourceMemoryId,\n      reason: \"duplicate-rule\",\n      existingRuleId: existingRule.frontmatter.id,\n    });\n    return report;\n  }\n\n  const confidence = promotionConfidence(sourceMemory);\n  const candidateBase = {\n    sourceMemoryId: options.sourceMemoryId,\n    content,\n    confidence,\n    tags: promotionTags(sourceMemory),\n    memoryKind: \"note\" as const,\n    lineage: [options.sourceMemoryId],\n  };\n\n  if (options.dryRun === true) {\n    report.promoted.push({\n      id: `dry-run:${options.sourceMemoryId}`,\n      ...candidateBase,\n    });\n    return report;\n  }\n\n  const id = await storage.writeMemory(\"rule\", content, {\n    confidence,\n    tags: candidateBase.tags,\n    source: \"semantic-rule-promotion\",\n    lineage: candidateBase.lineage,\n    sourceMemoryId: options.sourceMemoryId,\n    memoryKind: \"note\",\n    links: buildSupportLinks(options.sourceMemoryId, confidence),\n  });\n  report.promoted.push({\n    id,\n    ...candidateBase,\n  });\n  return report;\n}\n"],"mappings":";;;;;AA+BA,SAAS,wBAAwB,OAAuB;AACtD,SAAO,MAAM,QAAQ,QAAQ,GAAG,EAAE,KAAK;AACzC;AAEA,SAAS,+BAA+B,OAAuB;AAC7D,SAAO,MAAM,QAAQ,YAAY,EAAE,EAAE,KAAK;AAC5C;AAEA,SAAS,wBAAwB,OAAuB;AACtD,SAAO,0BAA0B,KAAK,KAAK,wBAAwB,KAAK;AAC1E;AAEA,SAAS,oBAAoB,OAAuB;AAClD,SAAO,wBAAwB,KAAK,EAAE,YAAY;AACpD;AAEA,SAAS,0BAA0B,SAAgC;AACjE,QAAM,QAAQ,QAAQ,MAAM,wDAAwD;AACpF,MAAI,CAAC,MAAO,QAAO;AACnB,QAAM,YAAY,+BAA+B,wBAAwB,MAAM,CAAC,KAAK,EAAE,CAAC;AACxF,QAAM,UAAU,+BAA+B,wBAAwB,MAAM,CAAC,KAAK,EAAE,CAAC;AACtF,MAAI,UAAU,WAAW,KAAK,QAAQ,WAAW,EAAG,QAAO;AAC3D,SAAO,MAAM,SAAS,SAAS,OAAO;AACxC;AAEA,SAAS,oBAAoB,QAA4B;AACvD,QAAM,OAAO,OAAO,SAAS,OAAO,YAAY,UAAU,IAAI,OAAO,YAAY,aAAa;AAC9F,SAAO,KAAK,IAAI,KAAK,KAAK,IAAI,MAAM,IAAI,CAAC;AAC3C;AAEA,SAAS,cAAc,QAA8B;AACnD,SAAO,MAAM,KAAK,oBAAI,IAAI,CAAC,GAAI,OAAO,YAAY,QAAQ,CAAC,GAAI,iBAAiB,eAAe,CAAC,CAAC;AACnG;AAEA,SAAS,kBAAkB,gBAAwB,YAAkC;AACnF,SAAO;AAAA,IACL;AAAA,MACE,UAAU;AAAA,MACV,UAAU;AAAA,MACV,UAAU;AAAA,MACV,QAAQ;AAAA,IACV;AAAA,EACF;AACF;AAEA,eAAsB,8BAA8B,SAKX;AACvC,QAAM,SAAsC;AAAA,IAC1C,SAAS,QAAQ;AAAA,IACjB,QAAQ,QAAQ,WAAW;AAAA,IAC3B,UAAU,CAAC;AAAA,IACX,SAAS,CAAC;AAAA,EACZ;AACA,MAAI,CAAC,QAAQ,SAAS;AACpB,WAAO,QAAQ,KAAK;AAAA,MAClB,gBAAgB,QAAQ;AAAA,MACxB,QAAQ;AAAA,IACV,CAAC;AACD,WAAO;AAAA,EACT;AAEA,QAAM,UAAU,IAAI,eAAe,QAAQ,SAAS;AACpD,QAAM,eAAe,MAAM,QAAQ,cAAc,QAAQ,cAAc;AACvE,MAAI,CAAC,cAAc;AACjB,WAAO,QAAQ,KAAK;AAAA,MAClB,gBAAgB,QAAQ;AAAA,MACxB,QAAQ;AAAA,IACV,CAAC;AACD,WAAO;AAAA,EACT;AACA,MAAI,aAAa,YAAY,WAAW,cAAc,aAAa,YAAY,eAAe,WAAW;AACvG,WAAO,QAAQ,KAAK;AAAA,MAClB,gBAAgB,QAAQ;AAAA,MACxB,QAAQ;AAAA,IACV,CAAC;AACD,WAAO;AAAA,EACT;AAEA,QAAM,UAAU,0BAA0B,aAAa,OAAO;AAC9D,MAAI,CAAC,SAAS;AACZ,WAAO,QAAQ,KAAK;AAAA,MAClB,gBAAgB,QAAQ;AAAA,MACxB,QAAQ;AAAA,IACV,CAAC;AACD,WAAO;AAAA,EACT;AAEA,QAAM,UAAU,oBAAoB,OAAO;AAC3C,QAAM,gBAAgB,MAAM,QAAQ,gBAAgB,GAAG;AAAA,IACrD,CAAC,WACC,OAAO,YAAY,aAAa,UAChC,OAAO,YAAY,WAAW,cAC9B,oBAAoB,OAAO,OAAO,MAAM;AAAA,EAC5C;AACA,MAAI,cAAc;AAChB,WAAO,QAAQ,KAAK;AAAA,MAClB,gBAAgB,QAAQ;AAAA,MACxB,QAAQ;AAAA,MACR,gBAAgB,aAAa,YAAY;AAAA,IAC3C,CAAC;AACD,WAAO;AAAA,EACT;AAEA,QAAM,aAAa,oBAAoB,YAAY;AACnD,QAAM,gBAAgB;AAAA,IACpB,gBAAgB,QAAQ;AAAA,IACxB;AAAA,IACA;AAAA,IACA,MAAM,cAAc,YAAY;AAAA,IAChC,YAAY;AAAA,IACZ,SAAS,CAAC,QAAQ,cAAc;AAAA,EAClC;AAEA,MAAI,QAAQ,WAAW,MAAM;AAC3B,WAAO,SAAS,KAAK;AAAA,MACnB,IAAI,WAAW,QAAQ,cAAc;AAAA,MACrC,GAAG;AAAA,IACL,CAAC;AACD,WAAO;AAAA,EACT;AAEA,QAAM,KAAK,MAAM,QAAQ,YAAY,QAAQ,SAAS;AAAA,IACpD;AAAA,IACA,MAAM,cAAc;AAAA,IACpB,QAAQ;AAAA,IACR,SAAS,cAAc;AAAA,IACvB,gBAAgB,QAAQ;AAAA,IACxB,YAAY;AAAA,IACZ,OAAO,kBAAkB,QAAQ,gBAAgB,UAAU;AAAA,EAC7D,CAAC;AACD,SAAO,SAAS,KAAK;AAAA,IACnB;AAAA,IACA,GAAG;AAAA,EACL,CAAC;AACD,SAAO;AACT;","names":[]}

package/dist/chunk-LIRZNNUP.js

@@ -0,0 +1,74 @@
+import {
+  graphEdgeKey
+} from "./chunk-Y4Z4I6WK.js";
+
+// src/graph-dashboard-parser.ts
+import path from "path";
+import { readFile } from "fs/promises";
+var GRAPH_TYPES = ["entity", "time", "causal"];
+function graphFile(memoryDir, type) {
+  return path.join(memoryDir, "state", "graphs", `${type}.jsonl`);
+}
+function isGraphEdge(raw, expectedType) {
+  if (!raw || typeof raw !== "object") return false;
+  const edge = raw;
+  return edge.type === expectedType && typeof edge.from === "string" && edge.from.length > 0 && typeof edge.to === "string" && edge.to.length > 0 && typeof edge.weight === "number" && Number.isFinite(edge.weight) && typeof edge.label === "string" && typeof edge.ts === "string";
+}
+async function graphSnapshotFromMemoryDir(memoryDir) {
+  const nodes = /* @__PURE__ */ new Set();
+  const edges = [];
+  const filesMissing = [];
+  let malformedLines = 0;
+  const seenEdges = /* @__PURE__ */ new Set();
+  for (const type of GRAPH_TYPES) {
+    const filePath = graphFile(memoryDir, type);
+    let raw = "";
+    try {
+      raw = await readFile(filePath, "utf-8");
+    } catch {
+      filesMissing.push(type);
+      continue;
+    }
+    for (const line of raw.split("\n")) {
+      const trimmed = line.trim();
+      if (!trimmed) continue;
+      let parsed;
+      try {
+        parsed = JSON.parse(trimmed);
+      } catch {
+        malformedLines += 1;
+        continue;
+      }
+      if (!isGraphEdge(parsed, type)) {
+        malformedLines += 1;
+        continue;
+      }
+      const key = graphEdgeKey(parsed);
+      if (seenEdges.has(key)) continue;
+      seenEdges.add(key);
+      edges.push(parsed);
+      nodes.add(parsed.from);
+      nodes.add(parsed.to);
+    }
+  }
+  const sortedEdges = edges.sort(
+    (a, b) => a.type.localeCompare(b.type) || a.from.localeCompare(b.from) || a.to.localeCompare(b.to) || a.ts.localeCompare(b.ts)
+  );
+  const sortedNodes = [...nodes].sort((a, b) => a.localeCompare(b)).map((id) => ({ id }));
+  return {
+    generatedAt: (/* @__PURE__ */ new Date()).toISOString(),
+    nodes: sortedNodes,
+    edges: sortedEdges,
+    stats: {
+      nodes: sortedNodes.length,
+      edges: sortedEdges.length,
+      malformedLines,
+      filesMissing
+    }
+  };
+}
+
+export {
+  graphSnapshotFromMemoryDir
+};
+//# sourceMappingURL=chunk-LIRZNNUP.js.map

package/dist/chunk-LIRZNNUP.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/graph-dashboard-parser.ts"],"sourcesContent":["import path from \"node:path\";\nimport { readFile } from \"node:fs/promises\";\nimport type { GraphEdge, GraphType } from \"./graph.js\";\nimport { graphEdgeKey } from \"./graph-dashboard-key.js\";\n\nexport interface GraphSnapshotNode {\n  id: string;\n}\n\nexport interface GraphSnapshotStats {\n  nodes: number;\n  edges: number;\n  malformedLines: number;\n  filesMissing: GraphType[];\n}\n\nexport interface GraphSnapshot {\n  generatedAt: string;\n  nodes: GraphSnapshotNode[];\n  edges: GraphEdge[];\n  stats: GraphSnapshotStats;\n}\n\nconst GRAPH_TYPES: GraphType[] = [\"entity\", \"time\", \"causal\"];\n\nfunction graphFile(memoryDir: string, type: GraphType): string {\n  return path.join(memoryDir, \"state\", \"graphs\", `${type}.jsonl`);\n}\n\nfunction isGraphEdge(raw: unknown, expectedType: GraphType): raw is GraphEdge {\n  if (!raw || typeof raw !== \"object\") return false;\n  const edge = raw as Record<string, unknown>;\n  return (\n    edge.type === expectedType &&\n    typeof edge.from === \"string\" &&\n    edge.from.length > 0 &&\n    typeof edge.to === \"string\" &&\n    edge.to.length > 0 &&\n    typeof edge.weight === \"number\" &&\n    Number.isFinite(edge.weight) &&\n    typeof edge.label === \"string\" &&\n    typeof edge.ts === \"string\"\n  );\n}\n\nexport async function graphSnapshotFromMemoryDir(memoryDir: string): Promise<GraphSnapshot> {\n  const nodes = new Set<string>();\n  const edges: GraphEdge[] = [];\n  const filesMissing: GraphType[] = [];\n  let malformedLines = 0;\n  const seenEdges = new Set<string>();\n\n  for (const type of GRAPH_TYPES) {\n    const filePath = graphFile(memoryDir, type);\n    let raw = \"\";\n    try {\n      raw = await readFile(filePath, \"utf-8\");\n    } catch {\n      filesMissing.push(type);\n      continue;\n    }\n    for (const line of raw.split(\"\\n\")) {\n      const trimmed = line.trim();\n      if (!trimmed) continue;\n      let parsed: unknown;\n      try {\n        parsed = JSON.parse(trimmed);\n      } catch {\n        malformedLines += 1;\n        continue;\n      }\n      if (!isGraphEdge(parsed, type)) {\n        malformedLines += 1;\n        continue;\n      }\n      const key = graphEdgeKey(parsed);\n      if (seenEdges.has(key)) continue;\n      seenEdges.add(key);\n      edges.push(parsed);\n      nodes.add(parsed.from);\n      nodes.add(parsed.to);\n    }\n  }\n\n  const sortedEdges = edges.sort((a, b) =>\n    a.type.localeCompare(b.type) ||\n    a.from.localeCompare(b.from) ||\n    a.to.localeCompare(b.to) ||\n    a.ts.localeCompare(b.ts)\n  );\n  const sortedNodes = [...nodes].sort((a, b) => a.localeCompare(b)).map((id) => ({ id }));\n\n  return {\n    generatedAt: new Date().toISOString(),\n    nodes: sortedNodes,\n    edges: sortedEdges,\n    stats: {\n      nodes: sortedNodes.length,\n      edges: sortedEdges.length,\n      malformedLines,\n      filesMissing,\n    },\n  };\n}\n"],"mappings":";;;;;AAAA,OAAO,UAAU;AACjB,SAAS,gBAAgB;AAsBzB,IAAM,cAA2B,CAAC,UAAU,QAAQ,QAAQ;AAE5D,SAAS,UAAU,WAAmB,MAAyB;AAC7D,SAAO,KAAK,KAAK,WAAW,SAAS,UAAU,GAAG,IAAI,QAAQ;AAChE;AAEA,SAAS,YAAY,KAAc,cAA2C;AAC5E,MAAI,CAAC,OAAO,OAAO,QAAQ,SAAU,QAAO;AAC5C,QAAM,OAAO;AACb,SACE,KAAK,SAAS,gBACd,OAAO,KAAK,SAAS,YACrB,KAAK,KAAK,SAAS,KACnB,OAAO,KAAK,OAAO,YACnB,KAAK,GAAG,SAAS,KACjB,OAAO,KAAK,WAAW,YACvB,OAAO,SAAS,KAAK,MAAM,KAC3B,OAAO,KAAK,UAAU,YACtB,OAAO,KAAK,OAAO;AAEvB;AAEA,eAAsB,2BAA2B,WAA2C;AAC1F,QAAM,QAAQ,oBAAI,IAAY;AAC9B,QAAM,QAAqB,CAAC;AAC5B,QAAM,eAA4B,CAAC;AACnC,MAAI,iBAAiB;AACrB,QAAM,YAAY,oBAAI,IAAY;AAElC,aAAW,QAAQ,aAAa;AAC9B,UAAM,WAAW,UAAU,WAAW,IAAI;AAC1C,QAAI,MAAM;AACV,QAAI;AACF,YAAM,MAAM,SAAS,UAAU,OAAO;AAAA,IACxC,QAAQ;AACN,mBAAa,KAAK,IAAI;AACtB;AAAA,IACF;AACA,eAAW,QAAQ,IAAI,MAAM,IAAI,GAAG;AAClC,YAAM,UAAU,KAAK,KAAK;AAC1B,UAAI,CAAC,QAAS;AACd,UAAI;AACJ,UAAI;AACF,iBAAS,KAAK,MAAM,OAAO;AAAA,MAC7B,QAAQ;AACN,0BAAkB;AAClB;AAAA,MACF;AACA,UAAI,CAAC,YAAY,QAAQ,IAAI,GAAG;AAC9B,0BAAkB;AAClB;AAAA,MACF;AACA,YAAM,MAAM,aAAa,MAAM;AAC/B,UAAI,UAAU,IAAI,GAAG,EAAG;AACxB,gBAAU,IAAI,GAAG;AACjB,YAAM,KAAK,MAAM;AACjB,YAAM,IAAI,OAAO,IAAI;AACrB,YAAM,IAAI,OAAO,EAAE;AAAA,IACrB;AAAA,EACF;AAEA,QAAM,cAAc,MAAM;AAAA,IAAK,CAAC,GAAG,MACjC,EAAE,KAAK,cAAc,EAAE,IAAI,KAC3B,EAAE,KAAK,cAAc,EAAE,IAAI,KAC3B,EAAE,GAAG,cAAc,EAAE,EAAE,KACvB,EAAE,GAAG,cAAc,EAAE,EAAE;AAAA,EACzB;AACA,QAAM,cAAc,CAAC,GAAG,KAAK,EAAE,KAAK,CAAC,GAAG,MAAM,EAAE,cAAc,CAAC,CAAC,EAAE,IAAI,CAAC,QAAQ,EAAE,GAAG,EAAE;AAEtF,SAAO;AAAA,IACL,cAAa,oBAAI,KAAK,GAAE,YAAY;AAAA,IACpC,OAAO;AAAA,IACP,OAAO;AAAA,IACP,OAAO;AAAA,MACL,OAAO,YAAY;AAAA,MACnB,OAAO,YAAY;AAAA,MACnB;AAAA,MACA;AAAA,IACF;AAAA,EACF;AACF;","names":[]}

package/dist/chunk-LK6SGL53.js

@@ -0,0 +1,22 @@
+// src/runtime/child-process.ts
+import { createRequire } from "module";
+var require2 = createRequire(import.meta.url);
+function loadModule() {
+  return require2("node:child_process");
+}
+function launchProcess(command, args, options) {
+  const moduleApi = loadModule();
+  const launch = moduleApi["spawn"];
+  return launch(command, args, options);
+}
+function launchProcessSync(command, args, options) {
+  const moduleApi = loadModule();
+  const launchSync = moduleApi["spawnSync"];
+  return launchSync(command, args, options);
+}
+
+export {
+  launchProcess,
+  launchProcessSync
+};
+//# sourceMappingURL=chunk-LK6SGL53.js.map

package/dist/chunk-LK6SGL53.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/runtime/child-process.ts"],"sourcesContent":["import { createRequire } from \"node:module\";\nimport type {\n  ChildProcess as NodeChildProcess,\n  SpawnOptions,\n  SpawnSyncOptionsWithStringEncoding,\n  SpawnSyncReturns,\n} from \"node:child_process\";\n\nconst require = createRequire(import.meta.url);\n\ntype ChildProcessModule = typeof import(\"node:child_process\");\n\nfunction loadModule(): ChildProcessModule {\n  return require(\"node:child_process\") as ChildProcessModule;\n}\n\nexport type CommandChildProcess = NodeChildProcess;\n\nexport function launchProcess(\n  command: string,\n  args: string[],\n  options?: SpawnOptions,\n): CommandChildProcess {\n  const moduleApi = loadModule();\n  const launch = moduleApi[\"spawn\"] as (\n    command: string,\n    args?: readonly string[],\n    options?: SpawnOptions,\n  ) => CommandChildProcess;\n  return launch(command, args, options);\n}\n\nexport function launchProcessSync(\n  command: string,\n  args: string[],\n  options: SpawnSyncOptionsWithStringEncoding,\n): SpawnSyncReturns<string> {\n  const moduleApi = loadModule();\n  const launchSync = moduleApi[\"spawnSync\"] as (\n    command: string,\n    args: readonly string[],\n    options: SpawnSyncOptionsWithStringEncoding,\n  ) => SpawnSyncReturns<string>;\n  return launchSync(command, args, options);\n}\n"],"mappings":";AAAA,SAAS,qBAAqB;AAQ9B,IAAMA,WAAU,cAAc,YAAY,GAAG;AAI7C,SAAS,aAAiC;AACxC,SAAOA,SAAQ,oBAAoB;AACrC;AAIO,SAAS,cACd,SACA,MACA,SACqB;AACrB,QAAM,YAAY,WAAW;AAC7B,QAAM,SAAS,UAAU,OAAO;AAKhC,SAAO,OAAO,SAAS,MAAM,OAAO;AACtC;AAEO,SAAS,kBACd,SACA,MACA,SAC0B;AAC1B,QAAM,YAAY,WAAW;AAC7B,QAAM,aAAa,UAAU,WAAW;AAKxC,SAAO,WAAW,SAAS,MAAM,OAAO;AAC1C;","names":["require"]}

package/dist/chunk-LOBRX7VD.js

@@ -0,0 +1,200 @@
+import {
+  assertIsoRecordedAt,
+  assertSafePathSegment,
+  assertString,
+  isRecord,
+  optionalString,
+  optionalStringArray,
+  recordStoreDay,
+  validateStringRecord
+} from "./chunk-DGXUHMOV.js";
+import {
+  listJsonFiles,
+  readJsonFile
+} from "./chunk-LPSF4OQH.js";
+
+// src/objective-state.ts
+import path from "path";
+import { mkdir, writeFile } from "fs/promises";
+function validateValueRef(raw, field) {
+  if (raw === void 0) return void 0;
+  if (!isRecord(raw)) throw new Error(`${field} must be an object`);
+  const exists = typeof raw.exists === "boolean" ? raw.exists : void 0;
+  const ref = optionalString(raw.ref);
+  const valueHash = optionalString(raw.valueHash);
+  if (exists === void 0 && ref === void 0 && valueHash === void 0) {
+    throw new Error(`${field} must include exists, ref, or valueHash`);
+  }
+  return { exists, ref, valueHash };
+}
+function validateMetadata(raw) {
+  return validateStringRecord(raw, "metadata");
+}
+function resolveObjectiveStateStoreDir(memoryDir, overrideDir) {
+  if (typeof overrideDir === "string" && overrideDir.trim().length > 0) {
+    return overrideDir.trim();
+  }
+  return path.join(memoryDir, "state", "objective-state");
+}
+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");
+  const source = assertString(raw.source, "source");
+  if (!["tool_result", "cli", "system", "manual"].includes(source)) {
+    throw new Error("source must be one of tool_result|cli|system|manual");
+  }
+  const kind = assertString(raw.kind, "kind");
+  if (!["tool", "file", "process", "record", "workspace"].includes(kind)) {
+    throw new Error("kind must be one of tool|file|process|record|workspace");
+  }
+  const changeKind = assertString(raw.changeKind, "changeKind");
+  if (!["created", "updated", "deleted", "observed", "executed", "failed"].includes(changeKind)) {
+    throw new Error("changeKind must be one of created|updated|deleted|observed|executed|failed");
+  }
+  const outcomeRaw = optionalString(raw.outcome);
+  if (outcomeRaw !== void 0 && !["success", "failure", "partial", "unknown"].includes(outcomeRaw)) {
+    throw new Error("outcome must be one of success|failure|partial|unknown");
+  }
+  return {
+    schemaVersion: 1,
+    snapshotId: assertSafePathSegment(assertString(raw.snapshotId, "snapshotId"), "snapshotId"),
+    recordedAt: assertIsoRecordedAt(assertString(raw.recordedAt, "recordedAt")),
+    sessionKey: assertString(raw.sessionKey, "sessionKey"),
+    source,
+    kind,
+    changeKind,
+    scope: assertString(raw.scope, "scope"),
+    summary: assertString(raw.summary, "summary"),
+    toolName: optionalString(raw.toolName),
+    command: optionalString(raw.command),
+    outcome: outcomeRaw,
+    before: validateValueRef(raw.before, "before"),
+    after: validateValueRef(raw.after, "after"),
+    entityRefs: optionalStringArray(raw.entityRefs, "entityRefs"),
+    tags: optionalStringArray(raw.tags, "tags"),
+    metadata: validateMetadata(raw.metadata)
+  };
+}
+async function recordObjectiveStateSnapshot(options) {
+  const rootDir = resolveObjectiveStateStoreDir(options.memoryDir, options.objectiveStateStoreDir);
+  const validated = validateObjectiveStateSnapshot(options.snapshot);
+  const day = recordStoreDay(validated.recordedAt);
+  const snapshotsDir = path.join(rootDir, "snapshots", day);
+  const filePath = path.join(snapshotsDir, `${validated.snapshotId}.json`);
+  await mkdir(snapshotsDir, { recursive: true });
+  await writeFile(filePath, JSON.stringify(validated, null, 2), "utf8");
+  return filePath;
+}
+async function getObjectiveStateStoreStatus(options) {
+  const rootDir = resolveObjectiveStateStoreDir(options.memoryDir, options.objectiveStateStoreDir);
+  const snapshotsDir = path.join(rootDir, "snapshots");
+  const { files, snapshots, invalidSnapshots } = await readObjectiveStateSnapshots(options);
+  snapshots.sort((a, b) => b.recordedAt.localeCompare(a.recordedAt));
+  const byKind = {};
+  const byOutcome = {};
+  for (const snapshot of snapshots) {
+    byKind[snapshot.kind] = (byKind[snapshot.kind] ?? 0) + 1;
+    const outcome = snapshot.outcome ?? "unknown";
+    byOutcome[outcome] = (byOutcome[outcome] ?? 0) + 1;
+  }
+  return {
+    enabled: options.enabled,
+    writesEnabled: options.writesEnabled,
+    rootDir,
+    snapshotsDir,
+    snapshots: {
+      total: files.length,
+      valid: snapshots.length,
+      invalid: invalidSnapshots.length,
+      byKind,
+      byOutcome,
+      latestSnapshotId: snapshots[0]?.snapshotId,
+      latestRecordedAt: snapshots[0]?.recordedAt,
+      latestSessionKey: snapshots[0]?.sessionKey
+    },
+    latestSnapshot: snapshots[0],
+    invalidSnapshots
+  };
+}
+async function readObjectiveStateSnapshots(options) {
+  const rootDir = resolveObjectiveStateStoreDir(options.memoryDir, options.objectiveStateStoreDir);
+  const files = await listJsonFiles(path.join(rootDir, "snapshots"));
+  const snapshots = [];
+  const invalidSnapshots = [];
+  for (const filePath of files) {
+    try {
+      snapshots.push(validateObjectiveStateSnapshot(await readJsonFile(filePath)));
+    } catch (error) {
+      invalidSnapshots.push({
+        path: filePath,
+        error: error instanceof Error ? error.message : String(error)
+      });
+    }
+  }
+  return { files, snapshots, invalidSnapshots };
+}
+function normalizeTokens(value) {
+  return value.toLowerCase().split(/[^a-z0-9]+/).map((token) => token.trim()).filter((token) => token.length >= 2);
+}
+function overlapScore(queryTokens, value, weight) {
+  if (!value) return 0;
+  const tokens = new Set(normalizeTokens(value));
+  let matches = 0;
+  for (const token of queryTokens) {
+    if (tokens.has(token)) matches += 1;
+  }
+  return matches * weight;
+}
+function lexicalScoreObjectiveStateSnapshot(snapshot, queryTokens) {
+  let score = 0;
+  score += overlapScore(queryTokens, snapshot.scope, 4);
+  score += overlapScore(queryTokens, snapshot.summary, 3);
+  score += overlapScore(queryTokens, snapshot.command, 3);
+  score += overlapScore(queryTokens, snapshot.toolName, 2);
+  score += overlapScore(queryTokens, snapshot.tags?.join(" "), 2);
+  score += overlapScore(queryTokens, snapshot.entityRefs?.join(" "), 2);
+  score += overlapScore(queryTokens, snapshot.kind, 1);
+  score += overlapScore(queryTokens, snapshot.changeKind, 1);
+  score += overlapScore(queryTokens, snapshot.outcome, 1);
+  return score;
+}
+function scoreObjectiveStateSnapshot(snapshot, lexicalScore, sessionKey) {
+  let score = lexicalScore;
+  if (sessionKey && snapshot.sessionKey === sessionKey) score += 1.5;
+  const recordedAtMs = Date.parse(snapshot.recordedAt);
+  if (Number.isFinite(recordedAtMs)) {
+    const ageHours = Math.max(0, (Date.now() - recordedAtMs) / 36e5);
+    score += 1 / (1 + ageHours);
+  }
+  return score;
+}
+async function searchObjectiveStateSnapshots(options) {
+  const maxResults = Math.max(0, Math.floor(options.maxResults));
+  if (maxResults === 0) return [];
+  const { snapshots } = await readObjectiveStateSnapshots(options);
+  if (snapshots.length === 0) return [];
+  const queryTokens = new Set(normalizeTokens(options.query));
+  const scored = snapshots.map((snapshot) => {
+    const lexicalScore = lexicalScoreObjectiveStateSnapshot(snapshot, queryTokens);
+    return {
+      snapshot,
+      lexicalScore,
+      score: scoreObjectiveStateSnapshot(snapshot, lexicalScore, options.sessionKey)
+    };
+  });
+  const filtered = queryTokens.size === 0 ? scored : scored.filter((result) => result.lexicalScore > 0);
+  filtered.sort((left, right) => {
+    if (right.score !== left.score) return right.score - left.score;
+    return right.snapshot.recordedAt.localeCompare(left.snapshot.recordedAt);
+  });
+  return filtered.slice(0, maxResults);
+}
+
+export {
+  resolveObjectiveStateStoreDir,
+  validateObjectiveStateSnapshot,
+  recordObjectiveStateSnapshot,
+  getObjectiveStateStoreStatus,
+  searchObjectiveStateSnapshots
+};
+//# sourceMappingURL=chunk-LOBRX7VD.js.map