synomem 0.1.1 → 0.3.0

package/src/projections.ts

@@ -16,9 +16,25 @@ import type {
   KudosRecord,
   MemoRecord,
   NoteRecord,
+  PostRecord,
+  TaskDue,
+  TaskRecord,
   TodoRecord,
 } from './types.js';
 
+/**
+ * The instant a deadline has passed.
+ *
+ * A date-only deadline does not invent a time of day; it lapses at the end of
+ * that UTC day, which is the latest reading that cannot call work late while
+ * the stated day is still running. Every projection must use this one rule, or
+ * two stores would disagree about what is overdue.
+ */
+export function dueInstant(due: TaskDue | undefined): string | undefined {
+  if (!due) return undefined;
+  return due.kind === 'date' ? `${due.date}T23:59:59.999Z` : due.datetime;
+}
+
 const generatedMarker = '<!-- Generated by Synomem. Rebuild with `synomem rebuild`. -->';
 
 function manifestPath(home: string, path: string): string {
@@ -111,7 +127,7 @@ function memoInboxMarkdown(record: MemoRecord): string {
   ].join('\n')}\n`;
 }
 
-function todoInboxMarkdown(record: TodoRecord): string {
+function taskInboxMarkdown(record: TaskRecord): string {
   const due =
     record.current.due?.kind === 'date'
       ? record.current.due.date
@@ -126,7 +142,7 @@ function todoInboxMarkdown(record: TodoRecord): string {
     `**Status:** ${record.status}  `,
     `**Priority:** ${record.current.priority}  `,
     `**Due:** ${escapeMarkdown(due)}  `,
-    `**Todo ID:** \`${record.event.id}\``,
+    `**Task ID:** \`${record.event.id}\``,
     '',
     ...(record.current.description ? [escapeMarkdown(record.current.description), ''] : []),
   ].join('\n')}\n`;
@@ -157,16 +173,16 @@ function memoryMarkdown(profile: AgentProfile, records: NoteRecord[], rebuiltAt:
   return `${lines.join('\n')}\n`;
 }
 
-function todosMarkdown(profile: AgentProfile, records: TodoRecord[], rebuiltAt: string): string {
+function tasksMarkdown(profile: AgentProfile, records: TaskRecord[], rebuiltAt: string): string {
   const lines = [
     generatedMarker,
     '',
-    `# Todos — ${escapeMarkdown(profile.displayName)}`,
+    `# Tasks — ${escapeMarkdown(profile.displayName)}`,
     '',
     `_Last rebuilt: ${rebuiltAt}_`,
     '',
   ];
-  if (!records.length) lines.push('_No todos yet._', '');
+  if (!records.length) lines.push('_No tasks yet._', '');
   for (const record of records) {
     const due =
       record.current.due?.kind === 'date'
@@ -180,7 +196,7 @@ function todosMarkdown(profile: AgentProfile, records: TodoRecord[], rebuiltAt:
       `**Status:** ${record.status}  `,
       `**Priority:** ${record.current.priority}  `,
       `**Due:** ${escapeMarkdown(due)}  `,
-      `**Todo ID:** \`${record.event.id}\``,
+      `**Task ID:** \`${record.event.id}\``,
       '',
     );
   }
@@ -239,6 +255,75 @@ export function memoRecordsFromEvents(events: SynomemEvent[]): MemoRecord[] {
   return [...records.values()].sort((a, b) => b.event.createdAt.localeCompare(a.event.createdAt));
 }
 
