@dexto/core 1.5.2 → 1.5.4

package/dist/session/session-manager.js

@@ -494,6 +494,152 @@ class SessionManager {
       sessionTTL: this.sessionTTL
     };
   }
+  /**
+   * Get the raw session data for a session ID.
+   * This is used for accessing continuation fields and other metadata.
+   *
+   * @param sessionId The session ID
+   * @returns Session data if found, undefined otherwise
+   */
+  async getSessionData(sessionId) {
+    await this.ensureInitialized();
+    const sessionKey = `session:${sessionId}`;
+    return await this.services.storageManager.getDatabase().get(sessionKey);
+  }
+  /**
+   * Creates a continuation session from a compacted session.
+   * The new session will have the summary as its first message.
+   *
+   * @param fromSessionId The session being compacted
+   * @returns The new session ID and ChatSession
+   */
+  async createContinuationSession(fromSessionId) {
+    await this.ensureInitialized();
+    const fromSessionData = await this.getSessionData(fromSessionId);
+    if (!fromSessionData) {
+      throw SessionError.notFound(fromSessionId);
+    }
+    const activeSessionKeys = await this.services.storageManager.getDatabase().list("session:");
+    if (activeSessionKeys.length >= this.maxSessions) {
+      throw SessionError.maxSessionsExceeded(activeSessionKeys.length, this.maxSessions);
+    }
+    const newSessionId = randomUUID();
+    const originalLLMConfig = this.services.stateManager.getRuntimeConfig(fromSessionId).llm;
+    this.services.stateManager.updateLLM(originalLLMConfig, newSessionId);
+    const parentCompactionCount = fromSessionData.compactionCount ?? 0;
+    const newSessionData = {
+      id: newSessionId,
+      createdAt: Date.now(),
+      lastActivity: Date.now(),
+      messageCount: 0,
+      continuedFrom: fromSessionId,
+      compactionCount: parentCompactionCount + 1,
+      ...fromSessionData.userId !== void 0 && { userId: fromSessionData.userId },
+      ...fromSessionData.metadata && {
+        metadata: {
+          ...fromSessionData.metadata,
+          title: fromSessionData.metadata?.title
+          // Preserve title
+        }
+      }
+    };
+    const sessionKey = `session:${newSessionId}`;
+    try {
+      await this.services.storageManager.getDatabase().set(sessionKey, newSessionData);
+      await this.services.storageManager.getCache().set(sessionKey, newSessionData, this.sessionTTL / 1e3);
+    } catch (error) {
+      this.services.stateManager.clearSessionOverride(newSessionId);
+      throw error;
+    }
+    const session = new ChatSession(
+      { ...this.services, sessionManager: this },
+      newSessionId,
+      this.logger
+    );
+    try {
+      await session.init();
+    } catch (error) {
+      session.dispose();
+      await this.services.storageManager.getDatabase().delete(sessionKey);
+      await this.services.storageManager.getCache().delete(sessionKey);
+      this.services.stateManager.clearSessionOverride(newSessionId);
+      throw error;
+    }
+    this.sessions.set(newSessionId, session);
+    this.logger.info(
+      `Created continuation session ${newSessionId} from compacted session ${fromSessionId}`
+    );
+    return { sessionId: newSessionId, session };
+  }
+  /**
+   * Marks a session as compacted and links it to its continuation session.
+   *
+   * @param sessionId The session being compacted
+   * @param continuedToId The new session created from compaction
+   */
+  async markSessionCompacted(sessionId, continuedToId) {
+    await this.ensureInitialized();
+    const sessionKey = `session:${sessionId}`;
+    const sessionData = await this.services.storageManager.getDatabase().get(sessionKey);
+    if (!sessionData) {
+      throw SessionError.notFound(sessionId);
+    }
+    sessionData.continuedTo = continuedToId;
+    sessionData.compactedAt = Date.now();
+    sessionData.lastActivity = Date.now();
+    await this.services.storageManager.getDatabase().set(sessionKey, sessionData);
+    await this.services.storageManager.getCache().set(sessionKey, sessionData, this.sessionTTL / 1e3);
+    this.logger.debug(`Marked session ${sessionId} as compacted \u2192 ${continuedToId}`);
+  }
+  /**
+   * Gets the compaction count for a session.
+   * Returns 0 if the session has never been compacted.
+   *
+   * @param sessionId The session ID
+   * @returns Number of times this session chain has been compacted
+   */
+  async getCompactionCount(sessionId) {
+    const sessionData = await this.getSessionData(sessionId);
+    return sessionData?.compactionCount ?? 0;
+  }
+  /**
+   * Gets the chain of linked sessions (ancestors and descendants).
+   * Returns sessions in chronological order (oldest first).
+   *
+   * @param sessionId Any session ID in the chain
+   * @returns Array of session data in the chain, ordered chronologically
+   */
+  async getSessionChain(sessionId) {
+    await this.ensureInitialized();
+    const chain = [];
+    const visited = /* @__PURE__ */ new Set();
+    let currentData = await this.getSessionData(sessionId);
+    if (!currentData) {
+      return [];
+    }
+    while (currentData?.continuedFrom && !visited.has(currentData.continuedFrom)) {
+      visited.add(currentData.id);
+      const parent = await this.getSessionData(currentData.continuedFrom);
+      if (!parent) {
+        break;
+      }
+      currentData = parent;
+    }
+    if (currentData && !visited.has(currentData.id)) {
+      visited.add(currentData.id);
+    }
+    visited.clear();
+    while (currentData && !visited.has(currentData.id)) {
+      visited.add(currentData.id);
+      chain.push(currentData);
+      if (currentData.continuedTo) {
+        currentData = await this.getSessionData(currentData.continuedTo);
+      } else {
+        break;
+      }
+    }
+    return chain;
+  }
   /**
    * Cleanup all sessions and resources.
    * This should be called when shutting down the application.

package/dist/session/title-generator.cjs

@@ -52,11 +52,11 @@ async function generateSessionTitle(config, toolManager, systemPromptManager, re
       "Message:",
       sanitizeUserText(userText, 512)
     ].join("\n");
-    const result = await tempService.stream(
+    const streamResult = await tempService.stream(
       instruction,
       controller ? { signal: controller.signal } : void 0
     );
-    const processed = postProcessTitle(result);
+    const processed = postProcessTitle(streamResult.text);
     if (!processed) {
       return { error: "LLM returned empty title" };
     }

package/dist/session/title-generator.js

@@ -29,11 +29,11 @@ async function generateSessionTitle(config, toolManager, systemPromptManager, re
       "Message:",
       sanitizeUserText(userText, 512)
     ].join("\n");
-    const result = await tempService.stream(
+    const streamResult = await tempService.stream(
       instruction,
       controller ? { signal: controller.signal } : void 0
     );
-    const processed = postProcessTitle(result);
+    const processed = postProcessTitle(streamResult.text);
     if (!processed) {
       return { error: "LLM returned empty title" };
     }

package/dist/systemPrompt/in-built-prompts.cjs

@@ -1,7 +1,9 @@
 "use strict";
+var __create = Object.create;
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
 var __hasOwnProp = Object.prototype.hasOwnProperty;
 var __export = (target, all) => {
   for (var name in all)
@@ -15,10 +17,19 @@ var __copyProps = (to, from, except, desc) => {
   }
   return to;
 };
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 var in_built_prompts_exports = {};
 __export(in_built_prompts_exports, {
   getCurrentDate: () => getCurrentDate,
+  getEnvironmentInfo: () => getEnvironmentInfo,
   getResourceData: () => getResourceData
 });
 module.exports = __toCommonJS(in_built_prompts_exports);
@@ -26,6 +37,30 @@ async function getCurrentDate(_context) {
   const date = (/* @__PURE__ */ new Date()).toISOString().split("T")[0];
   return `<date>Current date: ${date}</date>`;
 }
