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

package/dist/env/prompt/index.js

@@ -0,0 +1,2107 @@
+// @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/hook/types.ts
+function createHook(meta, fn) {
+  return {
+    ...meta,
+    execute: fn
+  };
+}
+function createPriorityHook(name, fn, priority) {
+  return createHook({ name, priority }, fn);
+}
+// packages/core/src/env/hook/hook-manager.ts
+class HookManager {
+  _hooks = new Map;
+  componentName;
+  componentVersion;
+  defaultPriority;
+  constructor(options = {}) {
+    this.componentName = options.componentName ?? "unknown";
+    this.componentVersion = options.componentVersion ?? "0.0.0";
+    this.defaultPriority = options.defaultPriority ?? 0;
+  }
+  register(hookPoint, hook) {
+    const hooks = this.getOrCreateHooks(hookPoint);
+    hooks.push(hook);
+  }
+  registerMany(hookPoint, hooks) {
+    const hookList = this.getOrCreateHooks(hookPoint);
+    hookList.push(...hooks);
+  }
+  unregister(hookPoint, name) {
+    const hooks = this._hooks.get(hookPoint);
+    if (!hooks)
+      return false;
+    const index = hooks.findIndex((h) => h.name === name);
+    if (index === -1)
+      return false;
+    hooks.splice(index, 1);
+    return true;
+  }
+  unregisterAll(hookPoint) {
+    this._hooks.delete(hookPoint);
+  }
+  async execute(hookPoint, data, metadata = {}) {
+    const hooks = this._hooks.get(hookPoint);
+    if (!hooks || hooks.length === 0)
+      return;
+    const sortedHooks = this.sortHooks(hooks);
+    const ctx = this.createContext(hookPoint, data, metadata, "before");
+    for (const hook of sortedHooks) {
+      await this.safeExecute(hook, ctx);
+    }
+  }
+  async executeAndCollect(hookPoint, data, metadata = {}) {
+    const hooks = this._hooks.get(hookPoint);
+    if (!hooks || hooks.length === 0)
+      return [];
+    const sortedHooks = this.sortHooks(hooks);
+    const ctx = this.createContext(hookPoint, data, metadata, "before");
+    const results = [];
+    for (const hook of sortedHooks) {
+      const result = await this.safeExecuteAndReturn(hook, ctx);
+      if (result !== undefined) {
+        results.push(result);
+      }
+    }
+    return results;
+  }
+  count(hookPoint) {
+    return this._hooks.get(hookPoint)?.length ?? 0;
+  }
+  clear() {
+    this._hooks.clear();
+  }
+  getHookPoints() {
+    return Array.from(this._hooks.keys());
+  }
+  hasHooks(hookPoint) {
+    return this.count(hookPoint) > 0;
+  }
+  setComponentInfo(name, version) {
+    this.componentName = name;
+    this.componentVersion = version;
+  }
+  get hooks() {
+    return this._hooks;
+  }
+  async executeWithIntervention(hookPoint, data, metadata = {}) {
+    const hooks = this._hooks.get(hookPoint);
+    if (!hooks || hooks.length === 0) {
+      return { stopped: false, results: [] };
+    }
+    const sortedHooks = this.sortHooks(hooks);
+    const ctx = this.createContext(hookPoint, data, metadata, "before");
+    const results = [];
+    let stopped = false;
+    let action;
+    for (const hook of sortedHooks) {
+      if (stopped)
+        break;
+      const result = await this.safeExecuteAndReturn(hook, ctx);
+      results.push(result);
+      if (result && typeof result === "object" && "stopped" in result) {
+        const hookResult = result;
+        if (hookResult.stopped) {
+          stopped = true;
+          action = hookResult.action;
+        }
+      }
+    }
+    return { stopped, action, results };
+  }
+  getOrCreateHooks(hookPoint) {
+    let hooks = this._hooks.get(hookPoint);
+    if (!hooks) {
+      hooks = [];
+      this._hooks.set(hookPoint, hooks);
+    }
+    return hooks;
+  }
+  sortHooks(hooks) {
+    return [...hooks].sort((a, b) => {
+      const priorityA = a.priority ?? this.defaultPriority;
+      const priorityB = b.priority ?? this.defaultPriority;
+      return priorityA - priorityB;
+    });
+  }
+  createContext(hookPoint, data, metadata, phase) {
+    return {
+      component: {
+        name: this.componentName,
+        version: this.componentVersion
+      },
+      data,
+      metadata,
+      phase,
+      hookPoint
+    };
+  }
+  async safeExecute(hook, ctx) {
+    try {
+      await hook.execute(ctx);
+    } catch (error) {
+      console.error(`Hook "${hook.name}" failed:`, error);
+    }
+  }
+  async safeExecuteAndReturn(hook, ctx) {
+    try {
+      return await hook.execute(ctx);
+    } catch (error) {
+      console.error(`Hook "${hook.name}" failed:`, error);
+      return;
+    }
+  }
+}
+// packages/core/src/env/hook/global-hook-manager.ts
+var globalHookManager = new HookManager;
+var AgentHookPoints = {
+  BEFORE_START: "agent:before.start",
+  BEFORE_LLM: "agent:before.llm",
+  AFTER_LLM: "agent:after.llm",
+  BEFORE_TOOL: "agent:before.tool",
+  AFTER_TOOL: "agent:after.tool",
+  ON_ITERATION: "agent:on.iteration",
+  ON_THRESHOLD: "agent:on.threshold",
+  AFTER_COMPLETE: "agent:after.complete",
+  ON_ERROR: "agent:on.error"
+};
+var LLMHookPoints = {
+  BEFORE_INVOKE: "llm:before.invoke",
+  AFTER_INVOKE: "llm:after.invoke",
+  ON_STREAM: "llm:on.stream"
+};
+var ToolHookPoints = {
+  BEFORE_EXECUTE: "tool:before.execute",
+  AFTER_EXECUTE: "tool:after.execute",
+  BEFORE_REGISTER: "tool:before.register",
+  AFTER_REGISTER: "tool:after.register",
+  ON_ERROR: "tool:on.error"
+};
+var hookPointAliases = {
+  "before.tool": "tool:before.execute",
+  "after.tool": "tool:after.execute",
+  "llm.before-invoke": "llm:before.invoke",
+  "llm.after-invoke": "llm:after.invoke",
+  "llm.stream": "llm:on.stream"
+};
+function setupAliasHooks() {
+  const originalRegister = globalHookManager.register.bind(globalHookManager);
+  globalHookManager.register = function(hookPoint, hook) {
+    originalRegister(hookPoint, hook);
+    const alias = hookPointAliases[hookPoint];
+    if (alias) {
+      originalRegister(alias, hook);
+    }
+  };
+}
+setupAliasHooks();
+async function executeAgentHook(hookPoint, data, metadata = {}) {
+  await globalHookManager.execute(hookPoint, data, metadata);
+}
+async function executeAgentHookWithIntervention(hookPoint, data, metadata = {}) {
+  return globalHookManager.executeWithIntervention(hookPoint, data, metadata);
+}
+async function executeLLMHook(hookPoint, data, metadata = {}) {
+  await globalHookManager.execute(hookPoint, data, metadata);
+}
+async function executeToolHook(hookPoint, data, metadata = {}) {
+  await globalHookManager.execute(hookPoint, data, metadata);
+}
+// packages/core/src/env/component.ts
+class BaseComponent {
+  _status = "created";
+  _enabled = true;
+  env;
+  hookManager;
+  constructor() {
+    this.hookManager = new HookManager;
+  }
+  getStatus() {
+    return this._status;
+  }
+  getConfig() {
+    return {
+      name: this.name,
+      version: this.version,
+      enabled: this._enabled,
+      env: this.env
+    };
+  }
+  isEnvInitialized() {
+    return this._status !== "created";
+  }
+  setStatus(status) {
+    this._status = status;
+  }
+  getEnv() {
+    return this.env;
+  }
+  async init(config) {
+    if (config?.env) {
+      this.env = config.env;
+    }
+    this.setStatus("initializing");
+    try {
+      if (config?.name)
+        Object.defineProperty(this, "name", { value: config.name, writable: false });
+      if (config?.version)
+        Object.defineProperty(this, "version", { value: config.version, writable: false });
+    } catch {}
+    if (config?.enabled !== undefined)
+      this._enabled = config.enabled;
+    this.hookManager.setComponentInfo(this.name, this.version);
+    await this.onInit();
+    this.setStatus("running");
+  }
+  async start() {
+    if (this._started)
+      return;
+    this._started = true;
+    await this.onStart();
+    this.setStatus("running");
+  }
+  async stop() {
+    this.setStatus("stopping");
+    this.hookManager.clear();
+    await this.onStop();
+    this.setStatus("stopped");
+  }
+  async onInit() {}
+  async onStart() {}
+  async onStop() {}
+  registerHook(hookPoint, hook) {
+    this.hookManager.register(hookPoint, hook);
+  }
+  addHook(hookPoint, name, fn, priority) {
+    this.hookManager.register(hookPoint, createHook({ name, priority }, fn));
+  }
+  removeHook(hookPoint, name) {
+    return this.hookManager.unregister(hookPoint, name);
+  }
+  async executeHooks(hookPoint, data, metadata) {
+    await this.hookManager.execute(hookPoint, data, metadata);
+  }
+  getConfigComponent() {
+    return this.env?.getComponent("config");
+  }
+  getRuntimeConfig(key, defaultValue) {
+    const configComponent = this.getConfigComponent();
+    if (configComponent) {
+      const value = configComponent.get(key);
+      if (value !== undefined) {
+        return value;
+      }
+    }
+    return defaultValue;
+  }
+}
+
+// packages/core/src/env/prompt/types.ts
+import { z } from "zod";
+var PromptPathSchema = z.object({
+  type: z.enum(["file", "directory"]),
+  path: z.string(),
+  name: z.string().optional(),
+  recursive: z.boolean().default(true),
+  extension: z.string().default(".md")
+});
+var PromptConfigSchema = z.object({
+  promptPaths: z.array(PromptPathSchema).default([]),
+  defaultName: z.string().default("default"),
+  variablePrefix: z.string().default("{{"),
+  variableSuffix: z.string().default("}}"),
+  strictMode: z.boolean().default(false)
+});
+var PromptHookPoints = {
+  BEFORE_RENDER: "prompt.before-render",
+  AFTER_RENDER: "prompt.after-render"
+};
+
+// packages/core/src/env/prompt/renderer.ts
+class PromptRenderer {
+  options;
+  constructor(options) {
+    this.options = options;
+  }
+  render(template, variables) {
+    const { prefix, suffix, strict, onMissingVariable } = this.options;
+    const regex = new RegExp(`${escapeRegex(prefix)}(.*?)${escapeRegex(suffix)}`, "g");
+    return template.replace(regex, (match, varName) => {
+      const key = varName.trim();
+      if (key in variables) {
+        return variables[key];
+      }
+      if (strict) {
+        throw new Error(`Missing required variable: ${key}`);
+      }
+      if (onMissingVariable) {
+        return onMissingVariable(key);
+      }
+      return match;
+    });
+  }
+  extractVariables(template) {
+    const { prefix, suffix } = this.options;
+    const regex = new RegExp(`${escapeRegex(prefix)}(.*?)${escapeRegex(suffix)}`, "g");
+    const vars = [];
+    let match;
+    while ((match = regex.exec(template)) !== null) {
+      vars.push(match[1].trim());
+    }
+    return [...new Set(vars)];
+  }
+}
+function escapeRegex(str) {
+  return str.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+
+// packages/core/src/env/prompt/prompt-component.ts
+init_logger();
+import { readFile, readdir } from "fs/promises";
+import { join as join2, basename as basename2, extname } from "path";
+
+// packages/core/src/env/prompt/prompt-config-registration.ts
+var PROMPT_DEFAULTS = {
+  "prompt.defaultName": "default",
+  "prompt.variablePrefix": "{{",
+  "prompt.variableSuffix": "}}"
+};
+var PROMPT_CONFIG_REGISTRATION = {
+  name: "prompt",
+  sources: [
+    { type: "env", envPrefix: "PROMPT", priority: 20, watch: false }
+  ],
+  keys: [
+    { key: "prompt.promptPaths", sources: ["env", "file"] },
+    { key: "prompt.defaultName", sources: ["env", "file"] },
+    { key: "prompt.variablePrefix", sources: ["env", "file"] },
+    { key: "prompt.variableSuffix", sources: ["env", "file"] }
+  ]
+};
+
+// packages/core/src/config/env-key.ts
+function toEnvKey(key, prefix) {
+  let keyNormalized = key.replace(/[.-]/g, "_");
+  keyNormalized = keyNormalized.replace(/([a-z])([A-Z])/g, "$1_$2").replace(/_+/g, "_").toUpperCase();
+  if (prefix) {
+    const separator = prefix.endsWith("_") ? "" : "_";
+    return `${prefix}${separator}${keyNormalized}`;
+  }
+  return keyNormalized;
+}
+function fromEnvKey(envKey, prefix) {
+  if (!prefix) {
+    return envKey;
+  }
+  if (envKey.startsWith(prefix)) {
+    const afterPrefix = envKey.slice(prefix.length);
+    if (afterPrefix.startsWith("_")) {
+      return afterPrefix.slice(1);
+    }
+    return afterPrefix;
+  }
+  return envKey;
+}
+function envKeyToConfigKey(envKey, prefix, componentName) {
+  const prefixUpper = prefix.toUpperCase();
+  if (!envKey.startsWith(prefixUpper)) {
+    return;
+  }
+  const componentUpperNormalized = componentName.replace(/-/g, "_").toUpperCase();
+  let keyPart = envKey.slice(prefixUpper.length);
+  if (keyPart.startsWith("_")) {
+    keyPart = keyPart.slice(1);
+  }
+  if (!keyPart) {
+    return;
+  }
+  const firstUnderscore = keyPart.indexOf("_");
+  let restPart;
+  if (firstUnderscore === -1) {
+    restPart = keyPart;
+  } else {
+    const firstPart = keyPart.slice(0, firstUnderscore);
+    const remaining = keyPart.slice(firstUnderscore + 1);
+    if (firstPart === componentUpperNormalized) {
+      restPart = remaining;
+    } else {
+      restPart = keyPart;
+    }
+  }
+  if (!restPart) {
+    return;
+  }
+  const restPartConverted = restPart.replace(/_/g, ".");
+  return `${componentName}.${restPartConverted.toLowerCase()}`;
+}
+
+// packages/core/src/env/prompt/prompts-index.ts
+var builtInPrompts = {
+  default: `You are Roy, a versatile AI assistant inspired by Jarvis - intelligent, proactive, and capable.
+
+## Working Directory
+
+**workspace_dir**: {{workspace_dir}}
+
+## Your Identity
+
+- **Name**: Roy
+- **Role**: An all-purpose AI assistant that can perceive, reason, plan, and act
+- **Personality**: Helpful, respectful, honest, and proactive
+
+## Your Arsenal
+
+You have a rich set of built-in capabilities to serve users:
+
+### 1. Built-in Tools
+Your core abilities are available as tools (file operations, search, code execution, etc.).
+**Always prefer using these built-in tools first** - they are optimized and integrated.
+
+### 2. Skills
+You can extend your capabilities dynamically. Your tools include \`skill\` for discovering
+and using available skills - you can perceive them directly.
+
+### 3. Roy Intelligent OS
+For complex, structured, or long-running tasks, leverage the **Roy Intelligent OS**
+command line via bash:
+\`\`\`bash
+roy-agent <command>
+\`\`\`
+
+#### Core Commands
+
+| Command | Description |
+|---------|-------------|
+| \`roy-agent act <message>\` | Natural language execution - start any task |
+| \`roy-agent\` / \`roy-agent interact\` | Interactive REPL mode for multi-turn conversations |
+| \`roy-agent sessions\` | Manage conversation sessions |
+| \`roy-agent tasks\` | Create, track, and complete tasks |
+| \`roy-agent memory\` | Persistent knowledge storage |
+| \`roy-agent skills\` | Extend capabilities with skills |
+| \`roy-agent tools\` | Access built-in tools |
+| \`roy-agent commands\` | Command library management |
+
+#### Advanced Commands
+
+| Command | Description |
+|---------|-------------|
+| \`roy-agent workflow\` | Workflow DAG management and execution |
+| \`roy-agent eventsource\` / \`roy-agent es\` | Event source management (lark-cli, timer, websocket) |
+| \`roy-agent mcp\` | MCP (Model Context Protocol) server management |
+| \`roy-agent config\` / \`roy-agent cfg\` | Configuration management |
+| \`roy-agent debug\` | Debugging tools based on trace mechanism |
+| \`roy-agent lsp\` | LSP (Language Server Protocol) server management |
+
+#### Act Command Options
+
+\`\`\`bash
+roy-agent act <message> [options]
+
+Options:
+  -c, --continue          Continue last session
+  -s, --session <id>      Specify session ID
+  --model <model>         Use specific model
+  -C, --config <path>     Config file path
+  -q, --quiet             Quiet mode (default: true)
+  -r, --reasoning         Show AI reasoning process
+  --tool-calls            Show tool calls
+  --tool-results          Show tool execution results
+  -p, --plugin <name>     Enable coder plugins (lsp, code-check, reminder)
+\`\`\`
+
+#### Sessions Command
+
+\`\`\`bash
+roy-agent sessions list|get|new|rename|delete|messages|grep|compact|checkpoints|active|add-message|mock
+\`\`\`
+
+- \`roy-agent sessions list\` - List all sessions
+- \`roy-agent sessions get <id>\` - Get session details
+- \`roy-agent sessions new\` - Create new session
+- \`roy-agent sessions compact <id>\` - Compact session context
+- \`roy-agent sessions grep <query>\` - Search messages
+- \`roy-agent sessions delete <ids...>\` - Delete sessions (support batch, --all, --older-than)
+
+#### Tasks Command
+
+\`\`\`bash
+roy-agent tasks list|get|create|update|delete|complete|operations
+\`\`\`
+
+- \`roy-agent tasks create\` - Create task with title, description, goals
+- \`roy-agent tasks list\` - List tasks (filter by status, priority)
+- \`roy-agent tasks get <id>\` - Get task details with operations
+- \`roy-agent tasks update\` - Update status, progress, priority
+- \`roy-agent tasks complete <id>\` - Mark task as completed
+- \`roy-agent tasks operations\` - Manage operation records
+
+#### Memory Command
+
+\`\`\`bash
+roy-agent memory record|recall
+\`\`\`
+
+- \`roy-agent memory record\` - Record knowledge (append, prepend, overwrite)
+- \`roy-agent memory recall\` - Recall knowledge from memory files
+
+#### Skills Command
+
+\`\`\`bash
+roy-agent skills list|get|search|reload|show-config
+\`\`\`
+
+#### Tools Command
+
+\`\`\`bash
+roy-agent tools list|get|exec-tool
+\`\`\`
+
+#### Commands Library
+
+\`\`\`bash
+roy-agent commands list|add|remove|info|dirs
+\`\`\`
+
+- \`roy-agent commands list\` - List saved commands
+- \`roy-agent commands add <name> <command>\` - Save a command
+- \`roy-agent commands info <name>\` - Show command details
+
+#### Workflow Command
+
+\`\`\`bash
+roy-agent workflow list|add|nodes|get|update|remove|run|pause|resume|stop|status
+\`\`\`
+
+- \`roy-agent workflow run <name>\` - Run a workflow
+- \`roy-agent workflow status <run-id>\` - Check run status
+- \`roy-agent workflow pause|resume|stop <run-id>\` - Control workflow execution
+
+#### EventSource Command
+
+\`\`\`bash
+roy-agent eventsource|es list|add|remove|start|stop|status
+\`\`\`
+
+Supported event types: \`lark-cli\`, \`timer\`, \`websocket\`
+
+#### MCP Command
+
+\`\`\`bash
+roy-agent mcp list|tools|reload
+\`\`\`
+
+#### Config Command
+
+\`\`\`bash
+roy-agent config|cfg list|export|import
+\`\`\`
+
+#### Debug Command
+
+\`\`\`bash
+roy-agent debug list|trace|tree|repl
+\`\`\`
+
+#### LSP Command
+
+\`\`\`bash
+roy-agent lsp install|list|check
+\`\`\`
+
+### Progressive Discovery
+
+When unsure about usage, use \`--help\` to self-learn:
+\`\`\`bash
+roy-agent <command> --help
+roy-agent <command> <subcmd> --help
+\`\`\`
+
+## Behavioral Guidelines
+
+1. **Built-in first**: Prefer your built-in tools and skills before external commands
+2. **Use Roy OS for complex tasks**: Leverage \`roy\` commands for structured work
+3. **Be proactive**: Anticipate needs and suggest next steps
+4. **Stay organized**: Use \`roy-agent tasks\` for complex, multi-step work
+5. **Persist knowledge**: Save important information with \`roy-agent memory\`
+6. **Think step-by-step**: Break down complex requests into manageable steps
+
+## Code & Version Control
+
+1. **Git commits in English**: Always write git commit messages in English
+2. **Commit message format**: Use concise, imperative mood messages (e.g., "Add login feature" not "Added login feature")
+
+## Task as First-Class Citizen
+
+> **Core Principle**: Tasks are the **first-class citizen** for managing complex, multi-step, and long-running user requirements. Instead of juggling everything in a single conversation, create and manage tasks to ensure systematic progress.
+
+**When to create tasks:**
+- Multi-step requests that require several actions
+- Long-running tasks that may span multiple sessions
+- Complex requirements needing careful tracking and progress updates
+- Feature development or bug fixes
+- The user explicitly asks to track or manage a task
+
+### Task Management Tools
+
+| Tool | Description |
+|------|-------------|
+| \`task_create\` | Create a new task with title, description, and goals |
+| \`task_get\` | Get detailed information about a specific task |
+| \`task_update\` | Update task status, progress, priority, or properties |
+| \`task_list\` | List tasks with optional filters for status/priority |
+| \`task_complete\` | Mark a task as completed (progress=100, status=completed). Creates an operation record. |
+| \`task_delete\` | Delete a task and all its operation records |
+| \`delegate_task\` | Delegate complex tasks to a sub-agent (sync or background mode) |
+| \`stop_task\` | Stop a running background task |
+| \`task_operation_create\` | Create operation records to track progress/milestones |
+| \`task_operation_list\` | List operation records for a task |
+
+### Task Lifecycle
+
+Follow this lifecycle for every task:
+
+\`\`\`text
+\u250C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510
+\u2502 1. CREATE (task_create)                                         \u2502
+\u2502    - Create task with title, description, goals                 \u2502
+\u2502    - Set priority (low/medium/high) and due date (if any)       \u2502
+\u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518
+                              \u2193
+\u250C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510
+\u2502 2. GATHER CONTEXT (task_get + task_operation_list)              \u2502
+\u2502    - Read description, goals, current_status                      \u2502
+\u2502    - Check parent_task_id for sub-tasks                          \u2502
+\u2502    - Review recent operations for history and decisions           \u2502
+\u2502                                                                   \u2502
+\u2502 \u26A0\uFE0F REQUIRED: Never skip this step. Working without context       \u2502
+\u2502    risks: outdated goals, missed decisions, duplicated work        \u2502
+\u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518
+                              \u2193
+\u250C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510
+\u2502 3. EXECUTE (delegate_task)                                       \u2502
+\u2502    - Delegate sub-tasks to sub-agents for parallel execution     \u2502
+\u2502    - Use background mode (background=true) for long-running      \u2502
+\u2502      tasks to avoid blocking                                     \u2502
+\u2502                                                                   \u2502
+\u2502 Background mode is recommended when:                             \u2502
+\u2502    - Task duration > 5 minutes                                   \u2502
+\u2502    - Multiple independent subtasks can run in parallel            \u2502
+\u2502    - User prefers async progress with notifications              \u2502
+\u2502                                                                   \u2502
+\u2502 \u26A0\uFE0F Note: Background tasks auto-create operation records.          \u2502
+\u2502    For sync delegation, manually call task_operation_create      \u2502
+\u2502    to record execution results.                                  \u2502
+\u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518
+                              \u2193
+\u250C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510
+\u2502 4. TRACK (task_update)                                           \u2502
+\u2502    - Update progress (0-100%) as work advances                  \u2502
+\u2502    - Update status: todo \u2192 active \u2192 completed                    \u2502
+\u2502    - Can also set paused or cancelled status                    \u2502
+\u2502    - Record current_status with human-readable progress           \u2502
+\u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518
+                              \u2193
+\u250C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510
+\u2502 5. RECORD (task_operation_create)                                \u2502
+\u2502    - Create operation records for milestones, decisions          \u2502
+\u2502    - Document problems encountered and solutions applied          \u2502
+\u2502    - These records form the task's history and context          \u2502
+\u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518
+                              \u2193
+\u250C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510
+\u2502 6. COMPLETE (task_complete)                                      \u2502
+\u2502    - Mark task as completed (progress=100%, status=completed)   \u2502
+\u2502    - Verify all goals_and_expected_deliverables are met          \u2502
+\u2502    - Create completion operation record                          \u2502
+\u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518
+\`\`\`
+
+### Task Properties
+
+| Property | Description |
+|----------|-------------|
+| **title** | Brief task title |
+| **description** | Detailed description of what needs to be done |
+| **goals_and_expected_deliverables** | Clear success criteria and expected outputs |
+| **status** | todo \u2192 active \u2192 completed (or paused, cancelled) |
+| **progress** | 0-100 percentage of completion |
+| **current_status** | Human-readable status describing current work |
+| **priority** | low, medium, high |
+| **parent_task_id** | Parent task ID (if this is a sub-task) |
+
+### Task Context Awareness
+
+**Before starting any task-related work, you MUST gather context:**
+
+1. **Read task details**: Use \`task_get\` to read description, goals, status
+2. **Read operation history**: Use \`task_operation_list\` to get the last ~20 operation records
+3. **Read parent context** (if \`parent_task_id\` exists): Understand overall goal
+
+**Why context matters**: Without it, you risk:
+- Working on outdated or wrong goals
+- Missing critical decisions made in operations
+- Losing parent task alignment
+- Duplicating or conflicting work
+
+### {{memory}}`,
+  coding: `You are an expert coding assistant.
+
+## Your Approach
+
+1. **Understand first**: Make sure you understand the user's requirements before writing code
+2. **Best practices**: Follow language-specific best practices and coding standards
+3. **Readable code**: Write clean, readable, and maintainable code
+4. **Error handling**: Always consider error cases and handle them appropriately
+5. **Testing**: Write tests when appropriate to verify correctness
+
+## Code Generation Guidelines
+
+- Use clear variable and function names
+- Add comments for complex logic
+- Follow the existing code style in the project
+- Consider performance implications
+- Think about edge cases`,
+  review: `You are a code review expert.
+
+## Review Focus Areas
+
+1. **Correctness**: Does the code do what it's supposed to do?
+2. **Security**: Are there any security vulnerabilities?
+3. **Performance**: Could the code be more efficient?
+4. **Readability**: Is the code easy to understand and maintain?
+5. **Testing**: Are there adequate tests?
+
+## Feedback Style
+
+- Be specific and actionable
+- Explain why something is a problem
+- Suggest improvements with examples
+- Acknowledge good practices`,
+  "project-memory": `# \u89D2\u8272
+\u4F60\u662F\u4E00\u4E2A\u9879\u76EE\u8BB0\u5FC6\u7BA1\u7406\u4E13\u5BB6\uFF0C\u8D1F\u8D23\u4ECE\u4F1A\u8BDD\u5386\u53F2\u4E2D\u63D0\u70BC\u9879\u76EE\u7684\u5173\u952E\u77E5\u8BC6\u3002
+
+# \u4F60\u7684\u804C\u8D23
+1. **\u4FE1\u606F\u6536\u96C6**\uFF1A\u5728\u63D0\u70BC\u8BB0\u5FC6\u524D\uFF0C\u5148\u6536\u96C6\u9879\u76EE\u4E0A\u4E0B\u6587\u4FE1\u606F\uFF08\u91CD\u8981\uFF01\uFF09
+2. **\u63D0\u70BC\u9879\u76EE\u77E5\u8BC6**\uFF1A\u4ECE\u5BF9\u8BDD\u4E2D\u63D0\u53D6\u6280\u672F\u6808\u3001\u67B6\u6784\u3001\u8BBE\u8BA1\u51B3\u7B56
+3. **\u62BD\u8C61\u89C4\u8303**\uFF1A\u5C06\u5177\u4F53\u7684\u6307\u4EE4\u548C\u53CD\u9988\u63D0\u70BC\u6210\u901A\u7528\u89C4\u5219
+4. **\u4FDD\u6301\u4E00\u81F4\u6027**\uFF1A\u786E\u4FDD\u65B0\u65E7\u77E5\u8BC6\u4E0D\u51B2\u7A81\uFF0C\u51B2\u7A81\u65F6\u6574\u5408\u6700\u4F18\u65B9\u6848
+5. **\u4E3B\u52A8\u9057\u5FD8**\uFF1A\u6807\u8BB0\u6216\u79FB\u9664\u8FC7\u65F6\u3001\u4E0D\u518D\u9002\u7528\u7684\u4FE1\u606F
+
+# \u9879\u76EE\u8BB0\u5FC6\u5185\u5BB9\u7C7B\u578B
+- \u9879\u76EE\u7B80\u4ECB\uFF1A\u9879\u76EE\u662F\u4EC0\u4E48\u3001\u89E3\u51B3\u4EC0\u4E48\u95EE\u9898
+- \u6280\u672F\u6808\uFF1A\u6846\u67B6\u3001\u8BED\u8A00\u3001\u6570\u636E\u5E93\u3001\u4E2D\u95F4\u4EF6\u7B49
+- \u67B6\u6784\u8BBE\u8BA1\uFF1A\u76EE\u5F55\u7ED3\u6784\u3001\u6A21\u5757\u5212\u5206\u3001\u6838\u5FC3\u7EC4\u4EF6
+- \u5F00\u53D1\u89C4\u8303\uFF1A\u547D\u540D\u89C4\u8303\u3001\u4EE3\u7801\u98CE\u683C\u3001\u63D0\u4EA4\u89C4\u8303\u3001PR \u89C4\u8303
+- \u5DE5\u4F5C\u6D41\u7A0B\uFF1A\u5F00\u53D1\u6D41\u7A0B\u3001\u6D4B\u8BD5\u8981\u6C42\u3001\u90E8\u7F72\u6D41\u7A0B
+- \u7EA6\u5B9A\u4FD7\u6210\uFF1A\u56E2\u961F\u5171\u8BC6\u3001\u975E\u6587\u6863\u5316\u7684\u60EF\u4F8B
+- \u5DF2\u77E5\u7EA6\u675F\uFF1A\u6027\u80FD\u8981\u6C42\u3001\u517C\u5BB9\u6027\u8981\u6C42\u3001\u5B89\u5168\u8003\u8651
+
+# \u63D0\u70BC\u539F\u5219
+1. **\u5177\u4F53\u2192\u62BD\u8C61**\uFF1A\u5C06\u5177\u4F53\u6307\u4EE4"\u8FD9\u91CC\u8981\u7528\u4E0B\u5212\u7EBF" \u2192 "\u547D\u540D: snake_case"
+2. **\u4FDD\u7559\u4E0A\u4E0B\u6587**\uFF1A\u4FDD\u7559\u4E3A\u4EC0\u4E48\u7684\u7B54\u6848\uFF0C\u4E0D\u53EA\u662F\u662F\u4EC0\u4E48
+3. **\u53EF\u6267\u884C\u6027**\uFF1A\u89C4\u5219\u8981\u5177\u4F53\u53EF\u6267\u884C\uFF0C\u4E0D\u8981\u6A21\u7CCA\u63CF\u8FF0
+4. **\u4F18\u5148\u7EA7**\uFF1A\u91CD\u8981\u7684\u653E\u524D\u9762\uFF0C\u7EC6\u8282\u653E\u540E\u9762
+
+# \u4FE1\u606F\u6536\u96C6\u6B65\u9AA4\uFF08\u5FC5\u987B\u6267\u884C\uFF01\uFF09
+
+\u5728\u63D0\u70BC\u9879\u76EE\u8BB0\u5FC6\u4E4B\u524D\uFF0C**\u5FC5\u987B\u5148\u6536\u96C6\u9879\u76EE\u4E0A\u4E0B\u6587**\uFF1A
+
+1. **\u9605\u8BFB\u9879\u76EE README**
+   - \u4F7F\u7528 \`glob("README*.md")\` \u67E5\u627E README \u6587\u4EF6
+   - \u4F7F\u7528 \`read_file("README.md")\` \u9605\u8BFB\u9879\u76EE\u8BF4\u660E
+   - \u4E86\u89E3\u9879\u76EE\u6982\u8FF0\u3001\u529F\u80FD\u5B9A\u4F4D\u3001\u4F7F\u7528\u65B9\u6CD5
+
+2. **\u68C0\u67E5\u8BBE\u8BA1\u6587\u6863**
+   - \u4F7F\u7528 \`glob("docs/**/*.md")\` \u67E5\u627E\u8BBE\u8BA1\u6587\u6863
+   - \u4F7F\u7528 \`read_file()\` \u9605\u8BFB\u67B6\u6784\u8BBE\u8BA1\u3001SPEC \u7B49\u6587\u6863
+   - \u4E86\u89E3\u8BBE\u8BA1\u51B3\u7B56\u53CA\u5176\u7406\u7531
+
+3. **\u67E5\u770B\u4EE3\u7801\u5B9E\u73B0**
+   - \u4F7F\u7528 \`glob("**/package.json")\` \u4E86\u89E3\u9879\u76EE\u4F9D\u8D56\u548C\u6280\u672F\u6808
+   - \u4F7F\u7528 \`glob("**/*.ts")\` \u6216 \`glob("**/*.tsx")\` \u4E86\u89E3\u4EE3\u7801\u7ED3\u6784
+   - \u4F7F\u7528 \`bash("ls -la src/")\` \u6216 \`bash("ls -la packages/")\` \u67E5\u770B\u76EE\u5F55\u7ED3\u6784
+
+4. **\u56DE\u987E\u73B0\u6709\u9879\u76EE\u8BB0\u5FC6**
+   - \u5DF2\u6709\u8BB0\u5FC6\u8DEF\u5F84\uFF1A\`{CURRENT_MEMORY}\` \u4E2D\u7684\u5185\u5BB9
+   - \u4E86\u89E3\u5DF2\u6709\u7684\u9879\u76EE\u8BB0\u5FC6\uFF0C\u907F\u514D\u91CD\u590D\u8BB0\u5F55
+
+5. **\u641C\u7D22\u4F1A\u8BDD\u5386\u53F2\uFF08\u53EF\u9009\uFF09**
+   - \u4F7F\u7528 \`search_sessions("\u9879\u76EE \u6280\u672F\u6808 \u67B6\u6784")\` \u641C\u7D22\u76F8\u5173\u4F1A\u8BDD
+   - \u4F7F\u7528 \`get_session(session_id)\` \u83B7\u53D6\u611F\u5174\u8DA3\u7684\u4F1A\u8BDD\u8BE6\u60C5
+
+# \u7528\u6237\u6307\u5BFC
+{USER_REQUIREMENT}
+
+# \u4F5C\u7528\u57DF
+{SCOPE}
+
+# \u73B0\u6709\u9879\u76EE\u8BB0\u5FC6
+{CURRENT_MEMORY}
+
+# \u53EF\u7528\u5DE5\u5177
+- search_sessions(query, session_id?, limit?): \u641C\u7D22\u4F1A\u8BDD\u5386\u53F2
+- get_session(session_id): \u83B7\u53D6\u6307\u5B9A\u4F1A\u8BDD
+- record_memory({ scope, mode, content, title }): \u5199\u5165\u8BB0\u5FC6\u6587\u4EF6
+- glob(pattern, cwd?): \u67E5\u627E\u5339\u914D\u7684\u6587\u4EF6
+- bash(command, workdir?): \u6267\u884C\u547D\u4EE4
+- read_file(path, offset?, limit?): \u8BFB\u53D6\u6587\u4EF6\u5185\u5BB9
+
+# \u6267\u884C\u6D41\u7A0B
+1. **\u6536\u96C6\u9879\u76EE\u4FE1\u606F**\uFF08\u5FC5\u987B\u6B65\u9AA4\uFF09
+   - \u4F7F\u7528 glob + read_file \u9605\u8BFB README.md\u3001\u8BBE\u8BA1\u6587\u6863
+   - \u4F7F\u7528 bash + glob \u4E86\u89E3\u4EE3\u7801\u7ED3\u6784\u548C\u4F9D\u8D56
+   - \u56DE\u987E\u73B0\u6709\u9879\u76EE\u8BB0\u5FC6
+
+2. \u7406\u89E3\u73B0\u6709\u9879\u76EE\u8BB0\u5FC6
+3. \u6839\u636E\u7528\u6237\u6307\u5BFC\u786E\u5B9A\u63D0\u70BC\u91CD\u70B9
+4. \u5206\u6790\u63D0\u70BC\u65B0\u77E5\u8BC6
+5. \u6574\u5408\u65B0\u65E7\u77E5\u8BC6\uFF0C\u751F\u6210\u5B8C\u6574\u7684\u9879\u76EE\u8BB0\u5FC6
+6. \u4F7F\u7528 record_memory({ scope: "project", mode: "overwrite", content, title }) \u5199\u5165
+
+# \u8F93\u51FA\u8981\u6C42
+\u76F4\u63A5\u8C03\u7528 record_memory \u5DE5\u5177\uFF0C\u5199\u5165\u65B0\u7684\u9879\u76EE\u8BB0\u5FC6\u3002
+\u8F93\u51FA\u683C\u5F0F\u4E3A Markdown\uFF0C\u4FDD\u6301\u7ED3\u6784\u6E05\u6670\u3002`,
+  "global-memory": `# \u89D2\u8272
+\u4F60\u662F\u4E00\u4E2A\u5168\u5C40\u8BB0\u5FC6\u7BA1\u7406\u4E13\u5BB6\uFF0C\u8D1F\u8D23\u63D0\u70BC\u8DE8\u9879\u76EE\u7684\u901A\u7528\u77E5\u8BC6\u548C\u7528\u6237\u504F\u597D\u3002
+
+# \u4F60\u7684\u804C\u8D23
+1. **\u7528\u6237\u753B\u50CF**\uFF1A\u63D0\u70BC\u7528\u6237\u7684\u6C9F\u901A\u98CE\u683C\u3001\u6280\u672F\u504F\u597D\u3001\u5DE5\u4F5C\u4E60\u60EF
+2. **\u76EE\u6807\u8FFD\u8E2A**\uFF1A\u8BB0\u5F55\u7528\u6237\u7684\u957F\u671F\u76EE\u6807\u3001\u5F53\u524D\u4EFB\u52A1\u3001\u8FDB\u5EA6
+3. **\u901A\u7528\u89C4\u5219**\uFF1A\u63D0\u70BC\u8DE8\u9879\u76EE\u90FD\u9002\u7528\u7684\u884C\u4E3A\u89C4\u8303
+4. **\u9057\u5FD8\u5904\u7406**\uFF1A\u6807\u8BB0\u6216\u79FB\u9664\u4E0D\u518D\u76F8\u5173\u7684\u76EE\u6807\u548C\u4FE1\u606F
+
+# \u5168\u5C40\u8BB0\u5FC6\u5185\u5BB9\u7C7B\u578B
+- \u7528\u6237\u504F\u597D\uFF1A\u6C9F\u901A\u98CE\u683C\uFF08\u7B80\u6D01/\u8BE6\u7EC6\uFF09\u3001\u53CD\u9988\u504F\u597D\u3001\u51B3\u7B56\u98CE\u683C
+- \u6280\u672F\u503E\u5411\uFF1A\u504F\u597D\u7684\u6280\u672F\u6808\u3001\u6846\u67B6\u3001\u8BED\u8A00\u3001\u5F00\u53D1\u5DE5\u5177
+- \u5DE5\u4F5C\u4E60\u60EF\uFF1A\u5DE5\u4F5C\u65F6\u95F4\u3001\u4E13\u6CE8\u5468\u671F\u3001\u504F\u597D\u65F6\u6BB5
+- \u5F53\u524D\u76EE\u6807\uFF1A\u6B63\u5728\u8FDB\u884C\u7684\u4E8B\u9879\u3001\u77ED\u671F\u76EE\u6807\uFF081-3\u6708\uFF09
+- \u957F\u671F\u613F\u666F\uFF1A\u5927\u65B9\u5411\u3001\u6218\u7565\u76EE\u6807\u3001\u4EBA\u751F\u9636\u6BB5
+- \u8DE8\u9879\u76EE\u89C4\u8303\uFF1A\u6240\u6709\u9879\u76EE\u90FD\u9075\u5FAA\u7684\u901A\u7528\u89C4\u5219
+
+# \u63D0\u70BC\u539F\u5219
+1. **\u4EE5\u7528\u6237\u4E3A\u4E2D\u5FC3**\uFF1A\u5173\u6CE8\u7528\u6237\u600E\u4E48\u8BF4\u3001\u600E\u4E48\u60F3\uFF0C\u4E0D\u53EA\u662F\u505A\u4EC0\u4E48
+2. **\u76EE\u6807\u5BFC\u5411**\uFF1A\u533A\u5206\u5DF2\u5B8C\u6210\u3001\u8FDB\u884C\u4E2D\u3001\u8BA1\u5212\u4E2D
+3. **\u53EF\u64CD\u4F5C\u6027**\uFF1A\u504F\u597D\u8981\u5177\u4F53\uFF0C\u5982"\u7528\u6237\u559C\u6B22\u5148\u770B\u7ED3\u8BBA"\u800C\u975E"\u7528\u6237\u5F88\u5FD9"
+4. **\u65F6\u95F4\u654F\u611F**\uFF1A\u6807\u8BB0\u6709\u65F6\u95F4\u9650\u5236\u7684\u76EE\u6807
+
+# \u7528\u6237\u6307\u5BFC
+{USER_REQUIREMENT}
+
+# \u4F5C\u7528\u57DF
+{SCOPE}
+
+# \u73B0\u6709\u5168\u5C40\u8BB0\u5FC6
+{CURRENT_MEMORY}
+
+# \u53EF\u7528\u5DE5\u5177
+- search_sessions(query, session_id?, limit?): \u641C\u7D22\u4F1A\u8BDD\u5386\u53F2
+- get_session(session_id): \u83B7\u53D6\u6307\u5B9A\u4F1A\u8BDD
+- record_memory({ scope, mode, content, title }): \u5199\u5165\u8BB0\u5FC6\u6587\u4EF6
+
+# \u6267\u884C\u6D41\u7A0B
+1. \u7406\u89E3\u73B0\u6709\u5168\u5C40\u8BB0\u5FC6
+2. \u6839\u636E\u7528\u6237\u6307\u5BFC\u786E\u5B9A\u63D0\u70BC\u91CD\u70B9
+3. \u4F7F\u7528\u5DE5\u5177\u641C\u7D22\u76F8\u5173\u4F1A\u8BDD\u5386\u53F2
+4. \u5206\u6790\u63D0\u70BC\u65B0\u77E5\u8BC6
+5. \u6574\u5408\u65B0\u65E7\u77E5\u8BC6\uFF0C\u751F\u6210\u5B8C\u6574\u7684\u5168\u5C40\u8BB0\u5FC6
+6. \u4F7F\u7528 record_memory({ scope: "global", mode: "overwrite", content, title }) \u5199\u5165
+
+# \u8F93\u51FA\u8981\u6C42
+\u76F4\u63A5\u8C03\u7528 record_memory \u5DE5\u5177\uFF0C\u5199\u5165\u65B0\u7684\u5168\u5C40\u8BB0\u5FC6\u3002
+\u8F93\u51FA\u683C\u5F0F\u4E3A Markdown\uFF0C\u4FDD\u6301\u7ED3\u6784\u6E05\u6670\u3002`
+};
+function getBuiltInPromptNames() {
+  return Object.keys(builtInPrompts);
+}
+function getBuiltInPrompt(name) {
+  return builtInPrompts[name];
+}
+
+// packages/core/src/env/prompt/prompt-component.ts
+var logger = createLogger("prompt");
+
+class PromptComponent extends BaseComponent {
+  name = "prompt";
+  version = "1.0.0";
+  prompts = new Map;
+  config;
+  configComponent;
+  renderer;
+  configWatcher;
+  constructor() {
+    super();
+  }
+  async init(config) {
+    await super.init(config);
+    const options = config.options;
+    if (!options?.configComponent) {
+      throw new Error("ConfigComponent is required for PromptComponent initialization");
+    }
+    this.configComponent = options.configComponent;
+    await this.registerConfig(options);
+    this.initRenderer();
+    await this.loadPrompts();
+    this.setStatus("running");
+    logger.info(`[PromptComponent] Initialized with ${this.prompts.size} prompts`);
+  }
+  async registerConfig(options) {
+    const configComponent = options.configComponent;
+    if (!configComponent)
+      return;
+    const { config, defaultName, promptPaths, variablePrefix, variableSuffix } = options;
+    configComponent.registerComponent(PROMPT_CONFIG_REGISTRATION);
+    await configComponent.load("prompt");
+    const prefix = "PROMPT";
+    const promptKeys = [
+      "prompt.defaultName",
+      "prompt.promptPaths",
+      "prompt.variablePrefix",
+      "prompt.variableSuffix",
+      "prompt.strictMode"
+    ];
+    for (const key of promptKeys) {
+      const envKey = toEnvKey(key, prefix);
+      const value = process.env[envKey];
+      if (value !== undefined) {
+        await configComponent.set(key, value);
+      }
+    }
+    const loadedKeys = new Set(promptKeys);
+    for (const envKey of Object.keys(process.env)) {
+      const configKey = envKeyToConfigKey(envKey, prefix, "prompt");
+      if (!configKey)
+        continue;
+      if (loadedKeys.has(configKey))
+        continue;
+      loadedKeys.add(configKey);
+      const value = process.env[envKey];
+      if (value !== undefined) {
+        await configComponent.set(configKey, value);
+      }
+    }
+    for (const [key, value] of Object.entries(PROMPT_DEFAULTS)) {
+      if (configComponent.get(key) === undefined) {
+        await configComponent.set(key, value);
+      }
+    }
+    if (config) {
+      const flatConfig = this.flattenConfig(config);
+      for (const [key, value] of Object.entries(flatConfig)) {
+        await configComponent.set(key, value);
+      }
+    }
+    if (defaultName !== undefined) {
+      await configComponent.set("prompt.defaultName", defaultName);
+    }
+    if (promptPaths !== undefined) {
+      await configComponent.set("prompt.promptPaths", promptPaths);
+    }
+    if (variablePrefix !== undefined) {
+      await configComponent.set("prompt.variablePrefix", variablePrefix);
+    }
+    if (variableSuffix !== undefined) {
+      await configComponent.set("prompt.variableSuffix", variableSuffix);
+    }
+    this.registerConfigWatcher(configComponent);
+    this.config = {
+      defaultName: configComponent.get("prompt.defaultName") || "default",
+      promptPaths: configComponent.get("prompt.promptPaths") || [],
+      variablePrefix: configComponent.get("prompt.variablePrefix") || "{{",
+      variableSuffix: configComponent.get("prompt.variableSuffix") || "}}",
+      strictMode: configComponent.get("prompt.strictMode") || false
+    };
+  }
+  flattenConfig(obj, prefix = "prompt") {
+    const result = {};
+    for (const [key, value] of Object.entries(obj)) {
+      const fullKey = `${prefix}.${key}`;
+      if (value && typeof value === "object" && !Array.isArray(value)) {
+        Object.assign(result, this.flattenConfig(value, fullKey));
+      } else {
+        result[fullKey] = value;
+      }
+    }
+    return result;
+  }
+  registerConfigWatcher(configComponent) {
+    if (typeof configComponent.watch !== "function") {
+      return;
+    }
+    this.configWatcher = configComponent.watch("prompt.*", (event) => {
+      this.onConfigChange(event);
+    });
+  }
+  onConfigChange(event) {
+    const key = event.key;
+    const value = event.newValue;
+    if (value === undefined)
+      return;
+    logger.debug(`[PromptComponent] Config updated: ${key} = ${JSON.stringify(value)}`);
+    switch (key) {
+      case "prompt.defaultName":
+        if (this.config)
+          this.config.defaultName = value;
+        break;
+      case "prompt.promptPaths":
+        if (this.config)
+          this.config.promptPaths = value;
+        break;
+      case "prompt.variablePrefix":
+        if (this.config) {
+          this.config.variablePrefix = value;
+          this.initRenderer();
+        }
+        break;
+      case "prompt.variableSuffix":
+        if (this.config) {
+          this.config.variableSuffix = value;
+          this.initRenderer();
+        }
+        break;
+      case "prompt.strictMode":
+        if (this.config)
+          this.config.strictMode = value;
+        break;
+    }
+  }
+  initRenderer() {
+    const config = this.config || {
+      defaultName: "default",
+      promptPaths: [],
+      variablePrefix: "{{",
+      variableSuffix: "}}",
+      strictMode: false
+    };
+    this.renderer = new PromptRenderer({
+      prefix: config.variablePrefix,
+      suffix: config.variableSuffix,
+      strict: config.strictMode,
+      onMissingVariable: (name) => {
+        logger.warn(`Undefined variable: ${name}`);
+        return `{{${name}}}`;
+      }
+    });
+  }
+  async onStart() {
+    logger.info("[PromptComponent] Started");
+  }
+  async onStop() {
+    this.prompts.clear();
+    this.setStatus("stopped");
+    logger.info("[PromptComponent] Stopped");
+  }
+  getPromptConfig(key, defaultValue) {
+    if (this.config && key in this.config) {
+      return this.config[key] ?? defaultValue;
+    }
+    return defaultValue;
+  }
+  add(name, content, source = "inline") {
+    const entry = {
+      name,
+      content,
+      source,
+      overridable: true,
+      loadedAt: Date.now()
+    };
+    const existing = this.prompts.get(name);
+    if (existing && !existing.overridable) {
+      logger.debug(`[PromptComponent] Skip override for non-overridable prompt: ${name}`);
+      return;
+    }
+    this.prompts.set(name, entry);
+    logger.debug(`[PromptComponent] Added prompt: ${name} (${source})`);
+  }
+  get(name) {
+    return this.prompts.get(name)?.content;
+  }
+  getEntry(name) {
+    return this.prompts.get(name);
+  }
+  has(name) {
+    return this.prompts.has(name);
+  }
+  delete(name) {
+    return this.prompts.delete(name);
+  }
+  list() {
+    return Array.from(this.prompts.keys());
+  }
+  size() {
+    return this.prompts.size;
+  }
+  async getPrompt(name, variables = {}) {
+    const defaultName = this.getPromptConfig("defaultName", "default");
+    const targetName = this.has(name) ? name : defaultName;
+    const entry = this.prompts.get(targetName);
+    if (!entry) {
+      logger.warn(`[PromptComponent] Prompt not found: ${name}, using fallback`);
+      return "You are a helpful assistant.";
+    }
+    return this.render(entry.content, variables, { name: targetName });
+  }
+  async render(content, variables = {}, context) {
+    const hookContext = {
+      name: context?.name || "anonymous",
+      originalContent: content,
+      renderedContent: content,
+      variables
+    };
+    await this.executeHooks(PromptHookPoints.BEFORE_RENDER, hookContext);
+    hookContext.renderedContent = this.renderer.render(hookContext.originalContent, variables);
+    await this.executeHooks(PromptHookPoints.AFTER_RENDER, hookContext);
+    return hookContext.renderedContent;
+  }
+  extractVariables(content) {
+    return this.renderer.extractVariables(content);
+  }
+  async loadPrompts() {
+    await this.loadBuiltInPrompts();
+    await this.loadExternalPrompts();
+  }
+  async loadBuiltInPrompts() {
+    for (const [name, content] of Object.entries(builtInPrompts)) {
+      if (content) {
+        this.prompts.set(name, {
+          name,
+          content,
+          source: "built-in",
+          overridable: false,
+          loadedAt: Date.now()
+        });
+        logger.debug(`[PromptComponent] Loaded built-in prompt: ${name}`);
+      }
+    }
+    logger.info(`[PromptComponent] Loaded ${this.prompts.size} built-in prompts`);
+  }
+  async loadExternalPrompts() {
+    const promptPaths = this.getPromptConfig("promptPaths", []);
+    for (const pathConfig of promptPaths) {
+      try {
+        if (pathConfig.type === "file") {
+          await this.loadFromFile(pathConfig.path, pathConfig.name);
+        } else if (pathConfig.type === "directory") {
+          await this.loadFromDirectory(pathConfig.path, pathConfig.extension || ".md", pathConfig.recursive !== false);
+        }
+      } catch (error) {
+        logger.error(`[PromptComponent] Failed to load from ${pathConfig.path}:`, error);
+      }
+    }
+  }
+  async loadFromFile(filePath, name) {
+    try {
+      const content = await readFile(filePath, "utf-8");
+      const promptName = name || basename2(filePath, extname(filePath));
+      this.add(promptName, content.trim(), "file");
+      const entry = this.prompts.get(promptName);
+      if (entry)
+        entry.filePath = filePath;
+      logger.debug(`[PromptComponent] Loaded prompt from file: ${filePath}`);
+      return true;
+    } catch (error) {
+      logger.error(`[PromptComponent] Failed to load file ${filePath}:`, error);
+      return false;
+    }
+  }
+  async loadFromDirectory(directory, extension = ".md", recursive = true) {
+    let loaded = 0;
+    try {
+      const files = await this.findFiles(directory, extension, recursive);
+      for (const filePath of files) {
+        const relativePath = filePath.replace(directory + "/", "");
+        const promptName = relativePath.replace(/\\/g, "/").replace(new RegExp(escapeRegex2(extension) + "$"), "").replace(/\//g, "-");
+        const content = await readFile(filePath, "utf-8");
+        this.add(promptName, content.trim(), "directory");
+        const entry = this.prompts.get(promptName);
+        if (entry)
+          entry.filePath = filePath;
+        loaded++;
+      }
+      logger.info(`[PromptComponent] Loaded ${loaded} prompts from directory: ${directory}`);
+    } catch (error) {
+      logger.error(`[PromptComponent] Failed to load directory ${directory}:`, error);
+    }
+    return loaded;
+  }
+  async findFiles(dir, extension, recursive) {
+    const files = [];
+    try {
+      const entries = await readdir(dir, { withFileTypes: true });
+      for (const entry of entries) {
+        const fullPath = join2(dir, entry.name);
+        if (entry.isDirectory() && recursive) {
+          const subFiles = await this.findFiles(fullPath, extension, true);
+          files.push(...subFiles);
+        } else if (entry.isFile() && entry.name.endsWith(extension)) {
+          files.push(fullPath);
+        }
+      }
+    } catch (error) {
+      logger.warn(`[PromptComponent] Cannot read directory ${dir}:`, error);
+    }
+    return files;
+  }
+  registerPromptHook(hookPoint, name, fn, priority) {
+    this.addHook(hookPoint, name, fn, priority);
+  }
+  getHookPoints() {
+    return [PromptHookPoints.BEFORE_RENDER, PromptHookPoints.AFTER_RENDER];
+  }
+}
+function escapeRegex2(str) {
+  return str.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+export {
+  PromptRenderer,
+  PromptPathSchema,
+  PromptConfigSchema,
+  PromptComponent
+};