+/**
+ * Rebuilds posts from their events, acknowledgements included.
+ *
+ * Edits are kept as a list rather than collapsed into the current text. A reader
+ * has to be able to see that a post changed after somebody acknowledged it —
+ * silently rewriting what was acknowledged is how a record becomes a lie.
+ */
+export function postRecordsFromEvents(events: SynomemEvent[]): PostRecord[] {
+  const records = new Map<string, PostRecord>();
+  for (const event of events) {
+    if (event.type === 'post.created') {
+      records.set(event.id, {
+        event,
+        edits: [],
+        acknowledgments: [],
+        status: 'active',
+        title: event.title,
+        body: event.body,
+        ...(event.tags ? { tags: event.tags } : {}),
+        // The text version, counting only changes to the text.
+        //
+        // Deliberately not the aggregate version, which also counts every
+        // acknowledgement. If they were the same number, somebody
+        // acknowledging a post would invalidate an edit the author was in the
+        // middle of making — a conflict with nothing to reconcile.
+        version: 1,
+      });
+    } else if (event.type === 'post.edited') {
+      const record = records.get(event.postId);
+      if (record) {
+        record.edits.push(event);
+        record.title = event.title;
+        record.body = event.body;
+        if (event.tags) record.tags = event.tags;
+        record.version += 1;
+      }
+    } else if (event.type === 'post.archived') {
+      const record = records.get(event.postId);
+      if (record) {
+        record.archived = event;
+        record.status = 'archived';
+      }
+    } else if (event.type === 'post.acknowledged') {
+      const record = records.get(event.postId);
+      if (record) {
+        // One statement per actor: a repeat replaces rather than accumulates.
+        const existing = record.acknowledgments.findIndex(
+          (entry) => entry.actor.id === event.actor.id && entry.actor.kind === event.actor.kind,
+        );
+        const entry = {
+          actor: event.actor,
+          acknowledgedAt: event.createdAt,
+          ...(event.note ? { note: event.note } : {}),
+        };
+        if (existing >= 0) record.acknowledgments[existing] = entry;
+        else record.acknowledgments.push(entry);
+      }
+    } else if (event.type === 'post.acknowledgment.withdrawn') {
+      const record = records.get(event.postId);
+      if (record) {
+        record.acknowledgments = record.acknowledgments.filter(
+          (entry) => !(entry.actor.id === event.actor.id && entry.actor.kind === event.actor.kind),
+        );
+      }
+    }
+  }
+  return [...records.values()];
+}
+
 export function noteRecordsFromEvents(events: SynomemEvent[]): NoteRecord[] {
   const records = new Map<string, NoteRecord>();
   for (const event of events) {
@@ -278,6 +363,13 @@ export function noteRecordsFromEvents(events: SynomemEvent[]): NoteRecord[] {
   return [...records.values()].sort((a, b) => b.event.createdAt.localeCompare(a.event.createdAt));
 }
 
+/**
+ * Builds private Todo records.
+ *
+ * Deliberately simpler than the Task reducer: there is no acceptance state and
+ * no response history, because there is nobody to negotiate with. A Todo goes
+ * open → completed / canceled / archived, and back to open on reopen.
+ */
 export function todoRecordsFromEvents(events: SynomemEvent[]): TodoRecord[] {
   const records = new Map<string, TodoRecord>();
   for (const event of events) {
@@ -286,14 +378,13 @@ export function todoRecordsFromEvents(events: SynomemEvent[]): TodoRecord[] {
         event,
         current: {
           title: event.title,
-          ...(event.description !== undefined ? { description: event.description } : {}),
+          ...(event.details !== undefined ? { details: event.details } : {}),
           priority: event.priority,
           ...(event.due ? { due: event.due } : {}),
           tags: event.tags ?? [],
-          visibility: event.visibility,
           version: event.aggregateVersion,
         },
-        status: event.requiresAcceptance ? 'assigned' : 'open',
+        status: 'open',
       });
     } else if (event.type === 'todo.updated') {
       const record = records.get(event.todoId);
@@ -301,24 +392,25 @@ export function todoRecordsFromEvents(events: SynomemEvent[]): TodoRecord[] {
         record.update = event;
         record.current = {
           title: event.title,
-          ...(event.description !== undefined ? { description: event.description } : {}),
+          ...(event.details !== undefined ? { details: event.details } : {}),
           priority: event.priority,
           ...(event.due ? { due: event.due } : {}),
           tags: event.tags ?? [],
-          visibility: event.visibility,
           version: event.aggregateVersion,
         };
       }
-    } else if (event.type === 'todo.accepted') {
+    } else if (event.type === 'todo.reopened') {
       const record = records.get(event.todoId);
       if (record) {
+        record.reopened = event;
         record.current.version = event.aggregateVersion;
         record.status = 'open';
+        delete record.terminal;
       }
     } else if (
       event.type === 'todo.completed' ||
-      event.type === 'todo.rejected' ||
-      event.type === 'todo.canceled'
+      event.type === 'todo.canceled' ||
+      event.type === 'todo.archived'
     ) {
       const record = records.get(event.todoId);
       if (record) {
@@ -327,12 +419,85 @@ export function todoRecordsFromEvents(events: SynomemEvent[]): TodoRecord[] {
         record.status =
           event.type === 'todo.completed'
             ? 'completed'
-            : event.type === 'todo.rejected'
+            : event.type === 'todo.canceled'
+              ? 'canceled'
+              : 'archived';
+      }
+    }
+  }
+  return [...records.values()];
+}
+
+export function taskRecordsFromEvents(events: SynomemEvent[]): TaskRecord[] {
+  const records = new Map<string, TaskRecord>();
+  for (const event of events) {
+    if (event.type === 'task.created') {
+      records.set(event.id, {
+        event,
+        current: {
+          title: event.title,
+          ...(event.description !== undefined ? { description: event.description } : {}),
+          priority: event.priority,
+          ...(event.due ? { due: event.due } : {}),
+          tags: event.tags ?? [],
+          visibility: event.visibility,
+          version: event.aggregateVersion,
+        },
+        status: event.requiresAcceptance ? 'assigned' : 'open',
+        responses: [],
+      });
+    } else if (event.type === 'task.updated') {
+      const record = records.get(event.taskId);
+      if (record) {
+        record.update = event;
+        record.current = {
+          title: event.title,
+          ...(event.description !== undefined ? { description: event.description } : {}),
+          priority: event.priority,
+          ...(event.due ? { due: event.due } : {}),
+          tags: event.tags ?? [],
+          visibility: event.visibility,
+          version: event.aggregateVersion,
+        };
+      }
+    } else if (event.type === 'task.accepted') {
+      const record = records.get(event.taskId);
+      if (record) {
+        record.current.version = event.aggregateVersion;
+        record.status = 'open';
+        record.responses.push({
+          kind: 'accepted',
+          ...(event.response !== undefined ? { response: event.response } : {}),
+          actor: event.actor,
+          at: event.createdAt,
+        });
+      }
+    } else if (
+      event.type === 'task.completed' ||
+      event.type === 'task.rejected' ||
+      event.type === 'task.canceled'
+    ) {
+      const record = records.get(event.taskId);
+      if (record) {
+        record.terminal = event;
+        record.current.version = event.aggregateVersion;
+        if (event.type === 'task.rejected') {
+          record.responses.push({
+            kind: 'rejected',
+            response: event.response,
+            actor: event.actor,
+            at: event.createdAt,
+          });
+        }
+        record.status =
+          event.type === 'task.completed'
+            ? 'completed'
+            : event.type === 'task.rejected'
               ? 'rejected'
               : 'canceled';
       }
-    } else if (event.type === 'todo.reopened') {
-      const record = records.get(event.todoId);
+    } else if (event.type === 'task.reopened') {
+      const record = records.get(event.taskId);
       if (record) {
         record.reopened = event;
         record.current.version = event.aggregateVersion;
@@ -358,9 +523,9 @@ export function renderMarkdownExport(events: SynomemEvent[]): string {
       (record) =>
         `## Note: ${escapeMarkdown(record.current.title)}\n\n${escapeMarkdown(record.current.body)}\n\nStatus: ${record.status}; version ${record.current.version}\n\nID: \`${record.event.id}\``,
     ),
-    ...todoRecordsFromEvents(events).map(
+    ...taskRecordsFromEvents(events).map(
       (record) =>
-        `## Todo: ${escapeMarkdown(record.current.title)}\n\n${record.current.description ? `${escapeMarkdown(record.current.description)}\n\n` : ''}Status: ${record.status}; priority ${record.current.priority}\n\nID: \`${record.event.id}\``,
+        `## Task: ${escapeMarkdown(record.current.title)}\n\n${record.current.description ? `${escapeMarkdown(record.current.description)}\n\n` : ''}Status: ${record.status}; priority ${record.current.priority}\n\nID: \`${record.event.id}\``,
     ),
   ];
   return `${sections.join('\n\n')}\n`;
@@ -380,7 +545,7 @@ export class ProjectionManager implements ProjectionWriter {
     const records = recordsFromEvents(events);
     const memos = memoRecordsFromEvents(events);
     const notes = noteRecordsFromEvents(events);
-    const todos = todoRecordsFromEvents(events);
+    const tasks = taskRecordsFromEvents(events);
     const rebuiltAt = events.at(-1)?.createdAt ?? new Date(0).toISOString();
     const generated: string[] = [];
 
@@ -394,12 +559,12 @@ export class ProjectionManager implements ProjectionWriter {
       const inboxDirectory = join(agentDirectory, 'inbox');
       const kudosInboxDirectory = join(inboxDirectory, 'kudos');
       const memoInboxDirectory = join(inboxDirectory, 'memos');
-      const todoInboxDirectory = join(inboxDirectory, 'todos');
+      const taskInboxDirectory = join(inboxDirectory, 'tasks');
       assertNoSymlinkEscape(this.storage.home, inboxDirectory);
       ensureDirectory(inboxDirectory);
       ensureDirectory(kudosInboxDirectory);
       ensureDirectory(memoInboxDirectory);
-      ensureDirectory(todoInboxDirectory);
+      ensureDirectory(taskInboxDirectory);
 
       atomicWriteDerivedFile(
         profilePath,
@@ -424,11 +589,11 @@ export class ProjectionManager implements ProjectionWriter {
         atomicWriteDerivedFile(memoryPath, memoryMarkdown(profile, agentNotes, rebuiltAt));
         generated.push(manifestPath(this.storage.home, memoryPath));
       }
-      const agentTodos = todos.filter((record) => record.event.assigneeAgentId === profile.id);
-      if (this.storage.config.projection.writeTodosMarkdown) {
-        const todosPath = join(agentDirectory, 'TODOS.md');
-        atomicWriteDerivedFile(todosPath, todosMarkdown(profile, agentTodos, rebuiltAt));
-        generated.push(manifestPath(this.storage.home, todosPath));
+      const agentTasks = tasks.filter((record) => record.event.assigneeAgentId === profile.id);
+      if (this.storage.config.projection.writeTasksMarkdown) {
+        const tasksPath = join(agentDirectory, 'TASKS.md');
+        atomicWriteDerivedFile(tasksPath, tasksMarkdown(profile, agentTasks, rebuiltAt));
+        generated.push(manifestPath(this.storage.home, tasksPath));
       }
       if (this.storage.config.projection.writeInboxEntries) {
         for (const record of agentRecords.filter(
@@ -445,11 +610,11 @@ export class ProjectionManager implements ProjectionWriter {
           atomicWriteDerivedFile(inboxPath, memoInboxMarkdown(record));
           generated.push(manifestPath(this.storage.home, inboxPath));
         }
-        for (const record of agentTodos.filter(
+        for (const record of agentTasks.filter(
           (item) => item.status === 'open' || item.status === 'assigned',
         )) {
-          const inboxPath = join(todoInboxDirectory, `${record.event.id}.md`);
-          atomicWriteDerivedFile(inboxPath, todoInboxMarkdown(record));
+          const inboxPath = join(taskInboxDirectory, `${record.event.id}.md`);
+          atomicWriteDerivedFile(inboxPath, taskInboxMarkdown(record));
           generated.push(manifestPath(this.storage.home, inboxPath));
         }
       }
@@ -487,7 +652,7 @@ export class ProjectionManager implements ProjectionWriter {
     const notes = noteRecordsFromEvents(events).filter(
       (record) => record.event.ownerAgentId === profile.id,
     );
-    const todos = todoRecordsFromEvents(events).filter(
+    const tasks = taskRecordsFromEvents(events).filter(
       (record) => record.event.assigneeAgentId === profile.id,
     );
     const rebuiltAt = events.at(-1)?.createdAt ?? new Date(0).toISOString();
@@ -495,14 +660,14 @@ export class ProjectionManager implements ProjectionWriter {
     const inboxDirectory = join(agentDirectory, 'inbox');
     const kudosInboxDirectory = join(inboxDirectory, 'kudos');
     const memoInboxDirectory = join(inboxDirectory, 'memos');
-    const todoInboxDirectory = join(inboxDirectory, 'todos');
+    const taskInboxDirectory = join(inboxDirectory, 'tasks');
     assertNoSymlinkEscape(this.storage.home, agentDirectory);
     assertNoSymlinkEscape(this.storage.home, inboxDirectory);
     ensureDirectory(agentDirectory);
     ensureDirectory(inboxDirectory);
     ensureDirectory(kudosInboxDirectory);
     ensureDirectory(memoInboxDirectory);
-    ensureDirectory(todoInboxDirectory);
+    ensureDirectory(taskInboxDirectory);
 
     const generated: string[] = [];
     const profilePath = join(agentDirectory, 'profile.json');
@@ -532,10 +697,10 @@ export class ProjectionManager implements ProjectionWriter {
       generated.push(manifestPath(this.storage.home, memoryPath));
     }
 
-    if (this.storage.config.projection.writeTodosMarkdown) {
-      const todosPath = join(agentDirectory, 'TODOS.md');
-      atomicWriteDerivedFile(todosPath, todosMarkdown(profile, todos, rebuiltAt));
-      generated.push(manifestPath(this.storage.home, todosPath));
+    if (this.storage.config.projection.writeTasksMarkdown) {
+      const tasksPath = join(agentDirectory, 'TASKS.md');
+      atomicWriteDerivedFile(tasksPath, tasksMarkdown(profile, tasks, rebuiltAt));
+      generated.push(manifestPath(this.storage.home, tasksPath));
     }
 
     if (this.storage.config.projection.writeInboxEntries) {
@@ -553,12 +718,12 @@ export class ProjectionManager implements ProjectionWriter {
         if (!existsSync(inboxPath)) atomicWriteDerivedFile(inboxPath, memoInboxMarkdown(record));
         generated.push(relativePath);
       }
-      for (const record of todos.filter(
+      for (const record of tasks.filter(
         (item) => item.status === 'open' || item.status === 'assigned',
       )) {
-        const inboxPath = join(todoInboxDirectory, `${record.event.id}.md`);
+        const inboxPath = join(taskInboxDirectory, `${record.event.id}.md`);
         const relativePath = manifestPath(this.storage.home, inboxPath);
-        if (!existsSync(inboxPath)) atomicWriteDerivedFile(inboxPath, todoInboxMarkdown(record));
+        if (!existsSync(inboxPath)) atomicWriteDerivedFile(inboxPath, taskInboxMarkdown(record));
         generated.push(relativePath);
       }
     }
@@ -589,13 +754,13 @@ export class ProjectionManager implements ProjectionWriter {
     const events = this.storage.getReadableEvents();
     const records = recordsFromEvents(events);
     const memos = memoRecordsFromEvents(events);
-    const todos = todoRecordsFromEvents(events);
+    const tasks = taskRecordsFromEvents(events);
     const paths: string[] = [];
     for (const profile of profiles) {
       paths.push(`${profile.id}/profile.json`);
       if (this.storage.config.projection.writeWinsMarkdown) paths.push(`${profile.id}/WINS.md`);
       if (this.storage.config.projection.writeMemoryMarkdown) paths.push(`${profile.id}/MEMORY.md`);
-      if (this.storage.config.projection.writeTodosMarkdown) paths.push(`${profile.id}/TODOS.md`);
+      if (this.storage.config.projection.writeTasksMarkdown) paths.push(`${profile.id}/TASKS.md`);
       if (this.storage.config.projection.writeInboxEntries) {
         for (const record of records.filter(
           (item) =>
@@ -610,12 +775,12 @@ export class ProjectionManager implements ProjectionWriter {
         )) {
           paths.push(`${profile.id}/inbox/memos/${record.event.id}.md`);
         }
-        for (const record of todos.filter(
+        for (const record of tasks.filter(
           (item) =>
             item.event.assigneeAgentId === profile.id &&
             (item.status === 'open' || item.status === 'assigned'),
         )) {
-          paths.push(`${profile.id}/inbox/todos/${record.event.id}.md`);
+          paths.push(`${profile.id}/inbox/tasks/${record.event.id}.md`);
         }
       }
     }

package/src/remote.ts

@@ -4,16 +4,21 @@ import type { SynomemService, SynomemServiceCapabilities, SynomemServiceInfo } f
 import type {
   ActorIdentity,
   ChangesInput,
+  BindRuntimeInput,
   CreateAgentInput,
+  CreatePostInput,
+  UpdatePostInput,
   CreateNoteInput,
-  CreateTodoInput,
+  CreateTaskInput,
   GiveKudosInput,
   ItemListInput,
   KudosListInput,
   ReviseNoteInput,
   SendMemoInput,
   UpdateAgentInput,
+  UpdateTaskInput,
   UpdateTodoInput,
+  CreateTodoInput,
 } from './types.js';
 
 const defaultMaximumResponseBytes = 1024 * 1024;
@@ -169,6 +174,78 @@ export class RemoteSynomemService implements SynomemService {
       ),
     list: () =>
       this.request<Awaited<ReturnType<SynomemService['agents']['list']>>>('GET', 'agents'),
+    resolve: (query: string) =>
+      this.request<Awaited<ReturnType<SynomemService['agents']['resolve']>>>(
+        'GET',
+        `agents/resolve?query=${encodeURIComponent(query)}`,
+      ),
+    directory: () =>
+      this.request<Awaited<ReturnType<SynomemService['agents']['directory']>>>(
+        'GET',
+        'agents/directory',
+      ),
+    bindings: (idOrAlias: string) =>
+      this.request<Awaited<ReturnType<SynomemService['agents']['bindings']>>>(
+        'GET',
+        `agents/${encodeURIComponent(idOrAlias)}/runtimes`,
+      ),
+    bindRuntime: (input: BindRuntimeInput) =>
+      this.mutation<Awaited<ReturnType<SynomemService['agents']['bindRuntime']>>>(
+        'POST',
+        `agents/${encodeURIComponent(input.agentId)}/runtimes`,
+        input,
+      ),
+    unbindRuntime: (bindingId: string) =>
+      this.request<Awaited<ReturnType<SynomemService['agents']['unbindRuntime']>>>(
+        'DELETE',
+        `agents/runtimes/${encodeURIComponent(bindingId)}`,
+      ),
+  };
+
+  readonly posts = {
+    create: (input: CreatePostInput) =>
+      this.mutation<Awaited<ReturnType<SynomemService['posts']['create']>>>('POST', 'posts', input),
+    list: (input: Omit<ItemListInput, 'kinds'> = {}) =>
+      this.request<Awaited<ReturnType<SynomemService['posts']['list']>>>(
+        'GET',
+        `posts${queryString(input)}`,
+      ),
+    get: (id: string) =>
+      this.request<Awaited<ReturnType<SynomemService['posts']['get']>>>(
+        'GET',
+        `posts/${encodeURIComponent(id)}`,
+      ),
+    update: (input: UpdatePostInput) =>
+      this.mutation<Awaited<ReturnType<SynomemService['posts']['update']>>>(
+        'POST',
+        `posts/${encodeURIComponent(input.postId)}/revisions`,
+        input,
+        ['postId'],
+      ),
+    archive: (input: { postId: string; reason?: string; idempotencyKey?: string }) =>
+      this.mutation<Awaited<ReturnType<SynomemService['posts']['archive']>>>(
+        'POST',
+        `posts/${encodeURIComponent(input.postId)}/archive`,
+        input,
+        ['postId'],
+      ),
+    acknowledge: (input: { postId: string; note?: string; idempotencyKey?: string }) =>
+      this.mutation<Awaited<ReturnType<SynomemService['posts']['acknowledge']>>>(
+        'POST',
+        `posts/${encodeURIComponent(input.postId)}/acknowledgment`,
+        input,
+        ['postId'],
+      ),
+    withdrawAcknowledgment: (input: { postId: string; reason?: string }) =>
+      this.request<Awaited<ReturnType<SynomemService['posts']['withdrawAcknowledgment']>>>(
+        'DELETE',
+        `posts/${encodeURIComponent(input.postId)}/acknowledgment`,
+      ),
+    roster: (postId: string) =>
+      this.request<Awaited<ReturnType<SynomemService['posts']['roster']>>>(
+        'GET',
+        `posts/${encodeURIComponent(postId)}/roster`,
+      ),
   };
 
   readonly kudos = {
@@ -261,6 +338,42 @@ export class RemoteSynomemService implements SynomemService {
       ),
   };
 
+  readonly tasks = {
+    create: (input: CreateTaskInput) =>
+      this.mutation<Awaited<ReturnType<SynomemService['tasks']['create']>>>('POST', 'tasks', input),
+    list: (input: Omit<ItemListInput, 'kinds'> = {}) =>
+      this.request<Awaited<ReturnType<SynomemService['tasks']['list']>>>(
+        'GET',
+        `tasks${queryString(input)}`,
+      ),
+    get: (id: string) =>
+      this.request<Awaited<ReturnType<SynomemService['tasks']['get']>>>(
+        'GET',
+        `tasks/${encodeURIComponent(id)}`,
+      ),
+    update: (input: UpdateTaskInput) =>
+      this.mutation<Awaited<ReturnType<SynomemService['tasks']['update']>>>(
+        'POST',
+        `tasks/${encodeURIComponent(input.taskId)}/revisions`,
+        input,
+        ['taskId'],
+      ),
+    accept: (input: { taskId: string; response?: string; idempotencyKey?: string }) =>
+      this.taskTransition('accept', input),
+    reject: (input: { taskId: string; response: string; idempotencyKey?: string }) =>
+      this.taskTransition('reject', input),
+    complete: (input: { taskId: string; note?: string; idempotencyKey?: string }) =>
+      this.taskTransition('complete', input),
+    reopen: (input: { taskId: string; idempotencyKey?: string }) =>
+      this.taskTransition('reopen', input),
+    cancel: (input: { taskId: string; reason?: string; idempotencyKey?: string }) =>
+      this.taskTransition('cancel', input),
+  };
+
+  /**
+   * Private self-reminders. The remote surface mirrors the local one exactly so
+   * a caller does not have to know which backend it is talking to.
+   */
   readonly todos = {
     create: (input: CreateTodoInput) =>
       this.mutation<Awaited<ReturnType<SynomemService['todos']['create']>>>('POST', 'todos', input),
@@ -281,16 +394,43 @@ export class RemoteSynomemService implements SynomemService {
         input,
         ['todoId'],
       ),
-    accept: (input: { todoId: string; idempotencyKey?: string }) =>
-      this.todoTransition('accept', input),
-    reject: (input: { todoId: string; reason?: string; idempotencyKey?: string }) =>
-      this.todoTransition('reject', input),
     complete: (input: { todoId: string; note?: string; idempotencyKey?: string }) =>
       this.todoTransition('complete', input),
     reopen: (input: { todoId: string; idempotencyKey?: string }) =>
       this.todoTransition('reopen', input),
     cancel: (input: { todoId: string; reason?: string; idempotencyKey?: string }) =>
       this.todoTransition('cancel', input),
+    archive: (input: { todoId: string; idempotencyKey?: string }) =>
+      this.todoTransition('archive', input),
+  };
+
+  /**
+   * Discovery mirrors the local semantics: the age/deadline is resolved here so
+   * both backends answer the same question, rather than each server deciding
+   * what "older than 24 hours" means.
+   */
+  readonly discovery = {
+    unanswered: (
+      input: Omit<ItemListInput, 'awaitingResponse' | 'pending'> & { olderThanHours?: number } = {},
+    ) => {
+      const { olderThanHours, awaitingSince, ...rest } = input;
+      const since =
+        awaitingSince ??
+        (olderThanHours !== undefined
+          ? new Date(Date.now() - olderThanHours * 3_600_000).toISOString()
+          : undefined);
+      return this.request<Awaited<ReturnType<SynomemService['items']['list']>>>(
+        'GET',
+        `items${queryString({ ...rest, awaitingResponse: true, ...(since ? { awaitingSince: since } : {}) })}`,
+      );
+    },
+    overdue: (input: Omit<ItemListInput, 'overdueAsOf'> & { asOf?: string } = {}) => {
+      const { asOf, ...rest } = input;
+      return this.request<Awaited<ReturnType<SynomemService['items']['list']>>>(
+        'GET',
+        `items${queryString({ ...rest, overdueAsOf: asOf ?? new Date().toISOString() })}`,
+      );
+    },
   };
 
   readonly items = {
@@ -410,11 +550,29 @@ export class RemoteSynomemService implements SynomemService {
     );
   }
 
-  private todoTransition(
+  private taskTransition(
     transition: 'accept' | 'reject' | 'complete' | 'reopen' | 'cancel',
+    input: {
+      taskId: string;
+      idempotencyKey?: string;
+      reason?: string;
+      note?: string;
+      response?: string;
+    },
+  ) {
+    return this.mutation<Awaited<ReturnType<SynomemService['tasks']['accept']>>>(
+      'POST',
+      `tasks/${encodeURIComponent(input.taskId)}/${transition}`,
+      input,
+      ['taskId'],
+    );
+  }
+
+  private todoTransition(
+    transition: 'complete' | 'reopen' | 'cancel' | 'archive',
     input: { todoId: string; idempotencyKey?: string; reason?: string; note?: string },
   ) {
-    return this.mutation<Awaited<ReturnType<SynomemService['todos']['accept']>>>(
+    return this.mutation<Awaited<ReturnType<SynomemService['todos']['complete']>>>(
       'POST',
       `todos/${encodeURIComponent(input.todoId)}/${transition}`,
       input,
@@ -437,7 +595,7 @@ export class RemoteSynomemService implements SynomemService {
   }
 
   private async request<T>(
-    method: 'GET' | 'POST' | 'PATCH',
+    method: 'GET' | 'POST' | 'PATCH' | 'DELETE',
     path: string,
     body?: object,
     idempotencyKey?: string,