+async function getEnvironmentInfo(_context) {
+  if (typeof process === "undefined" || !process.cwd) {
+    return "<environment>Environment info not available in browser context</environment>";
+  }
+  try {
+    const [{ existsSync }, { platform }, { join }] = await Promise.all([
+      import("fs"),
+      import("os"),
+      import("path")
+    ]);
+    const cwd = process.cwd();
+    const os = platform();
+    const isGitRepo = existsSync(join(cwd, ".git"));
+    const shell = process.env.SHELL || (os === "win32" ? "cmd.exe" : "/bin/sh");
+    return `<environment>
+  <cwd>${cwd}</cwd>
+  <platform>${os}</platform>
+  <is_git_repo>${isGitRepo}</is_git_repo>
+  <shell>${shell}</shell>
+</environment>`;
+  } catch {
+    return "<environment>Environment info not available</environment>";
+  }
+}
 async function getResourceData(context) {
   const resources = await context.mcpManager.listAllResources();
   if (!resources || resources.length === 0) {
@@ -58,5 +93,6 @@ ${parts.join("\n")}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   getCurrentDate,
+  getEnvironmentInfo,
   getResourceData
 });

package/dist/systemPrompt/in-built-prompts.d.ts

@@ -10,8 +10,25 @@ import { DynamicContributorContext } from './types.js';
  * - Place all dynamic prompt-generating functions in this file.
  * - Also update the `registry.ts` file to register the new function.
  * - Use XML tags to indicate the start and end of the dynamic prompt - they are known to improve performance
