@ai-setting/roy-agent-core 1.4.11 → 1.4.12

package/dist/env/session/storage/index.js

@@ -0,0 +1,2049 @@
+// @bun
+var __defProp = Object.defineProperty;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+function __accessProp(key) {
+  return this[key];
+}
+var __toCommonJS = (from) => {
+  var entry = (__moduleCache ??= new WeakMap).get(from), desc;
+  if (entry)
+    return entry;
+  entry = __defProp({}, "__esModule", { value: true });
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (var key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(entry, key))
+        __defProp(entry, key, {
+          get: __accessProp.bind(from, key),
+          enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+        });
+  }
+  __moduleCache.set(from, entry);
+  return entry;
+};
+var __moduleCache;
+var __returnValue = (v) => v;
+function __exportSetter(name, newValue) {
+  this[name] = __returnValue.bind(null, newValue);
+}
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, {
+      get: all[name],
+      enumerable: true,
+      configurable: true,
+      set: __exportSetter.bind(all, name)
+    });
+};
+var __legacyDecorateClassTS = function(decorators, target, key, desc) {
+  var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+  if (typeof Reflect === "object" && typeof Reflect.decorate === "function")
+    r = Reflect.decorate(decorators, target, key, desc);
+  else
+    for (var i = decorators.length - 1;i >= 0; i--)
+      if (d = decorators[i])
+        r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+  return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __esm = (fn, res) => () => (fn && (res = fn(fn = 0)), res);
+var __require = import.meta.require;
+
+// packages/core/src/env/log-trace/span-storage.ts
+var exports_span_storage = {};
+__export(exports_span_storage, {
+  SQLiteSpanStorage: () => SQLiteSpanStorage
+});
+
+class SQLiteSpanStorage {
+  db = null;
+  dbPath;
+  initialized = false;
+  constructor(dbPath) {
+    if (!dbPath) {
+      throw new Error("SQLiteSpanStorage requires a valid dbPath parameter");
+    }
+    if (dbPath === ":memory:") {
+      throw new Error("SQLiteSpanStorage does not support :memory: mode. Use a file path instead.");
+    }
+    this.dbPath = dbPath;
+  }
+  async initialize() {
+    if (this.initialized)
+      return;
+    const { Database } = __require("bun:sqlite");
+    const fs = __require("fs");
+    const path = __require("path");
+    const dir = path.dirname(this.dbPath);
+    if (!fs.existsSync(dir)) {
+      fs.mkdirSync(dir, { recursive: true });
+    }
+    this.db = new Database(this.dbPath);
+    this.db.run("PRAGMA journal_mode=WAL");
+    this.db.run("PRAGMA busy_timeout=5000");
+    this.db.run("PRAGMA synchronous=NORMAL");
+    this.db.run(`
+      CREATE TABLE IF NOT EXISTS span (
+        span_id TEXT PRIMARY KEY,
+        trace_id TEXT NOT NULL,
+        parent_span_id TEXT,
+        name TEXT NOT NULL,
+        kind TEXT NOT NULL,
+        status TEXT NOT NULL,
+        start_time INTEGER NOT NULL,
+        end_time INTEGER,
+        attributes TEXT,
+        result TEXT,
+        error TEXT,
+        time_created INTEGER NOT NULL
+      )
+    `);
+    this.db.run("CREATE INDEX IF NOT EXISTS idx_span_trace ON span(trace_id)");
+    this.db.run("CREATE INDEX IF NOT EXISTS idx_span_parent ON span(parent_span_id)");
+    this.initialized = true;
+  }
+  save(span) {
+    if (!this.db)
+      return;
+    const stmt = this.db.prepare(`
+      INSERT OR REPLACE INTO span 
+      (span_id, trace_id, parent_span_id, name, kind, status, start_time, end_time, attributes, result, error, time_created)
+      VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+    `);
+    const resultValue = span.result !== undefined && span.result !== null ? typeof span.result === "string" ? span.result : JSON.stringify(span.result) : null;
+    stmt.run(span.spanId, span.traceId, span.parentSpanId || null, span.name, span.kind, span.status, span.startTime, span.endTime || null, JSON.stringify(span.attributes), resultValue, span.error || null, Date.now());
+  }
+  saveBatch(spans) {
+    for (const span of spans) {
+      this.save(span);
+    }
+  }
+  findByTraceId(traceId) {
+    if (!this.db)
+      return [];
+    const rows = this.db.prepare("SELECT * FROM span WHERE trace_id = ?").all(traceId);
+    return this.buildTree(rows.map(this.rowToSpan));
+  }
+  findBySpanId(spanId) {
+    if (!this.db)
+      return;
+    const row = this.db.prepare("SELECT * FROM span WHERE span_id = ?").get(spanId);
+    return row ? this.rowToSpan(row) : undefined;
+  }
+  listTraces(limit = 10) {
+    if (!this.db)
+      return [];
+    const rows = this.db.prepare(`
+      SELECT trace_id, 
+             MIN(start_time) as start_time,
+             MAX(end_time) as end_time,
+             COUNT(*) as span_count
+      FROM span 
+      GROUP BY trace_id 
+      ORDER BY start_time DESC 
+      LIMIT ?
+    `).all(limit);
+    return rows.map((row) => ({
+      traceId: row.trace_id,
+      rootSpanName: "unknown",
+      startTime: row.start_time,
+      endTime: row.end_time,
+      duration: row.end_time - row.start_time,
+      spanCount: row.span_count,
+      status: "ok"
+    }));
+  }
+  deleteByTraceId(traceId) {
+    if (this.db) {
+      this.db.prepare("DELETE FROM span WHERE trace_id = ?").run(traceId);
+    }
+  }
+  close() {
+    if (this.db) {
+      this.db.close();
+      this.db = null;
+    }
+  }
+  rowToSpan(row) {
+    return {
+      traceId: row.trace_id,
+      spanId: row.span_id,
+      parentSpanId: row.parent_span_id,
+      name: row.name,
+      kind: row.kind,
+      status: row.status,
+      startTime: row.start_time,
+      endTime: row.end_time,
+      attributes: row.attributes ? JSON.parse(row.attributes) : {},
+      result: row.result || undefined,
+      error: row.error || undefined
+    };
+  }
+  buildTree(spans) {
+    const spanMap = new Map;
+    const roots = [];
+    for (const span of spans) {
+      spanMap.set(span.spanId, { ...span, children: [] });
+    }
+    for (const span of spanMap.values()) {
+      if (span.parentSpanId) {
+        const parent = spanMap.get(span.parentSpanId);
+        if (parent) {
+          parent.children.push(span);
+        } else {
+          roots.push(span);
+        }
+      } else {
+        roots.push(span);
+      }
+    }
+    return roots;
+  }
+}
+
+// packages/core/src/env/log-trace/opentelemetry/propagation.ts
+function padLeft(str, length) {
+  return str.padStart(length, "0");
+}
+function isValidHex(str) {
+  return /^[0-9a-f]+$/i.test(str);
+}
+function serialize(context) {
+  const traceId = padLeft(context.traceId.toLowerCase(), TRACE_ID_LENGTH);
+  const spanId = padLeft(context.spanId.toLowerCase(), PARENT_SPAN_ID_LENGTH);
+  const parts = [
+    TRACE_CONTEXT_VERSION,
+    traceId,
+    spanId,
+    TRACE_FLAGS_SAMPLED
+  ];
+  return parts.join("-");
+}
+function parse(traceparent) {
+  if (!traceparent || typeof traceparent !== "string") {
+    return;
+  }
+  const trimmed = traceparent.trim();
+  const parts = trimmed.split("-");
+  if (parts.length !== 4) {
+    return;
+  }
+  const [version, traceId, senderSpanId, flags] = parts;
+  if (version !== TRACE_CONTEXT_VERSION) {
+    if (version > TRACE_CONTEXT_VERSION) {
+      return;
+    }
+  }
+  if (traceId.length !== TRACE_ID_LENGTH || !isValidHex(traceId)) {
+    return;
+  }
+  if (senderSpanId.length !== PARENT_SPAN_ID_LENGTH || !isValidHex(senderSpanId)) {
+    return;
+  }
+  if (flags.length !== FLAGS_LENGTH || !isValidHex(flags)) {
+    return;
+  }
+  return {
+    traceId: traceId.toLowerCase(),
+    spanId: senderSpanId.toLowerCase()
+  };
+}
+var TRACE_CONTEXT_VERSION = "00", TRACE_FLAGS_SAMPLED = "01", TRACEPARENT_HEADER = "TRACEPARENT", TRACE_ID_LENGTH = 32, PARENT_SPAN_ID_LENGTH = 16, FLAGS_LENGTH = 2, propagation;
+var init_propagation = __esm(() => {
+  propagation = {
+    inject(carrier, context) {
+      carrier[TRACEPARENT_HEADER] = serialize(context);
+    },
+    extract(carrier) {
+      const traceparent = carrier[TRACEPARENT_HEADER];
+      if (!traceparent) {
+        return;
+      }
+      return parse(traceparent);
+    },
+    getTraceparentHeader() {
+      return TRACEPARENT_HEADER;
+    }
+  };
+});
+
+// packages/core/src/env/log-trace/types.ts
+var SpanKind, SpanStatus;
+var init_types = __esm(() => {
+  ((SpanKind2) => {
+    SpanKind2["CLIENT"] = "client";
+    SpanKind2["SERVER"] = "server";
+    SpanKind2["INTERNAL"] = "internal";
+  })(SpanKind ||= {});
+  ((SpanStatus2) => {
+    SpanStatus2["OK"] = "ok";
+    SpanStatus2["ERROR"] = "error";
+  })(SpanStatus ||= {});
+});
+
+// packages/core/src/env/log-trace/opentelemetry/tracer-provider.ts
+var exports_tracer_provider = {};
+__export(exports_tracer_provider, {
+  resetTracerProvider: () => resetTracerProvider,
+  getTracerProvider: () => getTracerProvider,
+  OTelTracerProvider: () => OTelTracerProvider
+});
+
+class OTelSpanImpl {
+  name;
+  kind;
+  spanContext;
+  attributes = {};
+  startTime;
+  endTime;
+  error;
+  storage;
+  parentSpanContext;
+  onEnd;
+  constructor(name, spanContext, storage, parentSpanContext, onEnd) {
+    this.name = name;
+    this.kind = "internal";
+    this.spanContext = spanContext;
+    this.parentSpanContext = parentSpanContext;
+    this.startTime = Date.now();
+    this.storage = storage;
+    this.onEnd = onEnd;
+  }
+  setAttribute(key, value) {
+    this.attributes[key] = value;
+  }
+  addEvent(name, attributes) {
+    const events = this.attributes._events || [];
+    events.push({ name, attributes });
+    this.attributes._events = events;
+  }
+  end(result, error) {
+    this.endTime = Date.now();
+    if (error) {
+      this.error = error.message;
+    }
+    this.storage.save({
+      traceId: this.spanContext.traceId,
+      spanId: this.spanContext.spanId,
+      parentSpanId: this.spanContext.parentSpanId,
+      name: this.name,
+      kind: this.kind,
+      status: error ? "error" /* ERROR */ : "ok" /* OK */,
+      startTime: this.startTime,
+      endTime: this.endTime,
+      attributes: this.attributes,
+      result,
+      error: this.error
+    });
+    this.onEnd?.();
+  }
+}
+
+class OTelTracerImpl {
+  name;
+  version;
+  storage;
+  currentContext;
+  activeSpans = new Map;
+  onSpanEndCallback;
+  provider;
+  constructor(name, version, storage, provider) {
+    this.name = name;
+    this.version = version;
+    this.storage = storage;
+    this.provider = provider;
+  }
+  setOnSpanEndCallback(callback) {
+    this.onSpanEndCallback = callback;
+  }
+  getActiveSpanCount() {
+    return this.activeSpans.size;
+  }
+  startSpan(name, options) {
+    const parentFromOptions = options?.parent;
+    const hasExplicitParent = options && "parent" in options;
+    const globalContext = this.provider.getGlobalContext();
+    let effectiveParentContext;
+    if (hasExplicitParent) {
+      effectiveParentContext = parentFromOptions;
+    } else if (this.currentContext) {
+      effectiveParentContext = this.currentContext;
+    } else if (globalContext) {
+      effectiveParentContext = globalContext;
+    }
+    const traceId = effectiveParentContext?.traceId || this.generateTraceId();
+    const spanId = this.generateSpanId();
+    let parentSpanId;
+    if (hasExplicitParent && parentFromOptions) {
+      parentSpanId = parentFromOptions.parentSpanId || parentFromOptions.spanId;
+    } else if (this.currentContext) {
+      parentSpanId = this.currentContext.spanId;
+    } else if (globalContext) {
+      parentSpanId = globalContext.spanId;
+    }
+    const spanContext = {
+      traceId,
+      spanId,
+      parentSpanId
+    };
+    this.currentContext = {
+      traceId,
+      spanId,
+      parentSpanId
+    };
+    const span = new OTelSpanImpl(name, spanContext, this.storage, effectiveParentContext, () => this.handleSpanEnd(spanContext.spanId, effectiveParentContext?.spanId));
+    if (options?.attributes) {
+      for (const [key, value] of Object.entries(options.attributes)) {
+        span.setAttribute(key, value);
+      }
+    }
+    this.activeSpans.set(spanId, span);
+    return span;
+  }
+  injectToEnv(env) {
+    if (this.currentContext) {
+      propagation.inject(env, this.currentContext);
+    }
+  }
+  getCurrentContext() {
+    return this.currentContext;
+  }
+  setCurrentContext(context) {
+    this.currentContext = context;
+  }
+  endSpan(span) {
+    const spanContext = span.spanContext;
+    this.activeSpans.delete(spanContext.spanId);
+    const currentTraceId = this.currentContext?.traceId;
+    if (spanContext.parentSpanId) {
+      const parentSpan = this.activeSpans.get(spanContext.parentSpanId);
+      if (parentSpan) {
+        const parentContext = {
+          traceId: spanContext.traceId,
+          spanId: parentSpan.spanContext.spanId,
+          parentSpanId: parentSpan.spanContext.parentSpanId
+        };
+        this.currentContext = parentContext;
+        return parentContext;
+      }
+      if (currentTraceId) {
+        const parentContext = {
+          traceId: currentTraceId,
+          spanId: spanContext.parentSpanId,
+          parentSpanId: undefined
+        };
+        this.currentContext = parentContext;
+        return parentContext;
+      }
+    }
+    this.currentContext = undefined;
+    return;
+  }
+  generateTraceId() {
+    const timestamp = Date.now().toString(16).padStart(12, "0");
+    const random = Array.from({ length: 5 }, () => Math.floor(Math.random() * 4294967295).toString(16).padStart(8, "0")).join("");
+    return (timestamp + random).slice(0, 32).padStart(32, "0");
+  }
+  generateSpanId() {
+    return Math.floor(Math.random() * 18446744073709552000).toString(16).padStart(16, "0");
+  }
+  handleSpanEnd(spanId, parentSpanId) {
+    this.activeSpans.delete(spanId);
+    const currentTraceId = this.currentContext?.traceId;
+    if (parentSpanId) {
+      const parentSpan = this.activeSpans.get(parentSpanId);
+      if (parentSpan) {
+        this.currentContext = {
+          traceId: parentSpan.spanContext.traceId,
+          spanId: parentSpan.spanContext.spanId,
+          parentSpanId: parentSpan.spanContext.parentSpanId
+        };
+        return;
+      }
+      if (currentTraceId) {
+        this.currentContext = {
+          traceId: currentTraceId,
+          spanId: parentSpanId,
+          parentSpanId: undefined
+        };
+        return;
+      }
+    }
+    this.currentContext = undefined;
+  }
+}
+
+class OTelTracerProvider {
+  tracers = new Map;
+  storage;
+  initialized = false;
+  globalContext;
+  constructor(storage, dbPath) {
+    this.storage = storage || new SQLiteSpanStorage(dbPath || getDefaultDbPath());
+  }
+  async initialize() {
+    if (this.initialized)
+      return;
+    await this.storage.initialize();
+    this.initialized = true;
+  }
+  isInitialized() {
+    return this.initialized;
+  }
+  getGlobalContext() {
+    return this.globalContext;
+  }
+  setGlobalContext(context) {
+    this.globalContext = context;
+  }
+  getTracer(name, version) {
+    const key = `${name}@${version || "0.0.0"}`;
+    let tracer = this.tracers.get(key);
+    if (!tracer) {
+      tracer = new OTelTracerImpl(name, version, this.storage, this);
+      this.tracers.set(key, tracer);
+      if (this.initialized) {
+        this.restoreFromEnv(tracer);
+      }
+    }
+    return tracer;
+  }
+  restoreFromEnv(tracer) {
+    const extracted = propagation.extract(process.env);
+    if (extracted) {
+      tracer.setCurrentContext({
+        traceId: extracted.traceId,
+        spanId: extracted.spanId,
+        parentSpanId: undefined
+      });
+    }
+  }
+  shutdown() {
+    for (const tracer of this.tracers.values()) {}
+    this.tracers.clear();
+    this.storage.close();
+    this.initialized = false;
+    this.globalContext = undefined;
+    delete process.env["TRACEPARENT"];
+    delete process.env["TRACE_ID"];
+    delete process.env["LOG_TRACE_REQUEST_ID"];
+  }
+  getStorage() {
+    return this.storage;
+  }
+}
+function getTracerProvider() {
+  if (!providerInstance) {
+    providerInstance = new OTelTracerProvider;
+  }
+  return providerInstance;
+}
+function resetTracerProvider() {
+  if (providerInstance) {
+    providerInstance.shutdown();
+    providerInstance = null;
+  }
+}
+function getDefaultDbPath() {
+  const os = __require("os");
+  const path = __require("path");
+  const home = os.homedir();
+  const dataHome = process.env.XDG_DATA_HOME || path.join(home, ".local", "share");
+  return path.join(dataHome, "roy-agent", "traces.db");
+}
+var providerInstance = null;
+var init_tracer_provider = __esm(() => {
+  init_propagation();
+  init_types();
+});
+
+// packages/core/src/env/log-trace/logger.ts
+import { appendFileSync, existsSync, mkdirSync } from "fs";
+import { join } from "path";
+function simplifyFilePath(fullPath) {
+  let path = fullPath.replace(/\\/g, "/");
+  const bunfsMatch = path.match(/\/\$bunfs\/root\/(.+)$/);
+  if (bunfsMatch) {
+    const virtualPath = bunfsMatch[1];
+    const packagesMatch = virtualPath.match(/(packages\/[^/]+\/src\/[^/]+\/.+)$/);
+    if (packagesMatch) {
+      return packagesMatch[1];
+    }
+    return virtualPath;
+  }
+  const fileProtocolMatch = path.match(/@roy-agent\+core@file\+([^/]+)\/node_modules\/@roy-agent\/core\/(.+)$/);
+  if (fileProtocolMatch) {
+    const rootPkg = fileProtocolMatch[1].replace(/\+/g, "/");
+    const remaining = fileProtocolMatch[2];
+    const prefix = rootPkg;
+    const suffix = remaining.startsWith("src/") ? remaining : `src/${remaining}`;
+    return `${prefix}/${suffix}`;
+  }
+  const packagesRootMatch = path.match(/(packages\/[^/]+\/src\/[^/]+\/.+)$/);
+  if (packagesRootMatch) {
+    return packagesRootMatch[1];
+  }
+  const rootMarkers = ["packages/core/src", "packages/core", "packages"];
+  for (const marker of rootMarkers) {
+    const idx = path.indexOf(marker);
+    if (idx !== -1) {
+      return path.substring(idx);
+    }
+  }
+  return path;
+}
+function getDefaultLogDir() {
+  const home = process.env.HOME || process.env.USERPROFILE || "/tmp";
+  try {
+    const xdg = __require("xdg-basedir");
+    if (xdg.xdgData) {
+      return join(xdg.xdgData, "roy-agent", "logs");
+    }
+  } catch {}
+  return join(home, ".local", "share", "roy-agent", "logs");
+}
+function isQuietMode() {
+  return quietMode;
+}
+function setQuietMode(enabled) {
+  quietMode = enabled;
+}
+function setConfigComponent(component) {
+  configComponentInstance = component;
+}
+function getLogLevel() {
+  if (configComponentInstance) {
+    const level = configComponentInstance.get("log_trace.logging.level");
+    if (level && ["debug", "info", "warn", "error"].includes(level)) {
+      return level;
+    }
+  }
+  const envLevel = process.env.LOG_LEVEL;
+  if (envLevel && ["debug", "info", "warn", "error"].includes(envLevel)) {
+    return envLevel;
+  }
+  return "info";
+}
+function getCategoryLogLevel(category) {
+  if (configComponentInstance) {
+    const levels = configComponentInstance.get("log_trace.logging.levels");
+    if (levels && typeof levels === "object") {
+      const categoryLevel = levels[category];
+      if (categoryLevel && ["debug", "info", "warn", "error"].includes(categoryLevel)) {
+        return categoryLevel;
+      }
+    }
+    const directLevel = configComponentInstance.get(`log_trace.logging.levels.${category}`);
+    if (directLevel && ["debug", "info", "warn", "error"].includes(directLevel)) {
+      return directLevel;
+    }
+  }
+  const envKey = `LOG_LEVEL_${category.toUpperCase().replace(/:/g, "_")}`;
+  const envLevel = process.env[envKey];
+  if (envLevel && ["debug", "info", "warn", "error"].includes(envLevel)) {
+    return envLevel;
+  }
+  return getLogLevel();
+}
+function isAbsolutePath(path) {
+  if (path.startsWith("/")) {
+    return true;
+  }
+  if (/^[a-zA-Z]:[/\\]/.test(path)) {
+    return true;
+  }
+  return false;
+}
+function expandHomeDir(path) {
+  if (path.startsWith("~")) {
+    const home = process.env.HOME || process.env.USERPROFILE || "/tmp";
+    return join(home, path.slice(1));
+  }
+  return path;
+}
+function getLogFile() {
+  if (configComponentInstance) {
+    const file = configComponentInstance.get("log_trace.logging.file");
+    if (file) {
+      return file;
+    }
+  }
+  return "app.log";
+}
+function getLogDir() {
+  if (configComponentInstance) {
+    const dir = configComponentInstance.get("log_trace.logging.dir");
+    if (dir) {
+      return dir;
+    }
+  }
+  return getDefaultLogDir();
+}
+function getMaxOutput() {
+  if (configComponentInstance) {
+    const maxOutput = configComponentInstance.get("log-trace.logging.maxOutput");
+    if (typeof maxOutput === "number") {
+      return maxOutput;
+    }
+  }
+  return;
+}
+function setLogDirOverride(dir) {
+  logDirOverride = dir;
+}
+function getLogDirOverride() {
+  return logDirOverride;
+}
+
+class Logger {
+  prefix;
+  constructor(prefix) {
+    this.prefix = prefix;
+  }
+  shouldLog(level) {
+    const categoryLevel = getCategoryLogLevel(this.prefix);
+    return levelPriority[level] >= levelPriority[categoryLevel];
+  }
+  ensureLogDirectory(dir) {
+    if (!existsSync(dir)) {
+      try {
+        mkdirSync(dir, { recursive: true });
+      } catch (err) {
+        console.error("[Logger] Failed to create log directory:", dir, err);
+      }
+    }
+  }
+  getCallerLocation() {
+    const originalLimit = Error.stackTraceLimit;
+    Error.stackTraceLimit = 10;
+    const err = new Error;
+    Error.captureStackTrace(err, this.formatMessage);
+    const stack = err.stack?.split(`
+`) || [];
+    Error.stackTraceLimit = originalLimit;
+    for (let i = 1;i < stack.length; i++) {
+      const line = stack[i];
+      if (line.includes("at ") && !line.includes("logger.ts") && !line.includes("formatMessage")) {
+        const match = line.match(/at\s+.+\s+\((.+):(\d+):\d+\)/) || line.match(/at\s+(.+):(\d+):\d+/);
+        if (match) {
+          const filePath = match[1];
+          const relativePath = this.getRelativePath(filePath);
+          return {
+            file: relativePath,
+            line: parseInt(match[2], 10)
+          };
+        }
+      }
+    }
+    return null;
+  }
+  getRelativePath(fullPath) {
+    return simplifyFilePath(fullPath);
+  }
+  formatMessage(level, message, data) {
+    const now = new Date;
+    const timestamp = now.toLocaleString("zh-CN", {
+      timeZone: "Asia/Shanghai",
+      year: "numeric",
+      month: "2-digit",
+      day: "2-digit",
+      hour: "2-digit",
+      minute: "2-digit",
+      second: "2-digit",
+      hour12: false
+    }).replace(/\//g, "-") + "." + String(now.getMilliseconds()).padStart(3, "0");
+    const prefix = this.prefix ? `[${this.prefix}]` : "";
+    let traceIdStr = "";
+    try {
+      const provider = getTracerProvider();
+      const tracer = provider.getTracer("roy-tracer");
+      const context = tracer.getCurrentContext();
+      if (context?.traceId) {
+        traceIdStr = `[traceId=${context.traceId}]`;
+      }
+    } catch {}
+    let locationStr = "";
+    if (data && typeof data === "object" && "callerLocation" in data) {
+      const logData = data;
+      locationStr = logData.callerLocation ? ` [${logData.callerLocation}]` : "";
+      const { callerLocation: _callerLocation, ...rest } = logData;
+      data = Object.keys(rest).length > 0 ? rest : undefined;
+    } else {
+      const location = this.getCallerLocation();
+      if (location) {
+        locationStr = ` [${location.file}:${location.line}]`;
+      }
+    }
+    let formatted = `${timestamp} [${level.toUpperCase()}]${traceIdStr}${locationStr}${prefix} ${message}`;
+    if (data !== undefined) {
+      if (typeof data === "object") {
+        formatted += " " + JSON.stringify(data).replace(/\n/g, "");
+      } else {
+        formatted += " " + String(data);
+      }
+    }
+    const maxOutput = getMaxOutput();
+    if (maxOutput && maxOutput > 0 && formatted.length > maxOutput) {
+      formatted = formatted.substring(0, maxOutput) + " [TRUNCATED]";
+    }
+    return formatted;
+  }
+  writeToFile(message) {
+    try {
+      const dir = getLogDir();
+      const filename = getLogFile();
+      const expandedDir = expandHomeDir(dir);
+      const resolvedDir = isAbsolutePath(expandedDir) ? expandedDir : join(process.cwd(), expandedDir);
+      this.ensureLogDirectory(resolvedDir);
+      const logFile = join(resolvedDir, filename);
+      appendFileSync(logFile, message + `
+`, "utf-8");
+    } catch (err) {
+      console.error("[Logger] Failed to write to log file:", err);
+    }
+  }
+  log(level, message, data) {
+    if (!this.shouldLog(level))
+      return;
+    const formatted = this.formatMessage(level, message, data);
+    this.writeToFile(formatted);
+    if (!isQuietMode()) {
+      const consoleMethod = level === "error" ? console.error : level === "warn" ? console.warn : level === "info" ? console.log : console.debug;
+      consoleMethod(formatted);
+    }
+  }
+  debug(message, data) {
+    this.log("debug", message, data);
+  }
+  info(message, data) {
+    this.log("info", message, data);
+  }
+  warn(message, data) {
+    this.log("warn", message, data);
+  }
+  error(message, data) {
+    this.log("error", message, data);
+  }
+}
+function createLogger(prefix) {
+  if (!loggerCache.has(prefix)) {
+    loggerCache.set(prefix, new Logger(prefix));
+  }
+  return loggerCache.get(prefix);
+}
+function getLogLevels() {
+  return ["debug", "info", "warn", "error"];
+}
+var configComponentInstance = null, quietMode = false, logDirOverride, levelPriority, loggerCache;
+var init_logger = __esm(() => {
+  init_tracer_provider();
+  levelPriority = {
+    debug: 0,
+    info: 1,
+    warn: 2,
+    error: 3
+  };
+  loggerCache = new Map;
+});
+
+// packages/core/src/env/log-trace/decorator.ts
+function Traced(options) {
+  return function(target, propertyKey, descriptor) {
+    const originalFn = descriptor.value;
+    const spanName = options?.name || propertyKey;
+    descriptor.value = wrapFunction(originalFn, spanName, {
+      recordParams: options?.recordParams ?? true,
+      recordResult: options?.recordResult ?? false,
+      recordError: options?.recordError ?? true,
+      log: options?.log ?? false,
+      maxLogSize: options?.maxLogSize,
+      paramFilter: options?.paramFilter
+    });
+    return descriptor;
+  };
+}
+function TracedAs(name, options) {
+  return Traced({ name, ...options });
+}
+function TracedLightweight(options) {
+  return Traced({ recordParams: false, recordResult: false, log: options?.log ?? false, maxLogSize: options?.maxLogSize });
+}
+function wrapFunction(fn, name, options) {
+  const shouldLog = options?.log ?? false;
+  const getMaxLogSize = () => {
+    if (options?.maxLogSize !== undefined) {
+      return options.maxLogSize;
+    }
+    const configMaxOutput = getMaxOutput();
+    return configMaxOutput !== undefined ? configMaxOutput : 500;
+  };
+  const truncate = (obj) => {
+    if (obj === undefined)
+      return;
+    if (obj === null)
+      return null;
+    const maxLogSize = getMaxLogSize();
+    let str;
+    try {
+      str = typeof obj === "string" ? obj : JSON.stringify(obj, null, 0).replace(/\n/g, "");
+    } catch (e) {
+      str = `[Object with circular reference: ${e instanceof Error ? e.message : String(e)}]`;
+    }
+    if (maxLogSize > 0 && str.length > maxLogSize) {
+      return str.slice(0, maxLogSize) + " [TRUNCATED]";
+    }
+    try {
+      return JSON.parse(str);
+    } catch {
+      return str;
+    }
+  };
+  const truncateString = (obj) => {
+    if (obj === undefined)
+      return "undefined";
+    if (obj === null)
+      return "null";
+    const maxLogSize = getMaxLogSize();
+    let str;
+    try {
+      str = typeof obj === "string" ? obj : JSON.stringify(obj, null, 0).replace(/\n/g, "");
+    } catch (e) {
+      str = `[Object with circular reference: ${e instanceof Error ? e.message : String(e)}]`;
+    }
+    return maxLogSize > 0 && str.length > maxLogSize ? str.slice(0, maxLogSize) + " [TRUNCATED]" : str;
+  };
+  const TRACE_LOG_PREFIX = "[TRACE]";
+  const getCallerLocation = () => {
+    const originalLimit = Error.stackTraceLimit;
+    Error.stackTraceLimit = 15;
+    const err = new Error;
+    Error.captureStackTrace(err, getCallerLocation);
+    const stack = err.stack?.split(`
+`) || [];
+    Error.stackTraceLimit = originalLimit;
+    for (let i = 1;i < stack.length; i++) {
+      const line = stack[i];
+      if (line.includes("decorator.ts") || line.includes("decorator.js") || line.includes("logFn") || line.includes("getCallerLocation"))
+        continue;
+      const match = line.match(/at\s+.+\s+\((.+):(\d+):\d+\)/) || line.match(/at\s+(.+):(\d+):\d+/);
+      if (match) {
+        const filePath = match[1];
+        if (!filePath || filePath === "native")
+          continue;
+        const relativePath = simplifyFilePath(filePath);
+        return `${relativePath}:${match[2]}`;
+      }
+    }
+    return "";
+  };
+  const logFn = (event, argsOrData, callerLocation) => {
+    if (!shouldLog)
+      return;
+    const logger = createLogger("traced:" + name);
+    const tag = event === "enter" ? ">>>" : event === "quit" ? "<<<" : "!!!";
+    const prefix = `${TRACE_LOG_PREFIX} ${tag} ${name}`;
+    const originalFnLocation = callerLocation || getCallerLocation();
+    const logMessage = (msg, data) => {
+      if (data !== undefined) {
+        logger.info(`${prefix} ${msg}: ${truncateString(data)}`, { callerLocation: originalFnLocation });
+      } else {
+        logger.info(`${prefix} ${msg}`, { callerLocation: originalFnLocation });
+      }
+    };
+    if (event === "enter") {
+      logMessage("enter", argsOrData);
+    } else if (event === "quit") {
+      logMessage("quit", options?.recordResult ? argsOrData : undefined);
+    } else {
+      logMessage("error", argsOrData);
+    }
+  };
+  return function(...args) {
+    const tracer = getTracerProvider().getTracer("roy-tracer");
+    const attributes = {};
+    if (options?.recordParams !== false) {
+      if (options?.paramFilter) {
+        attributes["params"] = truncate(options.paramFilter(args));
+      } else {
+        attributes["params"] = truncate(args);
+      }
+    }
+    const callerLocation = getCallerLocation();
+    logFn("enter", args, callerLocation);
+    const span = tracer.startSpan(name, { attributes });
+    try {
+      const result = fn.call(this, ...args);
+      if (result && typeof result === "object" && typeof result.then === "function") {
+        return result.then((resolved) => {
+          span.setAttribute("result", JSON.stringify(truncate(resolved)));
+          span.end(resolved);
+          logFn("quit", options?.recordResult ? resolved : undefined, callerLocation);
+          return resolved;
+        }, (rejected) => {
+          span.setAttribute("error", String(rejected));
+          span.end(undefined, rejected instanceof Error ? rejected : new Error(String(rejected)));
+          logFn("error", rejected.message, callerLocation);
+          throw rejected;
+        });
+      }
+      span.setAttribute("result", JSON.stringify(truncate(result)));
+      span.end(result);
+      logFn("quit", options?.recordResult ? result : undefined, callerLocation);
+      return result;
+    } catch (error) {
+      span.setAttribute("error", String(error));
+      span.end(undefined, error instanceof Error ? error : new Error(String(error)));
+      logFn("error", error.message, callerLocation);
+      throw error;
+    }
+  };
+}
+var init_decorator = __esm(() => {
+  init_tracer_provider();
+  init_logger();
+});
+
+// packages/core/src/env/session/session-message-converter.ts
+init_decorator();
+import { randomUUID } from "crypto";
+var DEFAULT_REASONING_BUDGET_TOKENS = 1e4;
+
+class SessionMessageConverter {
+  toModelMessage(msg) {
+    if (msg.role === "assistant") {
+      const content = [];
+      for (const part of msg.parts || []) {
+        if (part.type === "text") {
+          const textPart = part;
+          content.push({
+            type: "text",
+            text: textPart.content,
+            ...textPart.synthetic !== undefined && { synthetic: textPart.synthetic }
+          });
+        } else if (part.type === "reasoning") {
+          const reasoningPart = part;
+          content.push({
+            type: "reasoning",
+            text: reasoningPart.content,
+            reasoningType: reasoningPart.reasoningType
+          });
+        } else if (part.type === "tool-call") {
+          const toolPart = part;
+          let parsedArgs = {};
+          if (typeof toolPart.arguments === "string") {
+            try {
+              parsedArgs = JSON.parse(toolPart.arguments);
+            } catch {
+              parsedArgs = { _raw: toolPart.arguments };
+            }
+          } else {
+            parsedArgs = toolPart.arguments;
+          }
+          content.push({
+            type: "tool-call",
+            toolCallId: toolPart.toolCallId,
+            toolName: toolPart.toolName,
+            input: parsedArgs
+          });
+        } else if (part.type === "file") {
+          const filePart = part;
+          content.push({
+            type: "file",
+            url: filePart.url,
+            mimeType: filePart.mime,
+            filename: filePart.filename
+          });
+        } else if (part.type === "tool-result" || part.type === "checkpoint") {} else {
+          console.debug(`[session-message-converter] Skipping unsupported part type in assistant: ${part.type}`);
+        }
+      }
+      if (content.length === 0 && msg.content) {
+        return { role: "assistant", content: msg.content };
+      }
+      return { role: "assistant", content };
+    }
+    if (msg.role === "tool") {
+      const toolPart = msg.parts?.find((p) => p.type === "tool-result");
+      return {
+        role: "tool",
+        content: [{
+          type: "tool-result",
+          toolCallId: toolPart?.toolCallId || "",
+          toolName: toolPart?.toolName || "",
+          output: toolPart?.output || msg.content || ""
+        }]
+      };
+    }
+    return {
+      role: msg.role,
+      content: msg.content || ""
+    };
+  }
+  fromModelMessage(aiMsg, options) {
+    const parts = [];
+    const content = typeof aiMsg.content === "string" || Array.isArray(aiMsg.content) ? aiMsg.content : "";
+    let hasToolCallPart = false;
+    let hasToolResultPart = false;
+    if (typeof content === "string") {
+      parts.push({ type: "text", content });
+    } else if (Array.isArray(content)) {
+      for (const part of content) {
+        const p = part;
+        if (p.type === "text") {
+          parts.push({ type: "text", content: p.text || "" });
+        } else if (p.type === "reasoning") {
+          parts.push({
+            type: "reasoning",
+            content: p.text || "",
+            reasoningType: p.reasoningType,
+            state: "completed"
+          });
+        } else if (p.type === "tool-call") {
+          hasToolCallPart = true;
+          parts.push({
+            type: "tool-call",
+            toolCallId: p.toolCallId,
+            toolName: p.toolName,
+            arguments: p.input,
+            state: "pending"
+          });
+        } else if (p.type === "tool-result") {
+          hasToolResultPart = true;
+          parts.push({
+            type: "tool-result",
+            toolCallId: p.toolCallId,
+            toolName: p.toolName,
+            output: typeof p.output === "string" ? p.output : JSON.stringify(p.output),
+            state: "completed"
+          });
+        } else if (p.type === "file") {
+          parts.push({
+            type: "file",
+            mime: p.mimeType || "application/octet-stream",
+            url: p.url,
+            filename: p.filename
+          });
+        } else {
+          console.debug(`[session-message-converter] Unknown part type: ${p.type}`);
+        }
+      }
+    }
+    let metadataType;
+    if (aiMsg.role === "assistant" && hasToolCallPart) {
+      metadataType = "tool_call";
+    } else if (aiMsg.role === "tool") {
+      metadataType = "tool_result";
+    }
+    const result = {
+      id: options?.messageID || `msg_${randomUUID()}`,
+      sessionID: options?.sessionID || "",
+      role: aiMsg.role,
+      timestamp: Date.now(),
+      parts,
+      content: typeof content === "string" ? content : ""
+    };
+    if (metadataType) {
+      result.metadata = { type: metadataType };
+    }
+    return result;
+  }
+  sessionToHistory(messages) {
+    return messages.filter((msg) => !msg.metadata?.isArchived && !msg.isArchived).map((msg) => this.toModelMessage(msg));
+  }
+  extractProviderOptions(msg) {
+    const options = {};
+    const reasoningParts = msg.parts?.filter((p) => p.type === "reasoning");
+    if (reasoningParts && reasoningParts.length > 0) {
+      const firstReasoning = reasoningParts[0];
+      if (firstReasoning.reasoningType) {
+        options.openai = {
+          thinking: {
+            type: firstReasoning.reasoningType === "effort" ? "extended" : "core"
+          }
+        };
+        if (firstReasoning.reasoningType === "effort") {
+          const budgetTokens = firstReasoning.metadata?.tokenCount || DEFAULT_REASONING_BUDGET_TOKENS;
+          options.anthropic = {
+            thinking: {
+              type: "enabled",
+              budgetTokens
+            }
+          };
+        }
+      }
+    }
+    return options;
+  }
+  migrateMessage(oldMsg) {
+    if (oldMsg.parts && oldMsg.parts.length > 0) {
+      const firstPart = oldMsg.parts[0];
+      if (firstPart && typeof firstPart.type === "string" && firstPart.type.length > 0) {
+        return {
+          ...oldMsg,
+          content: oldMsg.content || ""
+        };
+      }
+    }
+    return {
+      ...oldMsg,
+      content: oldMsg.content || "",
+      parts: oldMsg.content ? [{ type: "text", content: oldMsg.content }] : []
+    };
+  }
+}
+__legacyDecorateClassTS([
+  TracedAs("session-message-converter.toModelMessage", { recordParams: true, recordResult: true, log: true })
+], SessionMessageConverter.prototype, "toModelMessage", null);
+__legacyDecorateClassTS([
+  TracedAs("session-message-converter.fromModelMessage", { recordParams: true, recordResult: true, log: true })
+], SessionMessageConverter.prototype, "fromModelMessage", null);
+
+// packages/core/src/env/session/storage/memory.ts
+import { randomUUID as randomUUID2 } from "crypto";
+function generateSessionId() {
+  return `session_${randomUUID2()}`;
+}
+function generateMessageId() {
+  return `msg_${randomUUID2()}`;
+}
+
+class MemorySessionStore {
+  sessions = new Map;
+  messages = new Map;
+  checkpoints = new Map;
+  messageConverter = new SessionMessageConverter;
+  async create(options) {
+    const now = Date.now();
+    const session = {
+      id: options.id ?? generateSessionId(),
+      title: options.title ?? "Session",
+      directory: options.directory ?? "/tmp",
+      parentID: options.parentID,
+      createdAt: now,
+      updatedAt: now,
+      messageCount: 0,
+      metadata: {
+        ...options.metadata,
+        messageCount: 0,
+        checkpoints: { checkpoints: [] }
+      }
+    };
+    if (this.sessions.has(session.id)) {
+      throw new Error(`Session with ID '${session.id}' already exists`);
+    }
+    this.sessions.set(session.id, session);
+    this.messages.set(session.id, []);
+    this.checkpoints.set(session.id, []);
+    return session;
+  }
+  async get(id) {
+    return this.sessions.get(id);
+  }
+  async list(options) {
+    let sessions = Array.from(this.sessions.values());
+    if (options?.filter?.metadata) {
+      sessions = sessions.filter((s) => {
+        for (const [key, value] of Object.entries(options.filter.metadata)) {
+          if (s.metadata?.[key] !== value)
+            return false;
+        }
+        return true;
+      });
+    }
+    if (options?.filter?.startTime) {
+      sessions = sessions.filter((s) => s.createdAt >= options.filter.startTime);
+    }
+    if (options?.filter?.endTime) {
+      sessions = sessions.filter((s) => s.createdAt <= options.filter.endTime);
+    }
+    const sortField = options?.sort?.field ?? "updatedAt";
+    const sortOrder = options?.sort?.order ?? "desc";
+    sessions.sort((a, b) => {
+      let aVal;
+      let bVal;
+      if (sortField === "title") {
+        aVal = a.title;
+        bVal = b.title;
+      } else if (sortField === "createdAt") {
+        aVal = a.createdAt;
+        bVal = b.createdAt;
+      } else {
+        aVal = a.updatedAt;
+        bVal = b.updatedAt;
+      }
+      if (aVal < bVal)
+        return sortOrder === "asc" ? -1 : 1;
+      if (aVal > bVal)
+        return sortOrder === "asc" ? 1 : -1;
+      return 0;
+    });
+    const offset = options?.offset ?? 0;
+    const limit = options?.limit ?? 100;
+    return sessions.slice(offset, offset + limit);
+  }
+  async update(id, updates) {
+    const session = this.sessions.get(id);
+    if (!session)
+      return false;
+    if (updates.title !== undefined) {
+      session.title = updates.title;
+    }
+    if (updates.metadata !== undefined) {
+      session.metadata = { ...session.metadata, ...updates.metadata };
+    }
+    session.updatedAt = Date.now();
+    return true;
+  }
+  async delete(id) {
+    const deleted = this.sessions.delete(id);
+    if (deleted) {
+      this.messages.delete(id);
+      this.checkpoints.delete(id);
+    }
+    return deleted;
+  }
+  async getCount() {
+    return this.sessions.size;
+  }
+  async addMessage(sessionId, message) {
+    const session = this.sessions.get(sessionId);
+    if (!session) {
+      throw new Error(`Session not found: ${sessionId}`);
+    }
+    const rawMessage = {
+      sessionID: sessionId,
+      role: message.role,
+      content: message.content,
+      parts: message.parts,
+      metadata: message.metadata
+    };
+    const msg = this.messageConverter.migrateMessage(rawMessage);
+    msg.id = generateMessageId();
+    msg.timestamp = Date.now();
+    const sessionMessages = this.messages.get(sessionId) ?? [];
+    sessionMessages.push(msg);
+    this.messages.set(sessionId, sessionMessages);
+    session.messageCount = sessionMessages.filter((m) => !m.isArchived).length;
+    session.metadata = {
+      ...session.metadata,
+      messageCount: session.messageCount
+    };
+    session.updatedAt = Date.now();
+    return msg.id;
+  }
+  async getMessages(sessionId, offset = 0, limit = 50, options) {
+    let messages = this.messages.get(sessionId) ?? [];
+    if (!options?.includeArchived) {
+      messages = messages.filter((m) => !m.isArchived);
+    }
+    if (options?.fromCheckpointId) {
+      const checkpoint = await this.getCheckpoint(sessionId, options.fromCheckpointId);
+      if (checkpoint) {
+        const checkpointIndex = messages.findIndex((m) => m.metadata?.checkpointId === options.fromCheckpointId);
+        if (checkpointIndex >= 0) {
+          messages = messages.slice(checkpointIndex);
+        }
+      }
+    }
+    let actualOffset = offset;
+    if (offset < 0) {
+      const total = messages.length;
+      actualOffset = Math.max(0, total + offset * limit);
+    }
+    if (options?.reverse) {
+      messages = messages.reverse();
+    }
+    return messages.slice(actualOffset, actualOffset + limit);
+  }
+  async getMessageCount(sessionId, includeArchived = false) {
+    const messages = this.messages.get(sessionId) ?? [];
+    if (includeArchived) {
+      return messages.length;
+    }
+    return messages.filter((m) => !m.isArchived).length;
+  }
+  async getMessageIndexes(sessionId, role) {
+    const messages = this.messages.get(sessionId) ?? [];
+    const indexes = [];
+    messages.filter((m) => !m.isArchived).forEach((msg, filteredIdx) => {
+      if (msg.role === role) {
+        indexes.push(filteredIdx);
+      }
+    });
+    return indexes;
+  }
+  async saveCheckpoint(sessionId, checkpoint) {
+    const session = this.sessions.get(sessionId);
+    if (!session) {
+      throw new Error(`Session not found: ${sessionId}`);
+    }
+    const cps = this.checkpoints.get(sessionId) ?? [];
+    cps.push(checkpoint);
+    this.checkpoints.set(sessionId, cps);
+    const meta = session.metadata || {};
+    const checkpointsMeta = meta.checkpoints || { checkpoints: [] };
+    checkpointsMeta.checkpoints.push({
+      id: checkpoint.id,
+      messageIndex: checkpoint.messageIndex,
+      title: checkpoint.title,
+      createdAt: checkpoint.createdAt,
+      type: checkpoint.type
+    });
+    checkpointsMeta.latestCheckpointId = checkpoint.id;
+    meta.checkpoints = checkpointsMeta;
+    if (!meta.checkpointDetails) {
+      meta.checkpointDetails = {};
+    }
+    meta.checkpointDetails[checkpoint.id] = checkpoint;
+    session.metadata = meta;
+    session.updatedAt = Date.now();
+  }
+  async getCheckpoints(sessionId) {
+    return this.checkpoints.get(sessionId) ?? [];
+  }
+  async getCheckpoint(sessionId, checkpointId) {
+    const cps = this.checkpoints.get(sessionId) ?? [];
+    return cps.find((cp) => cp.id === checkpointId);
+  }
+  async deleteCheckpoint(sessionId, checkpointId) {
+    const session = this.sessions.get(sessionId);
+    if (!session)
+      return false;
+    const cps = this.checkpoints.get(sessionId) ?? [];
+    const index = cps.findIndex((cp) => cp.id === checkpointId);
+    if (index === -1)
+      return false;
+    cps.splice(index, 1);
+    this.checkpoints.set(sessionId, cps);
+    const messages = this.messages.get(sessionId) ?? [];
+    for (const msg of messages) {
+      if (msg.checkpointId === checkpointId) {
+        msg.isArchived = false;
+        msg.archivedAt = undefined;
+        msg.checkpointId = undefined;
+      }
+    }
+    const meta = session.metadata || {};
+    const checkpointsMeta = meta.checkpoints || { checkpoints: [] };
+    checkpointsMeta.checkpoints = checkpointsMeta.checkpoints.filter((cp) => cp.id !== checkpointId);
+    checkpointsMeta.latestCheckpointId = cps[cps.length - 1]?.id;
+    if (meta.checkpointDetails) {
+      delete meta.checkpointDetails[checkpointId];
+    }
+    session.metadata = meta;
+    session.messageCount = messages.filter((m) => !m.isArchived).length;
+    session.updatedAt = Date.now();
+    return true;
+  }
+  async archiveMessages(sessionId, checkpointId, beforeIndex) {
+    const session = this.sessions.get(sessionId);
+    if (!session)
+      return 0;
+    const messages = this.messages.get(sessionId) ?? [];
+    let archivedCount = 0;
+    for (let i = 0;i < beforeIndex; i++) {
+      if (!messages[i].isArchived) {
+        messages[i].isArchived = true;
+        messages[i].archivedAt = Date.now();
+        messages[i].checkpointId = checkpointId;
+        archivedCount++;
+      }
+    }
+    session.messageCount = messages.filter((m) => !m.isArchived).length;
+    session.updatedAt = Date.now();
+    return archivedCount;
+  }
+  async getActiveMessages(sessionId, offset = 0, limit = 50) {
+    const messages = this.messages.get(sessionId) ?? [];
+    const activeMessages = messages.filter((m) => !m.isArchived);
+    return activeMessages.slice(offset, offset + limit);
+  }
+  async searchMessages(options) {
+    const matches = [];
+    const {
+      query,
+      sessionId,
+      limit = 10,
+      beforeTime,
+      afterTime,
+      includeArchived = false
+    } = options;
+    let sessionsToSearch;
+    if (sessionId) {
+      const session = await this.get(sessionId);
+      sessionsToSearch = session ? [session] : [];
+    } else {
+      sessionsToSearch = Array.from(this.sessions.values());
+    }
+    const queryTerms = this.parseQuery(query);
+    for (const session of sessionsToSearch) {
+      if (beforeTime && session.updatedAt > beforeTime)
+        continue;
+      if (afterTime && session.updatedAt < afterTime)
+        continue;
+      let messages = this.messages.get(session.id) ?? [];
+      if (!includeArchived) {
+        messages = messages.filter((m) => !m.isArchived);
+      }
+      for (const msg of messages) {
+        if (beforeTime && msg.timestamp > beforeTime)
+          continue;
+        if (afterTime && msg.timestamp < afterTime)
+          continue;
+        const content = msg.content.toLowerCase();
+        let matchesQuery = true;
+        for (const term of queryTerms.required) {
+          if (!content.includes(term.toLowerCase())) {
+            matchesQuery = false;
+            break;
+          }
+        }
+        for (const term of queryTerms.excluded) {
+          if (content.includes(term.toLowerCase())) {
+            matchesQuery = false;
+            break;
+          }
+        }
+        if (matchesQuery) {
+          matches.push({
+            messageId: msg.id,
+            sessionId: session.id,
+            role: msg.role,
+            content: msg.content,
+            timestamp: msg.timestamp
+          });
+          if (matches.length >= limit) {
+            return matches;
+          }
+        }
+      }
+    }
+    return matches;
+  }
+  parseQuery(query) {
+    const terms = query.split(/\s+/).filter((t) => !t.startsWith('"') && !t.endsWith('"'));
+    const required = [];
+    const excluded = [];
+    for (const term of terms) {
+      if (term.startsWith("-") || term.startsWith("NOT ")) {
+        excluded.push(term.replace(/^-|^NOT /i, ""));
+      } else {
+        required.push(term);
+      }
+    }
+    return { required, excluded };
+  }
+  async close() {
+    this.sessions.clear();
+    this.messages.clear();
+    this.checkpoints.clear();
+  }
+}
+// packages/core/src/env/session/storage/sqlite.ts
+import { join as join2 } from "path";
+import { randomUUID as randomUUID3 } from "crypto";
+function generateSessionId2() {
+  return `session_${randomUUID3()}`;
+}
+function generateMessageId2() {
+  return `msg_${randomUUID3()}`;
+}
+function getDefaultDataDir() {
+  const home = process.env.HOME || process.env.USERPROFILE || "/tmp";
+  return join2(home, ".local", "share");
+}
+function getDefaultSessionDbPath() {
+  return join2(getDefaultDataDir(), "roy-agent", "sessions.db");
+}
+
+class SQLiteSessionStore {
+  db = null;
+  dbPath;
+  initialized = false;
+  sessionsCache = new Map;
+  messagesCache = new Map;
+  checkpointsCache = new Map;
+  messageConverter = new SessionMessageConverter;
+  constructor(dbPath) {
+    this.dbPath = dbPath || getDefaultSessionDbPath();
+  }
+  async initialize() {
+    if (this.initialized)
+      return;
+    const { Database } = __require("bun:sqlite");
+    if (this.dbPath !== ":memory:") {
+      const fs = __require("fs");
+      const path = __require("path");
+      const dir = path.dirname(this.dbPath);
+      if (!fs.existsSync(dir)) {
+        fs.mkdirSync(dir, { recursive: true });
+      }
+    }
+    this.db = new Database(this.dbPath);
+    this.db.run(`
+      CREATE TABLE IF NOT EXISTS session (
+        id TEXT PRIMARY KEY,
+        title TEXT NOT NULL,
+        directory TEXT NOT NULL,
+        parent_id TEXT,
+        created_at INTEGER NOT NULL,
+        updated_at INTEGER NOT NULL,
+        message_count INTEGER DEFAULT 0,
+        metadata TEXT
+      )
+    `);
+    this.db.run(`
+      CREATE TABLE IF NOT EXISTS message (
+        id TEXT PRIMARY KEY,
+        session_id TEXT NOT NULL,
+        role TEXT NOT NULL,
+        content TEXT NOT NULL,
+        timestamp INTEGER NOT NULL,
+        parts TEXT,
+        is_archived INTEGER DEFAULT 0,
+        archived_at INTEGER,
+        checkpoint_id TEXT,
+        metadata TEXT,
+        FOREIGN KEY (session_id) REFERENCES session(id) ON DELETE CASCADE
+      )
+    `);
+    this.db.run("CREATE INDEX IF NOT EXISTS idx_message_session ON message(session_id)");
+    this.db.run("CREATE INDEX IF NOT EXISTS idx_message_checkpoint ON message(checkpoint_id)");
+    this.initialized = true;
+  }
+  async create(options) {
+    await this.initialize();
+    const now = Date.now();
+    const session = {
+      id: options.id ?? generateSessionId2(),
+      title: options.title ?? "Session",
+      directory: options.directory ?? "/tmp",
+      parentID: options.parentID,
+      createdAt: now,
+      updatedAt: now,
+      messageCount: 0,
+      metadata: {
+        ...options.metadata,
+        messageCount: 0,
+        checkpoints: { checkpoints: [] }
+      }
+    };
+    const existing = this.db.prepare("SELECT id FROM session WHERE id = ?").get(session.id);
+    if (existing) {
+      throw new Error(`Session with ID '${session.id}' already exists`);
+    }
+    const stmt = this.db.prepare(`
+      INSERT INTO session (id, title, directory, parent_id, created_at, updated_at, message_count, metadata)
+      VALUES (?, ?, ?, ?, ?, ?, ?, ?)
+    `);
+    stmt.run(session.id, session.title, session.directory, session.parentID || null, session.createdAt, session.updatedAt, session.messageCount, JSON.stringify(session.metadata));
+    this.sessionsCache.set(session.id, session);
+    this.messagesCache.set(session.id, []);
+    this.checkpointsCache.set(session.id, []);
+    return session;
+  }
+  async get(id) {
+    await this.initialize();
+    const cached = this.sessionsCache.get(id);
+    if (cached)
+      return cached;
+    const row = this.db.prepare("SELECT * FROM session WHERE id = ?").get(id);
+    if (!row)
+      return;
+    const session = this.rowToSession(row);
+    this.sessionsCache.set(session.id, session);
+    return session;
+  }
+  async list(options) {
+    await this.initialize();
+    let sql = "SELECT * FROM session";
+    const params = [];
+    const conditions = [];
+    if (options?.filter?.metadata) {
+      for (const [key, value] of Object.entries(options.filter.metadata)) {
+        conditions.push(`json_extract(metadata, '$.${key}') = ?`);
+        params.push(JSON.stringify(value));
+      }
+    }
+    if (options?.filter?.startTime) {
+      conditions.push("created_at >= ?");
+      params.push(options.filter.startTime);
+    }
+    if (options?.filter?.endTime) {
+      conditions.push("created_at <= ?");
+      params.push(options.filter.endTime);
+    }
+    if (conditions.length > 0) {
+      sql += " WHERE " + conditions.join(" AND ");
+    }
+    const sortField = options?.sort?.field ?? "updatedAt";
+    const sortOrder = options?.sort?.order ?? "desc";
+    const orderColumn = sortField === "title" ? "title" : sortField === "createdAt" ? "created_at" : "updated_at";
+    sql += ` ORDER BY ${orderColumn} ${sortOrder.toUpperCase()}`;
+    const offset = options?.offset ?? 0;
+    const limit = options?.limit ?? 100;
+    sql += " LIMIT ? OFFSET ?";
+    params.push(limit, offset);
+    const rows = this.db.prepare(sql).all(...params);
+    return rows.map((row) => this.rowToSession(row));
+  }
+  async getCount() {
+    await this.initialize();
+    const result = this.db.prepare("SELECT COUNT(*) as count FROM session").get();
+    return result.count;
+  }
+  async update(id, updates) {
+    await this.initialize();
+    const session = await this.get(id);
+    if (!session)
+      return false;
+    if (updates.title !== undefined) {
+      session.title = updates.title;
+    }
+    if (updates.metadata !== undefined) {
+      session.metadata = { ...session.metadata, ...updates.metadata };
+    }
+    session.updatedAt = Date.now();
+    const stmt = this.db.prepare(`
+      UPDATE session 
+      SET title = ?, metadata = ?, updated_at = ?
+      WHERE id = ?
+    `);
+    stmt.run(session.title, JSON.stringify(session.metadata), session.updatedAt, id);
+    this.sessionsCache.set(id, session);
+    return true;
+  }
+  async delete(id) {
+    await this.initialize();
+    const session = await this.get(id);
+    if (!session)
+      return false;
+    this.db.prepare("DELETE FROM session WHERE id = ?").run(id);
+    this.sessionsCache.delete(id);
+    this.messagesCache.delete(id);
+    this.checkpointsCache.delete(id);
+    return true;
+  }
+  async addMessage(sessionId, message) {
+    await this.initialize();
+    const session = await this.get(sessionId);
+    if (!session) {
+      throw new Error(`Session not found: ${sessionId}`);
+    }
+    const now = Date.now();
+    const msg = {
+      id: generateMessageId2(),
+      sessionID: sessionId,
+      role: message.role,
+      content: message.content,
+      timestamp: now,
+      parts: message.parts,
+      metadata: message.metadata
+    };
+    const stmt = this.db.prepare(`
+      INSERT INTO message (id, session_id, role, content, timestamp, parts, metadata)
+      VALUES (?, ?, ?, ?, ?, ?, ?)
+    `);
+    stmt.run(msg.id, msg.sessionID, msg.role, msg.content, msg.timestamp, msg.parts ? JSON.stringify(msg.parts) : null, msg.metadata ? JSON.stringify(msg.metadata) : null);
+    const countResult = this.db.prepare("SELECT COUNT(*) as count FROM message WHERE session_id = ? AND is_archived = 0").get(sessionId);
+    session.messageCount = countResult?.count || 0;
+    session.updatedAt = now;
+    session.metadata = {
+      ...session.metadata,
+      messageCount: session.messageCount
+    };
+    this.db.prepare(`
+      UPDATE session SET message_count = ?, metadata = ?, updated_at = ? WHERE id = ?
+    `).run(session.messageCount, JSON.stringify(session.metadata), session.updatedAt, sessionId);
+    const messages = this.messagesCache.get(sessionId) ?? [];
+    messages.push(msg);
+    this.messagesCache.set(sessionId, messages);
+    this.sessionsCache.set(sessionId, session);
+    return msg.id;
+  }
+  async getMessages(sessionId, offset = 0, limit = 50, options) {
+    await this.initialize();
+    let sql = "SELECT * FROM message WHERE session_id = ?";
+    let countSql = "SELECT COUNT(*) as count FROM message WHERE session_id = ?";
+    const params = [sessionId];
+    const countParams = [sessionId];
+    if (!options?.includeArchived) {
+      sql += " AND is_archived = 0";
+      countSql += " AND is_archived = 0";
+    }
+    if (options?.fromCheckpointId) {
+      sql += " AND timestamp >= (SELECT MIN(timestamp) FROM message WHERE session_id = ? AND json_extract(metadata, '$.checkpointId') = ?)";
+      params.push(sessionId, options.fromCheckpointId);
+    }
+    let actualOffset = offset;
+    if (offset < 0) {
+      const totalResult = this.db.prepare(countSql).get(...countParams);
+      const total = totalResult?.count || 0;
+      actualOffset = Math.max(0, total + offset * limit);
+    }
+    if (options?.reverse) {
+      sql += " ORDER BY timestamp DESC";
+    } else {
+      sql += " ORDER BY timestamp ASC";
+    }
+    sql += " LIMIT ? OFFSET ?";
+    params.push(limit, actualOffset);
+    const rows = this.db.prepare(sql).all(...params);
+    return rows.map((row) => this.rowToMessage(row));
+  }
+  async getMessageCount(sessionId, includeArchived = false) {
+    await this.initialize();
+    let sql = "SELECT COUNT(*) as count FROM message WHERE session_id = ?";
+    if (!includeArchived) {
+      sql += " AND is_archived = 0";
+    }
+    const result = this.db.prepare(sql).get(sessionId);
+    return result?.count || 0;
+  }
+  async getMessageIndexes(sessionId, role) {
+    await this.initialize();
+    const sql = `
+      SELECT idx FROM (
+        SELECT 
+          ROW_NUMBER() OVER (ORDER BY timestamp ASC) - 1 as idx,
+          role
+        FROM message 
+        WHERE session_id = ? AND is_archived = 0
+      ) ranked
+      WHERE role = ?
+    `;
+    const rows = this.db.prepare(sql).all(sessionId, role);
+    return rows.map((row) => row.idx);
+  }
+  async saveCheckpoint(sessionId, checkpoint) {
+    await this.initialize();
+    const session = await this.get(sessionId);
+    if (!session) {
+      throw new Error(`Session not found: ${sessionId}`);
+    }
+    const cps = this.checkpointsCache.get(sessionId) ?? [];
+    cps.push(checkpoint);
+    this.checkpointsCache.set(sessionId, cps);
+    const meta = session.metadata || {};
+    const checkpointsMeta = meta.checkpoints || { checkpoints: [] };
+    checkpointsMeta.checkpoints.push({
+      id: checkpoint.id,
+      messageIndex: checkpoint.messageIndex,
+      title: checkpoint.title,
+      createdAt: checkpoint.createdAt,
+      type: checkpoint.type
+    });
+    checkpointsMeta.latestCheckpointId = checkpoint.id;
+    meta.checkpoints = checkpointsMeta;
+    if (!meta.checkpointDetails) {
+      meta.checkpointDetails = {};
+    }
+    meta.checkpointDetails[checkpoint.id] = checkpoint;
+    session.metadata = meta;
+    session.updatedAt = Date.now();
+    const stmt = this.db.prepare(`
+      UPDATE session SET metadata = ?, updated_at = ? WHERE id = ?
+    `);
+    stmt.run(JSON.stringify(session.metadata), session.updatedAt, sessionId);
+    this.sessionsCache.set(sessionId, session);
+  }
+  async getCheckpoints(sessionId) {
+    await this.initialize();
+    const session = await this.get(sessionId);
+    if (!session)
+      return [];
+    const meta = session.metadata;
+    const checkpointDetails = meta?.checkpointDetails;
+    if (!checkpointDetails)
+      return [];
+    return Object.values(checkpointDetails);
+  }
+  async getCheckpoint(sessionId, checkpointId) {
+    await this.initialize();
+    const checkpoints = await this.getCheckpoints(sessionId);
+    return checkpoints.find((cp) => cp.id === checkpointId);
+  }
+  async deleteCheckpoint(sessionId, checkpointId) {
+    await this.initialize();
+    const session = await this.get(sessionId);
+    if (!session)
+      return false;
+    const checkpoints = this.checkpointsCache.get(sessionId) ?? [];
+    const index = checkpoints.findIndex((cp) => cp.id === checkpointId);
+    if (index === -1)
+      return false;
+    checkpoints.splice(index, 1);
+    this.checkpointsCache.set(sessionId, checkpoints);
+    this.db.prepare(`
+      UPDATE message SET is_archived = 0, archived_at = NULL, checkpoint_id = NULL
+      WHERE session_id = ? AND checkpoint_id = ?
+    `).run(sessionId, checkpointId);
+    const meta = session.metadata || {};
+    const checkpointsMeta = meta.checkpoints || { checkpoints: [] };
+    checkpointsMeta.checkpoints = checkpointsMeta.checkpoints.filter((cp) => cp.id !== checkpointId);
+    checkpointsMeta.latestCheckpointId = checkpoints[checkpoints.length - 1]?.id;
+    if (meta.checkpointDetails) {
+      delete meta.checkpointDetails[checkpointId];
+    }
+    session.metadata = meta;
+    const countResult = this.db.prepare("SELECT COUNT(*) as count FROM message WHERE session_id = ? AND is_archived = 0").get(sessionId);
+    session.messageCount = countResult?.count || 0;
+    session.updatedAt = Date.now();
+    this.db.prepare(`
+      UPDATE session SET metadata = ?, message_count = ?, updated_at = ? WHERE id = ?
+    `).run(JSON.stringify(session.metadata), session.messageCount, session.updatedAt, sessionId);
+    this.sessionsCache.set(sessionId, session);
+    return true;
+  }
+  async archiveMessages(sessionId, checkpointId, beforeIndex) {
+    await this.initialize();
+    const session = await this.get(sessionId);
+    if (!session)
+      return 0;
+    const now = Date.now();
+    const result = this.db.prepare(`
+      UPDATE message 
+      SET is_archived = 1, archived_at = ?, checkpoint_id = ?
+      WHERE session_id = ? AND id IN (
+        SELECT id FROM message WHERE session_id = ? AND is_archived = 0
+        ORDER BY timestamp ASC LIMIT ?
+      )
+    `).run(now, checkpointId, sessionId, sessionId, beforeIndex);
+    const countResult = this.db.prepare("SELECT COUNT(*) as count FROM message WHERE session_id = ? AND is_archived = 0").get(sessionId);
+    session.messageCount = countResult?.count || 0;
+    session.updatedAt = now;
+    this.db.prepare(`
+      UPDATE session SET message_count = ?, updated_at = ? WHERE id = ?
+    `).run(session.messageCount, session.updatedAt, sessionId);
+    this.sessionsCache.set(sessionId, session);
+    this.messagesCache.delete(sessionId);
+    return result.changes;
+  }
+  async getActiveMessages(sessionId, offset = 0, limit = 50) {
+    return this.getMessages(sessionId, offset, limit, { includeArchived: false });
+  }
+  async searchMessages(options) {
+    await this.initialize();
+    const matches = [];
+    const {
+      query,
+      sessionId,
+      limit = 10,
+      beforeTime,
+      afterTime,
+      includeArchived = false
+    } = options;
+    let sql = "SELECT * FROM message WHERE 1=1";
+    const params = [];
+    if (sessionId) {
+      sql += " AND session_id = ?";
+      params.push(sessionId);
+    }
+    if (!includeArchived) {
+      sql += " AND is_archived = 0";
+    }
+    if (beforeTime) {
+      sql += " AND timestamp <= ?";
+      params.push(beforeTime);
+    }
+    if (afterTime) {
+      sql += " AND timestamp >= ?";
+      params.push(afterTime);
+    }
+    sql += " ORDER BY timestamp DESC";
+    sql += " LIMIT ?";
+    params.push(limit * 10);
+    const rows = this.db.prepare(sql).all(...params);
+    const queryTerms = this.parseQuery(query);
+    const lowerQuery = query.toLowerCase();
+    for (const row of rows) {
+      const content = row.content.toLowerCase();
+      let matchesQuery = true;
+      for (const term of queryTerms.excluded) {
+        if (content.includes(term.toLowerCase())) {
+          matchesQuery = false;
+          break;
+        }
+      }
+      if (matchesQuery && queryTerms.required.length > 0) {
+        for (const term of queryTerms.required) {
+          if (!content.includes(term.toLowerCase())) {
+            matchesQuery = false;
+            break;
+          }
+        }
+      }
+      if (!matchesQuery && lowerQuery && content.includes(lowerQuery)) {
+        matchesQuery = true;
+      }
+      if (matchesQuery) {
+        matches.push({
+          messageId: row.id,
+          sessionId: row.session_id,
+          role: row.role,
+          content: row.content,
+          timestamp: row.timestamp
+        });
+        if (matches.length >= limit)
+          break;
+      }
+    }
+    return matches;
+  }
+  parseQuery(query) {
+    const terms = query.split(/\s+/).filter((t) => !t.startsWith('"') && !t.endsWith('"'));
+    const required = [];
+    const excluded = [];
+    for (const term of terms) {
+      if (term.startsWith("-") || term.toUpperCase().startsWith("NOT ")) {
+        excluded.push(term.replace(/^-|^NOT /i, ""));
+      } else {
+        required.push(term);
+      }
+    }
+    return { required, excluded };
+  }
+  async close() {
+    if (this.db) {
+      this.db.close();
+      this.db = null;
+    }
+    this.sessionsCache.clear();
+    this.messagesCache.clear();
+    this.checkpointsCache.clear();
+    this.initialized = false;
+  }
+  rowToSession(row) {
+    return {
+      id: row.id,
+      title: row.title,
+      directory: row.directory,
+      parentID: row.parent_id,
+      createdAt: row.created_at,
+      updatedAt: row.updated_at,
+      messageCount: row.message_count,
+      metadata: row.metadata ? JSON.parse(row.metadata) : undefined
+    };
+  }
+  rowToMessage(row) {
+    const rawMessage = {
+      id: row.id,
+      sessionID: row.session_id,
+      role: row.role,
+      content: row.content,
+      timestamp: row.timestamp,
+      parts: row.parts ? JSON.parse(row.parts) : undefined,
+      isArchived: row.is_archived === 1,
+      archivedAt: row.archived_at || undefined,
+      checkpointId: row.checkpoint_id || undefined,
+      metadata: row.metadata ? JSON.parse(row.metadata) : undefined
+    };
+    return this.messageConverter.migrateMessage(rawMessage);
+  }
+}
+export {
+  getDefaultSessionDbPath,
+  getDefaultDataDir,
+  SQLiteSessionStore,
+  MemorySessionStore
+};