agents 0.22.0 → 0.23.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.
Files changed (186) hide show
  1. package/README.md +20 -1
  2. package/dist/{agent-routing-CnkaHb-v.d.ts → agent-routing-DE5zmCQ8.d.ts} +1038 -394
  3. package/dist/agent-routing.d.ts +1 -1
  4. package/dist/agent-tool-types.d.ts +26 -26
  5. package/dist/{agent-tools-C0XJqWzB.d.ts → agent-tools-DtXMTDGM.d.ts} +7 -7
  6. package/dist/agent-tools.d.ts +21 -21
  7. package/dist/browser/ai.js +4 -1
  8. package/dist/browser/ai.js.map +1 -1
  9. package/dist/browser/tanstack-ai.js.map +1 -1
  10. package/dist/callable-decorator-DP__HhBA.d.ts +72 -0
  11. package/dist/callable-decorator.d.ts +18 -0
  12. package/dist/callable-decorator.js +71 -0
  13. package/dist/callable-decorator.js.map +1 -0
  14. package/dist/capability-BjSKYpzg.js.map +1 -1
  15. package/dist/capability-runner-Be_-PLR1.d.ts +459 -0
  16. package/dist/channel-Bnm4S7T2.d.ts +491 -0
  17. package/dist/channels/ai-sdk.d.ts +46 -0
  18. package/dist/channels/ai-sdk.js +120 -0
  19. package/dist/channels/ai-sdk.js.map +1 -0
  20. package/dist/channels/email.d.ts +95 -0
  21. package/dist/channels/email.js +323 -0
  22. package/dist/channels/email.js.map +1 -0
  23. package/dist/channels/index.d.ts +233 -0
  24. package/dist/channels/index.js +608 -0
  25. package/dist/channels/index.js.map +1 -0
  26. package/dist/channels/slack.d.ts +140 -0
  27. package/dist/channels/slack.js +614 -0
  28. package/dist/channels/slack.js.map +1 -0
  29. package/dist/channels/tanstack-ai.d.ts +39 -0
  30. package/dist/channels/tanstack-ai.js +17 -0
  31. package/dist/channels/tanstack-ai.js.map +1 -0
  32. package/dist/channels/telegram.d.ts +106 -0
  33. package/dist/channels/telegram.js +427 -0
  34. package/dist/channels/telegram.js.map +1 -0
  35. package/dist/channels/voice.d.ts +45 -0
  36. package/dist/channels/voice.js +122 -0
  37. package/dist/channels/voice.js.map +1 -0
  38. package/dist/chat/index.d.ts +2325 -2019
  39. package/dist/chat/index.js +888 -518
  40. package/dist/chat/index.js.map +1 -1
  41. package/dist/chat-sdk/index.d.ts +7 -7
  42. package/dist/chat-sdk/index.js +1 -1
  43. package/dist/client.d.ts +1 -1
  44. package/dist/context/index.d.ts +216 -0
  45. package/dist/context/index.js +454 -0
  46. package/dist/context/index.js.map +1 -0
  47. package/dist/{current-agent-CuMErtly.d.ts → current-agent-Da_C9a3b.d.ts} +90 -107
  48. package/dist/current-agent-DhoDkSnH.js.map +1 -1
  49. package/dist/{diagnostics-CaBjfz4J.js → diagnostics-BzvaX2UT.js} +5 -1
  50. package/dist/diagnostics-BzvaX2UT.js.map +1 -0
  51. package/dist/diagnostics-C4jcz3VK.js +360 -0
  52. package/dist/diagnostics-C4jcz3VK.js.map +1 -0
  53. package/dist/index-BB0kqhIz.d.ts +101 -0
  54. package/dist/index-BVVgDSdq.d.ts +1 -0
  55. package/dist/index-XDkuQ7zm.d.ts +89 -0
  56. package/dist/{index-DcSAZKsB.d.ts → index-YSKgfgg9.d.ts} +3 -1
  57. package/dist/index.d.ts +91 -82
  58. package/dist/index.js +3 -2
  59. package/dist/ingress-BfetZbMO.js +83 -0
  60. package/dist/ingress-BfetZbMO.js.map +1 -0
  61. package/dist/internal-CYlgHl1l.js +59 -0
  62. package/dist/internal-CYlgHl1l.js.map +1 -0
  63. package/dist/internal_context.d.ts +1 -1
  64. package/dist/lifecycle/index.d.ts +35 -17
  65. package/dist/lifecycle/index.js +1 -1
  66. package/dist/lifecycle-CMRGjZdw.js +1299 -0
  67. package/dist/lifecycle-CMRGjZdw.js.map +1 -0
  68. package/dist/mcp/client/index.d.ts +20 -20
  69. package/dist/mcp/index.d.ts +35 -35
  70. package/dist/mcp/index.js +1 -1
  71. package/dist/observability/index.d.ts +1 -1
  72. package/dist/observability/index.js +1 -1
  73. package/dist/react.d.ts +4 -4
  74. package/dist/{retries-CAvxtG9d.d.ts → retries-D9Ds-1lz.d.ts} +17 -6
  75. package/dist/retries.d.ts +8 -6
  76. package/dist/retries.js +13 -1
  77. package/dist/retries.js.map +1 -1
  78. package/dist/routing/index.d.ts +137 -0
  79. package/dist/routing/index.js +244 -0
  80. package/dist/routing/index.js.map +1 -0
  81. package/dist/sanitize-D9TujEK8.js +79 -0
  82. package/dist/sanitize-D9TujEK8.js.map +1 -0
  83. package/dist/scheduler-DD9NdYbF.js +665 -0
  84. package/dist/scheduler-DD9NdYbF.js.map +1 -0
  85. package/dist/{scheduler-DQoTGoAW.d.ts → scheduler-Dwh85ZGl.d.ts} +21 -22
  86. package/dist/schedules/index.d.ts +1 -1
  87. package/dist/schedules/index.js +1 -1
  88. package/dist/sentence-chunker-BAidJ4DA.d.ts +68 -0
  89. package/dist/serializable.d.ts +1 -1
  90. package/dist/sessions/index.d.ts +441 -0
  91. package/dist/sessions/index.js +2063 -0
  92. package/dist/sessions/index.js.map +1 -0
  93. package/dist/skills/index.d.ts +99 -0
  94. package/dist/skills/index.js +254 -5
  95. package/dist/skills/index.js.map +1 -1
  96. package/dist/{src-5W6JNKVb.js → src-DlSHshb2.js} +1460 -1110
  97. package/dist/src-DlSHshb2.js.map +1 -0
  98. package/dist/streams/index.d.ts +120 -0
  99. package/dist/streams/index.js +107 -0
  100. package/dist/streams/index.js.map +1 -0
  101. package/dist/streams-D6tJ0NN9.d.ts +370 -0
  102. package/dist/streams-DZKgAj9b.js +709 -0
  103. package/dist/streams-DZKgAj9b.js.map +1 -0
  104. package/dist/sub-routing.d.ts +12 -12
  105. package/dist/surface-bZZJqBka.js +17 -0
  106. package/dist/surface-bZZJqBka.js.map +1 -0
  107. package/dist/tasks/index.d.ts +64 -0
  108. package/dist/tasks/index.js +2 -0
  109. package/dist/tasks-BRJ5zgya.d.ts +517 -0
  110. package/dist/tasks-ylZgBjhj.js +1656 -0
  111. package/dist/tasks-ylZgBjhj.js.map +1 -0
  112. package/dist/text-segment-joiner-BtAFQSA_.js +57 -0
  113. package/dist/text-segment-joiner-BtAFQSA_.js.map +1 -0
  114. package/dist/text-stream-CpdiKrJB.js +272 -0
  115. package/dist/text-stream-CpdiKrJB.js.map +1 -0
  116. package/dist/tokens-nHAKcN6M.js +52 -0
  117. package/dist/tokens-nHAKcN6M.js.map +1 -0
  118. package/dist/tool-schema-CBjGPrsQ.js +31 -0
  119. package/dist/tool-schema-CBjGPrsQ.js.map +1 -0
  120. package/dist/types-B7LojTe4.d.ts +202 -0
  121. package/dist/types-_Faxb570.d.ts +439 -0
  122. package/dist/voice/client.d.ts +226 -0
  123. package/dist/voice/client.js +932 -0
  124. package/dist/voice/client.js.map +1 -0
  125. package/dist/voice/errors.d.ts +43 -0
  126. package/dist/voice/errors.js +41 -0
  127. package/dist/voice/errors.js.map +1 -0
  128. package/dist/voice/index.d.ts +271 -0
  129. package/dist/voice/index.js +1812 -0
  130. package/dist/voice/index.js.map +1 -0
  131. package/dist/voice/react.d.ts +167 -0
  132. package/dist/voice/react.js +234 -0
  133. package/dist/voice/react.js.map +1 -0
  134. package/dist/voice/sfu.d.ts +71 -0
  135. package/dist/voice/sfu.js +157 -0
  136. package/dist/voice/sfu.js.map +1 -0
  137. package/dist/voice/text.d.ts +6 -0
  138. package/dist/voice/text.js +2 -0
  139. package/dist/voice/types.d.ts +58 -0
  140. package/dist/voice/types.js +18 -0
  141. package/dist/voice/types.js.map +1 -0
  142. package/dist/voice/workers-ai.d.ts +136 -0
  143. package/dist/voice/workers-ai.js +568 -0
  144. package/dist/voice/workers-ai.js.map +1 -0
  145. package/dist/websockets/index.d.ts +192 -0
  146. package/dist/websockets/index.js +2 -0
  147. package/dist/websockets-DUfRHPRq.js +502 -0
  148. package/dist/websockets-DUfRHPRq.js.map +1 -0
  149. package/dist/workflow-types.d.ts +25 -25
  150. package/dist/workflows.d.ts +21 -21
  151. package/dist/workflows.js +1 -1
  152. package/docs/agent-class.md +2 -2
  153. package/docs/agent-tools.md +2 -1
  154. package/docs/channels.md +323 -0
  155. package/docs/chat-agents.md +6 -13
  156. package/docs/context.md +131 -0
  157. package/docs/index.md +15 -12
  158. package/docs/lifecycle.md +102 -55
  159. package/docs/long-running-agents.md +2 -2
  160. package/docs/mcp-servers.md +5 -1
  161. package/docs/resumable-streaming.md +1 -1
  162. package/docs/routing.md +105 -0
  163. package/docs/sessions.md +237 -871
  164. package/docs/streams.md +213 -0
  165. package/docs/sub-agents.md +184 -124
  166. package/docs/tasks.md +246 -0
  167. package/docs/voice.md +745 -0
  168. package/package.json +115 -13
  169. package/dist/capability-runner-CvHGZqUu.d.ts +0 -150
  170. package/dist/compaction-helpers-iiKMr2TQ.js +0 -340
  171. package/dist/compaction-helpers-iiKMr2TQ.js.map +0 -1
  172. package/dist/compaction-helpers-wUz6M3us.d.ts +0 -621
  173. package/dist/diagnostics-CaBjfz4J.js.map +0 -1
  174. package/dist/durable-object-lifecycle-D6nNQJJd.js +0 -862
  175. package/dist/durable-object-lifecycle-D6nNQJJd.js.map +0 -1
  176. package/dist/experimental/memory/session/index.d.ts +0 -671
  177. package/dist/experimental/memory/session/index.js +0 -2379
  178. package/dist/experimental/memory/session/index.js.map +0 -1
  179. package/dist/experimental/memory/utils/index.d.ts +0 -96
  180. package/dist/experimental/memory/utils/index.js +0 -79
  181. package/dist/experimental/memory/utils/index.js.map +0 -1
  182. package/dist/scheduler-CR9RHGos.js +0 -857
  183. package/dist/scheduler-CR9RHGos.js.map +0 -1
  184. package/dist/src-5W6JNKVb.js.map +0 -1
  185. package/dist/tool-output-truncation-CNnnGZQ3.js +0 -98
  186. package/dist/tool-output-truncation-CNnnGZQ3.js.map +0 -1
