@poncho-ai/harness 0.37.2 → 0.38.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.
@@ -10,12 +10,13 @@
10
10
  import { randomUUID } from "node:crypto";
11
11
  import type {
12
12
  Conversation,
13
+ ConversationCreateInit,
13
14
  ConversationSummary,
14
15
  PendingSubagentResult,
15
16
  } from "../state.js";
16
17
  import type { MainMemory } from "../memory.js";
17
18
  import type { TodoItem } from "../todo-tools.js";
18
- import type { Reminder } from "../reminder-store.js";
19
+ import type { Reminder, ReminderCreateInput, ReminderStatus } from "../reminder-store.js";
19
20
  import type { StorageEngine, VfsDirEntry, VfsStat } from "./engine.js";
20
21
  import { type DialectTag, migrations } from "./schema.js";
21
22
 
@@ -244,19 +245,30 @@ export abstract class SqlStorageEngine implements StorageEngine {
244
245
  ownerId?: string,
245
246
  title?: string,
246
247
  tenantId?: string | null,
248
+ init?: ConversationCreateInit,
247
249
  ): Promise<Conversation> => {
248
250
  const id = randomUUID();
249
251
  const now = Date.now();
250
252
  const conv: Conversation = {
251
253
  conversationId: id,
252
254
  title: normalizeTitle(title),
253
- messages: [],
255
+ messages: init?.messages ?? [],
254
256
  ownerId: ownerId ?? DEFAULT_OWNER,
255
257
  tenantId: tenantId === undefined ? null : tenantId,
256
258
  createdAt: now,
257
259
  updatedAt: now,
260
+ ...(init?.parentConversationId !== undefined
261
+ ? { parentConversationId: init.parentConversationId }
262
+ : {}),
263
+ ...(init?.subagentMeta !== undefined
264
+ ? { subagentMeta: init.subagentMeta }
265
+ : {}),
266
+ ...(init?.channelMeta !== undefined
267
+ ? { channelMeta: init.channelMeta }
268
+ : {}),
258
269
  };
259
270
  const data = JSON.stringify(conv);
271
+ const channelMetaJson = conv.channelMeta ? JSON.stringify(conv.channelMeta) : null;
260
272
  await this.executor.run(
261
273
  rewrite(
262
274
  `INSERT INTO conversations (id, agent_id, tenant_id, owner_id, title, data, message_count, created_at, updated_at,
@@ -271,12 +283,12 @@ export abstract class SqlStorageEngine implements StorageEngine {
271
283
  conv.ownerId,
272
284
  conv.title,
273
285
  data,
274
- 0,
286
+ conv.messages.length,
275
287
  new Date(now).toISOString(),
276
288
  new Date(now).toISOString(),
277
- null,
289
+ conv.parentConversationId ?? null,
278
290
  0,
279
- null,
291
+ channelMetaJson,
280
292
  ],
281
293
  );
282
294
  return conv;
@@ -497,21 +509,15 @@ export abstract class SqlStorageEngine implements StorageEngine {
497
509
  return rows.map((r) => this.rowToReminder(r));
498
510
  },
499
511
 
500
- create: async (input: {
501
- task: string;
502
- scheduledAt: number;
503
- timezone?: string;
504
- conversationId: string;
505
- ownerId?: string;
506
- tenantId?: string | null;
507
- }): Promise<Reminder> => {
512
+ create: async (input: ReminderCreateInput): Promise<Reminder> => {
508
513
  const id = randomUUID();
509
514
  const now = Date.now();
510
515
  const tid = normalizeTenant(input.tenantId);
516
+ const recurrenceJson = input.recurrence ? JSON.stringify(input.recurrence) : null;
511
517
  await this.executor.run(
512
518
  rewrite(
513
- `INSERT INTO reminders (id, agent_id, tenant_id, owner_id, conversation_id, task, status, scheduled_at, timezone, created_at)
514
- VALUES ($1, $2, $3, $4, $5, $6, $7, $8, $9, $10)`,
519
+ `INSERT INTO reminders (id, agent_id, tenant_id, owner_id, conversation_id, task, status, scheduled_at, timezone, created_at, recurrence, occurrence_count)
520
+ VALUES ($1, $2, $3, $4, $5, $6, $7, $8, $9, $10, $11, $12)`,
515
521
  this.dialect,
516
522
  ),
517
523
  [
@@ -525,6 +531,8 @@ export abstract class SqlStorageEngine implements StorageEngine {
525
531
  input.scheduledAt,
526
532
  input.timezone ?? null,
527
533
  new Date(now).toISOString(),
534
+ recurrenceJson,
535
+ 0,
528
536
  ],
529
537
  );
530
538
  return {
@@ -537,9 +545,54 @@ export abstract class SqlStorageEngine implements StorageEngine {
537
545
  conversationId: input.conversationId,
538
546
  ownerId: input.ownerId,
539
547
  tenantId: input.tenantId,
548
+ recurrence: input.recurrence ?? null,
549
+ occurrenceCount: 0,
540
550
  };
541
551
  },
542
552
 
553
+ update: async (id: string, fields: { scheduledAt?: number; occurrenceCount?: number; status?: ReminderStatus }): Promise<Reminder> => {
554
+ const setClauses: string[] = [];
555
+ const params: unknown[] = [];
556
+ let idx = 1;
557
+ if (fields.scheduledAt !== undefined) {
558
+ setClauses.push(`scheduled_at = $${idx++}`);
559
+ params.push(fields.scheduledAt);
560
+ }
561
+ if (fields.occurrenceCount !== undefined) {
562
+ setClauses.push(`occurrence_count = $${idx++}`);
563
+ params.push(fields.occurrenceCount);
564
+ }
565
+ if (fields.status !== undefined) {
566
+ setClauses.push(`status = $${idx++}`);
567
+ params.push(fields.status);
568
+ }
569
+ if (setClauses.length === 0) {
570
+ // Nothing to update — just fetch
571
+ const row = await this.executor.get(
572
+ rewrite("SELECT * FROM reminders WHERE id = $1 AND agent_id = $2", this.dialect),
573
+ [id, this.agentId],
574
+ );
575
+ if (!row) throw new Error(`Reminder ${id} not found`);
576
+ return this.rowToReminder(row);
577
+ }
578
+ params.push(id, this.agentId);
579
+ const idIdx = idx++;
580
+ const agentIdx = idx++;
581
+ await this.executor.run(
582
+ rewrite(
583
+ `UPDATE reminders SET ${setClauses.join(", ")} WHERE id = $${idIdx} AND agent_id = $${agentIdx}`,
584
+ this.dialect,
585
+ ),
586
+ params,
587
+ );
588
+ const row = await this.executor.get(
589
+ rewrite("SELECT * FROM reminders WHERE id = $1 AND agent_id = $2", this.dialect),
590
+ [id, this.agentId],
591
+ );
592
+ if (!row) throw new Error(`Reminder ${id} not found`);
593
+ return this.rowToReminder(row);
594
+ },
595
+
543
596
  cancel: async (id: string): Promise<Reminder> => {
544
597
  await this.executor.run(
545
598
  rewrite(
@@ -918,6 +971,16 @@ export abstract class SqlStorageEngine implements StorageEngine {
918
971
 
919
972
  private rowToReminder(row: QueryRow): Reminder {
920
973
  const tid = row.tenant_id as string;
974
+ let recurrence: Reminder["recurrence"] = null;
975
+ if (row.recurrence) {
976
+ try {
977
+ recurrence = typeof row.recurrence === "string"
978
+ ? JSON.parse(row.recurrence)
979
+ : row.recurrence;
980
+ } catch {
981
+ recurrence = null;
982
+ }
983
+ }
921
984
  return {
922
985
  id: row.id as string,
923
986
  task: row.task as string,
@@ -928,6 +991,8 @@ export abstract class SqlStorageEngine implements StorageEngine {
928
991
  conversationId: row.conversation_id as string,
929
992
  ownerId: (row.owner_id as string) ?? undefined,
930
993
  tenantId: tid === DEFAULT_TENANT ? null : tid,
994
+ recurrence,
995
+ occurrenceCount: (row.occurrence_count as number) ?? 0,
931
996
  };
932
997
  }
933
998
 
@@ -6,13 +6,14 @@
6
6
 
7
7
  import type {
8
8
  Conversation,
9
+ ConversationCreateInit,
9
10
  ConversationStore,
10
11
  ConversationSummary,
11
12
  PendingSubagentResult,
12
13
  } from "../state.js";
13
14
  import type { MainMemory, MemoryStore } from "../memory.js";
14
15
  import type { TodoItem, TodoStore } from "../todo-tools.js";
15
- import type { Reminder, ReminderStore } from "../reminder-store.js";
16
+ import type { Reminder, ReminderCreateInput, ReminderStatus, ReminderStore } from "../reminder-store.js";
16
17
  import type { StorageEngine } from "./engine.js";
17
18
 
18
19
  // ---------------------------------------------------------------------------
@@ -35,8 +36,12 @@ export function createConversationStoreFromEngine(
35
36
  engine.conversations.list(ownerId, tenantId),
36
37
  get: (conversationId: string) =>
37
38
  engine.conversations.get(conversationId),
38
- create: (ownerId?: string, title?: string, tenantId?: string | null) =>
39
- engine.conversations.create(ownerId, title, tenantId),
39
+ create: (
40
+ ownerId?: string,
41
+ title?: string,
42
+ tenantId?: string | null,
43
+ init?: ConversationCreateInit,
44
+ ) => engine.conversations.create(ownerId, title, tenantId, init),
40
45
  update: (conversation: Conversation) =>
41
46
  engine.conversations.update(conversation),
42
47
  rename: (conversationId: string, title: string) =>
@@ -86,14 +91,9 @@ export function createReminderStoreFromEngine(
86
91
  ): ReminderStore {
87
92
  return {
88
93
  list: () => engine.reminders.list(),
89
- create: (input: {
90
- task: string;
91
- scheduledAt: number;
92
- timezone?: string;
93
- conversationId: string;
94
- ownerId?: string;
95
- tenantId?: string | null;
96
- }) => engine.reminders.create(input),
94
+ create: (input: ReminderCreateInput) => engine.reminders.create(input),
95
+ update: (id: string, fields: { scheduledAt?: number; occurrenceCount?: number; status?: ReminderStatus }) =>
96
+ engine.reminders.update(id, fields),
97
97
  cancel: (id: string) => engine.reminders.cancel(id),
98
98
  delete: (id: string) => engine.reminders.delete(id),
99
99
  };
@@ -6,6 +6,7 @@ import { Bash } from "just-bash";
6
6
  import type {
7
7
  BashOptions,
8
8
  CommandName,
9
+ IFileSystem,
9
10
  NetworkConfig as JustBashNetworkConfig,
10
11
  } from "just-bash";
11
12
  import type { StorageEngine } from "../storage/engine.js";
@@ -65,6 +66,7 @@ function toBashOptions(
65
66
 
66
67
  export class BashEnvironmentManager {
67
68
  private environments = new Map<string, Bash>();
69
+ private filesystems = new Map<string, IFileSystem>();
68
70
  private readonly workingDir: string | null;
69
71
  private readonly bashOptions: Partial<BashOptions>;
70
72
 
@@ -79,11 +81,21 @@ export class BashEnvironmentManager {
79
81
  this.bashOptions = toBashOptions(bashConfig, network);
80
82
  }
81
83
 
84
+ /** Return the combined IFileSystem (VFS + optional /project mount) for a tenant. */
85
+ getFs(tenantId: string): IFileSystem {
86
+ let fs = this.filesystems.get(tenantId);
87
+ if (!fs) {
88
+ const adapter = new PonchoFsAdapter(this.engine, tenantId, this.limits);
89
+ fs = createBashFs(adapter, this.workingDir);
90
+ this.filesystems.set(tenantId, fs);
91
+ }
92
+ return fs;
93
+ }
94
+
82
95
  getOrCreate(tenantId: string): Bash {
83
96
  let bash = this.environments.get(tenantId);
84
97
  if (!bash) {
85
- const adapter = new PonchoFsAdapter(this.engine, tenantId, this.limits);
86
- const fs = createBashFs(adapter, this.workingDir);
98
+ const fs = this.getFs(tenantId);
87
99
  bash = new Bash({
88
100
  fs,
89
101
  cwd: "/",
@@ -112,9 +124,11 @@ export class BashEnvironmentManager {
112
124
 
113
125
  destroy(tenantId: string): void {
114
126
  this.environments.delete(tenantId);
127
+ this.filesystems.delete(tenantId);
115
128
  }
116
129
 
117
130
  destroyAll(): void {
118
131
  this.environments.clear();
132
+ this.filesystems.clear();
119
133
  }
120
134
  }
@@ -3,10 +3,10 @@
3
3
  // ---------------------------------------------------------------------------
4
4
 
5
5
  import { defineTool, type ToolDefinition } from "@poncho-ai/sdk";
6
- import type { StorageEngine } from "../storage/engine.js";
6
+ import type { IFileSystem } from "just-bash";
7
7
 
8
8
  export const createEditFileTool = (
9
- engine: StorageEngine,
9
+ getFs: (tenantId: string) => IFileSystem,
10
10
  ): ToolDefinition => defineTool({
11
11
  name: "edit_file",
12
12
  description:
@@ -44,12 +44,13 @@ export const createEditFileTool = (
44
44
  if (!oldStr) throw new Error("old_str must not be empty");
45
45
 
46
46
  const tenantId = context.tenantId ?? "__default__";
47
- const stat = await engine.vfs.stat(tenantId, filePath);
48
- if (!stat) throw new Error(`File not found: ${filePath}`);
49
- if (stat.type === "directory") throw new Error(`${filePath} is a directory`);
47
+ const fs = getFs(tenantId);
50
48
 
51
- const buf = await engine.vfs.readFile(tenantId, filePath);
52
- const content = Buffer.from(buf).toString("utf8");
49
+ if (!(await fs.exists(filePath))) throw new Error(`File not found: ${filePath}`);
50
+ const stat = await fs.stat(filePath);
51
+ if (stat.isDirectory) throw new Error(`${filePath} is a directory`);
52
+
53
+ const content = await fs.readFile(filePath);
53
54
 
54
55
  const first = content.indexOf(oldStr);
55
56
  if (first === -1) {
@@ -65,7 +66,7 @@ export const createEditFileTool = (
65
66
  }
66
67
 
67
68
  const updated = content.slice(0, first) + newStr + content.slice(first + oldStr.length);
68
- await engine.vfs.writeFile(tenantId, filePath, new TextEncoder().encode(updated));
69
+ await fs.writeFile(filePath, updated);
69
70
 
70
71
  return { ok: true, path: filePath };
71
72
  },
@@ -1,12 +1,10 @@
1
1
  // ---------------------------------------------------------------------------
2
- // read_file tool – read files from the VFS, returning binary files (images,
3
- // PDFs) as FileContentPart references that the harness resolves lazily at
4
- // model-request time via the vfs:// scheme.
2
+ // read_file tool – read files from the filesystem, returning binary files
3
+ // (images, PDFs) as inline base64 media parts.
5
4
  // ---------------------------------------------------------------------------
6
5
 
7
6
  import { defineTool, type ToolDefinition } from "@poncho-ai/sdk";
8
- import type { StorageEngine } from "../storage/engine.js";
9
- import { VFS_SCHEME } from "../upload-store.js";
7
+ import type { IFileSystem } from "just-bash";
10
8
 
11
9
  const MIME_MAP: Record<string, string> = {
12
10
  ".txt": "text/plain",
@@ -48,7 +46,7 @@ const isTextMime = (mime: string): boolean =>
48
46
  mime === "application/x-sh";
49
47
 
50
48
  export const createReadFileTool = (
51
- engine: StorageEngine,
49
+ getFs: (tenantId: string) => IFileSystem,
52
50
  ): ToolDefinition => defineTool({
53
51
  name: "read_file",
54
52
  description:
@@ -73,29 +71,30 @@ export const createReadFileTool = (
73
71
  }
74
72
 
75
73
  const tenantId = context.tenantId ?? "__default__";
76
- const stat = await engine.vfs.stat(tenantId, filePath);
77
- if (!stat) {
74
+ const fs = getFs(tenantId);
75
+
76
+ if (!(await fs.exists(filePath))) {
78
77
  throw new Error(`File not found: ${filePath}`);
79
78
  }
80
- if (stat.type === "directory") {
79
+ const stat = await fs.stat(filePath);
80
+ if (stat.isDirectory) {
81
81
  throw new Error(`${filePath} is a directory, not a file`);
82
82
  }
83
83
 
84
- const mediaType = stat.mimeType ?? mimeFromPath(filePath) ?? "application/octet-stream";
84
+ const mediaType = mimeFromPath(filePath) ?? "application/octet-stream";
85
85
  const filename = filePath.split("/").pop() ?? filePath;
86
86
 
87
87
  // Text files: read and return inline
88
88
  if (isTextMime(mediaType)) {
89
- const buf = await engine.vfs.readFile(tenantId, filePath);
90
- const text = Buffer.from(buf).toString("utf8");
89
+ const text = await fs.readFile(filePath);
91
90
  return { filename, mediaType, content: text };
92
91
  }
93
92
 
94
- // Images and PDFs: return a vfs:// reference that the harness resolves
95
- // lazily at model-request time — the actual bytes never sit in context.
93
+ // Binary files (images, PDFs): read bytes and return as base64
94
+ const buf = await fs.readFileBuffer(filePath);
96
95
  return {
97
96
  type: "file",
98
- data: `${VFS_SCHEME}${filePath}`,
97
+ data: Buffer.from(buf).toString("base64"),
99
98
  mediaType,
100
99
  filename,
101
100
  };
@@ -1,12 +1,12 @@
1
1
  // ---------------------------------------------------------------------------
2
- // write_file tool – create or overwrite a file in the VFS.
2
+ // write_file tool – create or overwrite a file in the filesystem.
3
3
  // ---------------------------------------------------------------------------
4
4
 
5
5
  import { defineTool, type ToolDefinition } from "@poncho-ai/sdk";
6
- import type { StorageEngine } from "../storage/engine.js";
6
+ import type { IFileSystem } from "just-bash";
7
7
 
8
8
  export const createWriteFileTool = (
9
- engine: StorageEngine,
9
+ getFs: (tenantId: string) => IFileSystem,
10
10
  ): ToolDefinition => defineTool({
11
11
  name: "write_file",
12
12
  description:
@@ -35,14 +35,15 @@ export const createWriteFileTool = (
35
35
  if (!filePath) throw new Error("path is required");
36
36
 
37
37
  const tenantId = context.tenantId ?? "__default__";
38
+ const fs = getFs(tenantId);
38
39
 
39
40
  // Create parent directories
40
41
  const dir = filePath.slice(0, filePath.lastIndexOf("/"));
41
42
  if (dir) {
42
- await engine.vfs.mkdir(tenantId, dir, true);
43
+ await fs.mkdir(dir, { recursive: true });
43
44
  }
44
45
 
45
- await engine.vfs.writeFile(tenantId, filePath, new TextEncoder().encode(content));
46
+ await fs.writeFile(filePath, content);
46
47
 
47
48
  return { ok: true, path: filePath };
48
49
  },
@@ -1,7 +1,8 @@
1
1
  import { describe, expect, it } from "vitest";
2
- import { createReminderStore } from "../src/reminder-store.js";
2
+ import { createReminderStore, computeNextOccurrence } from "../src/reminder-store.js";
3
3
  import { createReminderTools } from "../src/reminder-tools.js";
4
4
  import type { ToolContext } from "@poncho-ai/sdk";
5
+ import type { Reminder, Recurrence } from "../src/reminder-store.js";
5
6
 
6
7
  describe("reminder store", () => {
7
8
  it("creates with memory provider by default", () => {
@@ -66,6 +67,128 @@ describe("reminder store", () => {
66
67
  const store = createReminderStore("agent-noexist", { provider: "memory" });
67
68
  await expect(store.cancel("does-not-exist")).rejects.toThrow("not found");
68
69
  });
70
+
71
+ it("creates a recurring reminder with recurrence config", async () => {
72
+ const store = createReminderStore("agent-recur", { provider: "memory" });
73
+ const reminder = await store.create({
74
+ task: "Daily standup",
75
+ scheduledAt: Date.now() + 60_000,
76
+ conversationId: "conv-5",
77
+ recurrence: { type: "daily", interval: 1 },
78
+ });
79
+ expect(reminder.recurrence).toEqual({ type: "daily", interval: 1 });
80
+ expect(reminder.occurrenceCount).toBe(0);
81
+ });
82
+
83
+ it("updates scheduledAt and occurrenceCount", async () => {
84
+ const store = createReminderStore("agent-update", { provider: "memory" });
85
+ const reminder = await store.create({
86
+ task: "Weekly report",
87
+ scheduledAt: Date.now() + 60_000,
88
+ conversationId: "conv-6",
89
+ recurrence: { type: "weekly" },
90
+ });
91
+ const newTime = Date.now() + 7 * 24 * 60 * 60 * 1000;
92
+ const updated = await store.update(reminder.id, {
93
+ scheduledAt: newTime,
94
+ occurrenceCount: 1,
95
+ });
96
+ expect(updated.scheduledAt).toBe(newTime);
97
+ expect(updated.occurrenceCount).toBe(1);
98
+ expect(updated.status).toBe("pending");
99
+ });
100
+
101
+ it("throws when updating a nonexistent reminder", async () => {
102
+ const store = createReminderStore("agent-update-err", { provider: "memory" });
103
+ await expect(store.update("nope", { scheduledAt: 123 })).rejects.toThrow("not found");
104
+ });
105
+ });
106
+
107
+ describe("computeNextOccurrence", () => {
108
+ const baseReminder = (recurrence: Recurrence, overrides?: Partial<Reminder>): Reminder => ({
109
+ id: "r1",
110
+ task: "test",
111
+ scheduledAt: new Date("2026-04-14T09:00:00Z").getTime(),
112
+ status: "pending",
113
+ createdAt: Date.now(),
114
+ conversationId: "c1",
115
+ recurrence,
116
+ occurrenceCount: 0,
117
+ ...overrides,
118
+ });
119
+
120
+ it("returns null for non-recurring reminder", () => {
121
+ const r = baseReminder(null as unknown as Recurrence, { recurrence: null });
122
+ expect(computeNextOccurrence(r)).toBeNull();
123
+ });
124
+
125
+ it("computes daily recurrence", () => {
126
+ const r = baseReminder({ type: "daily" });
127
+ const next = computeNextOccurrence(r)!;
128
+ expect(next).toBe(r.scheduledAt + 24 * 60 * 60 * 1000);
129
+ });
130
+
131
+ it("computes daily recurrence with interval", () => {
132
+ const r = baseReminder({ type: "daily", interval: 3 });
133
+ const next = computeNextOccurrence(r)!;
134
+ expect(next).toBe(r.scheduledAt + 3 * 24 * 60 * 60 * 1000);
135
+ });
136
+
137
+ it("computes weekly recurrence", () => {
138
+ const r = baseReminder({ type: "weekly" });
139
+ const next = computeNextOccurrence(r)!;
140
+ expect(next).toBe(r.scheduledAt + 7 * 24 * 60 * 60 * 1000);
141
+ });
142
+
143
+ it("computes weekly recurrence with daysOfWeek", () => {
144
+ // 2026-04-14 is a Tuesday (day 2)
145
+ const r = baseReminder({ type: "weekly", daysOfWeek: [2, 4] }); // Tue, Thu
146
+ const next = computeNextOccurrence(r)!;
147
+ // Next match after Tuesday should be Thursday (2 days later)
148
+ expect(next).toBe(r.scheduledAt + 2 * 24 * 60 * 60 * 1000);
149
+ });
150
+
151
+ it("wraps weekly daysOfWeek to next week", () => {
152
+ // 2026-04-14 is a Tuesday (day 2). Only Monday (1) in list → next week.
153
+ const r = baseReminder({ type: "weekly", daysOfWeek: [1] });
154
+ const next = computeNextOccurrence(r)!;
155
+ // Next Monday is 6 days later
156
+ expect(next).toBe(r.scheduledAt + 6 * 24 * 60 * 60 * 1000);
157
+ });
158
+
159
+ it("computes monthly recurrence", () => {
160
+ const r = baseReminder({ type: "monthly" });
161
+ const next = computeNextOccurrence(r)!;
162
+ const nextDate = new Date(next);
163
+ expect(nextDate.getUTCMonth()).toBe(4); // May (0-indexed)
164
+ expect(nextDate.getUTCDate()).toBe(14);
165
+ });
166
+
167
+ it("computes cron recurrence", () => {
168
+ // Every day at 10:00 UTC
169
+ const r = baseReminder({ type: "cron", expression: "0 10 * * *" });
170
+ const next = computeNextOccurrence(r)!;
171
+ const nextDate = new Date(next);
172
+ expect(nextDate.getUTCHours()).toBe(10);
173
+ expect(nextDate.getUTCMinutes()).toBe(0);
174
+ });
175
+
176
+ it("respects maxOccurrences", () => {
177
+ const r = baseReminder({ type: "daily", maxOccurrences: 3 }, { occurrenceCount: 2 });
178
+ expect(computeNextOccurrence(r)).toBeNull();
179
+ });
180
+
181
+ it("respects endsAt", () => {
182
+ const endsAt = new Date("2026-04-14T10:00:00Z").getTime();
183
+ // Daily would go to April 15, which is after endsAt
184
+ const r = baseReminder({ type: "daily", endsAt });
185
+ expect(computeNextOccurrence(r)).toBeNull();
186
+ });
187
+
188
+ it("returns null for cron with no expression", () => {
189
+ const r = baseReminder({ type: "cron" });
190
+ expect(computeNextOccurrence(r)).toBeNull();
191
+ });
69
192
  });
70
193
 
71
194
  describe("reminder tools", () => {
@@ -105,6 +228,44 @@ describe("reminder tools", () => {
105
228
  expect(all).toHaveLength(1);
106
229
  });
107
230
 
231
+ it("set_reminder creates a recurring reminder", async () => {
232
+ const store = createReminderStore("agent-tool-recur", { provider: "memory" });
233
+ const tools = createReminderTools(store);
234
+ const setTool = tools.find((t) => t.name === "set_reminder")!;
235
+ const future = new Date(Date.now() + 3600_000).toISOString();
236
+ const result = (await setTool.handler(
237
+ {
238
+ task: "Daily standup",
239
+ datetime: future,
240
+ recurrence: { type: "daily", interval: 1 },
241
+ },
242
+ makeContext(),
243
+ )) as {
244
+ ok: boolean;
245
+ reminder: { id: string; status: string; recurrence: { type: string }; occurrenceCount: number };
246
+ };
247
+ expect(result.ok).toBe(true);
248
+ expect(result.reminder.recurrence.type).toBe("daily");
249
+ expect(result.reminder.occurrenceCount).toBe(0);
250
+
251
+ const all = await store.list();
252
+ expect(all).toHaveLength(1);
253
+ expect(all[0].recurrence).toEqual({ type: "daily", interval: 1 });
254
+ });
255
+
256
+ it("set_reminder rejects invalid recurrence type", async () => {
257
+ const store = createReminderStore("agent-tool-bad-recur", { provider: "memory" });
258
+ const tools = createReminderTools(store);
259
+ const setTool = tools.find((t) => t.name === "set_reminder")!;
260
+ const future = new Date(Date.now() + 3600_000).toISOString();
261
+ await expect(
262
+ setTool.handler(
263
+ { task: "Bad", datetime: future, recurrence: { type: "hourly" } },
264
+ makeContext(),
265
+ ),
266
+ ).rejects.toThrow("Invalid recurrence type");
267
+ });
268
+
108
269
  it("set_reminder rejects past datetimes", async () => {
109
270
  const store = createReminderStore("agent-tool-past", { provider: "memory" });
110
271
  const tools = createReminderTools(store);
@@ -113,18 +274,24 @@ describe("reminder tools", () => {
113
274
  await expect(setTool.handler({ task: "Too late", datetime: past }, makeContext())).rejects.toThrow("future");
114
275
  });
115
276
 
116
- it("list_reminders returns all reminders", async () => {
277
+ it("list_reminders returns all reminders with recurrence info", async () => {
117
278
  const store = createReminderStore("agent-tool-list", { provider: "memory" });
118
279
  await store.create({ task: "A", scheduledAt: Date.now() + 60_000, conversationId: "c1" });
119
- await store.create({ task: "B", scheduledAt: Date.now() + 120_000, conversationId: "c2" });
280
+ await store.create({
281
+ task: "B",
282
+ scheduledAt: Date.now() + 120_000,
283
+ conversationId: "c2",
284
+ recurrence: { type: "weekly", daysOfWeek: [1, 3, 5] },
285
+ });
120
286
 
121
287
  const tools = createReminderTools(store);
122
288
  const listTool = tools.find((t) => t.name === "list_reminders")!;
123
289
  const result = (await listTool.handler({}, makeContext())) as {
124
- reminders: Array<{ task: string }>;
290
+ reminders: Array<{ task: string; recurrence?: { type: string } }>;
125
291
  count: number;
126
292
  };
127
293
  expect(result.count).toBe(2);
294
+ expect(result.reminders[1].recurrence?.type).toBe("weekly");
128
295
  });
129
296
 
130
297
  it("list_reminders filters by status", async () => {
@@ -156,4 +323,26 @@ describe("reminder tools", () => {
156
323
  expect(result.ok).toBe(true);
157
324
  expect(result.reminder.status).toBe("cancelled");
158
325
  });
326
+
327
+ it("cancel_reminder stops recurring reminders", async () => {
328
+ const store = createReminderStore("agent-tool-cancel-recur", { provider: "memory" });
329
+ const r = await store.create({
330
+ task: "Stop repeating",
331
+ scheduledAt: Date.now() + 60_000,
332
+ conversationId: "c1",
333
+ recurrence: { type: "daily" },
334
+ });
335
+
336
+ const tools = createReminderTools(store);
337
+ const cancelTool = tools.find((t) => t.name === "cancel_reminder")!;
338
+ const result = (await cancelTool.handler({ id: r.id }, makeContext())) as {
339
+ ok: boolean;
340
+ reminder: { status: string };
341
+ };
342
+ expect(result.ok).toBe(true);
343
+ expect(result.reminder.status).toBe("cancelled");
344
+
345
+ const all = await store.list();
346
+ expect(all[0].status).toBe("cancelled");
347
+ });
159
348
  });