@axiom-lattice/core 2.1.12 → 2.1.14

package/dist/index.js

@@ -37,6 +37,7 @@ __export(index_exports, {
   AgentType: () => import_protocols.AgentType,
   ChunkBuffer: () => ChunkBuffer,
   ChunkBufferLatticeManager: () => ChunkBufferLatticeManager,
+  DefaultScheduleClient: () => DefaultScheduleClient,
   EmbeddingsLatticeManager: () => EmbeddingsLatticeManager,
   GraphBuildOptions: () => import_protocols.GraphBuildOptions,
   InMemoryAssistantStore: () => InMemoryAssistantStore,
@@ -44,15 +45,20 @@ __export(index_exports, {
   InMemoryThreadStore: () => InMemoryThreadStore,
   MemoryLatticeManager: () => MemoryLatticeManager,
   MemoryQueueClient: () => MemoryQueueClient,
+  MemoryScheduleStorage: () => MemoryScheduleStorage,
   MemoryType: () => import_protocols2.MemoryType,
   ModelLatticeManager: () => ModelLatticeManager,
+  PostgresDatabase: () => PostgresDatabase,
   Protocols: () => Protocols,
   QueueLatticeManager: () => QueueLatticeManager,
+  ScheduleLatticeManager: () => ScheduleLatticeManager,
+  SqlDatabaseManager: () => SqlDatabaseManager,
   StoreLatticeManager: () => StoreLatticeManager,
   ThreadStatus: () => ThreadStatus,
   ToolLatticeManager: () => ToolLatticeManager,
   VectorStoreLatticeManager: () => VectorStoreLatticeManager,
   agentLatticeManager: () => agentLatticeManager,
+  describeCronExpression: () => describeCronExpression,
   embeddingsLatticeManager: () => embeddingsLatticeManager,
   eventBus: () => eventBus,
   eventBusDefault: () => event_bus_default,
@@ -66,7 +72,9 @@ __export(index_exports, {
   getEmbeddingsClient: () => getEmbeddingsClient,
   getEmbeddingsLattice: () => getEmbeddingsLattice,
   getModelLattice: () => getModelLattice,
+  getNextCronTime: () => getNextCronTime,
   getQueueLattice: () => getQueueLattice,
+  getScheduleLattice: () => getScheduleLattice,
   getStoreLattice: () => getStoreLattice,
   getToolClient: () => getToolClient,
   getToolDefinition: () => getToolDefinition,
@@ -74,7 +82,9 @@ __export(index_exports, {
   getVectorStoreClient: () => getVectorStoreClient,
   getVectorStoreLattice: () => getVectorStoreLattice,
   hasChunkBuffer: () => hasChunkBuffer,
+  isValidCronExpression: () => isValidCronExpression,
   modelLatticeManager: () => modelLatticeManager,
+  parseCronExpression: () => parseCronExpression,
   queueLatticeManager: () => queueLatticeManager,
   registerAgentLattice: () => registerAgentLattice,
   registerAgentLattices: () => registerAgentLattices,
@@ -83,9 +93,12 @@ __export(index_exports, {
   registerEmbeddingsLattice: () => registerEmbeddingsLattice,
   registerModelLattice: () => registerModelLattice,
   registerQueueLattice: () => registerQueueLattice,
+  registerScheduleLattice: () => registerScheduleLattice,
   registerStoreLattice: () => registerStoreLattice,
   registerToolLattice: () => registerToolLattice,
   registerVectorStoreLattice: () => registerVectorStoreLattice,
+  scheduleLatticeManager: () => scheduleLatticeManager,
+  sqlDatabaseManager: () => sqlDatabaseManager,
   storeLatticeManager: () => storeLatticeManager,
   toolLatticeManager: () => toolLatticeManager,
   validateAgentInput: () => validateAgentInput,
@@ -680,6 +693,538 @@ registerToolLattice(
   }
 );
 
+// src/tool_lattice/sql/list_tables_sql.ts
+var import_zod3 = __toESM(require("zod"));
+
+// src/tool_lattice/sql/SqlDatabaseManager.ts
+var PostgresDatabase = class {
+  constructor(config) {
+    // pg.Pool
+    this.connected = false;
+    this.config = config;
+  }
+  async connect() {
+    if (this.connected) return;
+    try {
+      const { Pool } = await import("pg");
+      const poolConfig = this.config.connectionString ? { connectionString: this.config.connectionString } : {
+        host: this.config.host || "localhost",
+        port: this.config.port || 5432,
+        database: this.config.database,
+        user: this.config.user,
+        password: this.config.password,
+        ssl: this.config.ssl ? { rejectUnauthorized: false } : void 0
+      };
+      this.pool = new Pool(poolConfig);
+      const client = await this.pool.connect();
+      client.release();
+      this.connected = true;
+    } catch (error) {
+      throw new Error(`Failed to connect to PostgreSQL: ${error}`);
+    }
+  }
+  async disconnect() {
+    if (this.pool) {
+      await this.pool.end();
+      this.connected = false;
+    }
+  }
+  async listTables() {
+    await this.ensureConnected();
+    const query = `
+      SELECT table_name, table_schema
+      FROM information_schema.tables
+      WHERE table_schema NOT IN ('pg_catalog', 'information_schema')
+        AND table_type = 'BASE TABLE'
+      ORDER BY table_schema, table_name;
+    `;
+    const result = await this.pool.query(query);
+    return result.rows.map((row) => ({
+      name: row.table_name,
+      schema: row.table_schema
+    }));
+  }
+  async getTableInfo(tables) {
+    await this.ensureConnected();
+    const schemas = [];
+    for (const tableName of tables) {
+      const columnQuery = `
+        SELECT 
+          c.column_name,
+          c.data_type,
+          c.is_nullable,
+          c.column_default,
+          CASE WHEN pk.column_name IS NOT NULL THEN true ELSE false END as is_primary_key,
+          CASE WHEN fk.column_name IS NOT NULL THEN true ELSE false END as is_foreign_key,
+          fk.foreign_table_name,
+          fk.foreign_column_name
+        FROM information_schema.columns c
+        LEFT JOIN (
+          SELECT ku.column_name, ku.table_name
+          FROM information_schema.table_constraints tc
+          JOIN information_schema.key_column_usage ku
+            ON tc.constraint_name = ku.constraint_name
+          WHERE tc.constraint_type = 'PRIMARY KEY'
+        ) pk ON c.column_name = pk.column_name AND c.table_name = pk.table_name
+        LEFT JOIN (
+          SELECT 
+            kcu.column_name,
+            kcu.table_name,
+            ccu.table_name as foreign_table_name,
+            ccu.column_name as foreign_column_name
+          FROM information_schema.table_constraints tc
+          JOIN information_schema.key_column_usage kcu
+            ON tc.constraint_name = kcu.constraint_name
+          JOIN information_schema.constraint_column_usage ccu
+            ON tc.constraint_name = ccu.constraint_name
+          WHERE tc.constraint_type = 'FOREIGN KEY'
+        ) fk ON c.column_name = fk.column_name AND c.table_name = fk.table_name
+        WHERE c.table_name = $1
+        ORDER BY c.ordinal_position;
+      `;
+      const columnResult = await this.pool.query(columnQuery, [tableName]);
+      const columns = columnResult.rows.map((row) => ({
+        name: row.column_name,
+        type: row.data_type,
+        nullable: row.is_nullable === "YES",
+        default: row.column_default,
+        isPrimaryKey: row.is_primary_key,
+        isForeignKey: row.is_foreign_key,
+        foreignKeyRef: row.is_foreign_key ? `${row.foreign_table_name}.${row.foreign_column_name}` : void 0
+      }));
+      let sampleRows = [];
+      try {
+        const sampleQuery = `SELECT * FROM "${tableName}" LIMIT 3`;
+        const sampleResult = await this.pool.query(sampleQuery);
+        sampleRows = sampleResult.rows;
+      } catch {
+      }
+      schemas.push({
+        tableName,
+        columns,
+        sampleRows
+      });
+    }
+    return schemas;
+  }
+  async executeQuery(query) {
+    await this.ensureConnected();
+    const result = await this.pool.query(query);
+    return {
+      rows: result.rows,
+      rowCount: result.rowCount || result.rows.length,
+      fields: result.fields?.map((f) => f.name)
+    };
+  }
+  getDatabaseType() {
+    return "postgres";
+  }
+  async ensureConnected() {
+    if (!this.connected) {
+      await this.connect();
+    }
+  }
+};
+var SqlDatabaseManager = class _SqlDatabaseManager {
+  constructor() {
+    this.databases = /* @__PURE__ */ new Map();
+    this.defaultDatabaseKey = null;
+  }
+  /**
+   * Get the singleton instance
+   */
+  static getInstance() {
+    if (!_SqlDatabaseManager.instance) {
+      _SqlDatabaseManager.instance = new _SqlDatabaseManager();
+    }
+    return _SqlDatabaseManager.instance;
+  }
+  /**
+   * Register a database connection
+   * @param key - Unique identifier for the database
+   * @param config - Database configuration
+   */
+  registerDatabase(key, config) {
+    let database;
+    switch (config.type) {
+      case "postgres":
+        database = new PostgresDatabase(config);
+        break;
+      case "mysql":
+        throw new Error("MySQL support not yet implemented");
+      case "sqlite":
+        throw new Error("SQLite support not yet implemented");
+      default:
+        throw new Error(`Unsupported database type: ${config.type}`);
+    }
+    this.databases.set(key, database);
+    if (this.defaultDatabaseKey === null) {
+      this.defaultDatabaseKey = key;
+    }
+  }
+  /**
+   * Set the default database
+   * @param key - Database key to set as default
+   */
+  setDefaultDatabase(key) {
+    if (!this.databases.has(key)) {
+      throw new Error(`Database '${key}' not found`);
+    }
+    this.defaultDatabaseKey = key;
+  }
+  /**
+   * Get a database by key
+   * @param key - Database key (optional, uses default if not provided)
+   */
+  getDatabase(key) {
+    const dbKey = key || this.defaultDatabaseKey;
+    if (!dbKey) {
+      throw new Error("No database registered");
+    }
+    const database = this.databases.get(dbKey);
+    if (!database) {
+      throw new Error(`Database '${dbKey}' not found`);
+    }
+    return database;
+  }
+  /**
+   * Check if a database is registered
+   * @param key - Database key
+   */
+  hasDatabase(key) {
+    return this.databases.has(key);
+  }
+  /**
+   * Get all registered database keys
+   */
+  getDatabaseKeys() {
+    return Array.from(this.databases.keys());
+  }
+  /**
+   * Remove a database connection
+   * @param key - Database key
+   */
+  async removeDatabase(key) {
+    const database = this.databases.get(key);
+    if (database) {
+      await database.disconnect();
+      this.databases.delete(key);
+      if (this.defaultDatabaseKey === key) {
+        this.defaultDatabaseKey = this.databases.size > 0 ? this.databases.keys().next().value || null : null;
+      }
+    }
+  }
+  /**
+   * Disconnect all databases
+   */
+  async disconnectAll() {
+    for (const database of this.databases.values()) {
+      await database.disconnect();
+    }
+  }
+};
+var sqlDatabaseManager = SqlDatabaseManager.getInstance();
+
+// src/tool_lattice/sql/list_tables_sql.ts
+function getDatabaseKeyFromConfig(config) {
+  const runConfig = config.configurable?.runConfig;
+  return runConfig?.databaseKey;
+}
+registerToolLattice(
+  "list_tables_sql",
+  {
+    name: "list_tables_sql",
+    description: "List all tables in the connected SQL database. Returns a comma-separated list of table names. Use this tool first to understand what tables are available before querying the database.",
+    needUserApprove: false,
+    schema: import_zod3.default.object({})
+  },
+  async (_input, config) => {
+    try {
+      const databaseKey = getDatabaseKeyFromConfig(config);
+      const database = sqlDatabaseManager.getDatabase(databaseKey);
+      const tables = await database.listTables();
+      if (tables.length === 0) {
+        return "No tables found in the database.";
+      }
+      const tableNames = tables.map(
+        (t) => t.schema && t.schema !== "public" ? `${t.schema}.${t.name}` : t.name
+      );
+      return tableNames.join(", ");
+    } catch (error) {
+      return `Error listing tables: ${error instanceof Error ? error.message : String(error)}`;
+    }
+  }
+);
+
+// src/tool_lattice/sql/info_sql.ts
+var import_zod4 = __toESM(require("zod"));
+function getDatabaseKeyFromConfig2(config) {
+  const runConfig = config.configurable?.runConfig;
+  return runConfig?.databaseKey;
+}
+function formatTableSchema(schema) {
+  const lines = [];
+  lines.push(`
+Table: ${schema.tableName}`);
+  lines.push("-".repeat(40));
+  lines.push("Columns:");
+  for (const col of schema.columns) {
+    const constraints = [];
+    if (col.isPrimaryKey) constraints.push("PRIMARY KEY");
+    if (col.isForeignKey && col.foreignKeyRef)
+      constraints.push(`FK -> ${col.foreignKeyRef}`);
+    if (!col.nullable) constraints.push("NOT NULL");
+    const constraintStr = constraints.length > 0 ? ` [${constraints.join(", ")}]` : "";
+    lines.push(`  - ${col.name}: ${col.type}${constraintStr}`);
+  }
+  if (schema.sampleRows && schema.sampleRows.length > 0) {
+    lines.push("\nSample Rows (up to 3):");
+    for (const row of schema.sampleRows) {
+      const rowStr = Object.entries(row).map(([k, v]) => `${k}=${JSON.stringify(v)}`).join(", ");
+      lines.push(`  ${rowStr}`);
+    }
+  }
+  return lines.join("\n");
+}
+registerToolLattice(
+  "info_sql",
+  {
+    name: "info_sql",
+    description: "Get detailed schema information for specified tables, including column names, types, constraints (primary keys, foreign keys), and sample rows. Input should be a comma-separated list of table names.",
+    needUserApprove: false,
+    schema: import_zod4.default.object({
+      tables: import_zod4.default.string().describe(
+        "Comma-separated list of table names to get information for. Example: 'users, orders, products'"
+      )
+    })
+  },
+  async ({
+    tables
+  }, config) => {
+    try {
+      const databaseKey = getDatabaseKeyFromConfig2(config);
+      const database = sqlDatabaseManager.getDatabase(databaseKey);
+      const tableNames = tables.split(",").map((t) => t.trim()).filter((t) => t.length > 0);
+      if (tableNames.length === 0) {
+        return "Error: No table names provided. Please provide a comma-separated list of table names.";
+      }
+      const schemas = await database.getTableInfo(tableNames);
+      if (schemas.length === 0) {
+        return `No schema information found for tables: ${tableNames.join(", ")}`;
+      }
+      const output = schemas.map(formatTableSchema).join("\n");
+      return output;
+    } catch (error) {
+      return `Error getting table info: ${error instanceof Error ? error.message : String(error)}`;
+    }
+  }
+);
+
+// src/tool_lattice/sql/query_sql.ts
+var import_zod5 = __toESM(require("zod"));
+function getDatabaseKeyFromConfig3(config) {
+  const runConfig = config.configurable?.runConfig;
+  return runConfig?.databaseKey;
+}
+function formatQueryResult(rows, fields) {
+  if (rows.length === 0) {
+    return "Query executed successfully. No rows returned.";
+  }
+  const lines = [];
+  const columns = fields || Object.keys(rows[0]);
+  lines.push(columns.join(" | "));
+  lines.push("-".repeat(columns.join(" | ").length));
+  const maxRows = 50;
+  const displayRows = rows.slice(0, maxRows);
+  for (const row of displayRows) {
+    const values = columns.map((col) => {
+      const val = row[col];
+      if (val === null) return "NULL";
+      if (typeof val === "object") return JSON.stringify(val);
+      return String(val);
+    });
+    lines.push(values.join(" | "));
+  }
+  if (rows.length > maxRows) {
+    lines.push(`
+... (${rows.length - maxRows} more rows not shown)`);
+  }
+  lines.push(`
+Total rows: ${rows.length}`);
+  return lines.join("\n");
+}
+registerToolLattice(
+  "query_sql",
+  {
+    name: "query_sql",
+    description: "Execute a SQL query against the database and return the results. Input should be a valid SQL query. Use this tool to retrieve data from the database. For complex queries, first use list_tables_sql and info_sql to understand the database schema.",
+    needUserApprove: false,
+    // SQL queries should require user approval for safety
+    schema: import_zod5.default.object({
+      query: import_zod5.default.string().describe(
+        "The SQL query to execute. Should be a valid SELECT, INSERT, UPDATE, or DELETE statement."
+      )
+    })
+  },
+  async ({
+    query
+  }, config) => {
+    try {
+      const databaseKey = getDatabaseKeyFromConfig3(config);
+      const database = sqlDatabaseManager.getDatabase(databaseKey);
+      const trimmedQuery = query.trim();
+      if (!trimmedQuery) {
+        return "Error: Empty query provided. Please provide a valid SQL query.";
+      }
+      const result = await database.executeQuery(trimmedQuery);
+      return formatQueryResult(result.rows, result.fields);
+    } catch (error) {
+      return `Error executing query: ${error instanceof Error ? error.message : String(error)}`;
+    }
+  }
+);
+
+// src/tool_lattice/sql/query_checker_sql.ts
+var import_zod6 = __toESM(require("zod"));
+function getDatabaseKeyFromConfig4(config) {
+  const runConfig = config.configurable?.runConfig;
+  return runConfig?.databaseKey;
+}
+var DANGEROUS_KEYWORDS = [
+  "DROP",
+  "TRUNCATE",
+  "DELETE",
+  "ALTER",
+  "CREATE",
+  "GRANT",
+  "REVOKE"
+];
+function checkSyntax(query) {
+  const issues = [];
+  const upperQuery = query.toUpperCase();
+  let parenCount = 0;
+  for (const char of query) {
+    if (char === "(") parenCount++;
+    if (char === ")") parenCount--;
+    if (parenCount < 0) {
+      issues.push("Unbalanced parentheses: found closing ) without matching (");
+      break;
+    }
+  }
+  if (parenCount > 0) {
+    issues.push("Unbalanced parentheses: missing closing )");
+  }
+  const singleQuotes = (query.match(/'/g) || []).length;
+  if (singleQuotes % 2 !== 0) {
+    issues.push("Unbalanced single quotes");
+  }
+  if (upperQuery.includes("SELECT *") && upperQuery.includes("JOIN")) {
+    issues.push(
+      "Warning: SELECT * with JOIN may return duplicate column names. Consider specifying columns explicitly."
+    );
+  }
+  if ((upperQuery.includes("UPDATE ") || upperQuery.includes("DELETE FROM ")) && !upperQuery.includes("WHERE ")) {
+    issues.push(
+      "Warning: UPDATE or DELETE without WHERE clause will affect all rows in the table."
+    );
+  }
+  if (upperQuery.includes("GROUP BY") && !upperQuery.match(/\b(COUNT|SUM|AVG|MAX|MIN|ARRAY_AGG|STRING_AGG)\s*\(/i)) {
+    issues.push(
+      "Warning: GROUP BY used but no aggregate functions found. Make sure all non-aggregated columns are in GROUP BY."
+    );
+  }
+  return issues;
+}
+function checkDangerousOperations(query) {
+  const warnings = [];
+  const upperQuery = query.toUpperCase();
+  for (const keyword of DANGEROUS_KEYWORDS) {
+    if (upperQuery.includes(keyword)) {
+      warnings.push(
+        `Warning: Query contains potentially dangerous operation: ${keyword}`
+      );
+    }
+  }
+  return warnings;
+}
+registerToolLattice(
+  "query_checker_sql",
+  {
+    name: "query_checker_sql",
+    description: "Check a SQL query for common issues before execution. This tool validates syntax, checks for dangerous operations, and provides suggestions for improvement. Use this before executing queries to ensure they are safe and correct.",
+    needUserApprove: false,
+    schema: import_zod6.default.object({
+      query: import_zod6.default.string().describe("The SQL query to check and validate.")
+    })
+  },
+  async ({
+    query
+  }, config) => {
+    try {
+      const trimmedQuery = query.trim();
+      if (!trimmedQuery) {
+        return "Error: Empty query provided. Please provide a SQL query to check.";
+      }
+      const results = [];
+      results.push("SQL Query Check Results:");
+      results.push("=".repeat(40));
+      results.push(`
+Query:
+${trimmedQuery}
+`);
+      const syntaxIssues = checkSyntax(trimmedQuery);
+      if (syntaxIssues.length > 0) {
+        results.push("Syntax Issues:");
+        for (const issue of syntaxIssues) {
+          results.push(`  - ${issue}`);
+        }
+      } else {
+        results.push("Syntax: \u2713 No obvious syntax issues found");
+      }
+      const dangerWarnings = checkDangerousOperations(trimmedQuery);
+      if (dangerWarnings.length > 0) {
+        results.push("\nSafety Warnings:");
+        for (const warning of dangerWarnings) {
+          results.push(`  - ${warning}`);
+        }
+      } else {
+        results.push("Safety: \u2713 No dangerous operations detected");
+      }
+      try {
+        const databaseKey = getDatabaseKeyFromConfig4(config);
+        const database = sqlDatabaseManager.getDatabase(databaseKey);
+        const dbType = database.getDatabaseType();
+        if (dbType === "postgres") {
+          try {
+            await database.executeQuery(`EXPLAIN ${trimmedQuery}`);
+            results.push("Database Validation: \u2713 Query is valid against database schema");
+          } catch (explainError) {
+            results.push(
+              `Database Validation: \u2717 ${explainError instanceof Error ? explainError.message : String(explainError)}`
+            );
+          }
+        }
+      } catch {
+        results.push(
+          "Database Validation: Skipped (no database connection available)"
+        );
+      }
+      const hasErrors = syntaxIssues.some((i) => !i.startsWith("Warning:")) || dangerWarnings.length > 0;
+      results.push("\n" + "=".repeat(40));
+      if (hasErrors) {
+        results.push(
+          "Overall: \u26A0\uFE0F Query has potential issues. Review warnings before execution."
+        );
+      } else {
+        results.push("Overall: \u2713 Query appears to be safe to execute.");
+      }
+      return results.join("\n");
+    } catch (error) {
+      return `Error checking query: ${error instanceof Error ? error.message : String(error)}`;
+    }
+  }
+);
+
 // src/agent_lattice/types.ts
 var import_protocols = require("@axiom-lattice/protocols");
 
@@ -764,7 +1309,7 @@ var memory = new import_langgraph2.MemorySaver();
 registerCheckpointSaver("default", memory);
 
 // src/agent_lattice/builders/state.ts
-var import_zod3 = require("@langchain/langgraph/zod");
+var import_zod7 = require("@langchain/langgraph/zod");
 var import_langgraph3 = require("@langchain/langgraph");
 var createReactAgentSchema = (schema) => {
   return schema ? import_langgraph3.MessagesZodState.extend(schema.shape) : void 0;
@@ -804,7 +1349,7 @@ var import_langchain6 = require("langchain");
 var import_langchain2 = require("langchain");
 var import_langgraph4 = require("@langchain/langgraph");
 var import_v3 = require("zod/v3");
-var import_zod4 = require("@langchain/langgraph/zod");
+var import_zod8 = require("@langchain/langgraph/zod");
 
 // src/deep_agent_new/backends/utils.ts
 var import_micromatch = __toESM(require("micromatch"));
@@ -1172,7 +1717,7 @@ function fileDataReducer(left, right) {
   return result;
 }
 var FilesystemStateSchema = import_v3.z.object({
-  files: (0, import_zod4.withLangGraph)(
+  files: (0, import_zod8.withLangGraph)(
     import_v3.z.record(import_v3.z.string(), FileDataSchema).default({}),
     {
       reducer: {
@@ -2295,7 +2840,7 @@ var SUPPORTS_NOFOLLOW = fsSync.constants.O_NOFOLLOW !== void 0;
 
 // src/deep_agent_new/middleware/todos.ts
 var import_langgraph8 = require("@langchain/langgraph");
-var import_zod5 = require("zod");
+var import_zod9 = require("zod");
 var import_langchain5 = require("langchain");
 var WRITE_TODOS_DESCRIPTION = `Use this tool to create and manage a structured task list for your current work session. This helps you track progress, organize complex tasks, and demonstrate thoroughness to the user.
 It also helps the user understand the progress of the task and overall progress of their requests.
@@ -2523,12 +3068,12 @@ Writing todos takes time and tokens, use it when it is helpful for managing comp
 ## Important To-Do List Usage Notes to Remember
 - The \`write_todos\` tool should never be called multiple times in parallel.
 - Don't be afraid to revise the To-Do list as you go. New information may reveal new tasks that need to be done, or old tasks that are irrelevant.`;
-var TodoStatus = import_zod5.z.enum(["pending", "in_progress", "completed"]).describe("Status of the todo");
-var TodoSchema = import_zod5.z.object({
-  content: import_zod5.z.string().describe("Content of the todo item"),
+var TodoStatus = import_zod9.z.enum(["pending", "in_progress", "completed"]).describe("Status of the todo");
+var TodoSchema = import_zod9.z.object({
+  content: import_zod9.z.string().describe("Content of the todo item"),
   status: TodoStatus
 });
-var stateSchema = import_zod5.z.object({ todos: import_zod5.z.array(TodoSchema).default([]) });
+var stateSchema = import_zod9.z.object({ todos: import_zod9.z.array(TodoSchema).default([]) });
 function todoListMiddleware(options) {
   const writeTodos = (0, import_langchain5.tool)(
     ({ todos }, config) => {
@@ -2547,8 +3092,8 @@ function todoListMiddleware(options) {
     {
       name: "write_todos",
       description: options?.toolDescription ?? WRITE_TODOS_DESCRIPTION,
-      schema: import_zod5.z.object({
-        todos: import_zod5.z.array(TodoSchema).describe("List of todo items to update")
+      schema: import_zod9.z.object({
+        todos: import_zod9.z.array(TodoSchema).describe("List of todo items to update")
       })
     }
   );
@@ -3275,6 +3820,986 @@ var getChunkBuffer = (key) => ChunkBufferLatticeManager.getInstance().get(key);
 var registerChunkBuffer = (key, buffer) => ChunkBufferLatticeManager.getInstance().register(key, buffer);
 var hasChunkBuffer = (key) => ChunkBufferLatticeManager.getInstance().has(key);
 
+// src/schedule_lattice/ScheduleLatticeManager.ts
+var import_protocols7 = require("@axiom-lattice/protocols");
+
+// src/schedule_lattice/DefaultScheduleClient.ts
+var import_protocols6 = require("@axiom-lattice/protocols");
+
+// src/schedule_lattice/MemoryScheduleStorage.ts
+var import_protocols5 = require("@axiom-lattice/protocols");
+var MemoryScheduleStorage = class {
+  constructor() {
+    this.tasks = /* @__PURE__ */ new Map();
+  }
+  /**
+   * Save a new task
+   */
+  async save(task) {
+    this.tasks.set(task.taskId, { ...task });
+  }
+  /**
+   * Get task by ID
+   */
+  async get(taskId) {
+    const task = this.tasks.get(taskId);
+    return task ? { ...task } : null;
+  }
+  /**
+   * Update task
+   */
+  async update(taskId, updates) {
+    const task = this.tasks.get(taskId);
+    if (task) {
+      this.tasks.set(taskId, {
+        ...task,
+        ...updates,
+        updatedAt: Date.now()
+      });
+    }
+  }
+  /**
+   * Delete task
+   */
+  async delete(taskId) {
+    this.tasks.delete(taskId);
+  }
+  /**
+   * Get all active tasks (pending or paused)
+   */
+  async getActiveTasks() {
+    const result = [];
+    for (const task of this.tasks.values()) {
+      if (task.status === import_protocols5.ScheduledTaskStatus.PENDING || task.status === import_protocols5.ScheduledTaskStatus.PAUSED) {
+        result.push({ ...task });
+      }
+    }
+    return result;
+  }
+  /**
+   * Get tasks by type
+   */
+  async getTasksByType(taskType) {
+    const result = [];
+    for (const task of this.tasks.values()) {
+      if (task.taskType === taskType) {
+        result.push({ ...task });
+      }
+    }
+    return result;
+  }
+  /**
+   * Get tasks by status
+   */
+  async getTasksByStatus(status) {
+    const result = [];
+    for (const task of this.tasks.values()) {
+      if (task.status === status) {
+        result.push({ ...task });
+      }
+    }
+    return result;
+  }
+  /**
+   * Get tasks by execution type
+   */
+  async getTasksByExecutionType(executionType) {
+    const result = [];
+    for (const task of this.tasks.values()) {
+      if (task.executionType === executionType) {
+        result.push({ ...task });
+      }
+    }
+    return result;
+  }
+  /**
+   * Get tasks by assistant ID
+   */
+  async getTasksByAssistantId(assistantId) {
+    const result = [];
+    for (const task of this.tasks.values()) {
+      if (task.assistantId === assistantId) {
+        result.push({ ...task });
+      }
+    }
+    return result;
+  }
+  /**
+   * Get tasks by thread ID
+   */
+  async getTasksByThreadId(threadId) {
+    const result = [];
+    for (const task of this.tasks.values()) {
+      if (task.threadId === threadId) {
+        result.push({ ...task });
+      }
+    }
+    return result;
+  }
+  /**
+   * Get all tasks with optional filters
+   */
+  async getAllTasks(filters) {
+    let result = [];
+    for (const task of this.tasks.values()) {
+      let match = true;
+      if (filters?.status !== void 0 && task.status !== filters.status) {
+        match = false;
+      }
+      if (filters?.executionType !== void 0 && task.executionType !== filters.executionType) {
+        match = false;
+      }
+      if (filters?.taskType !== void 0 && task.taskType !== filters.taskType) {
+        match = false;
+      }
+      if (filters?.assistantId !== void 0 && task.assistantId !== filters.assistantId) {
+        match = false;
+      }
+      if (filters?.threadId !== void 0 && task.threadId !== filters.threadId) {
+        match = false;
+      }
+      if (match) {
+        result.push({ ...task });
+      }
+    }
+    result.sort((a, b) => b.createdAt - a.createdAt);
+    const offset = filters?.offset || 0;
+    const limit = filters?.limit;
+    if (limit !== void 0) {
+      result = result.slice(offset, offset + limit);
+    } else if (offset > 0) {
+      result = result.slice(offset);
+    }
+    return result;
+  }
+  /**
+   * Count tasks with optional filters
+   */
+  async countTasks(filters) {
+    let count = 0;
+    for (const task of this.tasks.values()) {
+      let match = true;
+      if (filters?.status !== void 0 && task.status !== filters.status) {
+        match = false;
+      }
+      if (filters?.executionType !== void 0 && task.executionType !== filters.executionType) {
+        match = false;
+      }
+      if (filters?.taskType !== void 0 && task.taskType !== filters.taskType) {
+        match = false;
+      }
+      if (filters?.assistantId !== void 0 && task.assistantId !== filters.assistantId) {
+        match = false;
+      }
+      if (filters?.threadId !== void 0 && task.threadId !== filters.threadId) {
+        match = false;
+      }
+      if (match) {
+        count++;
+      }
+    }
+    return count;
+  }
+  /**
+   * Delete completed/cancelled tasks older than specified time
+   */
+  async deleteOldTasks(olderThanMs) {
+    const cutoff = Date.now() - olderThanMs;
+    let deleted = 0;
+    for (const [taskId, task] of this.tasks.entries()) {
+      if ((task.status === import_protocols5.ScheduledTaskStatus.COMPLETED || task.status === import_protocols5.ScheduledTaskStatus.CANCELLED || task.status === import_protocols5.ScheduledTaskStatus.FAILED) && task.updatedAt < cutoff) {
+        this.tasks.delete(taskId);
+        deleted++;
+      }
+    }
+    return deleted;
+  }
+  /**
+   * Clear all tasks (useful for testing)
+   */
+  clear() {
+    this.tasks.clear();
+  }
+  /**
+   * Get total task count (useful for debugging)
+   */
+  size() {
+    return this.tasks.size;
+  }
+};
+
+// src/schedule_lattice/CronParser.ts
+function parseCronExpression(expression) {
+  const parts = expression.trim().split(/\s+/);
+  if (parts.length !== 5) {
+    throw new Error(
+      `Invalid cron expression: expected 5 fields, got ${parts.length}`
+    );
+  }
+  return {
+    minute: parseField(parts[0], 0, 59),
+    hour: parseField(parts[1], 0, 23),
+    dayOfMonth: parseField(parts[2], 1, 31),
+    month: parseField(parts[3], 1, 12),
+    dayOfWeek: parseField(parts[4], 0, 7).map((d) => d === 7 ? 0 : d)
+    // Normalize Sunday
+  };
+}
+function parseField(field, min, max) {
+  const values = /* @__PURE__ */ new Set();
+  const segments = field.split(",");
+  for (const segment of segments) {
+    const [range, stepStr] = segment.split("/");
+    const step = stepStr ? parseInt(stepStr, 10) : 1;
+    if (isNaN(step) || step < 1) {
+      throw new Error(`Invalid step value: ${stepStr}`);
+    }
+    let rangeStart;
+    let rangeEnd;
+    if (range === "*") {
+      rangeStart = min;
+      rangeEnd = max;
+    } else if (range.includes("-")) {
+      const [startStr, endStr] = range.split("-");
+      rangeStart = parseInt(startStr, 10);
+      rangeEnd = parseInt(endStr, 10);
+      if (isNaN(rangeStart) || isNaN(rangeEnd)) {
+        throw new Error(`Invalid range: ${range}`);
+      }
+    } else {
+      const value = parseInt(range, 10);
+      if (isNaN(value)) {
+        throw new Error(`Invalid value: ${range}`);
+      }
+      rangeStart = value;
+      rangeEnd = value;
+    }
+    if (rangeStart < min || rangeEnd > max || rangeStart > rangeEnd) {
+      throw new Error(`Value out of range: ${range} (expected ${min}-${max})`);
+    }
+    for (let i = rangeStart; i <= rangeEnd; i += step) {
+      values.add(i);
+    }
+  }
+  return Array.from(values).sort((a, b) => a - b);
+}
+function getNextCronTime(expression, after = /* @__PURE__ */ new Date(), timezone) {
+  const fields = parseCronExpression(expression);
+  const next = new Date(after.getTime());
+  next.setSeconds(0, 0);
+  next.setMinutes(next.getMinutes() + 1);
+  const maxIterations = 366 * 24 * 60;
+  let iterations = 0;
+  while (iterations < maxIterations) {
+    iterations++;
+    const month = next.getMonth() + 1;
+    if (!fields.month.includes(month)) {
+      const nextMonth = fields.month.find((m) => m > month);
+      if (nextMonth !== void 0) {
+        next.setMonth(nextMonth - 1, 1);
+      } else {
+        next.setFullYear(next.getFullYear() + 1);
+        next.setMonth(fields.month[0] - 1, 1);
+      }
+      next.setHours(fields.hour[0], fields.minute[0], 0, 0);
+      continue;
+    }
+    const dayOfMonth = next.getDate();
+    const maxDayOfMonth = new Date(
+      next.getFullYear(),
+      next.getMonth() + 1,
+      0
+    ).getDate();
+    const dayOfWeek = next.getDay();
+    const dayOfMonthMatch = fields.dayOfMonth.includes(dayOfMonth);
+    const dayOfWeekMatch = fields.dayOfWeek.includes(dayOfWeek);
+    const dayOfMonthWildcard = fields.dayOfMonth.length === 31 && fields.dayOfMonth[0] === 1 && fields.dayOfMonth[30] === 31;
+    const dayOfWeekWildcard = fields.dayOfWeek.length >= 7 || fields.dayOfWeek.length === 1 && fields.dayOfWeek.includes(0);
+    let dayMatch;
+    if (dayOfMonthWildcard && dayOfWeekWildcard) {
+      dayMatch = true;
+    } else if (dayOfMonthWildcard) {
+      dayMatch = dayOfWeekMatch;
+    } else if (dayOfWeekWildcard) {
+      dayMatch = dayOfMonthMatch;
+    } else {
+      dayMatch = dayOfMonthMatch || dayOfWeekMatch;
+    }
+    if (!dayMatch || dayOfMonth > maxDayOfMonth) {
+      next.setDate(next.getDate() + 1);
+      next.setHours(fields.hour[0], fields.minute[0], 0, 0);
+      continue;
+    }
+    const hour = next.getHours();
+    if (!fields.hour.includes(hour)) {
+      const nextHour = fields.hour.find((h) => h > hour);
+      if (nextHour !== void 0) {
+        next.setHours(nextHour, fields.minute[0], 0, 0);
+      } else {
+        next.setDate(next.getDate() + 1);
+        next.setHours(fields.hour[0], fields.minute[0], 0, 0);
+      }
+      continue;
+    }
+    const minute = next.getMinutes();
+    if (!fields.minute.includes(minute)) {
+      const nextMinute = fields.minute.find((m) => m > minute);
+      if (nextMinute !== void 0) {
+        next.setMinutes(nextMinute, 0, 0);
+      } else {
+        next.setHours(next.getHours() + 1, fields.minute[0], 0, 0);
+      }
+      continue;
+    }
+    return next;
+  }
+  throw new Error("Could not find next cron time within 1 year");
+}
+function isValidCronExpression(expression) {
+  try {
+    parseCronExpression(expression);
+    return true;
+  } catch {
+    return false;
+  }
+}
+function describeCronExpression(expression) {
+  const fields = parseCronExpression(expression);
+  const parts = [];
+  if (fields.minute.length === 60) {
+    parts.push("every minute");
+  } else if (fields.minute.length === 1) {
+    parts.push(`at minute ${fields.minute[0]}`);
+  } else {
+    parts.push(`at minutes ${fields.minute.join(", ")}`);
+  }
+  if (fields.hour.length === 24) {
+    parts.push("of every hour");
+  } else if (fields.hour.length === 1) {
+    parts.push(`of hour ${fields.hour[0]}`);
+  } else {
+    parts.push(`of hours ${fields.hour.join(", ")}`);
+  }
+  if (fields.dayOfMonth.length < 31) {
+    if (fields.dayOfMonth.length === 1) {
+      parts.push(`on day ${fields.dayOfMonth[0]}`);
+    } else {
+      parts.push(`on days ${fields.dayOfMonth.join(", ")}`);
+    }
+  }
+  const monthNames = [
+    "",
+    "Jan",
+    "Feb",
+    "Mar",
+    "Apr",
+    "May",
+    "Jun",
+    "Jul",
+    "Aug",
+    "Sep",
+    "Oct",
+    "Nov",
+    "Dec"
+  ];
+  if (fields.month.length < 12) {
+    const months = fields.month.map((m) => monthNames[m]);
+    parts.push(`in ${months.join(", ")}`);
+  }
+  const dayNames = ["Sun", "Mon", "Tue", "Wed", "Thu", "Fri", "Sat"];
+  const uniqueDays = [...new Set(fields.dayOfWeek)];
+  if (uniqueDays.length < 7) {
+    const days = uniqueDays.map((d) => dayNames[d]);
+    parts.push(`on ${days.join(", ")}`);
+  }
+  return parts.join(" ");
+}
+
+// src/schedule_lattice/DefaultScheduleClient.ts
+var _DefaultScheduleClient = class _DefaultScheduleClient {
+  constructor(storage) {
+    this.handlers = /* @__PURE__ */ new Map();
+    this.timers = /* @__PURE__ */ new Map();
+    this.storage = storage || new MemoryScheduleStorage();
+  }
+  /**
+   * Get the singleton instance of DefaultScheduleClient
+   */
+  static getInstance(storage) {
+    if (!_DefaultScheduleClient.instance) {
+      _DefaultScheduleClient.instance = new _DefaultScheduleClient(storage);
+    }
+    return _DefaultScheduleClient.instance;
+  }
+  /**
+   * Reset the singleton instance (useful for testing)
+   */
+  static resetInstance() {
+    if (_DefaultScheduleClient.instance) {
+      _DefaultScheduleClient.instance.cancelAll();
+      _DefaultScheduleClient.instance = null;
+    }
+  }
+  // ===== Handler Registration =====
+  registerHandler(taskType, handler) {
+    this.handlers.set(taskType, handler);
+    console.log(`[Scheduler] Handler registered for task type: ${taskType}`);
+  }
+  unregisterHandler(taskType) {
+    const result = this.handlers.delete(taskType);
+    if (result) {
+      console.log(
+        `[Scheduler] Handler unregistered for task type: ${taskType}`
+      );
+    }
+    return result;
+  }
+  hasHandler(taskType) {
+    return this.handlers.has(taskType);
+  }
+  getHandlerTypes() {
+    return Array.from(this.handlers.keys());
+  }
+  // ===== One-time Task Scheduling =====
+  async scheduleOnce(taskId, taskType, payload, options) {
+    if (!this.handlers.has(taskType)) {
+      console.error(
+        `[Scheduler] No handler registered for task type: ${taskType}`
+      );
+      return false;
+    }
+    let executeAt;
+    if (options.executeAt !== void 0) {
+      executeAt = options.executeAt;
+    } else if (options.delayMs !== void 0) {
+      executeAt = Date.now() + options.delayMs;
+    } else {
+      console.error("[Scheduler] Either executeAt or delayMs must be provided");
+      return false;
+    }
+    if (await this.has(taskId)) {
+      await this.cancel(taskId);
+    }
+    const now = Date.now();
+    const task = {
+      taskId,
+      taskType,
+      payload,
+      assistantId: options.assistantId,
+      threadId: options.threadId,
+      executionType: import_protocols6.ScheduleExecutionType.ONCE,
+      executeAt,
+      delayMs: options.delayMs,
+      status: import_protocols6.ScheduledTaskStatus.PENDING,
+      runCount: 0,
+      retryCount: 0,
+      maxRetries: options.maxRetries ?? 0,
+      createdAt: now,
+      updatedAt: now,
+      metadata: options.metadata
+    };
+    await this.storage.save(task);
+    this.scheduleTimer(task);
+    console.log(
+      `[Scheduler] One-time task scheduled: ${taskId}, executes at ${new Date(
+        executeAt
+      ).toISOString()}`
+    );
+    return true;
+  }
+  // ===== Cron Task Scheduling =====
+  async scheduleCron(taskId, taskType, payload, options) {
+    if (!this.handlers.has(taskType)) {
+      console.error(
+        `[Scheduler] No handler registered for task type: ${taskType}`
+      );
+      return false;
+    }
+    if (!isValidCronExpression(options.cronExpression)) {
+      console.error(
+        `[Scheduler] Invalid cron expression: ${options.cronExpression}`
+      );
+      return false;
+    }
+    if (await this.has(taskId)) {
+      await this.cancel(taskId);
+    }
+    const now = Date.now();
+    const nextRunAt = getNextCronTime(options.cronExpression, new Date(now));
+    const task = {
+      taskId,
+      taskType,
+      payload,
+      assistantId: options.assistantId,
+      threadId: options.threadId,
+      executionType: import_protocols6.ScheduleExecutionType.CRON,
+      cronExpression: options.cronExpression,
+      timezone: options.timezone,
+      nextRunAt: nextRunAt.getTime(),
+      status: import_protocols6.ScheduledTaskStatus.PENDING,
+      runCount: 0,
+      maxRuns: options.maxRuns,
+      retryCount: 0,
+      maxRetries: options.maxRetries ?? 0,
+      createdAt: now,
+      updatedAt: now,
+      expiresAt: options.expiresAt,
+      metadata: options.metadata
+    };
+    await this.storage.save(task);
+    this.scheduleTimer(task);
+    console.log(
+      `[Scheduler] Cron task scheduled: ${taskId}, expression: ${options.cronExpression}, next run: ${nextRunAt.toISOString()}`
+    );
+    return true;
+  }
+  // ===== Task Management =====
+  async cancel(taskId) {
+    const timer = this.timers.get(taskId);
+    if (timer) {
+      clearTimeout(timer.timerId);
+      this.timers.delete(taskId);
+    }
+    const task = await this.storage.get(taskId);
+    if (task) {
+      await this.storage.update(taskId, {
+        status: import_protocols6.ScheduledTaskStatus.CANCELLED
+      });
+      console.log(`[Scheduler] Task cancelled: ${taskId}`);
+      return true;
+    }
+    return false;
+  }
+  async pause(taskId) {
+    const task = await this.storage.get(taskId);
+    if (!task || task.executionType !== import_protocols6.ScheduleExecutionType.CRON) {
+      console.error(`[Scheduler] Can only pause CRON tasks: ${taskId}`);
+      return false;
+    }
+    if (task.status !== import_protocols6.ScheduledTaskStatus.PENDING) {
+      console.error(`[Scheduler] Can only pause PENDING tasks: ${taskId}`);
+      return false;
+    }
+    const timer = this.timers.get(taskId);
+    if (timer) {
+      clearTimeout(timer.timerId);
+      this.timers.delete(taskId);
+    }
+    await this.storage.update(taskId, {
+      status: import_protocols6.ScheduledTaskStatus.PAUSED
+    });
+    console.log(`[Scheduler] Task paused: ${taskId}`);
+    return true;
+  }
+  async resume(taskId) {
+    const task = await this.storage.get(taskId);
+    if (!task || task.executionType !== import_protocols6.ScheduleExecutionType.CRON) {
+      console.error(`[Scheduler] Can only resume CRON tasks: ${taskId}`);
+      return false;
+    }
+    if (task.status !== import_protocols6.ScheduledTaskStatus.PAUSED) {
+      console.error(`[Scheduler] Can only resume PAUSED tasks: ${taskId}`);
+      return false;
+    }
+    const nextRunAt = getNextCronTime(task.cronExpression);
+    await this.storage.update(taskId, {
+      status: import_protocols6.ScheduledTaskStatus.PENDING,
+      nextRunAt: nextRunAt.getTime()
+    });
+    const updatedTask = await this.storage.get(taskId);
+    if (updatedTask) {
+      this.scheduleTimer(updatedTask);
+    }
+    console.log(`[Scheduler] Task resumed: ${taskId}`);
+    return true;
+  }
+  async has(taskId) {
+    const task = await this.storage.get(taskId);
+    return task !== null;
+  }
+  async getTask(taskId) {
+    return this.storage.get(taskId);
+  }
+  async getRemainingTime(taskId) {
+    const task = await this.storage.get(taskId);
+    if (!task) {
+      return -1;
+    }
+    const targetTime = task.executionType === import_protocols6.ScheduleExecutionType.CRON ? task.nextRunAt : task.executeAt;
+    if (targetTime === void 0) {
+      return -1;
+    }
+    return Math.max(0, targetTime - Date.now());
+  }
+  async getActiveTaskCount() {
+    const tasks = await this.storage.getActiveTasks();
+    return tasks.length;
+  }
+  async getActiveTaskIds() {
+    const tasks = await this.storage.getActiveTasks();
+    return tasks.map((t) => t.taskId);
+  }
+  async cancelAll() {
+    for (const timer of this.timers.values()) {
+      clearTimeout(timer.timerId);
+    }
+    this.timers.clear();
+    const activeTasks = await this.storage.getActiveTasks();
+    for (const task of activeTasks) {
+      await this.storage.update(task.taskId, {
+        status: import_protocols6.ScheduledTaskStatus.CANCELLED
+      });
+    }
+    console.log(`[Scheduler] All tasks cancelled`);
+  }
+  // ===== Recovery =====
+  async restore() {
+    const activeTasks = await this.storage.getActiveTasks();
+    let restored = 0;
+    for (const task of activeTasks) {
+      if (!this.handlers.has(task.taskType)) {
+        console.warn(
+          `[Scheduler] No handler for task type ${task.taskType}, skipping restore for task ${task.taskId}`
+        );
+        continue;
+      }
+      if (task.status === import_protocols6.ScheduledTaskStatus.PAUSED) {
+        continue;
+      }
+      if (task.executionType === import_protocols6.ScheduleExecutionType.ONCE) {
+        if (task.executeAt && task.executeAt <= Date.now()) {
+          console.log(
+            `[Scheduler] Executing overdue one-time task: ${task.taskId}`
+          );
+          this.executeTask(task);
+        } else {
+          this.scheduleTimer(task);
+        }
+      } else if (task.executionType === import_protocols6.ScheduleExecutionType.CRON) {
+        const nextRunAt = getNextCronTime(task.cronExpression);
+        await this.storage.update(task.taskId, {
+          nextRunAt: nextRunAt.getTime()
+        });
+        const updatedTask = await this.storage.get(task.taskId);
+        if (updatedTask) {
+          this.scheduleTimer(updatedTask);
+        }
+      }
+      restored++;
+    }
+    console.log(`[Scheduler] Restored ${restored} tasks`);
+    return restored;
+  }
+  // ===== Storage =====
+  setStorage(storage) {
+    this.storage = storage;
+  }
+  getStorage() {
+    return this.storage;
+  }
+  // ===== Private Methods =====
+  scheduleTimer(task) {
+    const targetTime = task.executionType === import_protocols6.ScheduleExecutionType.CRON ? task.nextRunAt : task.executeAt;
+    if (targetTime === void 0) {
+      console.error(`[Scheduler] No execution time for task: ${task.taskId}`);
+      return;
+    }
+    const delay = Math.max(0, targetTime - Date.now());
+    const timerId = setTimeout(() => {
+      this.executeTask(task);
+    }, delay);
+    this.timers.set(task.taskId, {
+      timerId,
+      taskId: task.taskId
+    });
+  }
+  async executeTask(task) {
+    const handler = this.handlers.get(task.taskType);
+    if (!handler) {
+      console.error(
+        `[Scheduler] No handler for task type: ${task.taskType}, task: ${task.taskId}`
+      );
+      await this.storage.update(task.taskId, {
+        status: import_protocols6.ScheduledTaskStatus.FAILED,
+        lastError: `No handler registered for task type: ${task.taskType}`
+      });
+      return;
+    }
+    await this.storage.update(task.taskId, {
+      status: import_protocols6.ScheduledTaskStatus.RUNNING
+    });
+    console.log(`[Scheduler] Executing task: ${task.taskId}`);
+    try {
+      const latestTask = await this.storage.get(task.taskId);
+      if (!latestTask) {
+        console.error(`[Scheduler] Task not found: ${task.taskId}`);
+        return;
+      }
+      await handler(latestTask.payload, latestTask);
+      const newRunCount = latestTask.runCount + 1;
+      console.log(`[Scheduler] Task completed: ${task.taskId}`);
+      if (task.executionType === import_protocols6.ScheduleExecutionType.ONCE) {
+        await this.storage.update(task.taskId, {
+          status: import_protocols6.ScheduledTaskStatus.COMPLETED,
+          runCount: newRunCount,
+          lastRunAt: Date.now()
+        });
+        this.timers.delete(task.taskId);
+      } else if (task.executionType === import_protocols6.ScheduleExecutionType.CRON) {
+        if (task.maxRuns !== void 0 && newRunCount >= task.maxRuns) {
+          await this.storage.update(task.taskId, {
+            status: import_protocols6.ScheduledTaskStatus.COMPLETED,
+            runCount: newRunCount,
+            lastRunAt: Date.now()
+          });
+          this.timers.delete(task.taskId);
+          console.log(
+            `[Scheduler] Cron task completed (max runs): ${task.taskId}`
+          );
+          return;
+        }
+        if (task.expiresAt !== void 0 && Date.now() >= task.expiresAt) {
+          await this.storage.update(task.taskId, {
+            status: import_protocols6.ScheduledTaskStatus.COMPLETED,
+            runCount: newRunCount,
+            lastRunAt: Date.now()
+          });
+          this.timers.delete(task.taskId);
+          console.log(
+            `[Scheduler] Cron task completed (expired): ${task.taskId}`
+          );
+          return;
+        }
+        const nextRunAt = getNextCronTime(task.cronExpression);
+        await this.storage.update(task.taskId, {
+          status: import_protocols6.ScheduledTaskStatus.PENDING,
+          runCount: newRunCount,
+          lastRunAt: Date.now(),
+          nextRunAt: nextRunAt.getTime(),
+          retryCount: 0
+          // Reset retry count on success
+        });
+        const updatedTask = await this.storage.get(task.taskId);
+        if (updatedTask) {
+          this.scheduleTimer(updatedTask);
+          console.log(
+            `[Scheduler] Next cron run scheduled: ${task.taskId} at ${nextRunAt.toISOString()}`
+          );
+        }
+      }
+    } catch (error) {
+      const errorMessage = error instanceof Error ? error.message : String(error);
+      console.error(`[Scheduler] Task failed: ${task.taskId}`, error);
+      const latestTask = await this.storage.get(task.taskId);
+      if (!latestTask) return;
+      const newRetryCount = latestTask.retryCount + 1;
+      if (newRetryCount <= latestTask.maxRetries) {
+        console.log(
+          `[Scheduler] Retrying task: ${task.taskId} (attempt ${newRetryCount}/${latestTask.maxRetries})`
+        );
+        await this.storage.update(task.taskId, {
+          status: import_protocols6.ScheduledTaskStatus.PENDING,
+          retryCount: newRetryCount,
+          lastError: errorMessage
+        });
+        const retryDelay = Math.min(
+          1e3 * Math.pow(2, newRetryCount - 1),
+          6e4
+        );
+        const retryTask = await this.storage.get(task.taskId);
+        if (retryTask) {
+          if (task.executionType === import_protocols6.ScheduleExecutionType.ONCE) {
+            retryTask.executeAt = Date.now() + retryDelay;
+          } else {
+            retryTask.nextRunAt = Date.now() + retryDelay;
+          }
+          await this.storage.update(task.taskId, {
+            executeAt: retryTask.executeAt,
+            nextRunAt: retryTask.nextRunAt
+          });
+          this.scheduleTimer(retryTask);
+        }
+      } else {
+        await this.storage.update(task.taskId, {
+          status: import_protocols6.ScheduledTaskStatus.FAILED,
+          retryCount: newRetryCount,
+          lastError: errorMessage
+        });
+        this.timers.delete(task.taskId);
+        console.error(
+          `[Scheduler] Task failed permanently: ${task.taskId} (max retries exceeded)`
+        );
+      }
+    }
+  }
+};
+_DefaultScheduleClient.instance = null;
+var DefaultScheduleClient = _DefaultScheduleClient;
+
+// src/schedule_lattice/ScheduleLatticeManager.ts
+var ScheduleLatticeManager = class _ScheduleLatticeManager extends BaseLatticeManager {
+  /**
+   * Get ScheduleLatticeManager singleton instance
+   */
+  static getInstance() {
+    if (!_ScheduleLatticeManager._instance) {
+      _ScheduleLatticeManager._instance = new _ScheduleLatticeManager();
+    }
+    return _ScheduleLatticeManager._instance;
+  }
+  /**
+   * Get Lattice type prefix
+   */
+  getLatticeType() {
+    return "schedules";
+  }
+  /**
+   * Register schedule Lattice
+   * @param key Lattice key name
+   * @param config Schedule configuration
+   * @param client Optional schedule client. If not provided, will create based on config type.
+   */
+  registerLattice(key, config, client) {
+    let scheduleClient;
+    if (client) {
+      scheduleClient = client;
+      if (config.storage) {
+        scheduleClient.setStorage(config.storage);
+      }
+    } else {
+      let storage;
+      if (config.storage) {
+        storage = config.storage;
+      } else {
+        storage = new MemoryScheduleStorage();
+      }
+      if (config.type === import_protocols7.ScheduleType.MEMORY) {
+        scheduleClient = new DefaultScheduleClient(storage);
+      } else if (config.type === import_protocols7.ScheduleType.POSTGRES) {
+        if (!config.storage) {
+          throw new Error(
+            `PostgreSQL schedule storage must be provided. Please install @axiom-lattice/pg-stores and pass the storage in config.storage.`
+          );
+        }
+        scheduleClient = new DefaultScheduleClient(storage);
+      } else {
+        scheduleClient = new DefaultScheduleClient(storage);
+      }
+    }
+    const scheduleLattice = {
+      key,
+      config,
+      client: scheduleClient,
+      // Handler registration
+      registerHandler: (taskType, handler) => {
+        scheduleClient.registerHandler(taskType, handler);
+      },
+      unregisterHandler: (taskType) => {
+        return scheduleClient.unregisterHandler(taskType);
+      },
+      hasHandler: (taskType) => {
+        return scheduleClient.hasHandler(taskType);
+      },
+      getHandlerTypes: () => {
+        return scheduleClient.getHandlerTypes();
+      },
+      // One-time task scheduling
+      scheduleOnce: async (taskId, taskType, payload, options) => {
+        return scheduleClient.scheduleOnce(taskId, taskType, payload, options);
+      },
+      // Cron task scheduling
+      scheduleCron: async (taskId, taskType, payload, options) => {
+        return scheduleClient.scheduleCron(taskId, taskType, payload, options);
+      },
+      // Task management
+      cancel: async (taskId) => {
+        return scheduleClient.cancel(taskId);
+      },
+      pause: async (taskId) => {
+        return scheduleClient.pause(taskId);
+      },
+      resume: async (taskId) => {
+        return scheduleClient.resume(taskId);
+      },
+      has: async (taskId) => {
+        return scheduleClient.has(taskId);
+      },
+      getTask: async (taskId) => {
+        return scheduleClient.getTask(taskId);
+      },
+      getRemainingTime: async (taskId) => {
+        return scheduleClient.getRemainingTime(taskId);
+      },
+      getActiveTaskCount: async () => {
+        return scheduleClient.getActiveTaskCount();
+      },
+      getActiveTaskIds: async () => {
+        return scheduleClient.getActiveTaskIds();
+      },
+      cancelAll: async () => {
+        return scheduleClient.cancelAll();
+      },
+      // Recovery
+      restore: async () => {
+        return scheduleClient.restore();
+      }
+    };
+    this.register(key, scheduleLattice);
+  }
+  /**
+   * Get ScheduleLattice
+   * @param key Lattice key name
+   */
+  getScheduleLattice(key) {
+    const scheduleLattice = this.get(key);
+    if (!scheduleLattice) {
+      throw new Error(`ScheduleLattice ${key} not found`);
+    }
+    return scheduleLattice;
+  }
+  /**
+   * Get all Lattices
+   */
+  getAllLattices() {
+    return this.getAll();
+  }
+  /**
+   * Check if Lattice exists
+   * @param key Lattice key name
+   */
+  hasLattice(key) {
+    return this.has(key);
+  }
+  /**
+   * Remove Lattice
+   * @param key Lattice key name
+   */
+  removeLattice(key) {
+    return this.remove(key);
+  }
+  /**
+   * Clear all Lattices
+   */
+  clearLattices() {
+    this.clear();
+  }
+  /**
+   * Get Lattice count
+   */
+  getLatticeCount() {
+    return this.count();
+  }
+  /**
+   * Get Lattice key list
+   */
+  getLatticeKeys() {
+    return this.keys();
+  }
+};
+var scheduleLatticeManager = ScheduleLatticeManager.getInstance();
+var registerScheduleLattice = (key, config, client) => scheduleLatticeManager.registerLattice(key, config, client);
+var getScheduleLattice = (key) => scheduleLatticeManager.getScheduleLattice(key);
+
 // src/store_lattice/InMemoryThreadStore.ts
 var InMemoryThreadStore = class {
   constructor() {
@@ -3778,6 +5303,7 @@ var Protocols = __toESM(require("@axiom-lattice/protocols"));
   AgentType,
   ChunkBuffer,
   ChunkBufferLatticeManager,
+  DefaultScheduleClient,
   EmbeddingsLatticeManager,
   GraphBuildOptions,
   InMemoryAssistantStore,
@@ -3785,15 +5311,20 @@ var Protocols = __toESM(require("@axiom-lattice/protocols"));
   InMemoryThreadStore,
   MemoryLatticeManager,
   MemoryQueueClient,
+  MemoryScheduleStorage,
   MemoryType,
   ModelLatticeManager,
+  PostgresDatabase,
   Protocols,
   QueueLatticeManager,
+  ScheduleLatticeManager,
+  SqlDatabaseManager,
   StoreLatticeManager,
   ThreadStatus,
   ToolLatticeManager,
   VectorStoreLatticeManager,
   agentLatticeManager,
+  describeCronExpression,
   embeddingsLatticeManager,
   eventBus,
   eventBusDefault,
@@ -3807,7 +5338,9 @@ var Protocols = __toESM(require("@axiom-lattice/protocols"));
   getEmbeddingsClient,
   getEmbeddingsLattice,
   getModelLattice,
+  getNextCronTime,
   getQueueLattice,
+  getScheduleLattice,
   getStoreLattice,
   getToolClient,
   getToolDefinition,
@@ -3815,7 +5348,9 @@ var Protocols = __toESM(require("@axiom-lattice/protocols"));
   getVectorStoreClient,
   getVectorStoreLattice,
   hasChunkBuffer,
+  isValidCronExpression,
   modelLatticeManager,
+  parseCronExpression,
   queueLatticeManager,
   registerAgentLattice,
   registerAgentLattices,
@@ -3824,9 +5359,12 @@ var Protocols = __toESM(require("@axiom-lattice/protocols"));
   registerEmbeddingsLattice,
   registerModelLattice,
   registerQueueLattice,
+  registerScheduleLattice,
   registerStoreLattice,
   registerToolLattice,
   registerVectorStoreLattice,
+  scheduleLatticeManager,
+  sqlDatabaseManager,
   storeLatticeManager,
   toolLatticeManager,
   validateAgentInput,