@orka-js/durable 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Orka Team
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/index.cjs

@@ -0,0 +1,287 @@
+'use strict';
+
+// src/durable-agent.ts
+function generateId() {
+  return `job_${Date.now()}_${Math.random().toString(36).slice(2, 8)}`;
+}
+function now() {
+  return /* @__PURE__ */ new Date();
+}
+var DurableAgent = class {
+  agent;
+  store;
+  config;
+  schedulerHandle = null;
+  constructor(agent, store, config = {}) {
+    this.agent = agent;
+    this.store = store;
+    this.config = { maxRetries: 0, retryDelayMs: 1e3, ...config };
+  }
+  /**
+   * Run a job by ID.
+   * - Creates a new job if jobId doesn't exist yet.
+   * - If the job is already completed/cancelled, returns it as-is.
+   * - If paused, call resume() instead.
+   */
+  async run(jobId, input) {
+    let job = await this.store.load(jobId);
+    if (!job) {
+      job = {
+        id: jobId,
+        input,
+        status: "pending",
+        attempts: 0,
+        metadata: this.config.metadata,
+        createdAt: now(),
+        updatedAt: now()
+      };
+      await this.store.save(job);
+    }
+    if (job.status === "completed" || job.status === "cancelled") {
+      return job;
+    }
+    job.status = "running";
+    job.updatedAt = now();
+    job.attempts++;
+    await this.store.save(job);
+    try {
+      const result = await this.agent.run(input);
+      job.status = "completed";
+      job.result = result.output;
+      job.completedAt = now();
+    } catch (error) {
+      const err = error;
+      job.error = err.message;
+      if (job.attempts <= (this.config.maxRetries ?? 0)) {
+        job.status = "pending";
+        job.updatedAt = now();
+        await this.store.save(job);
+        if (this.config.retryDelayMs) {
+          await new Promise((r) => setTimeout(r, this.config.retryDelayMs));
+        }
+        return this.run(jobId, input);
+      }
+      job.status = "failed";
+    }
+    job.updatedAt = now();
+    await this.store.save(job);
+    return job;
+  }
+  /**
+   * Streaming run — yields LLM stream events plus job_status bookends.
+   */
+  async *runStream(jobId, input) {
+    let job = await this.store.load(jobId);
+    if (!job) {
+      job = {
+        id: jobId,
+        input,
+        status: "pending",
+        attempts: 0,
+        metadata: this.config.metadata,
+        createdAt: now(),
+        updatedAt: now()
+      };
+    }
+    if (job.status === "completed" || job.status === "cancelled") {
+      yield { type: "job_status", job };
+      return;
+    }
+    job.status = "running";
+    job.updatedAt = now();
+    job.attempts++;
+    await this.store.save(job);
+    yield { type: "job_status", job: { ...job } };
+    try {
+      if (typeof this.agent.runStream === "function") {
+        let finalContent = "";
+        for await (const event of this.agent.runStream(input)) {
+          yield event;
+          if (event.type === "done") finalContent = event.content;
+        }
+        job.status = "completed";
+        job.result = finalContent;
+      } else {
+        const result = await this.agent.run(input);
+        job.status = "completed";
+        job.result = result.output;
+      }
+      job.completedAt = now();
+    } catch (error) {
+      job.status = "failed";
+      job.error = error.message;
+    }
+    job.updatedAt = now();
+    await this.store.save(job);
+    yield { type: "job_status", job: { ...job } };
+  }
+  /** Pause a running job (marks as paused — the caller must stop feeding input). */
+  async pause(jobId) {
+    const job = await this.store.load(jobId);
+    if (!job) throw new Error(`Job "${jobId}" not found`);
+    if (job.status === "completed" || job.status === "cancelled") {
+      throw new Error(`Cannot pause a ${job.status} job`);
+    }
+    job.status = "paused";
+    job.updatedAt = now();
+    await this.store.save(job);
+  }
+  /** Resume a paused job with optional new input. */
+  async resume(jobId, newInput) {
+    const job = await this.store.load(jobId);
+    if (!job) throw new Error(`Job "${jobId}" not found`);
+    if (job.status !== "paused") {
+      throw new Error(`Job "${jobId}" is not paused (current status: ${job.status})`);
+    }
+    return this.run(jobId, newInput ?? job.input);
+  }
+  /** Cancel a job. */
+  async cancel(jobId) {
+    const job = await this.store.load(jobId);
+    if (!job) throw new Error(`Job "${jobId}" not found`);
+    job.status = "cancelled";
+    job.updatedAt = now();
+    await this.store.save(job);
+  }
+  /** Get job status. */
+  async status(jobId) {
+    return this.store.load(jobId);
+  }
+  /** List all jobs, optionally filtered by status. */
+  async list(filter) {
+    return this.store.list(filter);
+  }
+  /**
+   * Start a cron-scheduled agent (requires `node-cron` peer dep).
+   * @param schedule - Cron expression, e.g. '0 9 * * MON'
+   * @param inputFn - Function returning the input for each run
+   */
+  startScheduler() {
+    if (!this.config.schedule) throw new Error("DurableAgent: no schedule configured");
+    if (!this.config.onSchedule) throw new Error("DurableAgent: no onSchedule handler configured");
+    import('node-cron').then((cron) => {
+      this.schedulerHandle = cron.schedule(this.config.schedule, async () => {
+        const input = await this.config.onSchedule();
+        const jobId = generateId();
+        await this.run(jobId, input);
+      });
+    }).catch(() => {
+      throw new Error(
+        '@orka-js/durable: startScheduler() requires the "node-cron" package.\nInstall it with: npm install node-cron'
+      );
+    });
+  }
+  stopScheduler() {
+    if (this.schedulerHandle && typeof this.schedulerHandle.stop === "function") {
+      this.schedulerHandle.stop();
+      this.schedulerHandle = null;
+    }
+  }
+};
+
+// src/stores/memory-store.ts
+var MemoryDurableStore = class {
+  jobs = /* @__PURE__ */ new Map();
+  async save(job) {
+    this.jobs.set(job.id, { ...job });
+  }
+  async load(jobId) {
+    const job = this.jobs.get(jobId);
+    return job ? { ...job } : null;
+  }
+  async list(filter) {
+    const all = [...this.jobs.values()].map((j) => ({ ...j }));
+    if (filter?.status) {
+      return all.filter((j) => j.status === filter.status);
+    }
+    return all.sort((a, b) => b.createdAt.getTime() - a.createdAt.getTime());
+  }
+  async delete(jobId) {
+    this.jobs.delete(jobId);
+  }
+  clear() {
+    this.jobs.clear();
+  }
+  size() {
+    return this.jobs.size;
+  }
+};
+
+// src/stores/redis-store.ts
+var RedisDurableStore = class {
+  client = null;
+  prefix;
+  ttlSeconds;
+  url;
+  constructor(config = {}) {
+    this.url = config.url ?? "redis://localhost:6379";
+    this.prefix = config.prefix ?? "orka:durable:";
+    this.ttlSeconds = config.ttlSeconds ?? 60 * 60 * 24 * 7;
+  }
+  async getClient() {
+    if (this.client) return this.client;
+    let redis;
+    try {
+      redis = await import('redis');
+    } catch {
+      throw new Error(
+        '@orka-js/durable: RedisDurableStore requires the "redis" package.\nInstall it with: npm install redis'
+      );
+    }
+    const client = redis.createClient({ url: this.url });
+    await client.connect();
+    this.client = client;
+    return client;
+  }
+  key(jobId) {
+    return `${this.prefix}${jobId}`;
+  }
+  serialize(job) {
+    return JSON.stringify({
+      ...job,
+      createdAt: job.createdAt.toISOString(),
+      updatedAt: job.updatedAt.toISOString(),
+      completedAt: job.completedAt?.toISOString()
+    });
+  }
+  deserialize(raw) {
+    const data = JSON.parse(raw);
+    return {
+      ...data,
+      createdAt: new Date(data.createdAt),
+      updatedAt: new Date(data.updatedAt),
+      completedAt: data.completedAt ? new Date(data.completedAt) : void 0
+    };
+  }
+  async save(job) {
+    const client = await this.getClient();
+    await client.set(this.key(job.id), this.serialize(job));
+    if (["completed", "failed", "cancelled"].includes(job.status)) {
+      await client.expire(this.key(job.id), this.ttlSeconds);
+    }
+  }
+  async load(jobId) {
+    const client = await this.getClient();
+    const raw = await client.get(this.key(jobId));
+    return raw ? this.deserialize(raw) : null;
+  }
+  async list(filter) {
+    const client = await this.getClient();
+    const keys = await client.keys(`${this.prefix}*`);
+    if (keys.length === 0) return [];
+    const raws = await client.mGet(keys);
+    const jobs = raws.filter((r) => r !== null).map((r) => this.deserialize(r));
+    if (filter?.status) return jobs.filter((j) => j.status === filter.status);
+    return jobs.sort((a, b) => b.createdAt.getTime() - a.createdAt.getTime());
+  }
+  async delete(jobId) {
+    const client = await this.getClient();
+    await client.del(this.key(jobId));
+  }
+};
+
+exports.DurableAgent = DurableAgent;
+exports.MemoryDurableStore = MemoryDurableStore;
+exports.RedisDurableStore = RedisDurableStore;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/durable-agent.ts","../src/stores/memory-store.ts","../src/stores/redis-store.ts"],"names":[],"mappings":"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","file":"index.cjs","sourcesContent":["import type { LLMStreamEvent } from '@orka-js/core';\nimport type { BaseAgent } from '@orka-js/agent';\nimport type { DurableAgentConfig, DurableJob, DurableJobStatus, DurableStore } from './types.js';\n\nfunction generateId(): string {\n  return `job_${Date.now()}_${Math.random().toString(36).slice(2, 8)}`;\n}\n\nfunction now(): Date {\n  return new Date();\n}\n\ntype StreamableAgent = BaseAgent & {\n  runStream?: (input: string) => AsyncIterable<LLMStreamEvent>;\n};\n\nexport class DurableAgent {\n  private agent: StreamableAgent;\n  private store: DurableStore;\n  private config: DurableAgentConfig;\n  private schedulerHandle: unknown = null;\n\n  constructor(\n    agent: BaseAgent,\n    store: DurableStore,\n    config: DurableAgentConfig = {},\n  ) {\n    this.agent = agent as StreamableAgent;\n    this.store = store;\n    this.config = { maxRetries: 0, retryDelayMs: 1000, ...config };\n  }\n\n  /**\n   * Run a job by ID.\n   * - Creates a new job if jobId doesn't exist yet.\n   * - If the job is already completed/cancelled, returns it as-is.\n   * - If paused, call resume() instead.\n   */\n  async run(jobId: string, input: string): Promise<DurableJob> {\n    let job = await this.store.load(jobId);\n\n    if (!job) {\n      job = {\n        id: jobId,\n        input,\n        status: 'pending',\n        attempts: 0,\n        metadata: this.config.metadata,\n        createdAt: now(),\n        updatedAt: now(),\n      };\n      await this.store.save(job);\n    }\n\n    if (job.status === 'completed' || job.status === 'cancelled') {\n      return job;\n    }\n\n    job.status = 'running';\n    job.updatedAt = now();\n    job.attempts++;\n    await this.store.save(job);\n\n    try {\n      const result = await this.agent.run(input);\n      job.status = 'completed';\n      job.result = result.output;\n      job.completedAt = now();\n    } catch (error) {\n      const err = error as Error;\n      job.error = err.message;\n\n      if (job.attempts <= (this.config.maxRetries ?? 0)) {\n        job.status = 'pending';\n        job.updatedAt = now();\n        await this.store.save(job);\n        if (this.config.retryDelayMs) {\n          await new Promise(r => setTimeout(r, this.config.retryDelayMs));\n        }\n        return this.run(jobId, input);\n      }\n\n      job.status = 'failed';\n    }\n\n    job.updatedAt = now();\n    await this.store.save(job);\n    return job;\n  }\n\n  /**\n   * Streaming run — yields LLM stream events plus job_status bookends.\n   */\n  async *runStream(\n    jobId: string,\n    input: string,\n  ): AsyncIterable<LLMStreamEvent | { type: 'job_status'; job: DurableJob }> {\n    let job = await this.store.load(jobId);\n\n    if (!job) {\n      job = {\n        id: jobId,\n        input,\n        status: 'pending',\n        attempts: 0,\n        metadata: this.config.metadata,\n        createdAt: now(),\n        updatedAt: now(),\n      };\n    }\n\n    if (job.status === 'completed' || job.status === 'cancelled') {\n      yield { type: 'job_status', job };\n      return;\n    }\n\n    job.status = 'running';\n    job.updatedAt = now();\n    job.attempts++;\n    await this.store.save(job);\n    yield { type: 'job_status', job: { ...job } };\n\n    try {\n      if (typeof this.agent.runStream === 'function') {\n        let finalContent = '';\n        for await (const event of this.agent.runStream(input)) {\n          yield event;\n          if (event.type === 'done') finalContent = event.content;\n        }\n        job.status = 'completed';\n        job.result = finalContent;\n      } else {\n        const result = await this.agent.run(input);\n        job.status = 'completed';\n        job.result = result.output;\n      }\n      job.completedAt = now();\n    } catch (error) {\n      job.status = 'failed';\n      job.error = (error as Error).message;\n    }\n\n    job.updatedAt = now();\n    await this.store.save(job);\n    yield { type: 'job_status', job: { ...job } };\n  }\n\n  /** Pause a running job (marks as paused — the caller must stop feeding input). */\n  async pause(jobId: string): Promise<void> {\n    const job = await this.store.load(jobId);\n    if (!job) throw new Error(`Job \"${jobId}\" not found`);\n    if (job.status === 'completed' || job.status === 'cancelled') {\n      throw new Error(`Cannot pause a ${job.status} job`);\n    }\n    job.status = 'paused';\n    job.updatedAt = now();\n    await this.store.save(job);\n  }\n\n  /** Resume a paused job with optional new input. */\n  async resume(jobId: string, newInput?: string): Promise<DurableJob> {\n    const job = await this.store.load(jobId);\n    if (!job) throw new Error(`Job \"${jobId}\" not found`);\n    if (job.status !== 'paused') {\n      throw new Error(`Job \"${jobId}\" is not paused (current status: ${job.status})`);\n    }\n    return this.run(jobId, newInput ?? job.input);\n  }\n\n  /** Cancel a job. */\n  async cancel(jobId: string): Promise<void> {\n    const job = await this.store.load(jobId);\n    if (!job) throw new Error(`Job \"${jobId}\" not found`);\n    job.status = 'cancelled';\n    job.updatedAt = now();\n    await this.store.save(job);\n  }\n\n  /** Get job status. */\n  async status(jobId: string): Promise<DurableJob | null> {\n    return this.store.load(jobId);\n  }\n\n  /** List all jobs, optionally filtered by status. */\n  async list(filter?: { status?: DurableJobStatus }): Promise<DurableJob[]> {\n    return this.store.list(filter);\n  }\n\n  /**\n   * Start a cron-scheduled agent (requires `node-cron` peer dep).\n   * @param schedule - Cron expression, e.g. '0 9 * * MON'\n   * @param inputFn - Function returning the input for each run\n   */\n  startScheduler(): void {\n    if (!this.config.schedule) throw new Error('DurableAgent: no schedule configured');\n    if (!this.config.onSchedule) throw new Error('DurableAgent: no onSchedule handler configured');\n\n    import('node-cron').then(cron => {\n      this.schedulerHandle = (cron as {\n        schedule(expr: string, fn: () => void): unknown;\n      }).schedule(this.config.schedule!, async () => {\n        const input = await this.config.onSchedule!();\n        const jobId = generateId();\n        await this.run(jobId, input);\n      });\n    }).catch(() => {\n      throw new Error(\n        '@orka-js/durable: startScheduler() requires the \"node-cron\" package.\\n' +\n        'Install it with: npm install node-cron'\n      );\n    });\n  }\n\n  stopScheduler(): void {\n    if (this.schedulerHandle && typeof (this.schedulerHandle as { stop?: () => void }).stop === 'function') {\n      (this.schedulerHandle as { stop(): void }).stop();\n      this.schedulerHandle = null;\n    }\n  }\n}\n","import type { DurableJob, DurableJobStatus, DurableStore } from '../types.js';\n\n/**\n * In-memory durable store — suitable for development and testing.\n * Data is lost on process restart.\n */\nexport class MemoryDurableStore implements DurableStore {\n  private jobs: Map<string, DurableJob> = new Map();\n\n  async save(job: DurableJob): Promise<void> {\n    this.jobs.set(job.id, { ...job });\n  }\n\n  async load(jobId: string): Promise<DurableJob | null> {\n    const job = this.jobs.get(jobId);\n    return job ? { ...job } : null;\n  }\n\n  async list(filter?: { status?: DurableJobStatus }): Promise<DurableJob[]> {\n    const all = [...this.jobs.values()].map(j => ({ ...j }));\n    if (filter?.status) {\n      return all.filter(j => j.status === filter.status);\n    }\n    return all.sort((a, b) => b.createdAt.getTime() - a.createdAt.getTime());\n  }\n\n  async delete(jobId: string): Promise<void> {\n    this.jobs.delete(jobId);\n  }\n\n  clear(): void {\n    this.jobs.clear();\n  }\n\n  size(): number {\n    return this.jobs.size;\n  }\n}\n","import type { DurableJob, DurableJobStatus, DurableStore } from '../types.js';\n\nexport interface RedisDurableStoreConfig {\n  /** Redis connection URL — default 'redis://localhost:6379' */\n  url?: string;\n  /** Key prefix — default 'orka:durable:' */\n  prefix?: string;\n  /** TTL for terminal jobs (completed/failed/cancelled) in seconds — default 7 days */\n  ttlSeconds?: number;\n}\n\ntype RedisClient = {\n  connect(): Promise<void>;\n  get(key: string): Promise<string | null>;\n  set(key: string, value: string): Promise<unknown>;\n  expire(key: string, seconds: number): Promise<unknown>;\n  del(key: string): Promise<unknown>;\n  keys(pattern: string): Promise<string[]>;\n  mGet(keys: string[]): Promise<(string | null)[]>;\n};\n\n/**\n * Redis-backed durable store for production use.\n * Requires the `redis` package as a peer dependency.\n *\n * @example\n * ```typescript\n * import { RedisDurableStore } from '@orka-js/durable'\n * const store = new RedisDurableStore({ url: process.env.REDIS_URL })\n * ```\n */\nexport class RedisDurableStore implements DurableStore {\n  private client: RedisClient | null = null;\n  private prefix: string;\n  private ttlSeconds: number;\n  private url: string;\n\n  constructor(config: RedisDurableStoreConfig = {}) {\n    this.url = config.url ?? 'redis://localhost:6379';\n    this.prefix = config.prefix ?? 'orka:durable:';\n    this.ttlSeconds = config.ttlSeconds ?? 60 * 60 * 24 * 7;\n  }\n\n  private async getClient(): Promise<RedisClient> {\n    if (this.client) return this.client;\n\n    let redis: { createClient(config: { url: string }): RedisClient };\n    try {\n      redis = await import('redis') as unknown as typeof redis;\n    } catch {\n      throw new Error(\n        '@orka-js/durable: RedisDurableStore requires the \"redis\" package.\\n' +\n        'Install it with: npm install redis'\n      );\n    }\n\n    const client = redis.createClient({ url: this.url });\n    await client.connect();\n    this.client = client;\n    return client;\n  }\n\n  private key(jobId: string): string {\n    return `${this.prefix}${jobId}`;\n  }\n\n  private serialize(job: DurableJob): string {\n    return JSON.stringify({\n      ...job,\n      createdAt: job.createdAt.toISOString(),\n      updatedAt: job.updatedAt.toISOString(),\n      completedAt: job.completedAt?.toISOString(),\n    });\n  }\n\n  private deserialize(raw: string): DurableJob {\n    const data = JSON.parse(raw) as unknown as DurableJob & { createdAt: string; updatedAt: string; completedAt?: string };\n    return {\n      ...data,\n      createdAt: new Date(data.createdAt),\n      updatedAt: new Date(data.updatedAt),\n      completedAt: data.completedAt ? new Date(data.completedAt) : undefined,\n    };\n  }\n\n  async save(job: DurableJob): Promise<void> {\n    const client = await this.getClient();\n    await client.set(this.key(job.id), this.serialize(job));\n    if (['completed', 'failed', 'cancelled'].includes(job.status)) {\n      await client.expire(this.key(job.id), this.ttlSeconds);\n    }\n  }\n\n  async load(jobId: string): Promise<DurableJob | null> {\n    const client = await this.getClient();\n    const raw = await client.get(this.key(jobId));\n    return raw ? this.deserialize(raw) : null;\n  }\n\n  async list(filter?: { status?: DurableJobStatus }): Promise<DurableJob[]> {\n    const client = await this.getClient();\n    const keys = await client.keys(`${this.prefix}*`);\n    if (keys.length === 0) return [];\n    const raws = await client.mGet(keys);\n    const jobs = raws\n      .filter((r): r is string => r !== null)\n      .map(r => this.deserialize(r));\n    if (filter?.status) return jobs.filter(j => j.status === filter.status);\n    return jobs.sort((a, b) => b.createdAt.getTime() - a.createdAt.getTime());\n  }\n\n  async delete(jobId: string): Promise<void> {\n    const client = await this.getClient();\n    await client.del(this.key(jobId));\n  }\n}\n"]}