@@ -0,0 +1,454 @@
1
+ import { r as estimateStringTokens } from "../tokens-nHAKcN6M.js";
2
+ import { z } from "zod";
3
+ //#region src/context/search.ts
4
+ /**
5
+ * Check if a provider is a SearchProvider (has a `search` method).
6
+ */
7
+ function isSearchProvider(provider) {
8
+ return typeof provider === "object" && provider !== null && "search" in provider && typeof provider.search === "function";
9
+ }
10
+ /**
11
+ * SearchProvider backed by Durable Object SQLite with FTS5.
12
+ *
13
+ * - `get()` returns a count of indexed entries
14
+ * - `search(query)` full-text search using FTS5
15
+ * - `set(key, content)` indexes or replaces content under a key
16
+ *
17
+ * Entries live in one namespaced FTS5 table, separate from the session
18
+ * message index.
19
+ *
20
+ * @example
21
+ * ```ts
22
+ * const context = new ContextBlocks([
23
+ * { label: "knowledge", provider: new AgentSearchProvider(this) }
24
+ * ]);
25
+ * ```
26
+ */
27
+ var AgentSearchProvider = class {
28
+ constructor(agent) {
29
+ this.label = "";
30
+ this.initialized = false;
31
+ this.agent = agent;
32
+ }
33
+ init(label) {
34
+ this.label = label;
35
+ }
36
+ ensureTable() {
37
+ if (this.initialized) return;
38
+ this.agent.sql`
39
+ CREATE VIRTUAL TABLE IF NOT EXISTS cf_agents_search_fts
40
+ USING fts5(
41
+ label UNINDEXED,
42
+ key UNINDEXED,
43
+ content,
44
+ tokenize='porter unicode61'
45
+ )
46
+ `;
47
+ this.agent.sql`DROP TABLE IF EXISTS cf_agents_search_entries`;
48
+ this.initialized = true;
49
+ }
50
+ async get() {
51
+ this.ensureTable();
52
+ const count = this.agent.sql`
53
+ SELECT COUNT(*) as count FROM cf_agents_search_fts
54
+ WHERE label = ${this.label}
55
+ `[0]?.count ?? 0;
56
+ if (count === 0) return null;
57
+ return `${count} entries indexed.`;
58
+ }
59
+ async search(query) {
60
+ this.ensureTable();
61
+ const sanitized = query.split(/\s+/).filter(Boolean).map((w) => `"${w.replace(/"/g, "\"\"")}"`).join(" ");
62
+ if (!sanitized) return null;
63
+ try {
64
+ const rows = this.agent.sql`
65
+ SELECT f.key, f.content
66
+ FROM cf_agents_search_fts f
67
+ WHERE cf_agents_search_fts MATCH ${sanitized}
68
+ AND f.label = ${this.label}
69
+ ORDER BY rank
70
+ LIMIT 10
71
+ `;
72
+ if (rows.length === 0) return null;
73
+ return rows.map((r) => `[${r.key}]\n${r.content}`).join("\n\n");
74
+ } catch {
75
+ return null;
76
+ }
77
+ }
78
+ async set(key, content) {
79
+ this.ensureTable();
80
+ this.agent.sql`
81
+ DELETE FROM cf_agents_search_fts
82
+ WHERE label = ${this.label} AND key = ${key}
83
+ `;
84
+ this.agent.sql`
85
+ INSERT INTO cf_agents_search_fts (label, key, content)
86
+ VALUES (${this.label}, ${key}, ${content})
87
+ `;
88
+ }
89
+ };
90
+ //#endregion
91
+ //#region src/context/blocks.ts
92
+ function slugify(text) {
93
+ return text.slice(0, 60).toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-|-$/g, "");
94
+ }
95
+ function stableHash(text) {
96
+ let hash = 2166136261;
97
+ for (let i = 0; i < text.length; i++) {
98
+ hash ^= text.charCodeAt(i);
99
+ hash = Math.imul(hash, 16777619);
100
+ }
101
+ return (hash >>> 0).toString(36);
102
+ }
103
+ function contextEntryKey(metadataTitle, content) {
104
+ if (metadataTitle?.trim()) return slugify(metadataTitle) || `entry-${stableHash(metadataTitle)}`;
105
+ return `${slugify(content) || "entry"}-${stableHash(content)}`;
106
+ }
107
+ /**
108
+ * Check if a provider is writable (has a `set` method).
109
+ */
110
+ function isWritableProvider(provider) {
111
+ return typeof provider === "object" && provider !== null && "set" in provider && typeof provider.set === "function";
112
+ }
113
+ /**
114
+ * Manages context blocks with frozen snapshot support.
115
+ */
116
+ var ContextBlocks = class {
117
+ /**
118
+ * @param configs Blocks to load on first use.
119
+ * @param promptStore Persists the frozen system prompt, keeping the
120
+ * provider's prefix cache warm across wakes.
121
+ * @param defaultProvider Supplies storage for blocks declared without a
122
+ * provider, so a host can offer durable writable blocks by label alone.
123
+ */
124
+ constructor(configs, promptStore, defaultProvider) {
125
+ this.blocks = /* @__PURE__ */ new Map();
126
+ this.snapshot = null;
127
+ this.loaded = false;
128
+ this.configs = configs;
129
+ this.promptStore = promptStore ?? null;
130
+ this.defaultProvider = defaultProvider ?? null;
131
+ }
132
+ /** Fill in the host's storage for a block declared without a provider. */
133
+ withDefaultProvider(config) {
134
+ if (config.provider || !this.defaultProvider) return config;
135
+ return {
136
+ ...config,
137
+ provider: this.defaultProvider(config.label)
138
+ };
139
+ }
140
+ /**
141
+ * Load all blocks from their providers. Hosts call this once at startup;
142
+ * every other entry point loads lazily.
143
+ */
144
+ async load() {
145
+ this.configs = this.configs.map((config) => this.withDefaultProvider(config));
146
+ for (const config of this.configs) this.blocks.set(config.label, await this.loadBlock(config));
147
+ this.loaded = true;
148
+ }
149
+ /** Initialize a block's provider and read its current content. */
150
+ async loadBlock(config) {
151
+ const provider = config.provider;
152
+ provider?.init?.(config.label);
153
+ const content = provider ? await provider.get() ?? "" : "";
154
+ const searchable = isSearchProvider(provider);
155
+ return {
156
+ label: config.label,
157
+ description: config.description,
158
+ content,
159
+ tokens: estimateStringTokens(content),
160
+ maxTokens: config.maxTokens,
161
+ writable: isWritableProvider(provider) || searchable && !!provider?.set,
162
+ isSearchable: searchable
163
+ };
164
+ }
165
+ /**
166
+ * Dynamically register a new context block after initialization.
167
+ * Used by extensions to contribute context at runtime.
168
+ *
169
+ * If blocks have already been loaded, the new block's provider is
170
+ * initialized and loaded immediately. The snapshot is NOT updated
171
+ * automatically — call `refreshSystemPrompt()` to rebuild.
172
+ */
173
+ async addBlock(input) {
174
+ if (!this.loaded) await this.load();
175
+ if (this.configs.some((c) => c.label === input.label)) throw new Error(`Block "${input.label}" already exists`);
176
+ const config = this.withDefaultProvider(input);
177
+ this.configs.push(config);
178
+ const block = await this.loadBlock(config);
179
+ this.blocks.set(config.label, block);
180
+ return block;
181
+ }
182
+ /**
183
+ * Remove a dynamically registered context block.
184
+ * Used during extension unload cleanup.
185
+ *
186
+ * Returns true if the block existed and was removed.
187
+ * The snapshot is NOT updated automatically — call
188
+ * `refreshSystemPrompt()` to rebuild.
189
+ */
190
+ removeBlock(label) {
191
+ const idx = this.configs.findIndex((c) => c.label === label);
192
+ if (idx === -1) return false;
193
+ this.configs.splice(idx, 1);
194
+ this.blocks.delete(label);
195
+ return true;
196
+ }
197
+ /**
198
+ * Get a block by label.
199
+ */
200
+ getBlock(label) {
201
+ return this.blocks.get(label) ?? null;
202
+ }
203
+ /**
204
+ * Get all blocks.
205
+ */
206
+ getBlocks() {
207
+ return Array.from(this.blocks.values());
208
+ }
209
+ /**
210
+ * Set block content. Writes to provider immediately.
211
+ * Does NOT update the frozen snapshot.
212
+ */
213
+ async setBlock(label, content) {
214
+ if (!this.loaded) await this.load();
215
+ const config = this.configs.find((c) => c.label === label);
216
+ const existing = this.blocks.get(label);
217
+ if (!existing?.writable) throw new Error(`Block "${label}" is readonly`);
218
+ if (existing.isSearchable) throw new Error(`Block "${label}" is a keyed provider. Use setSearchEntry() instead.`);
219
+ const tokens = estimateStringTokens(content);
220
+ const maxTokens = config?.maxTokens ?? existing?.maxTokens;
221
+ if (maxTokens !== void 0 && tokens > maxTokens) throw new Error(`Block "${label}" exceeds maxTokens: ${tokens} > ${maxTokens}`);
222
+ const block = {
223
+ label,
224
+ description: config?.description ?? existing?.description,
225
+ content,
226
+ tokens,
227
+ maxTokens,
228
+ writable: true,
229
+ isSearchable: false
230
+ };
231
+ this.blocks.set(label, block);
232
+ if (config?.provider && isWritableProvider(config.provider)) await config.provider.set(content);
233
+ return block;
234
+ }
235
+ /** Index a search entry within a searchable block. */
236
+ async setSearchEntry(label, key, content) {
237
+ if (!this.loaded) await this.load();
238
+ const config = this.configs.find((c) => c.label === label);
239
+ const existing = this.blocks.get(label);
240
+ if (!existing?.isSearchable) throw new Error(`Block "${label}" is not a search provider`);
241
+ const provider = config?.provider;
242
+ if (!provider || !isSearchProvider(provider) || !provider.set) throw new Error(`Block "${label}" does not support writes`);
243
+ await provider.set(key, content);
244
+ existing.content = await provider.get() ?? "";
245
+ existing.tokens = estimateStringTokens(existing.content);
246
+ }
247
+ /** Search a searchable block. */
248
+ async searchContext(label, query) {
249
+ if (!this.loaded) await this.load();
250
+ const config = this.configs.find((c) => c.label === label);
251
+ if (!config?.provider || !isSearchProvider(config.provider)) throw new Error(`Block "${label}" is not a search provider`);
252
+ return config.provider.search(query);
253
+ }
254
+ /**
255
+ * Append content to a block.
256
+ */
257
+ async appendToBlock(label, content) {
258
+ if (!this.loaded) await this.load();
259
+ const existing = this.blocks.get(label);
260
+ if (!existing) throw new Error(`Block "${label}" not found`);
261
+ const needsSep = existing.content.length > 0 && !content.startsWith("\n");
262
+ return this.setBlock(label, existing.content + (needsSep ? "\n" : "") + content);
263
+ }
264
+ renderPrompt() {
265
+ const parts = [];
266
+ const sep = "═".repeat(46);
267
+ for (const block of this.blocks.values()) {
268
+ if (!block.content && !block.writable && !block.isSearchable) continue;
269
+ let header = block.label.toUpperCase();
270
+ if (block.description) header += ` (${block.description})`;
271
+ if (block.maxTokens) {
272
+ const pct = Math.round(block.tokens / block.maxTokens * 100);
273
+ header += ` [${pct}% — ${block.tokens}/${block.maxTokens} tokens]`;
274
+ }
275
+ if (block.isSearchable) header += " [searchable]";
276
+ else if (!block.writable) header += " [readonly]";
277
+ else header += " [writable]";
278
+ parts.push(`${sep}\n${header}\n${sep}\n${block.content}`);
279
+ }
280
+ return parts.join("\n\n");
281
+ }
282
+ /**
283
+ * The frozen system prompt. The first call renders the blocks and stores
284
+ * the result; every later call returns that same string, so the model
285
+ * provider's prefix cache stays warm. Block edits do not change it until
286
+ * `refreshSystemPrompt()` is called.
287
+ */
288
+ async freezeSystemPrompt() {
289
+ if (this.promptStore) {
290
+ const stored = await this.promptStore.get();
291
+ if (stored !== null) return stored;
292
+ }
293
+ if (this.snapshot !== null) return this.snapshot;
294
+ if (!this.loaded) await this.load();
295
+ this.snapshot = this.renderPrompt();
296
+ await this.promptStore?.set(this.snapshot);
297
+ return this.snapshot;
298
+ }
299
+ /**
300
+ * Reload every block from its provider, re-render the system prompt, and
301
+ * persist it. Use this after block content has changed.
302
+ */
303
+ async refreshSystemPrompt() {
304
+ this.loaded = false;
305
+ await this.load();
306
+ this.snapshot = this.renderPrompt();
307
+ await this.promptStore?.set(this.snapshot);
308
+ return this.snapshot;
309
+ }
310
+ /**
311
+ * AI tools for context blocks.
312
+ *
313
+ * Auto-wired based on provider capabilities:
314
+ * - `set_context` — when any block is writable
315
+ * - `search_context` — when any block is a search provider
316
+ */
317
+ async tools() {
318
+ if (!this.loaded) await this.load();
319
+ const blocks = Array.from(this.blocks.values());
320
+ const writable = blocks.filter((b) => b.writable);
321
+ const searchLabels = blocks.filter((b) => b.isSearchable).map((b) => b.label);
322
+ const toolSet = {};
323
+ if (writable.length > 0) {
324
+ const blockDescriptions = writable.map((b) => {
325
+ const kind = b.isSearchable ? "searchable, keyed entries" : "writable";
326
+ return `- "${b.label}" (${kind}): ${b.description ?? "no description"}`;
327
+ });
328
+ const keyedBlocks = writable.filter((b) => b.isSearchable);
329
+ const properties = {
330
+ label: {
331
+ type: "string",
332
+ enum: writable.map((b) => b.label),
333
+ description: "Block label to write to"
334
+ },
335
+ content: {
336
+ type: "string",
337
+ description: "The main content to write to the block."
338
+ },
339
+ action: {
340
+ type: "string",
341
+ enum: ["replace", "append"],
342
+ description: "replace (default) or append"
343
+ }
344
+ };
345
+ if (keyedBlocks.length > 0) properties.metadata = {
346
+ type: "object",
347
+ description: "Optional metadata for keyed entries (searchable blocks: " + keyedBlocks.map((b) => `"${b.label}"`).join(", ") + "). A title keeps updates stable; a description helps the model pick the right entry.",
348
+ properties: {
349
+ title: {
350
+ type: "string",
351
+ description: "Short title. Used as a stable identifier — entries with the same title are updated in place, different titles create new entries."
352
+ },
353
+ description: {
354
+ type: "string",
355
+ description: "One-line summary shown alongside the title in the system prompt so the model can decide when to load the entry."
356
+ }
357
+ }
358
+ };
359
+ const metadataHint = keyedBlocks.length > 0 ? "\n\nFor searchable blocks, pass `metadata: { title, description }` — title stabilises updates, description helps the model pick entries. Metadata is optional." : "";
360
+ toolSet.set_context = {
361
+ description: `Write to a context block. Available blocks:\n${blockDescriptions.join("\n")}\n\nWrites are durable and persist across sessions.${metadataHint}`,
362
+ inputSchema: z.fromJSONSchema({
363
+ type: "object",
364
+ properties,
365
+ required: ["label", "content"]
366
+ }),
367
+ execute: async ({ label, content, metadata, action }) => {
368
+ try {
369
+ const block = this.blocks.get(label);
370
+ if (!block) return `Error: block "${label}" not found`;
371
+ if (block.isSearchable) {
372
+ const key = contextEntryKey(metadata?.title, content);
373
+ await this.setSearchEntry(label, key, content);
374
+ return `Indexed "${key}" in ${label}.`;
375
+ }
376
+ const updated = action === "append" ? await this.appendToBlock(label, content) : await this.setBlock(label, content);
377
+ return `Written to ${label}. Usage: ${updated.maxTokens ? `${Math.round(updated.tokens / updated.maxTokens * 100)}% (${updated.tokens}/${updated.maxTokens} tokens)` : `${updated.tokens} tokens`}`;
378
+ } catch (err) {
379
+ return `Error: ${err instanceof Error ? err.message : String(err)}`;
380
+ }
381
+ }
382
+ };
383
+ }
384
+ if (searchLabels.length > 0) toolSet.search_context = {
385
+ description: "Search for information in a searchable context block. ONLY these blocks are searchable: " + searchLabels.map((l) => `"${l}"`).join(", ") + ". Other blocks cannot be searched.",
386
+ inputSchema: z.fromJSONSchema({
387
+ type: "object",
388
+ properties: {
389
+ label: {
390
+ type: "string",
391
+ enum: searchLabels,
392
+ description: "Searchable block label"
393
+ },
394
+ query: {
395
+ type: "string",
396
+ description: "Search query"
397
+ }
398
+ },
399
+ required: ["label", "query"]
400
+ }),
401
+ execute: async ({ label, query }) => {
402
+ try {
403
+ if (!searchLabels.includes(label)) return `Error: "${label}" is not searchable. Searchable blocks: ${searchLabels.join(", ")}`;
404
+ return await this.searchContext(label, query) ?? "No results found.";
405
+ } catch (err) {
406
+ return `Error: ${err instanceof Error ? err.message : String(err)}`;
407
+ }
408
+ }
409
+ };
410
+ return toolSet;
411
+ }
412
+ };
413
+ //#endregion
414
+ //#region src/context/sqlite-provider.ts
415
+ /** SQLite-backed writable context block provider. */
416
+ var AgentContextProvider = class {
417
+ constructor(agent, label) {
418
+ this.initialized = false;
419
+ this.agent = agent;
420
+ this.label = label ?? "";
421
+ }
422
+ init(label) {
423
+ if (!this.label) this.label = label;
424
+ }
425
+ ensureTable() {
426
+ if (this.initialized) return;
427
+ this.agent.sql`
428
+ CREATE TABLE IF NOT EXISTS cf_agents_context_blocks (
429
+ label TEXT PRIMARY KEY,
430
+ content TEXT NOT NULL,
431
+ updated_at DATETIME DEFAULT CURRENT_TIMESTAMP
432
+ )
433
+ `;
434
+ this.initialized = true;
435
+ }
436
+ async get() {
437
+ this.ensureTable();
438
+ return this.agent.sql`
439
+ SELECT content FROM cf_agents_context_blocks WHERE label = ${this.label}
440
+ `[0]?.content ?? null;
441
+ }
442
+ async set(content) {
443
+ this.ensureTable();
444
+ this.agent.sql`
445
+ INSERT INTO cf_agents_context_blocks (label, content)
446
+ VALUES (${this.label}, ${content})
447
+ ON CONFLICT(label) DO UPDATE SET content = ${content}, updated_at = CURRENT_TIMESTAMP
448
+ `;
449
+ }
450
+ };
451
+ //#endregion
452
+ export { AgentContextProvider, AgentSearchProvider, ContextBlocks };
453
+
454
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","names":[],"sources":["../../src/context/search.ts","../../src/context/blocks.ts","../../src/context/sqlite-provider.ts"],"sourcesContent":["/**\n * Search Provider — full-text searchable context blocks.\n *\n * Extends ContextProvider with `search()` for querying indexed content\n * and a keyed `set()` for indexing individual entries.\n *\n * Duck-typed: if a provider has a `search` method, it's a SearchProvider.\n */\n\nimport type { ContextProvider } from \"./blocks\";\nimport type { SqlProvider } from \"./sqlite-provider\";\n\n/**\n * Storage interface for searchable context.\n *\n * - `get()` returns a summary of indexed content (rendered into system prompt)\n * - `search(query)` full-text search (via search_context tool)\n * - `set(key, content)` indexes content under a key (via set_context tool)\n */\nexport interface SearchProvider extends ContextProvider {\n search(query: string): Promise<string | null>;\n set?(key: string, content: string): Promise<void>;\n}\n\n/**\n * Check if a provider is a SearchProvider (has a `search` method).\n */\nexport function isSearchProvider(\n provider: unknown\n): provider is SearchProvider {\n return (\n typeof provider === \"object\" &&\n provider !== null &&\n \"search\" in provider &&\n typeof (provider as SearchProvider).search === \"function\"\n );\n}\n\n// ── Agent Search Provider (DO SQLite FTS5) ─────────────────────────\n\n/**\n * SearchProvider backed by Durable Object SQLite with FTS5.\n *\n * - `get()` returns a count of indexed entries\n * - `search(query)` full-text search using FTS5\n * - `set(key, content)` indexes or replaces content under a key\n *\n * Entries live in one namespaced FTS5 table, separate from the session\n * message index.\n *\n * @example\n * ```ts\n * const context = new ContextBlocks([\n * { label: \"knowledge\", provider: new AgentSearchProvider(this) }\n * ]);\n * ```\n */\nexport class AgentSearchProvider implements SearchProvider {\n private agent: SqlProvider;\n private label = \"\";\n private initialized = false;\n\n constructor(agent: SqlProvider) {\n this.agent = agent;\n }\n\n init(label: string): void {\n this.label = label;\n }\n\n private ensureTable(): void {\n if (this.initialized) return;\n // The FTS table is the only store: a mirror row table would double the\n // billed writes of every indexed entry to serve a count and a lookup the\n // index already answers.\n this.agent.sql`\n CREATE VIRTUAL TABLE IF NOT EXISTS cf_agents_search_fts\n USING fts5(\n label UNINDEXED,\n key UNINDEXED,\n content,\n tokenize='porter unicode61'\n )\n `;\n this.agent.sql`DROP TABLE IF EXISTS cf_agents_search_entries`;\n this.initialized = true;\n }\n\n async get(): Promise<string | null> {\n this.ensureTable();\n const rows = this.agent.sql<{ count: number }>`\n SELECT COUNT(*) as count FROM cf_agents_search_fts\n WHERE label = ${this.label}\n `;\n const count = rows[0]?.count ?? 0;\n if (count === 0) return null;\n return `${count} entries indexed.`;\n }\n\n async search(query: string): Promise<string | null> {\n this.ensureTable();\n // Quote each word individually to prevent FTS5 syntax injection\n // while preserving implicit AND between terms\n const sanitized = query\n .split(/\\s+/)\n .filter(Boolean)\n .map((w) => `\"${w.replace(/\"/g, '\"\"')}\"`)\n .join(\" \");\n if (!sanitized) return null;\n try {\n const rows = this.agent.sql<{\n key: string;\n content: string;\n }>`\n SELECT f.key, f.content\n FROM cf_agents_search_fts f\n WHERE cf_agents_search_fts MATCH ${sanitized}\n AND f.label = ${this.label}\n ORDER BY rank\n LIMIT 10\n `;\n if (rows.length === 0) return null;\n return rows.map((r) => `[${r.key}]\\n${r.content}`).join(\"\\n\\n\");\n } catch {\n // Malformed FTS query\n return null;\n }\n }\n\n async set(key: string, content: string): Promise<void> {\n this.ensureTable();\n this.agent.sql`\n DELETE FROM cf_agents_search_fts\n WHERE label = ${this.label} AND key = ${key}\n `;\n this.agent.sql`\n INSERT INTO cf_agents_search_fts (label, key, content)\n VALUES (${this.label}, ${key}, ${content})\n `;\n }\n}\n","/**\n * Context Block Management\n *\n * Persistent key-value blocks (MEMORY, USER, SOUL, etc.) that are:\n * - Loaded from their providers at init\n * - Frozen into a snapshot when toSystemPrompt() is called\n * - Updated via setBlock() which writes to the provider immediately\n * but does NOT update the frozen snapshot (preserves LLM prefix cache)\n * - Re-snapshotted on next toSystemPrompt() call\n *\n * Provider type determines behavior:\n * - ContextProvider (get only) → readonly block in system prompt\n * - WritableContextProvider (get+set) → writable via set_context tool\n * - SearchProvider (get+search+set?) → searchable via search_context tool\n */\n\nimport type { ToolSet } from \"ai\";\nimport { z } from \"zod\";\nimport { estimateStringTokens } from \"../sessions/tokens\";\nimport { isSearchProvider, type SearchProvider } from \"./search\";\n\nfunction slugify(text: string): string {\n return text\n .slice(0, 60)\n .toLowerCase()\n .replace(/[^a-z0-9]+/g, \"-\")\n .replace(/^-|-$/g, \"\");\n}\n\nfunction stableHash(text: string): string {\n let hash = 0x811c9dc5;\n for (let i = 0; i < text.length; i++) {\n hash ^= text.charCodeAt(i);\n hash = Math.imul(hash, 0x01000193);\n }\n return (hash >>> 0).toString(36);\n}\n\nfunction contextEntryKey(metadataTitle: string | undefined, content: string) {\n if (metadataTitle?.trim()) {\n const slug = slugify(metadataTitle);\n return slug || `entry-${stableHash(metadataTitle)}`;\n }\n\n const slug = slugify(content) || \"entry\";\n return `${slug}-${stableHash(content)}`;\n}\n\n/**\n * Base storage interface for a context block.\n * A provider with only `get()` is readonly.\n */\nexport interface ContextProvider {\n get(): Promise<string | null>;\n /** Called by the context system to provide the block label before first use. */\n init?(label: string): void;\n}\n\n/**\n * Writable context provider — extends ContextProvider with `set()`.\n * Blocks backed by this provider are writable via the `set_context` tool.\n */\nexport interface WritableContextProvider extends ContextProvider {\n set(content: string): Promise<void>;\n}\n\n/**\n * Check if a provider is writable (has a `set` method).\n */\nexport function isWritableProvider(\n provider: unknown\n): provider is WritableContextProvider {\n return (\n typeof provider === \"object\" &&\n provider !== null &&\n \"set\" in provider &&\n typeof (provider as WritableContextProvider).set === \"function\"\n );\n}\n\n/**\n * Configuration for a context block.\n */\nexport interface ContextConfig {\n /** Block label — used as key and in tool descriptions */\n label: string;\n /** Human-readable description (shown to AI in tool) */\n description?: string;\n /** Maximum tokens allowed. Enforced on set. */\n maxTokens?: number;\n /** Storage provider. Determines block behavior:\n * - ContextProvider (get only) → readonly\n * - WritableContextProvider (get+set) → writable via set_context\n * - SearchProvider (get+search+set?) → searchable via search_context\n * If omitted, auto-wired to writable SQLite when using builder. */\n provider?: ContextProvider | WritableContextProvider | SearchProvider;\n}\n\n/**\n * A loaded context block with computed token count.\n */\nexport interface ContextBlock {\n label: string;\n description?: string;\n content: string;\n tokens: number;\n maxTokens?: number;\n /** True if provider is writable (has set) */\n writable: boolean;\n /** True if backed by a SearchProvider */\n isSearchable: boolean;\n}\n\n/**\n * Manages context blocks with frozen snapshot support.\n */\nexport class ContextBlocks {\n private configs: ContextConfig[];\n private blocks = new Map<string, ContextBlock>();\n private snapshot: string | null = null;\n private loaded = false;\n private promptStore: WritableContextProvider | null;\n private defaultProvider: ((label: string) => ContextProvider) | null;\n\n /**\n * @param configs Blocks to load on first use.\n * @param promptStore Persists the frozen system prompt, keeping the\n * provider's prefix cache warm across wakes.\n * @param defaultProvider Supplies storage for blocks declared without a\n * provider, so a host can offer durable writable blocks by label alone.\n */\n constructor(\n configs: ContextConfig[],\n promptStore?: WritableContextProvider,\n defaultProvider?: (label: string) => ContextProvider\n ) {\n this.configs = configs;\n this.promptStore = promptStore ?? null;\n this.defaultProvider = defaultProvider ?? null;\n }\n\n /** Fill in the host's storage for a block declared without a provider. */\n private withDefaultProvider(config: ContextConfig): ContextConfig {\n if (config.provider || !this.defaultProvider) return config;\n return { ...config, provider: this.defaultProvider(config.label) };\n }\n\n /**\n * Load all blocks from their providers. Hosts call this once at startup;\n * every other entry point loads lazily.\n */\n async load(): Promise<void> {\n this.configs = this.configs.map((config) =>\n this.withDefaultProvider(config)\n );\n for (const config of this.configs) {\n this.blocks.set(config.label, await this.loadBlock(config));\n }\n this.loaded = true;\n }\n\n /** Initialize a block's provider and read its current content. */\n private async loadBlock(config: ContextConfig): Promise<ContextBlock> {\n const provider = config.provider;\n provider?.init?.(config.label);\n const content = provider ? ((await provider.get()) ?? \"\") : \"\";\n const searchable = isSearchProvider(provider);\n return {\n label: config.label,\n description: config.description,\n content,\n tokens: estimateStringTokens(content),\n maxTokens: config.maxTokens,\n writable: isWritableProvider(provider) || (searchable && !!provider?.set),\n isSearchable: searchable\n };\n }\n\n /**\n * Dynamically register a new context block after initialization.\n * Used by extensions to contribute context at runtime.\n *\n * If blocks have already been loaded, the new block's provider is\n * initialized and loaded immediately. The snapshot is NOT updated\n * automatically — call `refreshSystemPrompt()` to rebuild.\n */\n async addBlock(input: ContextConfig): Promise<ContextBlock> {\n if (!this.loaded) await this.load();\n\n if (this.configs.some((c) => c.label === input.label)) {\n throw new Error(`Block \"${input.label}\" already exists`);\n }\n\n const config = this.withDefaultProvider(input);\n this.configs.push(config);\n const block = await this.loadBlock(config);\n this.blocks.set(config.label, block);\n return block;\n }\n\n /**\n * Remove a dynamically registered context block.\n * Used during extension unload cleanup.\n *\n * Returns true if the block existed and was removed.\n * The snapshot is NOT updated automatically — call\n * `refreshSystemPrompt()` to rebuild.\n */\n removeBlock(label: string): boolean {\n const idx = this.configs.findIndex((c) => c.label === label);\n if (idx === -1) return false;\n\n this.configs.splice(idx, 1);\n this.blocks.delete(label);\n return true;\n }\n\n /**\n * Get a block by label.\n */\n getBlock(label: string): ContextBlock | null {\n return this.blocks.get(label) ?? null;\n }\n\n /**\n * Get all blocks.\n */\n getBlocks(): ContextBlock[] {\n return Array.from(this.blocks.values());\n }\n\n /**\n * Set block content. Writes to provider immediately.\n * Does NOT update the frozen snapshot.\n */\n async setBlock(label: string, content: string): Promise<ContextBlock> {\n if (!this.loaded) await this.load();\n const config = this.configs.find((c) => c.label === label);\n const existing = this.blocks.get(label);\n\n if (!existing?.writable) {\n throw new Error(`Block \"${label}\" is readonly`);\n }\n\n if (existing.isSearchable) {\n throw new Error(\n `Block \"${label}\" is a keyed provider. Use setSearchEntry() instead.`\n );\n }\n\n const tokens = estimateStringTokens(content);\n const maxTokens = config?.maxTokens ?? existing?.maxTokens;\n\n if (maxTokens !== undefined && tokens > maxTokens) {\n throw new Error(\n `Block \"${label}\" exceeds maxTokens: ${tokens} > ${maxTokens}`\n );\n }\n\n const block: ContextBlock = {\n label,\n description: config?.description ?? existing?.description,\n content,\n tokens,\n maxTokens,\n writable: true,\n isSearchable: false\n };\n\n this.blocks.set(label, block);\n\n // Write to provider immediately (durable)\n if (config?.provider && isWritableProvider(config.provider)) {\n await config.provider.set(content);\n }\n\n return block;\n }\n\n /** Index a search entry within a searchable block. */\n private async setSearchEntry(\n label: string,\n key: string,\n content: string\n ): Promise<void> {\n if (!this.loaded) await this.load();\n const config = this.configs.find((c) => c.label === label);\n const existing = this.blocks.get(label);\n\n if (!existing?.isSearchable) {\n throw new Error(`Block \"${label}\" is not a search provider`);\n }\n\n const provider = config?.provider;\n if (!provider || !isSearchProvider(provider) || !provider.set) {\n throw new Error(`Block \"${label}\" does not support writes`);\n }\n\n await provider.set(key, content);\n\n // Refresh summary\n const summary = await provider.get();\n existing.content = summary ?? \"\";\n existing.tokens = estimateStringTokens(existing.content);\n }\n\n /** Search a searchable block. */\n private async searchContext(\n label: string,\n query: string\n ): Promise<string | null> {\n if (!this.loaded) await this.load();\n const config = this.configs.find((c) => c.label === label);\n\n if (!config?.provider || !isSearchProvider(config.provider)) {\n throw new Error(`Block \"${label}\" is not a search provider`);\n }\n\n return config.provider.search(query);\n }\n\n /**\n * Append content to a block.\n */\n async appendToBlock(label: string, content: string): Promise<ContextBlock> {\n if (!this.loaded) await this.load();\n const existing = this.blocks.get(label);\n if (!existing) {\n throw new Error(`Block \"${label}\" not found`);\n }\n const needsSep = existing.content.length > 0 && !content.startsWith(\"\\n\");\n return this.setBlock(\n label,\n existing.content + (needsSep ? \"\\n\" : \"\") + content\n );\n }\n\n private renderPrompt(): string {\n const parts: string[] = [];\n const sep = \"═\".repeat(46);\n\n for (const block of this.blocks.values()) {\n // Skip empty readonly blocks — writable and searchable blocks always\n // render so the LLM knows which tools can address them.\n if (!block.content && !block.writable && !block.isSearchable) continue;\n\n let header = block.label.toUpperCase();\n if (block.description) header += ` (${block.description})`;\n if (block.maxTokens) {\n const pct = Math.round((block.tokens / block.maxTokens) * 100);\n header += ` [${pct}% — ${block.tokens}/${block.maxTokens} tokens]`;\n }\n if (block.isSearchable) header += \" [searchable]\";\n else if (!block.writable) header += \" [readonly]\";\n else header += \" [writable]\";\n\n parts.push(`${sep}\\n${header}\\n${sep}\\n${block.content}`);\n }\n\n return parts.join(\"\\n\\n\");\n }\n\n // ── Public API ──────────────────────────────────────────────────\n\n /**\n * The frozen system prompt. The first call renders the blocks and stores\n * the result; every later call returns that same string, so the model\n * provider's prefix cache stays warm. Block edits do not change it until\n * `refreshSystemPrompt()` is called.\n */\n async freezeSystemPrompt(): Promise<string> {\n if (this.promptStore) {\n const stored = await this.promptStore.get();\n if (stored !== null) return stored;\n }\n if (this.snapshot !== null) return this.snapshot;\n\n if (!this.loaded) await this.load();\n this.snapshot = this.renderPrompt();\n await this.promptStore?.set(this.snapshot);\n return this.snapshot;\n }\n\n /**\n * Reload every block from its provider, re-render the system prompt, and\n * persist it. Use this after block content has changed.\n */\n async refreshSystemPrompt(): Promise<string> {\n this.loaded = false;\n await this.load();\n this.snapshot = this.renderPrompt();\n await this.promptStore?.set(this.snapshot);\n return this.snapshot;\n }\n\n /**\n * AI tools for context blocks.\n *\n * Auto-wired based on provider capabilities:\n * - `set_context` — when any block is writable\n * - `search_context` — when any block is a search provider\n */\n async tools(): Promise<ToolSet> {\n if (!this.loaded) await this.load();\n\n const blocks = Array.from(this.blocks.values());\n const writable = blocks.filter((b) => b.writable);\n const searchLabels = blocks\n .filter((b) => b.isSearchable)\n .map((b) => b.label);\n const toolSet: ToolSet = {};\n\n // ── set_context ──────────────────────────────────────────────\n\n if (writable.length > 0) {\n const blockDescriptions = writable.map((b) => {\n const kind = b.isSearchable ? \"searchable, keyed entries\" : \"writable\";\n return `- \"${b.label}\" (${kind}): ${b.description ?? \"no description\"}`;\n });\n const keyedBlocks = writable.filter((b) => b.isSearchable);\n\n const properties: Record<string, unknown> = {\n label: {\n type: \"string\" as const,\n enum: writable.map((b) => b.label),\n description: \"Block label to write to\"\n },\n content: {\n type: \"string\" as const,\n description: \"The main content to write to the block.\"\n },\n action: {\n type: \"string\" as const,\n enum: [\"replace\", \"append\"],\n description: \"replace (default) or append\"\n }\n };\n\n if (keyedBlocks.length > 0) {\n properties.metadata = {\n type: \"object\" as const,\n description:\n \"Optional metadata for keyed entries (searchable blocks: \" +\n keyedBlocks.map((b) => `\"${b.label}\"`).join(\", \") +\n \"). A title keeps updates stable; a description helps the model \" +\n \"pick the right entry.\",\n properties: {\n title: {\n type: \"string\" as const,\n description:\n \"Short title. Used as a stable identifier — entries with the \" +\n \"same title are updated in place, different titles create new entries.\"\n },\n description: {\n type: \"string\" as const,\n description:\n \"One-line summary shown alongside the title in the system prompt \" +\n \"so the model can decide when to load the entry.\"\n }\n }\n };\n }\n\n const metadataHint =\n keyedBlocks.length > 0\n ? \"\\n\\nFor searchable blocks, pass `metadata: { title, description }` \" +\n \"— title stabilises updates, description helps the model pick \" +\n \"entries. Metadata is optional.\"\n : \"\";\n\n toolSet.set_context = {\n description: `Write to a context block. Available blocks:\\n${blockDescriptions.join(\"\\n\")}\\n\\nWrites are durable and persist across sessions.${metadataHint}`,\n inputSchema: z.fromJSONSchema({\n type: \"object\" as const,\n properties: properties as Record<string, Record<string, unknown>>,\n required: [\"label\", \"content\"]\n }),\n execute: async ({\n label,\n content,\n metadata,\n action\n }: {\n label: string;\n content: string;\n metadata?: { title?: string; description?: string };\n action?: string;\n }) => {\n try {\n const block = this.blocks.get(label);\n if (!block) return `Error: block \"${label}\" not found`;\n\n if (block.isSearchable) {\n const key = contextEntryKey(metadata?.title, content);\n await this.setSearchEntry(label, key, content);\n return `Indexed \"${key}\" in ${label}.`;\n }\n\n const updated =\n action === \"append\"\n ? await this.appendToBlock(label, content)\n : await this.setBlock(label, content);\n const usage = updated.maxTokens\n ? `${Math.round((updated.tokens / updated.maxTokens) * 100)}% (${updated.tokens}/${updated.maxTokens} tokens)`\n : `${updated.tokens} tokens`;\n return `Written to ${label}. Usage: ${usage}`;\n } catch (err) {\n return `Error: ${err instanceof Error ? err.message : String(err)}`;\n }\n }\n };\n }\n\n // ── search_context ────────────────────────────────────────────\n\n if (searchLabels.length > 0) {\n toolSet.search_context = {\n description:\n \"Search for information in a searchable context block. \" +\n \"ONLY these blocks are searchable: \" +\n searchLabels.map((l) => `\"${l}\"`).join(\", \") +\n \". Other blocks cannot be searched.\",\n inputSchema: z.fromJSONSchema({\n type: \"object\" as const,\n properties: {\n label: {\n type: \"string\" as const,\n enum: searchLabels,\n description: \"Searchable block label\"\n },\n query: {\n type: \"string\" as const,\n description: \"Search query\"\n }\n },\n required: [\"label\", \"query\"]\n }),\n execute: async ({ label, query }: { label: string; query: string }) => {\n try {\n if (!searchLabels.includes(label)) {\n return `Error: \"${label}\" is not searchable. Searchable blocks: ${searchLabels.join(\", \")}`;\n }\n const results = await this.searchContext(label, query);\n return results ?? \"No results found.\";\n } catch (err) {\n return `Error: ${err instanceof Error ? err.message : String(err)}`;\n }\n }\n };\n }\n\n return toolSet;\n }\n}\n","/**\n * SQLite Context Block Provider\n *\n * Default durable storage for context blocks using DO SQLite.\n * Each block is a row in cf_agents_context_blocks.\n */\n\nimport type { WritableContextProvider } from \"./blocks\";\n\n/** Minimal tagged-template SQL surface used by SQLite context providers. */\nexport interface SqlProvider {\n sql<T = Record<string, string | number | boolean | null>>(\n strings: TemplateStringsArray,\n ...values: (string | number | boolean | null)[]\n ): T[];\n}\n\n/** SQLite-backed writable context block provider. */\nexport class AgentContextProvider implements WritableContextProvider {\n private agent: SqlProvider;\n private label: string;\n private initialized = false;\n\n constructor(agent: SqlProvider, label?: string) {\n this.agent = agent;\n this.label = label ?? \"\";\n }\n\n init(label: string): void {\n if (!this.label) {\n this.label = label;\n }\n }\n\n private ensureTable(): void {\n if (this.initialized) return;\n this.agent.sql`\n CREATE TABLE IF NOT EXISTS cf_agents_context_blocks (\n label TEXT PRIMARY KEY,\n content TEXT NOT NULL,\n updated_at DATETIME DEFAULT CURRENT_TIMESTAMP\n )\n `;\n this.initialized = true;\n }\n\n async get(): Promise<string | null> {\n this.ensureTable();\n const rows = this.agent.sql<{ content: string }>`\n SELECT content FROM cf_agents_context_blocks WHERE label = ${this.label}\n `;\n return rows[0]?.content ?? null;\n }\n\n async set(content: string): Promise<void> {\n this.ensureTable();\n this.agent.sql`\n INSERT INTO cf_agents_context_blocks (label, content)\n VALUES (${this.label}, ${content})\n ON CONFLICT(label) DO UPDATE SET content = ${content}, updated_at = CURRENT_TIMESTAMP\n `;\n }\n}\n"],"mappings":"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"}