- * - Each function should be named clearly to reflect its purpose (e.g., getCurrentDate, getResourceData).
+ * - Each function should be named clearly to reflect its purpose (e.g., getCurrentDate, getEnvironmentInfo).
+ */
+/**
+ * Returns the current date (without time to prevent KV-cache invalidation).
  */
 export declare function getCurrentDate(_context: DynamicContributorContext): Promise<string>;
+/**
+ * Returns environment information to help agents understand their execution context.
+ * This is kept separate from date to optimize caching (env info rarely changes).
+ *
+ * Includes:
+ * - Working directory (cwd)
+ * - Platform (os)
+ * - Whether the cwd is a git repository
+ * - Default shell
+ *
+ * Note: This function uses dynamic imports for Node.js modules to maintain browser compatibility.
+ * In browser environments, it returns a placeholder message.
+ */
+export declare function getEnvironmentInfo(_context: DynamicContributorContext): Promise<string>;
 export declare function getResourceData(context: DynamicContributorContext): Promise<string>;
 //# sourceMappingURL=in-built-prompts.d.ts.map

package/dist/systemPrompt/in-built-prompts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"in-built-prompts.d.ts","sourceRoot":"","sources":["../../src/systemPrompt/in-built-prompts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,MAAM,YAAY,CAAC;AAEvD;;;;;;;;;;;;GAYG;AAEH,wBAAsB,cAAc,CAAC,QAAQ,EAAE,yBAAyB,GAAG,OAAO,CAAC,MAAM,CAAC,CAIzF;AAGD,wBAAsB,eAAe,CAAC,OAAO,EAAE,yBAAyB,GAAG,OAAO,CAAC,MAAM,CAAC,CAiCzF"}
+{"version":3,"file":"in-built-prompts.d.ts","sourceRoot":"","sources":["../../src/systemPrompt/in-built-prompts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,MAAM,YAAY,CAAC;AAEvD;;;;;;;;;;;;GAYG;AAEH;;GAEG;AACH,wBAAsB,cAAc,CAAC,QAAQ,EAAE,yBAAyB,GAAG,OAAO,CAAC,MAAM,CAAC,CAGzF;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,kBAAkB,CAAC,QAAQ,EAAE,yBAAyB,GAAG,OAAO,CAAC,MAAM,CAAC,CA4B7F;AAGD,wBAAsB,eAAe,CAAC,OAAO,EAAE,yBAAyB,GAAG,OAAO,CAAC,MAAM,CAAC,CAiCzF"}

package/dist/systemPrompt/in-built-prompts.js

@@ -3,6 +3,30 @@ async function getCurrentDate(_context) {
   const date = (/* @__PURE__ */ new Date()).toISOString().split("T")[0];
   return `<date>Current date: ${date}</date>`;
 }
+async function getEnvironmentInfo(_context) {
+  if (typeof process === "undefined" || !process.cwd) {
+    return "<environment>Environment info not available in browser context</environment>";
+  }
+  try {
+    const [{ existsSync }, { platform }, { join }] = await Promise.all([
+      import("fs"),
+      import("os"),
+      import("path")
+    ]);
+    const cwd = process.cwd();
+    const os = platform();
+    const isGitRepo = existsSync(join(cwd, ".git"));
+    const shell = process.env.SHELL || (os === "win32" ? "cmd.exe" : "/bin/sh");
+    return `<environment>
+  <cwd>${cwd}</cwd>
+  <platform>${os}</platform>
+  <is_git_repo>${isGitRepo}</is_git_repo>
+  <shell>${shell}</shell>
+</environment>`;
+  } catch {
+    return "<environment>Environment info not available</environment>";
+  }
+}
 async function getResourceData(context) {
   const resources = await context.mcpManager.listAllResources();
   if (!resources || resources.length === 0) {
@@ -34,5 +58,6 @@ ${parts.join("\n")}
 }
 export {
   getCurrentDate,
+  getEnvironmentInfo,
   getResourceData
 };

package/dist/systemPrompt/manager.cjs

@@ -112,6 +112,28 @@ class SystemPromptManager {
   getContributors() {
     return this.contributors;
   }
+  /**
+   * Add a contributor dynamically after construction.
+   * The contributor will be inserted in priority order.
+   */
+  addContributor(contributor) {
+    this.contributors.push(contributor);
+    this.contributors.sort((a, b) => a.priority - b.priority);
+    this.logger.debug(
+      `Added contributor: ${contributor.id} (priority: ${contributor.priority})`
+    );
+  }
+  /**
+   * Remove a contributor by ID.
+   * Returns true if removed, false if not found.
+   */
+  removeContributor(id) {
+    const index = this.contributors.findIndex((c) => c.id === id);
+    if (index === -1) return false;
+    this.contributors.splice(index, 1);
+    this.logger.debug(`Removed contributor: ${id}`);
+    return true;
+  }
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {

package/dist/systemPrompt/manager.d.ts

@@ -21,5 +21,15 @@ export declare class SystemPromptManager {
      * Expose current list of contributors (for inspection or testing).
      */
     getContributors(): SystemPromptContributor[];
+    /**
+     * Add a contributor dynamically after construction.
+     * The contributor will be inserted in priority order.
+     */
+    addContributor(contributor: SystemPromptContributor): void;
+    /**
+     * Remove a contributor by ID.
+     * Returns true if removed, false if not found.
+     */
+    removeContributor(id: string): boolean;
 }
 //# sourceMappingURL=manager.d.ts.map

package/dist/systemPrompt/manager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../src/systemPrompt/manager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,2BAA2B,EAA8B,MAAM,cAAc,CAAC;AAG5F,OAAO,KAAK,EAAE,aAAa,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAEjF,OAAO,KAAK,EAAE,uBAAuB,EAAE,yBAAyB,EAAE,MAAM,YAAY,CAAC;AAErF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAI1D;;;GAGG;AACH,qBAAa,mBAAmB;IAC5B,OAAO,CAAC,YAAY,CAA4B;IAChD,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,aAAa,CAAgB;IACrC,OAAO,CAAC,MAAM,CAAe;gBAIzB,MAAM,EAAE,2BAA2B,EACnC,SAAS,EAAE,MAAM,EACjB,aAAa,EAAE,aAAa,EAC5B,cAAc,EAAE,uBAAuB,GAAG,SAAS,EACnD,MAAM,EAAE,YAAY;IAsCxB,OAAO,CAAC,iBAAiB;IAkCzB;;OAEG;IACG,KAAK,CAAC,GAAG,EAAE,yBAAyB,GAAG,OAAO,CAAC,MAAM,CAAC;IAa5D;;OAEG;IACH,eAAe,IAAI,uBAAuB,EAAE;CAG/C"}
+{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../src/systemPrompt/manager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,2BAA2B,EAA8B,MAAM,cAAc,CAAC;AAG5F,OAAO,KAAK,EAAE,aAAa,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAEjF,OAAO,KAAK,EAAE,uBAAuB,EAAE,yBAAyB,EAAE,MAAM,YAAY,CAAC;AAErF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAI1D;;;GAGG;AACH,qBAAa,mBAAmB;IAC5B,OAAO,CAAC,YAAY,CAA4B;IAChD,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,aAAa,CAAgB;IACrC,OAAO,CAAC,MAAM,CAAe;gBAIzB,MAAM,EAAE,2BAA2B,EACnC,SAAS,EAAE,MAAM,EACjB,aAAa,EAAE,aAAa,EAC5B,cAAc,EAAE,uBAAuB,GAAG,SAAS,EACnD,MAAM,EAAE,YAAY;IAsCxB,OAAO,CAAC,iBAAiB;IAkCzB;;OAEG;IACG,KAAK,CAAC,GAAG,EAAE,yBAAyB,GAAG,OAAO,CAAC,MAAM,CAAC;IAa5D;;OAEG;IACH,eAAe,IAAI,uBAAuB,EAAE;IAI5C;;;OAGG;IACH,cAAc,CAAC,WAAW,EAAE,uBAAuB,GAAG,IAAI;IAQ1D;;;OAGG;IACH,iBAAiB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;CAOzC"}

package/dist/systemPrompt/manager.js

@@ -90,6 +90,28 @@ class SystemPromptManager {
   getContributors() {
     return this.contributors;
   }
+  /**
+   * Add a contributor dynamically after construction.
+   * The contributor will be inserted in priority order.
+   */
+  addContributor(contributor) {
+    this.contributors.push(contributor);
+    this.contributors.sort((a, b) => a.priority - b.priority);
+    this.logger.debug(
+      `Added contributor: ${contributor.id} (priority: ${contributor.priority})`
+    );
+  }
+  /**
+   * Remove a contributor by ID.
+   * Returns true if removed, false if not found.
+   */
+  removeContributor(id) {
+    const index = this.contributors.findIndex((c) => c.id === id);
+    if (index === -1) return false;
+    this.contributors.splice(index, 1);
+    this.logger.debug(`Removed contributor: ${id}`);
+    return true;
+  }
 }
 export {
   SystemPromptManager

package/dist/systemPrompt/registry.cjs

@@ -34,9 +34,10 @@ __export(registry_exports, {
 });
 module.exports = __toCommonJS(registry_exports);
 var handlers = __toESM(require("./in-built-prompts.js"), 1);
-const PROMPT_GENERATOR_SOURCES = ["date", "resources"];
+const PROMPT_GENERATOR_SOURCES = ["date", "env", "resources"];
 const PROMPT_GENERATOR_REGISTRY = {
   date: handlers.getCurrentDate,
+  env: handlers.getEnvironmentInfo,
   resources: handlers.getResourceData
 };
 function getPromptGenerator(source) {

package/dist/systemPrompt/registry.d.ts

@@ -3,7 +3,7 @@ import { DynamicContributorContext } from './types.js';
  * This file contains the registry of all the functions that can generate dynamic prompt pieces at runtime.
  */
 export type DynamicPromptGenerator = (context: DynamicContributorContext) => Promise<string>;
-export declare const PROMPT_GENERATOR_SOURCES: readonly ["date", "resources"];
+export declare const PROMPT_GENERATOR_SOURCES: readonly ["date", "env", "resources"];
 export type PromptGeneratorSource = (typeof PROMPT_GENERATOR_SOURCES)[number];
 export declare const PROMPT_GENERATOR_REGISTRY: Record<PromptGeneratorSource, DynamicPromptGenerator>;
 export declare function getPromptGenerator(source: PromptGeneratorSource): DynamicPromptGenerator | undefined;

package/dist/systemPrompt/registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/systemPrompt/registry.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,yBAAyB,EAAE,MAAM,YAAY,CAAC;AAEvD;;GAEG;AACH,MAAM,MAAM,sBAAsB,GAAG,CAAC,OAAO,EAAE,yBAAyB,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;AAG7F,eAAO,MAAM,wBAAwB,gCAAiC,CAAC;AAEvE,MAAM,MAAM,qBAAqB,GAAG,CAAC,OAAO,wBAAwB,CAAC,CAAC,MAAM,CAAC,CAAC;AAG9E,eAAO,MAAM,yBAAyB,EAAE,MAAM,CAAC,qBAAqB,EAAE,sBAAsB,CAG3F,CAAC;AAGF,wBAAgB,kBAAkB,CAC9B,MAAM,EAAE,qBAAqB,GAC9B,sBAAsB,GAAG,SAAS,CAEpC"}
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/systemPrompt/registry.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,yBAAyB,EAAE,MAAM,YAAY,CAAC;AAEvD;;GAEG;AACH,MAAM,MAAM,sBAAsB,GAAG,CAAC,OAAO,EAAE,yBAAyB,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;AAG7F,eAAO,MAAM,wBAAwB,uCAAwC,CAAC;AAE9E,MAAM,MAAM,qBAAqB,GAAG,CAAC,OAAO,wBAAwB,CAAC,CAAC,MAAM,CAAC,CAAC;AAG9E,eAAO,MAAM,yBAAyB,EAAE,MAAM,CAAC,qBAAqB,EAAE,sBAAsB,CAI3F,CAAC;AAGF,wBAAgB,kBAAkB,CAC9B,MAAM,EAAE,qBAAqB,GAC9B,sBAAsB,GAAG,SAAS,CAEpC"}

package/dist/systemPrompt/registry.js

@@ -1,8 +1,9 @@
 import "../chunk-PTJYTZNU.js";
 import * as handlers from "./in-built-prompts.js";
-const PROMPT_GENERATOR_SOURCES = ["date", "resources"];
+const PROMPT_GENERATOR_SOURCES = ["date", "env", "resources"];
 const PROMPT_GENERATOR_REGISTRY = {
   date: handlers.getCurrentDate,
+  env: handlers.getEnvironmentInfo,
   resources: handlers.getResourceData
 };
 function getPromptGenerator(source) {

package/dist/systemPrompt/schemas.cjs

@@ -102,6 +102,13 @@ const SystemPromptContributorsSchema = import_zod.z.object({
       source: "date",
       enabled: true
     },
+    {
+      id: "env",
+      type: "dynamic",
+      priority: 15,
+      source: "env",
+      enabled: true
+    },
     {
       id: "resources",
       type: "dynamic",

package/dist/systemPrompt/schemas.d.ts

@@ -24,18 +24,18 @@ export declare const ContributorConfigSchema: z.ZodDiscriminatedUnion<"type", [z
     enabled: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
 } & {
     type: z.ZodLiteral<"dynamic">;
-    source: z.ZodEnum<["date", "resources"]>;
+    source: z.ZodEnum<["date", "env", "resources"]>;
 }, "strict", z.ZodTypeAny, {
     type: "dynamic";
     enabled: boolean;
     id: string;
     priority: number;
-    source: "date" | "resources";
+    source: "date" | "env" | "resources";
 }, {
     type: "dynamic";
     id: string;
     priority: number;
-    source: "date" | "resources";
+    source: "date" | "env" | "resources";
     enabled?: boolean | undefined;
 }>, z.ZodObject<{
     id: z.ZodString;
@@ -118,18 +118,18 @@ export declare const SystemPromptContributorsSchema: z.ZodObject<{
         enabled: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
     } & {
         type: z.ZodLiteral<"dynamic">;
-        source: z.ZodEnum<["date", "resources"]>;
+        source: z.ZodEnum<["date", "env", "resources"]>;
     }, "strict", z.ZodTypeAny, {
         type: "dynamic";
         enabled: boolean;
         id: string;
         priority: number;
-        source: "date" | "resources";
+        source: "date" | "env" | "resources";
     }, {
         type: "dynamic";
         id: string;
         priority: number;
-        source: "date" | "resources";
+        source: "date" | "env" | "resources";
         enabled?: boolean | undefined;
     }>, z.ZodObject<{
         id: z.ZodString;
@@ -196,7 +196,7 @@ export declare const SystemPromptContributorsSchema: z.ZodObject<{
         enabled: boolean;
         id: string;
         priority: number;
-        source: "date" | "resources";
+        source: "date" | "env" | "resources";
     } | {
         type: "file";
         options: {
@@ -222,7 +222,7 @@ export declare const SystemPromptContributorsSchema: z.ZodObject<{
         type: "dynamic";
         id: string;
         priority: number;
-        source: "date" | "resources";
+        source: "date" | "env" | "resources";
         enabled?: boolean | undefined;
     } | {
         type: "file";
@@ -273,18 +273,18 @@ export declare const SystemPromptConfigSchema: z.ZodBranded<z.ZodUnion<[z.ZodEff
         enabled: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
     } & {
         type: z.ZodLiteral<"dynamic">;
-        source: z.ZodEnum<["date", "resources"]>;
+        source: z.ZodEnum<["date", "env", "resources"]>;
     }, "strict", z.ZodTypeAny, {
         type: "dynamic";
         enabled: boolean;
         id: string;
         priority: number;
-        source: "date" | "resources";
+        source: "date" | "env" | "resources";
     }, {
         type: "dynamic";
         id: string;
         priority: number;
-        source: "date" | "resources";
+        source: "date" | "env" | "resources";
         enabled?: boolean | undefined;
     }>, z.ZodObject<{
         id: z.ZodString;
@@ -351,7 +351,7 @@ export declare const SystemPromptConfigSchema: z.ZodBranded<z.ZodUnion<[z.ZodEff
         enabled: boolean;
         id: string;
         priority: number;
-        source: "date" | "resources";
+        source: "date" | "env" | "resources";
     } | {
         type: "file";
         options: {
@@ -377,7 +377,7 @@ export declare const SystemPromptConfigSchema: z.ZodBranded<z.ZodUnion<[z.ZodEff
         type: "dynamic";
         id: string;
         priority: number;
-        source: "date" | "resources";
+        source: "date" | "env" | "resources";
         enabled?: boolean | undefined;
     } | {
         type: "file";

package/dist/systemPrompt/schemas.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../src/systemPrompt/schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AA0FxB,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAkB/B,CAAC;AAGN,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAExE,MAAM,MAAM,0BAA0B,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAElF,eAAO,MAAM,8BAA8B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAuB9B,CAAC;AAGd,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;oCAUM,CAAC;AAG5C,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAC1E,MAAM,MAAM,2BAA2B,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,wBAAwB,CAAC,CAAC"}
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../src/systemPrompt/schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AA0FxB,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAkB/B,CAAC;AAGN,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAExE,MAAM,MAAM,0BAA0B,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAElF,eAAO,MAAM,8BAA8B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA8B9B,CAAC;AAGd,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;oCAUM,CAAC;AAG5C,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAC1E,MAAM,MAAM,2BAA2B,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,wBAAwB,CAAC,CAAC"}

package/dist/systemPrompt/schemas.js

@@ -68,6 +68,13 @@ const SystemPromptContributorsSchema = z.object({
       source: "date",
       enabled: true
     },
+    {
+      id: "env",
+      type: "dynamic",
+      priority: 15,
+      source: "env",
+      enabled: true
+    },
     {
       id: "resources",
       type: "dynamic",

package/dist/tools/error-codes.cjs

@@ -27,6 +27,7 @@ var ToolErrorCode = /* @__PURE__ */ ((ToolErrorCode2) => {
   ToolErrorCode2["EXECUTION_FAILED"] = "tools_execution_failed";
   ToolErrorCode2["DIRECTORY_ACCESS_DENIED"] = "tools_directory_access_denied";
   ToolErrorCode2["VALIDATION_FAILED"] = "tools_validation_failed";
+  ToolErrorCode2["FILE_MODIFIED_SINCE_PREVIEW"] = "tools_file_modified_since_preview";
   ToolErrorCode2["CONFIRMATION_HANDLER_MISSING"] = "tools_confirmation_handler_missing";
   ToolErrorCode2["CONFIRMATION_TIMEOUT"] = "tools_confirmation_timeout";
   ToolErrorCode2["CONFIRMATION_CANCELLED"] = "tools_confirmation_cancelled";

package/dist/tools/error-codes.d.ts

@@ -8,6 +8,7 @@ export declare enum ToolErrorCode {
     EXECUTION_FAILED = "tools_execution_failed",
     DIRECTORY_ACCESS_DENIED = "tools_directory_access_denied",
     VALIDATION_FAILED = "tools_validation_failed",
+    FILE_MODIFIED_SINCE_PREVIEW = "tools_file_modified_since_preview",
     CONFIRMATION_HANDLER_MISSING = "tools_confirmation_handler_missing",
     CONFIRMATION_TIMEOUT = "tools_confirmation_timeout",
     CONFIRMATION_CANCELLED = "tools_confirmation_cancelled",

package/dist/tools/error-codes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"error-codes.d.ts","sourceRoot":"","sources":["../../src/tools/error-codes.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,oBAAY,aAAa;IAErB,gBAAgB,2BAA2B;IAC3C,iBAAiB,4BAA4B;IAC7C,gBAAgB,2BAA2B;IAC3C,uBAAuB,kCAAkC;IAGzD,iBAAiB,4BAA4B;IAG7C,4BAA4B,uCAAuC;IACnE,oBAAoB,+BAA+B;IACnD,sBAAsB,iCAAiC;IAGvD,cAAc,yBAAyB;IACvC,iBAAiB,uBAAuB;IACxC,iBAAiB,uBAAuB;IAGxC,cAAc,yBAAyB;IACvC,gBAAgB,2BAA2B;IAG3C,4BAA4B,kCAAkC;IAC9D,uCAAuC,6CAA6C;CACvF"}
+{"version":3,"file":"error-codes.d.ts","sourceRoot":"","sources":["../../src/tools/error-codes.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,oBAAY,aAAa;IAErB,gBAAgB,2BAA2B;IAC3C,iBAAiB,4BAA4B;IAC7C,gBAAgB,2BAA2B;IAC3C,uBAAuB,kCAAkC;IAGzD,iBAAiB,4BAA4B;IAC7C,2BAA2B,sCAAsC;IAGjE,4BAA4B,uCAAuC;IACnE,oBAAoB,+BAA+B;IACnD,sBAAsB,iCAAiC;IAGvD,cAAc,yBAAyB;IACvC,iBAAiB,uBAAuB;IACxC,iBAAiB,uBAAuB;IAGxC,cAAc,yBAAyB;IACvC,gBAAgB,2BAA2B;IAG3C,4BAA4B,kCAAkC;IAC9D,uCAAuC,6CAA6C;CACvF"}

package/dist/tools/error-codes.js

@@ -5,6 +5,7 @@ var ToolErrorCode = /* @__PURE__ */ ((ToolErrorCode2) => {
   ToolErrorCode2["EXECUTION_FAILED"] = "tools_execution_failed";
   ToolErrorCode2["DIRECTORY_ACCESS_DENIED"] = "tools_directory_access_denied";
   ToolErrorCode2["VALIDATION_FAILED"] = "tools_validation_failed";
+  ToolErrorCode2["FILE_MODIFIED_SINCE_PREVIEW"] = "tools_file_modified_since_preview";
   ToolErrorCode2["CONFIRMATION_HANDLER_MISSING"] = "tools_confirmation_handler_missing";
   ToolErrorCode2["CONFIRMATION_TIMEOUT"] = "tools_confirmation_timeout";
   ToolErrorCode2["CONFIRMATION_CANCELLED"] = "tools_confirmation_cancelled";

package/dist/tools/errors.cjs

@@ -103,6 +103,23 @@ class ToolError {
       { toolName, reason, ...context }
     );
   }
+  /**
+   * File was modified between preview and execute.
+   * This is a safety check to prevent corrupting user edits.
+   */
+  static fileModifiedSincePreview(toolName, filePath) {
+    return new import_DextoRuntimeError.DextoRuntimeError(
+      import_error_codes.ToolErrorCode.FILE_MODIFIED_SINCE_PREVIEW,
+      import_types.ErrorScope.TOOLS,
+      import_types.ErrorType.USER,
+      `File '${filePath}' was modified since the preview was generated. Please read the file again and retry the operation.`,
+      {
+        toolName,
+        filePath,
+        recovery: "Read the file with read_file tool to get current content, then retry the edit."
+      }
+    );
+  }
   /**
    * Tool unauthorized access
    */

package/dist/tools/errors.d.ts

@@ -51,6 +51,15 @@ export declare class ToolError {
         toolName: string;
         reason: string;
     }>;
+    /**
+     * File was modified between preview and execute.
+     * This is a safety check to prevent corrupting user edits.
+     */
+    static fileModifiedSincePreview(toolName: string, filePath: string): DextoRuntimeError<{
+        toolName: string;
+        filePath: string;
+        recovery: string;
+    }>;
     /**
      * Tool unauthorized access
      */