package/dist/index.d.cts

@@ -0,0 +1,141 @@
+import { LLMStreamEvent } from '@orka-js/core';
+import { BaseAgent } from '@orka-js/agent';
+
+type DurableJobStatus = 'pending' | 'running' | 'paused' | 'completed' | 'failed' | 'cancelled';
+interface DurableJob {
+    id: string;
+    input: string;
+    status: DurableJobStatus;
+    result?: string;
+    error?: string;
+    /** Saved conversation messages for resuming */
+    messages?: Array<{
+        role: 'user' | 'assistant' | 'system';
+        content: string;
+    }>;
+    metadata?: Record<string, unknown>;
+    createdAt: Date;
+    updatedAt: Date;
+    completedAt?: Date;
+    /** Number of retry attempts so far */
+    attempts: number;
+}
+interface DurableStore {
+    save(job: DurableJob): Promise<void>;
+    load(jobId: string): Promise<DurableJob | null>;
+    list(filter?: {
+        status?: DurableJobStatus;
+    }): Promise<DurableJob[]>;
+    delete(jobId: string): Promise<void>;
+}
+interface DurableAgentConfig {
+    /** Max retries on failure — default 0 */
+    maxRetries?: number;
+    /** Delay between retries in ms — default 1000 */
+    retryDelayMs?: number;
+    /** Cron expression for scheduled runs (requires node-cron peer dep) */
+    schedule?: string;
+    /** Called on each scheduled run to produce the input string */
+    onSchedule?: () => Promise<string> | string;
+    /** Metadata to attach to every job */
+    metadata?: Record<string, unknown>;
+}
+type DurableStreamEvent = LLMStreamEvent | {
+    type: 'job_status';
+    job: DurableJob;
+};
+
+declare class DurableAgent {
+    private agent;
+    private store;
+    private config;
+    private schedulerHandle;
+    constructor(agent: BaseAgent, store: DurableStore, config?: DurableAgentConfig);
+    /**
+     * Run a job by ID.
+     * - Creates a new job if jobId doesn't exist yet.
+     * - If the job is already completed/cancelled, returns it as-is.
+     * - If paused, call resume() instead.
+     */
+    run(jobId: string, input: string): Promise<DurableJob>;
+    /**
+     * Streaming run — yields LLM stream events plus job_status bookends.
+     */
+    runStream(jobId: string, input: string): AsyncIterable<LLMStreamEvent | {
+        type: 'job_status';
+        job: DurableJob;
+    }>;
+    /** Pause a running job (marks as paused — the caller must stop feeding input). */
+    pause(jobId: string): Promise<void>;
+    /** Resume a paused job with optional new input. */
+    resume(jobId: string, newInput?: string): Promise<DurableJob>;
+    /** Cancel a job. */
+    cancel(jobId: string): Promise<void>;
+    /** Get job status. */
+    status(jobId: string): Promise<DurableJob | null>;
+    /** List all jobs, optionally filtered by status. */
+    list(filter?: {
+        status?: DurableJobStatus;
+    }): Promise<DurableJob[]>;
+    /**
+     * Start a cron-scheduled agent (requires `node-cron` peer dep).
+     * @param schedule - Cron expression, e.g. '0 9 * * MON'
+     * @param inputFn - Function returning the input for each run
+     */
+    startScheduler(): void;
+    stopScheduler(): void;
+}
+
+/**
+ * In-memory durable store — suitable for development and testing.
+ * Data is lost on process restart.
+ */
+declare class MemoryDurableStore implements DurableStore {
+    private jobs;
+    save(job: DurableJob): Promise<void>;
+    load(jobId: string): Promise<DurableJob | null>;
+    list(filter?: {
+        status?: DurableJobStatus;
+    }): Promise<DurableJob[]>;
+    delete(jobId: string): Promise<void>;
+    clear(): void;
+    size(): number;
+}
+
+interface RedisDurableStoreConfig {
+    /** Redis connection URL — default 'redis://localhost:6379' */
+    url?: string;
+    /** Key prefix — default 'orka:durable:' */
+    prefix?: string;
+    /** TTL for terminal jobs (completed/failed/cancelled) in seconds — default 7 days */
+    ttlSeconds?: number;
+}
+/**
+ * Redis-backed durable store for production use.
+ * Requires the `redis` package as a peer dependency.
+ *
+ * @example
+ * ```typescript
+ * import { RedisDurableStore } from '@orka-js/durable'
+ * const store = new RedisDurableStore({ url: process.env.REDIS_URL })
+ * ```
+ */
+declare class RedisDurableStore implements DurableStore {
+    private client;
+    private prefix;
+    private ttlSeconds;
+    private url;
+    constructor(config?: RedisDurableStoreConfig);
+    private getClient;
+    private key;
+    private serialize;
+    private deserialize;
+    save(job: DurableJob): Promise<void>;
+    load(jobId: string): Promise<DurableJob | null>;
+    list(filter?: {
+        status?: DurableJobStatus;
+    }): Promise<DurableJob[]>;
+    delete(jobId: string): Promise<void>;
+}
+
+export { DurableAgent, type DurableAgentConfig, type DurableJob, type DurableJobStatus, type DurableStore, type DurableStreamEvent, MemoryDurableStore, RedisDurableStore };

