@mastra/cloudflare 1.7.5 → 1.7.6-alpha.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -94,6 +94,10 @@ The storage implementation handles schema creation and updates automatically. It
94
94
 
95
95
  Cloudflare KV is an eventually consistent store, meaning that data may not be immediately available across all regions after a write.
96
96
 
97
+ > **Resuming runs across Workers:** A write to KV can take up to about 60 seconds to reach other locations. If one Worker suspends a workflow or [durable agent](https://mastra.ai/docs/harness/durable-agents) run and a different Worker resumes it soon after, for example when a user approves a tool call quickly, the resume can read an older snapshot. It then fails with `AGENT_RESUME_NO_SNAPSHOT_FOUND` or `WORKFLOW_RUN_NOT_SUSPENDED`, or resumes from an earlier step.
98
+ >
99
+ > If runs can be resumed by a different Worker or process than the one that suspended them, use [Cloudflare Durable Objects storage](#cloudflare-durable-objects-storage) instead.
100
+
97
101
  ### Key Structure & Namespacing
98
102
 
99
103
  Keys in Cloudflare KV are structured as a combination of a configurable prefix and a table-specific format (e.g., `threads:threadId`). For Workers deployments, `keyPrefix` is used to isolate data within a namespace; for REST API deployments, `namespacePrefix` is used to isolate entire namespaces between environments or applications.
package/dist/index.cjs CHANGED
@@ -1,6 +1,6 @@
1
1
  Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
2
- const require_kv = require("./kv-kikiC8PI.cjs");
3
- const require_do = require("./do-Cl2WWMnv.cjs");
2
+ const require_kv = require("./kv-sSeIiUri.cjs");
3
+ const require_do = require("./do-DLpNbVvV.cjs");
4
4
  exports.CloudflareDOStorage = require_do.CloudflareDOStorage;
5
5
  exports.CloudflareKVStorage = require_kv.CloudflareKVStorage;
6
6
  exports.CloudflareStore = require_kv.CloudflareStore;
package/dist/index.js CHANGED
@@ -1,3 +1,3 @@
1
- import { a as MemoryStorageCloudflare, i as ScoresStorageCloudflare, n as CloudflareStore, r as WorkflowsStorageCloudflare, t as CloudflareKVStorage } from "./kv-OtUwwOU4.js";
2
- import { a as MemoryStorageDO, i as ScoresStorageDO, n as DOStore, r as WorkflowsStorageDO, s as DODB, t as CloudflareDOStorage } from "./do-BX1nAsXg.js";
1
+ import { a as MemoryStorageCloudflare, i as ScoresStorageCloudflare, n as CloudflareStore, r as WorkflowsStorageCloudflare, t as CloudflareKVStorage } from "./kv-BWTdU3Nl.js";
2
+ import { a as MemoryStorageDO, i as ScoresStorageDO, n as DOStore, r as WorkflowsStorageDO, s as DODB, t as CloudflareDOStorage } from "./do-BWVFzDmS.js";
3
3
  export { CloudflareDOStorage, CloudflareKVStorage, CloudflareStore, DODB, DOStore, MemoryStorageCloudflare, MemoryStorageDO, ScoresStorageCloudflare, ScoresStorageDO, WorkflowsStorageCloudflare, WorkflowsStorageDO };
package/dist/kv/index.cjs CHANGED
@@ -1,5 +1,5 @@
1
1
  Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
2
- const require_kv = require("../kv-kikiC8PI.cjs");
2
+ const require_kv = require("../kv-sSeIiUri.cjs");
3
3
  exports.CloudflareKVStorage = require_kv.CloudflareKVStorage;
4
4
  exports.CloudflareStore = require_kv.CloudflareStore;
5
5
  exports.MemoryStorageCloudflare = require_kv.MemoryStorageCloudflare;
package/dist/kv/index.js CHANGED
@@ -1 +1 @@
1
- export { t as CloudflareKVStorage, n as CloudflareStore, a as MemoryStorageCloudflare, i as ScoresStorageCloudflare, r as WorkflowsStorageCloudflare } from "../kv-OtUwwOU4.js";
1
+ export { t as CloudflareKVStorage, n as CloudflareStore, a as MemoryStorageCloudflare, i as ScoresStorageCloudflare, r as WorkflowsStorageCloudflare } from "../kv-BWTdU3Nl.js";
@@ -4,7 +4,7 @@ import Cloudflare from "cloudflare";
4
4
  import { MessageList } from "@mastra/core/agent";
5
5
  import { MastraBase } from "@mastra/core/base";
6
6
  import { saveScorePayloadSchema } from "@mastra/core/evals";
7
- //#region src/kv/storage/db/index.ts
7
+ // src/kv/storage/db/index.ts
8
8
  /**
9
9
  * Resolves CloudflareDomainConfig to CloudflareKVDBConfig.
10
10
  * Handles creating a new Cloudflare client if apiToken is provided.
@@ -483,8 +483,7 @@ var CloudflareKVDB = class extends MastraBase {
483
483
  }
484
484
  }
485
485
  };
486
- //#endregion
487
- //#region src/kv/storage/domains/memory/index.ts
486
+ // src/kv/storage/domains/memory/index.ts
488
487
  var MemoryStorageCloudflare = class extends MemoryStorage {
489
488
  supportsPartialThreadUpdate = true;
490
489
  #db;
@@ -1400,8 +1399,7 @@ var MemoryStorageCloudflare = class extends MemoryStorage {
1400
1399
  }
1401
1400
  }
1402
1401
  };
1403
- //#endregion
1404
- //#region src/kv/storage/domains/scores/index.ts
1402
+ // src/kv/storage/domains/scores/index.ts
1405
1403
  /**
1406
1404
  * Cloudflare KV-specific score row transformation.
1407
1405
  * Uses default options (no timestamp conversion).
@@ -1687,8 +1685,7 @@ var ScoresStorageCloudflare = class extends ScoresStorage {
1687
1685
  }
1688
1686
  }
1689
1687
  };
1690
- //#endregion
1691
- //#region src/kv/storage/domains/workflows/index.ts
1688
+ // src/kv/storage/domains/workflows/index.ts
1692
1689
  var WorkflowsStorageCloudflare = class extends WorkflowsStorage {
1693
1690
  #db;
1694
1691
  constructor(config) {
@@ -1923,16 +1920,14 @@ var WorkflowsStorageCloudflare = class extends WorkflowsStorage {
1923
1920
  }
1924
1921
  }
1925
1922
  };
1926
- //#endregion
1927
- //#region src/kv/storage/types.ts
1923
+ // src/kv/storage/types.ts
1928
1924
  /**
1929
1925
  * Helper to determine if a config is using Workers bindings
1930
1926
  */
1931
1927
  function isWorkersConfig(config) {
1932
1928
  return "bindings" in config;
1933
1929
  }
1934
- //#endregion
1935
- //#region src/kv/index.ts
1930
+ // src/kv/index.ts
1936
1931
  /**
1937
1932
  * Cloudflare KV storage adapter for Mastra.
1938
1933
  *
@@ -2029,7 +2024,6 @@ var CloudflareKVStorage = class extends MastraCompositeStore {
2029
2024
  * @deprecated Use CloudflareKVStorage instead
2030
2025
  */
2031
2026
  const CloudflareStore = CloudflareKVStorage;
2032
- //#endregion
2033
2027
  export { MemoryStorageCloudflare as a, ScoresStorageCloudflare as i, CloudflareStore as n, WorkflowsStorageCloudflare as r, CloudflareKVStorage as t };
2034
2028
 
2035
- //# sourceMappingURL=kv-OtUwwOU4.js.map
2029
+ //# sourceMappingURL=kv-BWTdU3Nl.js.map