package/dist/index.d.ts

@@ -0,0 +1,141 @@
+import { LLMStreamEvent } from '@orka-js/core';
+import { BaseAgent } from '@orka-js/agent';
+
+type DurableJobStatus = 'pending' | 'running' | 'paused' | 'completed' | 'failed' | 'cancelled';
+interface DurableJob {
+    id: string;
+    input: string;
+    status: DurableJobStatus;
+    result?: string;
+    error?: string;
+    /** Saved conversation messages for resuming */
+    messages?: Array<{
+        role: 'user' | 'assistant' | 'system';
+        content: string;
+    }>;
+    metadata?: Record<string, unknown>;
+    createdAt: Date;
+    updatedAt: Date;
+    completedAt?: Date;
+    /** Number of retry attempts so far */
+    attempts: number;
+}
+interface DurableStore {
+    save(job: DurableJob): Promise<void>;
+    load(jobId: string): Promise<DurableJob | null>;
+    list(filter?: {
+        status?: DurableJobStatus;
+    }): Promise<DurableJob[]>;
+    delete(jobId: string): Promise<void>;
+}
+interface DurableAgentConfig {
+    /** Max retries on failure — default 0 */
+    maxRetries?: number;
+    /** Delay between retries in ms — default 1000 */
+    retryDelayMs?: number;
+    /** Cron expression for scheduled runs (requires node-cron peer dep) */
+    schedule?: string;
+    /** Called on each scheduled run to produce the input string */
+    onSchedule?: () => Promise<string> | string;
+    /** Metadata to attach to every job */
+    metadata?: Record<string, unknown>;
+}
+type DurableStreamEvent = LLMStreamEvent | {
+    type: 'job_status';
+    job: DurableJob;
+};
+
+declare class DurableAgent {
+    private agent;
+    private store;
+    private config;
+    private schedulerHandle;
+    constructor(agent: BaseAgent, store: DurableStore, config?: DurableAgentConfig);
+    /**
+     * Run a job by ID.
+     * - Creates a new job if jobId doesn't exist yet.
+     * - If the job is already completed/cancelled, returns it as-is.
+     * - If paused, call resume() instead.
+     */
+    run(jobId: string, input: string): Promise<DurableJob>;
+    /**
+     * Streaming run — yields LLM stream events plus job_status bookends.
+     */
+    runStream(jobId: string, input: string): AsyncIterable<LLMStreamEvent | {
+        type: 'job_status';
+        job: DurableJob;
+    }>;
+    /** Pause a running job (marks as paused — the caller must stop feeding input). */
+    pause(jobId: string): Promise<void>;
+    /** Resume a paused job with optional new input. */
+    resume(jobId: string, newInput?: string): Promise<DurableJob>;
+    /** Cancel a job. */
+    cancel(jobId: string): Promise<void>;
+    /** Get job status. */
+    status(jobId: string): Promise<DurableJob | null>;
+    /** List all jobs, optionally filtered by status. */
+    list(filter?: {
+        status?: DurableJobStatus;
+    }): Promise<DurableJob[]>;
+    /**
+     * Start a cron-scheduled agent (requires `node-cron` peer dep).
+     * @param schedule - Cron expression, e.g. '0 9 * * MON'
+     * @param inputFn - Function returning the input for each run
+     */
+    startScheduler(): void;
+    stopScheduler(): void;
+}
+
+/**
+ * In-memory durable store — suitable for development and testing.
+ * Data is lost on process restart.
+ */
+declare class MemoryDurableStore implements DurableStore {
+    private jobs;
+    save(job: DurableJob): Promise<void>;
+    load(jobId: string): Promise<DurableJob | null>;
+    list(filter?: {
+        status?: DurableJobStatus;
+    }): Promise<DurableJob[]>;
+    delete(jobId: string): Promise<void>;
+    clear(): void;
+    size(): number;
+}
+
+interface RedisDurableStoreConfig {
+    /** Redis connection URL — default 'redis://localhost:6379' */
+    url?: string;
+    /** Key prefix — default 'orka:durable:' */
+    prefix?: string;
+    /** TTL for terminal jobs (completed/failed/cancelled) in seconds — default 7 days */
+    ttlSeconds?: number;
+}
+/**
+ * Redis-backed durable store for production use.
+ * Requires the `redis` package as a peer dependency.
+ *
+ * @example
+ * ```typescript
+ * import { RedisDurableStore } from '@orka-js/durable'
+ * const store = new RedisDurableStore({ url: process.env.REDIS_URL })
+ * ```
+ */
+declare class RedisDurableStore implements DurableStore {
+    private client;
+    private prefix;
+    private ttlSeconds;
+    private url;
+    constructor(config?: RedisDurableStoreConfig);
+    private getClient;
+    private key;
+    private serialize;
+    private deserialize;
+    save(job: DurableJob): Promise<void>;
+    load(jobId: string): Promise<DurableJob | null>;
+    list(filter?: {
+        status?: DurableJobStatus;
+    }): Promise<DurableJob[]>;
+    delete(jobId: string): Promise<void>;
+}
+
+export { DurableAgent, type DurableAgentConfig, type DurableJob, type DurableJobStatus, type DurableStore, type DurableStreamEvent, MemoryDurableStore, RedisDurableStore };

package/dist/index.js

@@ -0,0 +1,283 @@
+// src/durable-agent.ts
+function generateId() {
+  return `job_${Date.now()}_${Math.random().toString(36).slice(2, 8)}`;
+}
+function now() {
+  return /* @__PURE__ */ new Date();
+}
+var DurableAgent = class {
+  agent;
+  store;
+  config;
+  schedulerHandle = null;
+  constructor(agent, store, config = {}) {
+    this.agent = agent;
+    this.store = store;
+    this.config = { maxRetries: 0, retryDelayMs: 1e3, ...config };
+  }
+  /**
+   * Run a job by ID.
+   * - Creates a new job if jobId doesn't exist yet.
+   * - If the job is already completed/cancelled, returns it as-is.
+   * - If paused, call resume() instead.
+   */
+  async run(jobId, input) {
+    let job = await this.store.load(jobId);
+    if (!job) {
+      job = {
+        id: jobId,
+        input,
+        status: "pending",
+        attempts: 0,
+        metadata: this.config.metadata,
+        createdAt: now(),
+        updatedAt: now()
+      };
+      await this.store.save(job);
+    }
+    if (job.status === "completed" || job.status === "cancelled") {
+      return job;
+    }
+    job.status = "running";
+    job.updatedAt = now();
+    job.attempts++;
+    await this.store.save(job);
+    try {
+      const result = await this.agent.run(input);
+      job.status = "completed";
+      job.result = result.output;
+      job.completedAt = now();
+    } catch (error) {
+      const err = error;
+      job.error = err.message;
+      if (job.attempts <= (this.config.maxRetries ?? 0)) {
+        job.status = "pending";
+        job.updatedAt = now();
+        await this.store.save(job);
+        if (this.config.retryDelayMs) {
+          await new Promise((r) => setTimeout(r, this.config.retryDelayMs));
+        }
+        return this.run(jobId, input);
+      }
+      job.status = "failed";
+    }
+    job.updatedAt = now();
+    await this.store.save(job);
+    return job;
+  }
+  /**
+   * Streaming run — yields LLM stream events plus job_status bookends.
+   */
+  async *runStream(jobId, input) {
+    let job = await this.store.load(jobId);
+    if (!job) {
+      job = {
+        id: jobId,
+        input,
+        status: "pending",
+        attempts: 0,
+        metadata: this.config.metadata,
+        createdAt: now(),
+        updatedAt: now()
+      };
+    }
+    if (job.status === "completed" || job.status === "cancelled") {
+      yield { type: "job_status", job };
+      return;
+    }
+    job.status = "running";
+    job.updatedAt = now();
+    job.attempts++;
+    await this.store.save(job);
+    yield { type: "job_status", job: { ...job } };
+    try {
+      if (typeof this.agent.runStream === "function") {
+        let finalContent = "";
+        for await (const event of this.agent.runStream(input)) {
+          yield event;
+          if (event.type === "done") finalContent = event.content;
+        }
+        job.status = "completed";
+        job.result = finalContent;
+      } else {
+        const result = await this.agent.run(input);
+        job.status = "completed";
+        job.result = result.output;
+      }
+      job.completedAt = now();
+    } catch (error) {
+      job.status = "failed";
+      job.error = error.message;
+    }
+    job.updatedAt = now();
+    await this.store.save(job);
+    yield { type: "job_status", job: { ...job } };
+  }
+  /** Pause a running job (marks as paused — the caller must stop feeding input). */
+  async pause(jobId) {
+    const job = await this.store.load(jobId);
+    if (!job) throw new Error(`Job "${jobId}" not found`);
+    if (job.status === "completed" || job.status === "cancelled") {
+      throw new Error(`Cannot pause a ${job.status} job`);
+    }
+    job.status = "paused";
+    job.updatedAt = now();
+    await this.store.save(job);
+  }
+  /** Resume a paused job with optional new input. */
+  async resume(jobId, newInput) {
+    const job = await this.store.load(jobId);
+    if (!job) throw new Error(`Job "${jobId}" not found`);
+    if (job.status !== "paused") {
+      throw new Error(`Job "${jobId}" is not paused (current status: ${job.status})`);
+    }
+    return this.run(jobId, newInput ?? job.input);
+  }
+  /** Cancel a job. */
+  async cancel(jobId) {
+    const job = await this.store.load(jobId);
+    if (!job) throw new Error(`Job "${jobId}" not found`);
+    job.status = "cancelled";
+    job.updatedAt = now();
+    await this.store.save(job);
+  }
+  /** Get job status. */
+  async status(jobId) {
+    return this.store.load(jobId);
+  }
+  /** List all jobs, optionally filtered by status. */
+  async list(filter) {
+    return this.store.list(filter);
+  }
+  /**
+   * Start a cron-scheduled agent (requires `node-cron` peer dep).
+   * @param schedule - Cron expression, e.g. '0 9 * * MON'
+   * @param inputFn - Function returning the input for each run
+   */
+  startScheduler() {
+    if (!this.config.schedule) throw new Error("DurableAgent: no schedule configured");
+    if (!this.config.onSchedule) throw new Error("DurableAgent: no onSchedule handler configured");
+    import('node-cron').then((cron) => {
+      this.schedulerHandle = cron.schedule(this.config.schedule, async () => {
+        const input = await this.config.onSchedule();
+        const jobId = generateId();
+        await this.run(jobId, input);
+      });
+    }).catch(() => {
+      throw new Error(
+        '@orka-js/durable: startScheduler() requires the "node-cron" package.\nInstall it with: npm install node-cron'
+      );
+    });
+  }
+  stopScheduler() {
+    if (this.schedulerHandle && typeof this.schedulerHandle.stop === "function") {
+      this.schedulerHandle.stop();
+      this.schedulerHandle = null;
+    }
+  }
+};
+
+// src/stores/memory-store.ts
+var MemoryDurableStore = class {
+  jobs = /* @__PURE__ */ new Map();
+  async save(job) {
+    this.jobs.set(job.id, { ...job });
+  }
+  async load(jobId) {
+    const job = this.jobs.get(jobId);
+    return job ? { ...job } : null;
+  }
+  async list(filter) {
+    const all = [...this.jobs.values()].map((j) => ({ ...j }));
+    if (filter?.status) {
+      return all.filter((j) => j.status === filter.status);
+    }
+    return all.sort((a, b) => b.createdAt.getTime() - a.createdAt.getTime());
+  }
+  async delete(jobId) {
+    this.jobs.delete(jobId);
+  }
+  clear() {
+    this.jobs.clear();
+  }
+  size() {
+    return this.jobs.size;
+  }
+};
+
+// src/stores/redis-store.ts
+var RedisDurableStore = class {
+  client = null;
+  prefix;
+  ttlSeconds;
+  url;
+  constructor(config = {}) {
+    this.url = config.url ?? "redis://localhost:6379";
+    this.prefix = config.prefix ?? "orka:durable:";
+    this.ttlSeconds = config.ttlSeconds ?? 60 * 60 * 24 * 7;
+  }
+  async getClient() {
+    if (this.client) return this.client;
+    let redis;
+    try {
+      redis = await import('redis');
+    } catch {
+      throw new Error(
+        '@orka-js/durable: RedisDurableStore requires the "redis" package.\nInstall it with: npm install redis'
+      );
+    }
+    const client = redis.createClient({ url: this.url });
+    await client.connect();
+    this.client = client;
+    return client;
+  }
+  key(jobId) {
+    return `${this.prefix}${jobId}`;
+  }
+  serialize(job) {
+    return JSON.stringify({
+      ...job,
+      createdAt: job.createdAt.toISOString(),
+      updatedAt: job.updatedAt.toISOString(),
+      completedAt: job.completedAt?.toISOString()
+    });
+  }
+  deserialize(raw) {
+    const data = JSON.parse(raw);
+    return {
+      ...data,
+      createdAt: new Date(data.createdAt),
+      updatedAt: new Date(data.updatedAt),
+      completedAt: data.completedAt ? new Date(data.completedAt) : void 0
+    };
+  }
+  async save(job) {
+    const client = await this.getClient();
+    await client.set(this.key(job.id), this.serialize(job));
+    if (["completed", "failed", "cancelled"].includes(job.status)) {
+      await client.expire(this.key(job.id), this.ttlSeconds);
+    }
+  }
+  async load(jobId) {
+    const client = await this.getClient();
+    const raw = await client.get(this.key(jobId));
+    return raw ? this.deserialize(raw) : null;
+  }
+  async list(filter) {
+    const client = await this.getClient();
+    const keys = await client.keys(`${this.prefix}*`);
+    if (keys.length === 0) return [];
+    const raws = await client.mGet(keys);
+    const jobs = raws.filter((r) => r !== null).map((r) => this.deserialize(r));
+    if (filter?.status) return jobs.filter((j) => j.status === filter.status);
+    return jobs.sort((a, b) => b.createdAt.getTime() - a.createdAt.getTime());
+  }
+  async delete(jobId) {
+    const client = await this.getClient();
+    await client.del(this.key(jobId));
+  }
+};
+
+export { DurableAgent, MemoryDurableStore, RedisDurableStore };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/durable-agent.ts","../src/stores/memory-store.ts","../src/stores/redis-store.ts"],"names":[],"mappings":";AAIA,SAAS,UAAA,GAAqB;AAC5B,EAAA,OAAO,CAAA,IAAA,EAAO,IAAA,CAAK,GAAA,EAAK,IAAI,IAAA,CAAK,MAAA,EAAO,CAAE,QAAA,CAAS,EAAE,CAAA,CAAE,KAAA,CAAM,CAAA,EAAG,CAAC,CAAC,CAAA,CAAA;AACpE;AAEA,SAAS,GAAA,GAAY;AACnB,EAAA,2BAAW,IAAA,EAAK;AAClB;AAMO,IAAM,eAAN,MAAmB;AAAA,EAChB,KAAA;AAAA,EACA,KAAA;AAAA,EACA,MAAA;AAAA,EACA,eAAA,GAA2B,IAAA;AAAA,EAEnC,WAAA,CACE,KAAA,EACA,KAAA,EACA,MAAA,GAA6B,EAAC,EAC9B;AACA,IAAA,IAAA,CAAK,KAAA,GAAQ,KAAA;AACb,IAAA,IAAA,CAAK,KAAA,GAAQ,KAAA;AACb,IAAA,IAAA,CAAK,SAAS,EAAE,UAAA,EAAY,GAAG,YAAA,EAAc,GAAA,EAAM,GAAG,MAAA,EAAO;AAAA,EAC/D;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,MAAM,GAAA,CAAI,KAAA,EAAe,KAAA,EAAoC;AAC3D,IAAA,IAAI,GAAA,GAAM,MAAM,IAAA,CAAK,KAAA,CAAM,KAAK,KAAK,CAAA;AAErC,IAAA,IAAI,CAAC,GAAA,EAAK;AACR,MAAA,GAAA,GAAM;AAAA,QACJ,EAAA,EAAI,KAAA;AAAA,QACJ,KAAA;AAAA,QACA,MAAA,EAAQ,SAAA;AAAA,QACR,QAAA,EAAU,CAAA;AAAA,QACV,QAAA,EAAU,KAAK,MAAA,CAAO,QAAA;AAAA,QACtB,WAAW,GAAA,EAAI;AAAA,QACf,WAAW,GAAA;AAAI,OACjB;AACA,MAAA,MAAM,IAAA,CAAK,KAAA,CAAM,IAAA,CAAK,GAAG,CAAA;AAAA,IAC3B;AAEA,IAAA,IAAI,GAAA,CAAI,MAAA,KAAW,WAAA,IAAe,GAAA,CAAI,WAAW,WAAA,EAAa;AAC5D,MAAA,OAAO,GAAA;AAAA,IACT;AAEA,IAAA,GAAA,CAAI,MAAA,GAAS,SAAA;AACb,IAAA,GAAA,CAAI,YAAY,GAAA,EAAI;AACpB,IAAA,GAAA,CAAI,QAAA,EAAA;AACJ,IAAA,MAAM,IAAA,CAAK,KAAA,CAAM,IAAA,CAAK,GAAG,CAAA;AAEzB,IAAA,IAAI;AACF,MAAA,MAAM,MAAA,GAAS,MAAM,IAAA,CAAK,KAAA,CAAM,IAAI,KAAK,CAAA;AACzC,MAAA,GAAA,CAAI,MAAA,GAAS,WAAA;AACb,MAAA,GAAA,CAAI,SAAS,MAAA,CAAO,MAAA;AACpB,MAAA,GAAA,CAAI,cAAc,GAAA,EAAI;AAAA,IACxB,SAAS,KAAA,EAAO;AACd,MAAA,MAAM,GAAA,GAAM,KAAA;AACZ,MAAA,GAAA,CAAI,QAAQ,GAAA,CAAI,OAAA;AAEhB,MAAA,IAAI,GAAA,CAAI,QAAA,KAAa,IAAA,CAAK,MAAA,CAAO,cAAc,CAAA,CAAA,EAAI;AACjD,QAAA,GAAA,CAAI,MAAA,GAAS,SAAA;AACb,QAAA,GAAA,CAAI,YAAY,GAAA,EAAI;AACpB,QAAA,MAAM,IAAA,CAAK,KAAA,CAAM,IAAA,CAAK,GAAG,CAAA;AACzB,QAAA,IAAI,IAAA,CAAK,OAAO,YAAA,EAAc;AAC5B,UAAA,MAAM,IAAI,QAAQ,CAAA,CAAA,KAAK,UAAA,CAAW,GAAG,IAAA,CAAK,MAAA,CAAO,YAAY,CAAC,CAAA;AAAA,QAChE;AACA,QAAA,OAAO,IAAA,CAAK,GAAA,CAAI,KAAA,EAAO,KAAK,CAAA;AAAA,MAC9B;AAEA,MAAA,GAAA,CAAI,MAAA,GAAS,QAAA;AAAA,IACf;AAEA,IAAA,GAAA,CAAI,YAAY,GAAA,EAAI;AACpB,IAAA,MAAM,IAAA,CAAK,KAAA,CAAM,IAAA,CAAK,GAAG,CAAA;AACzB,IAAA,OAAO,GAAA;AAAA,EACT;AAAA;AAAA;AAAA;AAAA,EAKA,OAAO,SAAA,CACL,KAAA,EACA,KAAA,EACyE;AACzE,IAAA,IAAI,GAAA,GAAM,MAAM,IAAA,CAAK,KAAA,CAAM,KAAK,KAAK,CAAA;AAErC,IAAA,IAAI,CAAC,GAAA,EAAK;AACR,MAAA,GAAA,GAAM;AAAA,QACJ,EAAA,EAAI,KAAA;AAAA,QACJ,KAAA;AAAA,QACA,MAAA,EAAQ,SAAA;AAAA,QACR,QAAA,EAAU,CAAA;AAAA,QACV,QAAA,EAAU,KAAK,MAAA,CAAO,QAAA;AAAA,QACtB,WAAW,GAAA,EAAI;AAAA,QACf,WAAW,GAAA;AAAI,OACjB;AAAA,IACF;AAEA,IAAA,IAAI,GAAA,CAAI,MAAA,KAAW,WAAA,IAAe,GAAA,CAAI,WAAW,WAAA,EAAa;AAC5D,MAAA,MAAM,EAAE,IAAA,EAAM,YAAA,EAAc,GAAA,EAAI;AAChC,MAAA;AAAA,IACF;AAEA,IAAA,GAAA,CAAI,MAAA,GAAS,SAAA;AACb,IAAA,GAAA,CAAI,YAAY,GAAA,EAAI;AACpB,IAAA,GAAA,CAAI,QAAA,EAAA;AACJ,IAAA,MAAM,IAAA,CAAK,KAAA,CAAM,IAAA,CAAK,GAAG,CAAA;AACzB,IAAA,MAAM,EAAE,IAAA,EAAM,YAAA,EAAc,KAAK,EAAE,GAAG,KAAI,EAAE;AAE5C,IAAA,IAAI;AACF,MAAA,IAAI,OAAO,IAAA,CAAK,KAAA,CAAM,SAAA,KAAc,UAAA,EAAY;AAC9C,QAAA,IAAI,YAAA,GAAe,EAAA;AACnB,QAAA,WAAA,MAAiB,KAAA,IAAS,IAAA,CAAK,KAAA,CAAM,SAAA,CAAU,KAAK,CAAA,EAAG;AACrD,UAAA,MAAM,KAAA;AACN,UAAA,IAAI,KAAA,CAAM,IAAA,KAAS,MAAA,EAAQ,YAAA,GAAe,KAAA,CAAM,OAAA;AAAA,QAClD;AACA,QAAA,GAAA,CAAI,MAAA,GAAS,WAAA;AACb,QAAA,GAAA,CAAI,MAAA,GAAS,YAAA;AAAA,MACf,CAAA,MAAO;AACL,QAAA,MAAM,MAAA,GAAS,MAAM,IAAA,CAAK,KAAA,CAAM,IAAI,KAAK,CAAA;AACzC,QAAA,GAAA,CAAI,MAAA,GAAS,WAAA;AACb,QAAA,GAAA,CAAI,SAAS,MAAA,CAAO,MAAA;AAAA,MACtB;AACA,MAAA,GAAA,CAAI,cAAc,GAAA,EAAI;AAAA,IACxB,SAAS,KAAA,EAAO;AACd,MAAA,GAAA,CAAI,MAAA,GAAS,QAAA;AACb,MAAA,GAAA,CAAI,QAAS,KAAA,CAAgB,OAAA;AAAA,IAC/B;AAEA,IAAA,GAAA,CAAI,YAAY,GAAA,EAAI;AACpB,IAAA,MAAM,IAAA,CAAK,KAAA,CAAM,IAAA,CAAK,GAAG,CAAA;AACzB,IAAA,MAAM,EAAE,IAAA,EAAM,YAAA,EAAc,KAAK,EAAE,GAAG,KAAI,EAAE;AAAA,EAC9C;AAAA;AAAA,EAGA,MAAM,MAAM,KAAA,EAA8B;AACxC,IAAA,MAAM,GAAA,GAAM,MAAM,IAAA,CAAK,KAAA,CAAM,KAAK,KAAK,CAAA;AACvC,IAAA,IAAI,CAAC,GAAA,EAAK,MAAM,IAAI,KAAA,CAAM,CAAA,KAAA,EAAQ,KAAK,CAAA,WAAA,CAAa,CAAA;AACpD,IAAA,IAAI,GAAA,CAAI,MAAA,KAAW,WAAA,IAAe,GAAA,CAAI,WAAW,WAAA,EAAa;AAC5D,MAAA,MAAM,IAAI,KAAA,CAAM,CAAA,eAAA,EAAkB,GAAA,CAAI,MAAM,CAAA,IAAA,CAAM,CAAA;AAAA,IACpD;AACA,IAAA,GAAA,CAAI,MAAA,GAAS,QAAA;AACb,IAAA,GAAA,CAAI,YAAY,GAAA,EAAI;AACpB,IAAA,MAAM,IAAA,CAAK,KAAA,CAAM,IAAA,CAAK,GAAG,CAAA;AAAA,EAC3B;AAAA;AAAA,EAGA,MAAM,MAAA,CAAO,KAAA,EAAe,QAAA,EAAwC;AAClE,IAAA,MAAM,GAAA,GAAM,MAAM,IAAA,CAAK,KAAA,CAAM,KAAK,KAAK,CAAA;AACvC,IAAA,IAAI,CAAC,GAAA,EAAK,MAAM,IAAI,KAAA,CAAM,CAAA,KAAA,EAAQ,KAAK,CAAA,WAAA,CAAa,CAAA;AACpD,IAAA,IAAI,GAAA,CAAI,WAAW,QAAA,EAAU;AAC3B,MAAA,MAAM,IAAI,KAAA,CAAM,CAAA,KAAA,EAAQ,KAAK,CAAA,iCAAA,EAAoC,GAAA,CAAI,MAAM,CAAA,CAAA,CAAG,CAAA;AAAA,IAChF;AACA,IAAA,OAAO,IAAA,CAAK,GAAA,CAAI,KAAA,EAAO,QAAA,IAAY,IAAI,KAAK,CAAA;AAAA,EAC9C;AAAA;AAAA,EAGA,MAAM,OAAO,KAAA,EAA8B;AACzC,IAAA,MAAM,GAAA,GAAM,MAAM,IAAA,CAAK,KAAA,CAAM,KAAK,KAAK,CAAA;AACvC,IAAA,IAAI,CAAC,GAAA,EAAK,MAAM,IAAI,KAAA,CAAM,CAAA,KAAA,EAAQ,KAAK,CAAA,WAAA,CAAa,CAAA;AACpD,IAAA,GAAA,CAAI,MAAA,GAAS,WAAA;AACb,IAAA,GAAA,CAAI,YAAY,GAAA,EAAI;AACpB,IAAA,MAAM,IAAA,CAAK,KAAA,CAAM,IAAA,CAAK,GAAG,CAAA;AAAA,EAC3B;AAAA;AAAA,EAGA,MAAM,OAAO,KAAA,EAA2C;AACtD,IAAA,OAAO,IAAA,CAAK,KAAA,CAAM,IAAA,CAAK,KAAK,CAAA;AAAA,EAC9B;AAAA;AAAA,EAGA,MAAM,KAAK,MAAA,EAA+D;AACxE,IAAA,OAAO,IAAA,CAAK,KAAA,CAAM,IAAA,CAAK,MAAM,CAAA;AAAA,EAC/B;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,cAAA,GAAuB;AACrB,IAAA,IAAI,CAAC,IAAA,CAAK,MAAA,CAAO,UAAU,MAAM,IAAI,MAAM,sCAAsC,CAAA;AACjF,IAAA,IAAI,CAAC,IAAA,CAAK,MAAA,CAAO,YAAY,MAAM,IAAI,MAAM,gDAAgD,CAAA;AAE7F,IAAA,OAAO,WAAW,CAAA,CAAE,IAAA,CAAK,CAAA,IAAA,KAAQ;AAC/B,MAAA,IAAA,CAAK,kBAAmB,IAAA,CAErB,QAAA,CAAS,IAAA,CAAK,MAAA,CAAO,UAAW,YAAY;AAC7C,QAAA,MAAM,KAAA,GAAQ,MAAM,IAAA,CAAK,MAAA,CAAO,UAAA,EAAY;AAC5C,QAAA,MAAM,QAAQ,UAAA,EAAW;AACzB,QAAA,MAAM,IAAA,CAAK,GAAA,CAAI,KAAA,EAAO,KAAK,CAAA;AAAA,MAC7B,CAAC,CAAA;AAAA,IACH,CAAC,CAAA,CAAE,KAAA,CAAM,MAAM;AACb,MAAA,MAAM,IAAI,KAAA;AAAA,QACR;AAAA,OAEF;AAAA,IACF,CAAC,CAAA;AAAA,EACH;AAAA,EAEA,aAAA,GAAsB;AACpB,IAAA,IAAI,KAAK,eAAA,IAAmB,OAAQ,IAAA,CAAK,eAAA,CAA0C,SAAS,UAAA,EAAY;AACtG,MAAC,IAAA,CAAK,gBAAqC,IAAA,EAAK;AAChD,MAAA,IAAA,CAAK,eAAA,GAAkB,IAAA;AAAA,IACzB;AAAA,EACF;AACF;;;ACrNO,IAAM,qBAAN,MAAiD;AAAA,EAC9C,IAAA,uBAAoC,GAAA,EAAI;AAAA,EAEhD,MAAM,KAAK,GAAA,EAAgC;AACzC,IAAA,IAAA,CAAK,KAAK,GAAA,CAAI,GAAA,CAAI,IAAI,EAAE,GAAG,KAAK,CAAA;AAAA,EAClC;AAAA,EAEA,MAAM,KAAK,KAAA,EAA2C;AACpD,IAAA,MAAM,GAAA,GAAM,IAAA,CAAK,IAAA,CAAK,GAAA,CAAI,KAAK,CAAA;AAC/B,IAAA,OAAO,GAAA,GAAM,EAAE,GAAG,GAAA,EAAI,GAAI,IAAA;AAAA,EAC5B;AAAA,EAEA,MAAM,KAAK,MAAA,EAA+D;AACxE,IAAA,MAAM,GAAA,GAAM,CAAC,GAAG,IAAA,CAAK,IAAA,CAAK,MAAA,EAAQ,CAAA,CAAE,GAAA,CAAI,CAAA,CAAA,MAAM,EAAE,GAAG,GAAE,CAAE,CAAA;AACvD,IAAA,IAAI,QAAQ,MAAA,EAAQ;AAClB,MAAA,OAAO,IAAI,MAAA,CAAO,CAAA,CAAA,KAAK,CAAA,CAAE,MAAA,KAAW,OAAO,MAAM,CAAA;AAAA,IACnD;AACA,IAAA,OAAO,GAAA,CAAI,IAAA,CAAK,CAAC,CAAA,EAAG,CAAA,KAAM,CAAA,CAAE,SAAA,CAAU,OAAA,EAAQ,GAAI,CAAA,CAAE,SAAA,CAAU,OAAA,EAAS,CAAA;AAAA,EACzE;AAAA,EAEA,MAAM,OAAO,KAAA,EAA8B;AACzC,IAAA,IAAA,CAAK,IAAA,CAAK,OAAO,KAAK,CAAA;AAAA,EACxB;AAAA,EAEA,KAAA,GAAc;AACZ,IAAA,IAAA,CAAK,KAAK,KAAA,EAAM;AAAA,EAClB;AAAA,EAEA,IAAA,GAAe;AACb,IAAA,OAAO,KAAK,IAAA,CAAK,IAAA;AAAA,EACnB;AACF;;;ACNO,IAAM,oBAAN,MAAgD;AAAA,EAC7C,MAAA,GAA6B,IAAA;AAAA,EAC7B,MAAA;AAAA,EACA,UAAA;AAAA,EACA,GAAA;AAAA,EAER,WAAA,CAAY,MAAA,GAAkC,EAAC,EAAG;AAChD,IAAA,IAAA,CAAK,GAAA,GAAM,OAAO,GAAA,IAAO,wBAAA;AACzB,IAAA,IAAA,CAAK,MAAA,GAAS,OAAO,MAAA,IAAU,eAAA;AAC/B,IAAA,IAAA,CAAK,UAAA,GAAa,MAAA,CAAO,UAAA,IAAc,EAAA,GAAK,KAAK,EAAA,GAAK,CAAA;AAAA,EACxD;AAAA,EAEA,MAAc,SAAA,GAAkC;AAC9C,IAAA,IAAI,IAAA,CAAK,MAAA,EAAQ,OAAO,IAAA,CAAK,MAAA;AAE7B,IAAA,IAAI,KAAA;AACJ,IAAA,IAAI;AACF,MAAA,KAAA,GAAQ,MAAM,OAAO,OAAO,CAAA;AAAA,IAC9B,CAAA,CAAA,MAAQ;AACN,MAAA,MAAM,IAAI,KAAA;AAAA,QACR;AAAA,OAEF;AAAA,IACF;AAEA,IAAA,MAAM,SAAS,KAAA,CAAM,YAAA,CAAa,EAAE,GAAA,EAAK,IAAA,CAAK,KAAK,CAAA;AACnD,IAAA,MAAM,OAAO,OAAA,EAAQ;AACrB,IAAA,IAAA,CAAK,MAAA,GAAS,MAAA;AACd,IAAA,OAAO,MAAA;AAAA,EACT;AAAA,EAEQ,IAAI,KAAA,EAAuB;AACjC,IAAA,OAAO,CAAA,EAAG,IAAA,CAAK,MAAM,CAAA,EAAG,KAAK,CAAA,CAAA;AAAA,EAC/B;AAAA,EAEQ,UAAU,GAAA,EAAyB;AACzC,IAAA,OAAO,KAAK,SAAA,CAAU;AAAA,MACpB,GAAG,GAAA;AAAA,MACH,SAAA,EAAW,GAAA,CAAI,SAAA,CAAU,WAAA,EAAY;AAAA,MACrC,SAAA,EAAW,GAAA,CAAI,SAAA,CAAU,WAAA,EAAY;AAAA,MACrC,WAAA,EAAa,GAAA,CAAI,WAAA,EAAa,WAAA;AAAY,KAC3C,CAAA;AAAA,EACH;AAAA,EAEQ,YAAY,GAAA,EAAyB;AAC3C,IAAA,MAAM,IAAA,GAAO,IAAA,CAAK,KAAA,CAAM,GAAG,CAAA;AAC3B,IAAA,OAAO;AAAA,MACL,GAAG,IAAA;AAAA,MACH,SAAA,EAAW,IAAI,IAAA,CAAK,IAAA,CAAK,SAAS,CAAA;AAAA,MAClC,SAAA,EAAW,IAAI,IAAA,CAAK,IAAA,CAAK,SAAS,CAAA;AAAA,MAClC,aAAa,IAAA,CAAK,WAAA,GAAc,IAAI,IAAA,CAAK,IAAA,CAAK,WAAW,CAAA,GAAI;AAAA,KAC/D;AAAA,EACF;AAAA,EAEA,MAAM,KAAK,GAAA,EAAgC;AACzC,IAAA,MAAM,MAAA,GAAS,MAAM,IAAA,CAAK,SAAA,EAAU;AACpC,IAAA,MAAM,MAAA,CAAO,GAAA,CAAI,IAAA,CAAK,GAAA,CAAI,GAAA,CAAI,EAAE,CAAA,EAAG,IAAA,CAAK,SAAA,CAAU,GAAG,CAAC,CAAA;AACtD,IAAA,IAAI,CAAC,aAAa,QAAA,EAAU,WAAW,EAAE,QAAA,CAAS,GAAA,CAAI,MAAM,CAAA,EAAG;AAC7D,MAAA,MAAM,MAAA,CAAO,OAAO,IAAA,CAAK,GAAA,CAAI,IAAI,EAAE,CAAA,EAAG,KAAK,UAAU,CAAA;AAAA,IACvD;AAAA,EACF;AAAA,EAEA,MAAM,KAAK,KAAA,EAA2C;AACpD,IAAA,MAAM,MAAA,GAAS,MAAM,IAAA,CAAK,SAAA,EAAU;AACpC,IAAA,MAAM,MAAM,MAAM,MAAA,CAAO,IAAI,IAAA,CAAK,GAAA,CAAI,KAAK,CAAC,CAAA;AAC5C,IAAA,OAAO,GAAA,GAAM,IAAA,CAAK,WAAA,CAAY,GAAG,CAAA,GAAI,IAAA;AAAA,EACvC;AAAA,EAEA,MAAM,KAAK,MAAA,EAA+D;AACxE,IAAA,MAAM,MAAA,GAAS,MAAM,IAAA,CAAK,SAAA,EAAU;AACpC,IAAA,MAAM,OAAO,MAAM,MAAA,CAAO,KAAK,CAAA,EAAG,IAAA,CAAK,MAAM,CAAA,CAAA,CAAG,CAAA;AAChD,IAAA,IAAI,IAAA,CAAK,MAAA,KAAW,CAAA,EAAG,OAAO,EAAC;AAC/B,IAAA,MAAM,IAAA,GAAO,MAAM,MAAA,CAAO,IAAA,CAAK,IAAI,CAAA;AACnC,IAAA,MAAM,IAAA,GAAO,IAAA,CACV,MAAA,CAAO,CAAC,CAAA,KAAmB,CAAA,KAAM,IAAI,CAAA,CACrC,GAAA,CAAI,CAAA,CAAA,KAAK,IAAA,CAAK,WAAA,CAAY,CAAC,CAAC,CAAA;AAC/B,IAAA,IAAI,MAAA,EAAQ,QAAQ,OAAO,IAAA,CAAK,OAAO,CAAA,CAAA,KAAK,CAAA,CAAE,MAAA,KAAW,MAAA,CAAO,MAAM,CAAA;AACtE,IAAA,OAAO,IAAA,CAAK,IAAA,CAAK,CAAC,CAAA,EAAG,CAAA,KAAM,CAAA,CAAE,SAAA,CAAU,OAAA,EAAQ,GAAI,CAAA,CAAE,SAAA,CAAU,OAAA,EAAS,CAAA;AAAA,EAC1E;AAAA,EAEA,MAAM,OAAO,KAAA,EAA8B;AACzC,IAAA,MAAM,MAAA,GAAS,MAAM,IAAA,CAAK,SAAA,EAAU;AACpC,IAAA,MAAM,MAAA,CAAO,GAAA,CAAI,IAAA,CAAK,GAAA,CAAI,KAAK,CAAC,CAAA;AAAA,EAClC;AACF","file":"index.js","sourcesContent":["import type { LLMStreamEvent } from '@orka-js/core';\nimport type { BaseAgent } from '@orka-js/agent';\nimport type { DurableAgentConfig, DurableJob, DurableJobStatus, DurableStore } from './types.js';\n\nfunction generateId(): string {\n  return `job_${Date.now()}_${Math.random().toString(36).slice(2, 8)}`;\n}\n\nfunction now(): Date {\n  return new Date();\n}\n\ntype StreamableAgent = BaseAgent & {\n  runStream?: (input: string) => AsyncIterable<LLMStreamEvent>;\n};\n\nexport class DurableAgent {\n  private agent: StreamableAgent;\n  private store: DurableStore;\n  private config: DurableAgentConfig;\n  private schedulerHandle: unknown = null;\n\n  constructor(\n    agent: BaseAgent,\n    store: DurableStore,\n    config: DurableAgentConfig = {},\n  ) {\n    this.agent = agent as StreamableAgent;\n    this.store = store;\n    this.config = { maxRetries: 0, retryDelayMs: 1000, ...config };\n  }\n\n  /**\n   * Run a job by ID.\n   * - Creates a new job if jobId doesn't exist yet.\n   * - If the job is already completed/cancelled, returns it as-is.\n   * - If paused, call resume() instead.\n   */\n  async run(jobId: string, input: string): Promise<DurableJob> {\n    let job = await this.store.load(jobId);\n\n    if (!job) {\n      job = {\n        id: jobId,\n        input,\n        status: 'pending',\n        attempts: 0,\n        metadata: this.config.metadata,\n        createdAt: now(),\n        updatedAt: now(),\n      };\n      await this.store.save(job);\n    }\n\n    if (job.status === 'completed' || job.status === 'cancelled') {\n      return job;\n    }\n\n    job.status = 'running';\n    job.updatedAt = now();\n    job.attempts++;\n    await this.store.save(job);\n\n    try {\n      const result = await this.agent.run(input);\n      job.status = 'completed';\n      job.result = result.output;\n      job.completedAt = now();\n    } catch (error) {\n      const err = error as Error;\n      job.error = err.message;\n\n      if (job.attempts <= (this.config.maxRetries ?? 0)) {\n        job.status = 'pending';\n        job.updatedAt = now();\n        await this.store.save(job);\n        if (this.config.retryDelayMs) {\n          await new Promise(r => setTimeout(r, this.config.retryDelayMs));\n        }\n        return this.run(jobId, input);\n      }\n\n      job.status = 'failed';\n    }\n\n    job.updatedAt = now();\n    await this.store.save(job);\n    return job;\n  }\n\n  /**\n   * Streaming run — yields LLM stream events plus job_status bookends.\n   */\n  async *runStream(\n    jobId: string,\n    input: string,\n  ): AsyncIterable<LLMStreamEvent | { type: 'job_status'; job: DurableJob }> {\n    let job = await this.store.load(jobId);\n\n    if (!job) {\n      job = {\n        id: jobId,\n        input,\n        status: 'pending',\n        attempts: 0,\n        metadata: this.config.metadata,\n        createdAt: now(),\n        updatedAt: now(),\n      };\n    }\n\n    if (job.status === 'completed' || job.status === 'cancelled') {\n      yield { type: 'job_status', job };\n      return;\n    }\n\n    job.status = 'running';\n    job.updatedAt = now();\n    job.attempts++;\n    await this.store.save(job);\n    yield { type: 'job_status', job: { ...job } };\n\n    try {\n      if (typeof this.agent.runStream === 'function') {\n        let finalContent = '';\n        for await (const event of this.agent.runStream(input)) {\n          yield event;\n          if (event.type === 'done') finalContent = event.content;\n        }\n        job.status = 'completed';\n        job.result = finalContent;\n      } else {\n        const result = await this.agent.run(input);\n        job.status = 'completed';\n        job.result = result.output;\n      }\n      job.completedAt = now();\n    } catch (error) {\n      job.status = 'failed';\n      job.error = (error as Error).message;\n    }\n\n    job.updatedAt = now();\n    await this.store.save(job);\n    yield { type: 'job_status', job: { ...job } };\n  }\n\n  /** Pause a running job (marks as paused — the caller must stop feeding input). */\n  async pause(jobId: string): Promise<void> {\n    const job = await this.store.load(jobId);\n    if (!job) throw new Error(`Job \"${jobId}\" not found`);\n    if (job.status === 'completed' || job.status === 'cancelled') {\n      throw new Error(`Cannot pause a ${job.status} job`);\n    }\n    job.status = 'paused';\n    job.updatedAt = now();\n    await this.store.save(job);\n  }\n\n  /** Resume a paused job with optional new input. */\n  async resume(jobId: string, newInput?: string): Promise<DurableJob> {\n    const job = await this.store.load(jobId);\n    if (!job) throw new Error(`Job \"${jobId}\" not found`);\n    if (job.status !== 'paused') {\n      throw new Error(`Job \"${jobId}\" is not paused (current status: ${job.status})`);\n    }\n    return this.run(jobId, newInput ?? job.input);\n  }\n\n  /** Cancel a job. */\n  async cancel(jobId: string): Promise<void> {\n    const job = await this.store.load(jobId);\n    if (!job) throw new Error(`Job \"${jobId}\" not found`);\n    job.status = 'cancelled';\n    job.updatedAt = now();\n    await this.store.save(job);\n  }\n\n  /** Get job status. */\n  async status(jobId: string): Promise<DurableJob | null> {\n    return this.store.load(jobId);\n  }\n\n  /** List all jobs, optionally filtered by status. */\n  async list(filter?: { status?: DurableJobStatus }): Promise<DurableJob[]> {\n    return this.store.list(filter);\n  }\n\n  /**\n   * Start a cron-scheduled agent (requires `node-cron` peer dep).\n   * @param schedule - Cron expression, e.g. '0 9 * * MON'\n   * @param inputFn - Function returning the input for each run\n   */\n  startScheduler(): void {\n    if (!this.config.schedule) throw new Error('DurableAgent: no schedule configured');\n    if (!this.config.onSchedule) throw new Error('DurableAgent: no onSchedule handler configured');\n\n    import('node-cron').then(cron => {\n      this.schedulerHandle = (cron as {\n        schedule(expr: string, fn: () => void): unknown;\n      }).schedule(this.config.schedule!, async () => {\n        const input = await this.config.onSchedule!();\n        const jobId = generateId();\n        await this.run(jobId, input);\n      });\n    }).catch(() => {\n      throw new Error(\n        '@orka-js/durable: startScheduler() requires the \"node-cron\" package.\\n' +\n        'Install it with: npm install node-cron'\n      );\n    });\n  }\n\n  stopScheduler(): void {\n    if (this.schedulerHandle && typeof (this.schedulerHandle as { stop?: () => void }).stop === 'function') {\n      (this.schedulerHandle as { stop(): void }).stop();\n      this.schedulerHandle = null;\n    }\n  }\n}\n","import type { DurableJob, DurableJobStatus, DurableStore } from '../types.js';\n\n/**\n * In-memory durable store — suitable for development and testing.\n * Data is lost on process restart.\n */\nexport class MemoryDurableStore implements DurableStore {\n  private jobs: Map<string, DurableJob> = new Map();\n\n  async save(job: DurableJob): Promise<void> {\n    this.jobs.set(job.id, { ...job });\n  }\n\n  async load(jobId: string): Promise<DurableJob | null> {\n    const job = this.jobs.get(jobId);\n    return job ? { ...job } : null;\n  }\n\n  async list(filter?: { status?: DurableJobStatus }): Promise<DurableJob[]> {\n    const all = [...this.jobs.values()].map(j => ({ ...j }));\n    if (filter?.status) {\n      return all.filter(j => j.status === filter.status);\n    }\n    return all.sort((a, b) => b.createdAt.getTime() - a.createdAt.getTime());\n  }\n\n  async delete(jobId: string): Promise<void> {\n    this.jobs.delete(jobId);\n  }\n\n  clear(): void {\n    this.jobs.clear();\n  }\n\n  size(): number {\n    return this.jobs.size;\n  }\n}\n","import type { DurableJob, DurableJobStatus, DurableStore } from '../types.js';\n\nexport interface RedisDurableStoreConfig {\n  /** Redis connection URL — default 'redis://localhost:6379' */\n  url?: string;\n  /** Key prefix — default 'orka:durable:' */\n  prefix?: string;\n  /** TTL for terminal jobs (completed/failed/cancelled) in seconds — default 7 days */\n  ttlSeconds?: number;\n}\n\ntype RedisClient = {\n  connect(): Promise<void>;\n  get(key: string): Promise<string | null>;\n  set(key: string, value: string): Promise<unknown>;\n  expire(key: string, seconds: number): Promise<unknown>;\n  del(key: string): Promise<unknown>;\n  keys(pattern: string): Promise<string[]>;\n  mGet(keys: string[]): Promise<(string | null)[]>;\n};\n\n/**\n * Redis-backed durable store for production use.\n * Requires the `redis` package as a peer dependency.\n *\n * @example\n * ```typescript\n * import { RedisDurableStore } from '@orka-js/durable'\n * const store = new RedisDurableStore({ url: process.env.REDIS_URL })\n * ```\n */\nexport class RedisDurableStore implements DurableStore {\n  private client: RedisClient | null = null;\n  private prefix: string;\n  private ttlSeconds: number;\n  private url: string;\n\n  constructor(config: RedisDurableStoreConfig = {}) {\n    this.url = config.url ?? 'redis://localhost:6379';\n    this.prefix = config.prefix ?? 'orka:durable:';\n    this.ttlSeconds = config.ttlSeconds ?? 60 * 60 * 24 * 7;\n  }\n\n  private async getClient(): Promise<RedisClient> {\n    if (this.client) return this.client;\n\n    let redis: { createClient(config: { url: string }): RedisClient };\n    try {\n      redis = await import('redis') as unknown as typeof redis;\n    } catch {\n      throw new Error(\n        '@orka-js/durable: RedisDurableStore requires the \"redis\" package.\\n' +\n        'Install it with: npm install redis'\n      );\n    }\n\n    const client = redis.createClient({ url: this.url });\n    await client.connect();\n    this.client = client;\n    return client;\n  }\n\n  private key(jobId: string): string {\n    return `${this.prefix}${jobId}`;\n  }\n\n  private serialize(job: DurableJob): string {\n    return JSON.stringify({\n      ...job,\n      createdAt: job.createdAt.toISOString(),\n      updatedAt: job.updatedAt.toISOString(),\n      completedAt: job.completedAt?.toISOString(),\n    });\n  }\n\n  private deserialize(raw: string): DurableJob {\n    const data = JSON.parse(raw) as unknown as DurableJob & { createdAt: string; updatedAt: string; completedAt?: string };\n    return {\n      ...data,\n      createdAt: new Date(data.createdAt),\n      updatedAt: new Date(data.updatedAt),\n      completedAt: data.completedAt ? new Date(data.completedAt) : undefined,\n    };\n  }\n\n  async save(job: DurableJob): Promise<void> {\n    const client = await this.getClient();\n    await client.set(this.key(job.id), this.serialize(job));\n    if (['completed', 'failed', 'cancelled'].includes(job.status)) {\n      await client.expire(this.key(job.id), this.ttlSeconds);\n    }\n  }\n\n  async load(jobId: string): Promise<DurableJob | null> {\n    const client = await this.getClient();\n    const raw = await client.get(this.key(jobId));\n    return raw ? this.deserialize(raw) : null;\n  }\n\n  async list(filter?: { status?: DurableJobStatus }): Promise<DurableJob[]> {\n    const client = await this.getClient();\n    const keys = await client.keys(`${this.prefix}*`);\n    if (keys.length === 0) return [];\n    const raws = await client.mGet(keys);\n    const jobs = raws\n      .filter((r): r is string => r !== null)\n      .map(r => this.deserialize(r));\n    if (filter?.status) return jobs.filter(j => j.status === filter.status);\n    return jobs.sort((a, b) => b.createdAt.getTime() - a.createdAt.getTime());\n  }\n\n  async delete(jobId: string): Promise<void> {\n    const client = await this.getClient();\n    await client.del(this.key(jobId));\n  }\n}\n"]}

package/package.json

@@ -0,0 +1,71 @@
+{
+  "name": "@orka-js/durable",
+  "version": "1.0.0",
+  "description": "Durable, resumable, and scheduled agents for OrkaJS",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "sideEffects": false,
+  "keywords": [
+    "orkajs",
+    "orka",
+    "durable",
+    "agent",
+    "persistent",
+    "scheduler",
+    "llm",
+    "ai"
+  ],
+  "author": "OrkaJS Team",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/orka-js/orkajs.git",
+    "directory": "packages/durable"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "dependencies": {
+    "@orka-js/core": "1.5.0",
+    "@orka-js/agent": "1.5.2"
+  },
+  "devDependencies": {
+    "@types/node-cron": "^3.0.11",
+    "tsup": "^8.0.1",
+    "typescript": "^5.3.3",
+    "vitest": "^1.6.0"
+  },
+  "peerDependencies": {
+    "node-cron": "^3.0.0",
+    "redis": "^4.6.0"
+  },
+  "peerDependenciesMeta": {
+    "redis": {
+      "optional": true
+    },
+    "node-cron": {
+      "optional": true
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run"
+  }
+}