@batalabs/virlow-mcp-core 3.101.0 → 3.102.0

package/dist/cjs/todos.d.ts

@@ -0,0 +1,79 @@
+import type { VirlowApi } from './api.js';
+import { type Repeat, type Task, type TodoList } from './todo-format.js';
+import type { Vault } from './vault.js';
+export interface ListTodosArgs {
+    list?: string;
+    include_completed?: boolean;
+    query?: string;
+}
+export interface AddTodoArgs {
+    text: string;
+    list?: string;
+    due?: string;
+    my_day?: boolean;
+    important?: boolean;
+    note?: string;
+    steps?: string[];
+    repeat?: Repeat;
+    remind_at?: string;
+}
+export interface UpdateTodoArgs {
+    id: string;
+    text?: string;
+    done?: boolean;
+    due?: string | null;
+    my_day?: boolean;
+    important?: boolean;
+    note?: string;
+    add_steps?: string[];
+    complete_steps?: string[];
+    list?: string | null;
+    repeat?: Repeat | null;
+    remind_at?: string | null;
+}
+export interface CreateTodoListArgs {
+    name: string;
+    emoji?: string;
+    color?: string;
+}
+interface Loaded {
+    tasks: Task[];
+    lists: TodoList[];
+}
+export declare class TodoService {
+    private readonly api;
+    private readonly vault;
+    /** The clock, for "today" and reminder checks. Tests pass a fixed one. */
+    private readonly now;
+    constructor(api: VirlowApi, vault: Vault, 
+    /** The clock, for "today" and reminder checks. Tests pass a fixed one. */
+    now?: () => Date);
+    private today;
+    /** The key, or the vault's own "ask the user to unlock" error. */
+    private key;
+    private fetchAll;
+    private decrypt;
+    load(): Promise<Loaded>;
+    /** A list by id or name (case-insensitive). Never guesses between two
+     *  lists with one name, and never makes one up. */
+    private resolveList;
+    private scopeOf;
+    private listName;
+    private describe;
+    listTodos(args: ListTodosArgs): Promise<string>;
+    private scopeName;
+    listLists(): Promise<string>;
+    private validDay;
+    private validRemind;
+    private encrypted;
+    private createTask;
+    private channels;
+    /** Cancels the task's pending reminders. */
+    private clearReminders;
+    /** No label: the email only says there is a reminder, since the text is encrypted. */
+    private createReminder;
+    addTodo(args: AddTodoArgs): Promise<string>;
+    updateTodo(args: UpdateTodoArgs): Promise<string>;
+    createList(args: CreateTodoListArgs): Promise<string>;
+}
+export {};

package/dist/cjs/todos.js

@@ -0,0 +1,383 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TodoService = void 0;
+const virlow_crypto_1 = require("@batalabs/virlow-crypto");
+const todo_format_js_1 = require("./todo-format.js");
+/**
+ * The to-do list over the API, for the MCP tools.
+ *
+ * Tasks and lists are notes the API never lists with the rest (types `todo`
+ * and `todolist`), encrypted like any note: the text and every detail are in
+ * the ciphertext, and the server sees only whether a task is done and, through
+ * a reminder, when to send one. The format is todo-format.ts, shared with the
+ * web app and mirrored by iOS, so a task written here reads the same there.
+ *
+ * Nothing is cached: a to-do list is small, and the apps change it all the
+ * time, so every call reads the current state.
+ */
+/** Smart list names as a tool takes them. */
+const SMART_ALIASES = {
+    my_day: 'myday',
+    myday: 'myday',
+    'my day': 'myday',
+    important: 'important',
+    planned: 'planned',
+    tasks: 'tasks',
+};
+const DAY = /^\d{4}-\d{2}-\d{2}$/;
+const HEX = /^#[0-9a-f]{6}$/i;
+const NOTE_PREVIEW = 200;
+class TodoService {
+    api;
+    vault;
+    now;
+    constructor(api, vault, 
+    /** The clock, for "today" and reminder checks. Tests pass a fixed one. */
+    now = () => new Date()) {
+        this.api = api;
+        this.vault = vault;
+        this.now = now;
+    }
+    today() {
+        return (0, todo_format_js_1.dayKey)(this.now());
+    }
+    /** The key, or the vault's own "ask the user to unlock" error. */
+    key() {
+        return this.vault.session.key;
+    }
+    // MARK: Reading
+    async fetchAll(type) {
+        const rows = [];
+        for (let page = 1;; page++) {
+            const result = await this.api.listNotes({ type, deleted: false, limit: 50, page });
+            rows.push(...result.notes);
+            if (page >= result.pagination.pages || result.notes.length === 0)
+                break;
+        }
+        // Filtered here too: an API that predates the type ignores the filter.
+        return rows.filter((row) => row.type === type && row.deleted !== true);
+    }
+    async decrypt(key, row) {
+        if (!row.encryptedTitle)
+            return { title: row.title, content: row.content === '[ENCRYPTED]' ? '' : row.content };
+        try {
+            return await (0, virlow_crypto_1.decryptNoteFields)(key, row.encryptedTitle, row.encryptedContent ?? '', row.iv ?? '');
+        }
+        catch {
+            // A row that will not open (another key, a damaged write) is left out
+            // rather than failing the whole list.
+            return null;
+        }
+    }
+    async load() {
+        const key = this.key();
+        const [taskRows, listRows] = await Promise.all([this.fetchAll(todo_format_js_1.TODO_NOTE_TYPE), this.fetchAll(todo_format_js_1.TODO_LIST_NOTE_TYPE)]);
+        const tasks = [];
+        for (const row of taskRows) {
+            const opened = await this.decrypt(key, row);
+            if (!opened)
+                continue;
+            tasks.push({
+                id: row.id,
+                title: opened.title,
+                details: (0, todo_format_js_1.parseDetails)(opened.content),
+                done: row.archived === true,
+                createdAt: row.createdAt,
+                updatedAt: row.updatedAt,
+            });
+        }
+        const lists = [];
+        for (const row of listRows) {
+            const opened = await this.decrypt(key, row);
+            if (!opened)
+                continue;
+            lists.push({ id: row.id, name: opened.title, meta: (0, todo_format_js_1.parseListMeta)(opened.content), createdAt: row.createdAt });
+        }
+        lists.sort((a, b) => a.createdAt.localeCompare(b.createdAt));
+        return { tasks, lists };
+    }
+    /** A list by id or name (case-insensitive). Never guesses between two
+     *  lists with one name, and never makes one up. */
+    resolveList(lists, ref) {
+        const byId = lists.find((l) => l.id === ref);
+        if (byId)
+            return byId;
+        const wanted = ref.trim().toLowerCase();
+        const named = lists.filter((l) => l.name.trim().toLowerCase() === wanted);
+        if (named.length === 1)
+            return named[0];
+        if (named.length > 1) {
+            throw new Error(`More than one list is called "${ref}". Use its id: ${named.map((l) => l.id).join(', ')}.`);
+        }
+        const known = lists.length ? lists.map((l) => `"${l.name}"`).join(', ') : 'none yet';
+        throw new Error(`No to-do list called "${ref}". The person's lists: ${known}. ` +
+            'Use one of those, leave list out for Tasks, or call create_todo_list if they asked for a new one.');
+    }
+    scopeOf(lists, ref) {
+        if (ref === undefined || ref.trim() === '')
+            return null;
+        const smart = SMART_ALIASES[ref.trim().toLowerCase()];
+        if (smart)
+            return smart;
+        return (0, todo_format_js_1.listKey)(this.resolveList(lists, ref).id);
+    }
+    listName(lists, id) {
+        if (id === null)
+            return 'Tasks';
+        return lists.find((l) => l.id === id)?.name ?? 'Tasks';
+    }
+    describe(task, lists) {
+        const d = task.details;
+        const today = this.today();
+        const parts = [`list: ${this.listName(lists, d.list)}`];
+        if (d.due)
+            parts.push(`due ${d.due}${!task.done && d.due < today ? ' (overdue)' : ''}`);
+        if (d.myDay === today)
+            parts.push('in My Day');
+        if (d.important)
+            parts.push('important');
+        if (d.repeat)
+            parts.push(`repeats ${d.repeat}`);
+        if (d.remindAt)
+            parts.push(`remind at ${d.remindAt}`);
+        if (task.done && d.completedAt)
+            parts.push(`completed ${d.completedAt}`);
+        const lines = [`- [${task.done ? 'x' : ' '}] ${task.title} (id: ${task.id})`, `    ${parts.join(' · ')}`];
+        if (d.steps.length) {
+            const done = d.steps.filter((s) => s.done).length;
+            const steps = d.steps.map((s) => `[${s.done ? 'x' : ' '}] ${s.text} (id: ${s.id})`).join('; ');
+            lines.push(`    steps ${done} of ${d.steps.length}: ${steps}`);
+        }
+        if (d.note.trim()) {
+            const note = d.note.trim().replace(/\s+/g, ' ');
+            lines.push(`    note: ${note.length > NOTE_PREVIEW ? `${note.slice(0, NOTE_PREVIEW)}…` : note}`);
+        }
+        return lines.join('\n');
+    }
+    async listTodos(args) {
+        const { tasks, lists } = await this.load();
+        const today = this.today();
+        const scope = this.scopeOf(lists, args.list);
+        const query = args.query?.trim().toLowerCase();
+        const matches = (t) => !query || t.title.toLowerCase().includes(query) || t.details.note.toLowerCase().includes(query);
+        const open = scope
+            ? (0, todo_format_js_1.openTasks)(tasks, scope, today)
+            : tasks.filter((t) => !t.done).sort((a, b) => a.createdAt.localeCompare(b.createdAt));
+        const done = args.include_completed
+            ? scope
+                ? (0, todo_format_js_1.completedTasks)(tasks, scope, today)
+                : tasks
+                    .filter((t) => t.done)
+                    .sort((a, b) => (b.details.completedAt ?? b.updatedAt).localeCompare(a.details.completedAt ?? a.updatedAt))
+            : [];
+        const shown = [...open.filter(matches), ...done.filter(matches)];
+        const where = scope ? this.scopeName(lists, scope) : 'every list';
+        if (shown.length === 0) {
+            return query
+                ? `No to-dos in ${where} match "${args.query}".`
+                : `No ${args.include_completed ? '' : 'open '}to-dos in ${where}.`;
+        }
+        const head = `${open.filter(matches).length} open${args.include_completed ? `, ${done.filter(matches).length} completed` : ''} in ${where} (today is ${today}):`;
+        return [head, ...shown.map((t) => this.describe(t, lists))].join('\n');
+    }
+    scopeName(lists, scope) {
+        const smart = todo_format_js_1.SMART_LISTS.find((s) => s.id === scope);
+        if (smart)
+            return smart.label;
+        return this.listName(lists, scope.slice(5));
+    }
+    async listLists() {
+        const { tasks, lists } = await this.load();
+        const today = this.today();
+        const lines = todo_format_js_1.SMART_LISTS.map((s) => `- ${s.label} (${s.id === 'myday' ? 'my_day' : s.id}): ${(0, todo_format_js_1.openTasks)(tasks, s.id, today).length} open`);
+        lines.push(...lists.map((l) => `- ${l.meta.emoji ? `${l.meta.emoji} ` : ''}${l.name} (id: ${l.id}): ${(0, todo_format_js_1.openTasks)(tasks, (0, todo_format_js_1.listKey)(l.id), today).length} open`));
+        return [`Smart lists, then the person's own lists (today is ${today}):`, ...lines].join('\n');
+    }
+    // MARK: Writing
+    validDay(value, field) {
+        if (!DAY.test(value) || Number.isNaN(new Date(`${value}T00:00:00`).getTime())) {
+            throw new Error(`${field} must be a day as YYYY-MM-DD, got "${value}".`);
+        }
+        return value;
+    }
+    validRemind(value) {
+        const at = new Date(value);
+        if (Number.isNaN(at.getTime()))
+            throw new Error(`remind_at must be an ISO 8601 date and time, got "${value}".`);
+        if (at.getTime() <= this.now().getTime())
+            throw new Error(`remind_at must be in the future, got ${value}.`);
+        return at;
+    }
+    async encrypted(title, content) {
+        const key = this.key();
+        const salt = (0, virlow_crypto_1.bytesToBase64)(crypto.getRandomValues(new Uint8Array(32)));
+        const { encryptedTitle, encryptedContent, iv } = await (0, virlow_crypto_1.encryptNoteFields)(key, title, content);
+        return { title: '[ENCRYPTED]', content: '[ENCRYPTED]', encryptedTitle, encryptedContent, iv, salt };
+    }
+    async createTask(text, details) {
+        return this.api.createNote({ ...(await this.encrypted(text, (0, todo_format_js_1.serializeDetails)(details))), type: todo_format_js_1.TODO_NOTE_TYPE, folderId: null });
+    }
+    async channels() {
+        try {
+            const integrations = await this.api.integrations();
+            return integrations.slack.connected ? ['email', 'slack'] : ['email'];
+        }
+        catch {
+            return ['email'];
+        }
+    }
+    /** Cancels the task's pending reminders. */
+    async clearReminders(noteId) {
+        const reminders = await this.api.listReminders(noteId);
+        for (const r of reminders) {
+            if (r.status === 'pending')
+                await this.api.deleteReminder(r.id);
+        }
+    }
+    /** No label: the email only says there is a reminder, since the text is encrypted. */
+    async createReminder(noteId, at) {
+        await this.api.createReminder({ noteId, remindAt: at.toISOString(), label: null, channels: await this.channels() });
+    }
+    async addTodo(args) {
+        const text = args.text?.trim();
+        if (!text)
+            throw new Error('text is required.');
+        if (args.repeat !== undefined && !todo_format_js_1.REPEATS.includes(args.repeat)) {
+            throw new Error(`repeat must be one of ${todo_format_js_1.REPEATS.join(', ')}.`);
+        }
+        const remindAt = args.remind_at !== undefined ? this.validRemind(args.remind_at) : null;
+        const { lists } = await this.load();
+        const today = this.today();
+        const details = (0, todo_format_js_1.parseDetails)('');
+        if (args.list !== undefined && args.list.trim() !== '')
+            details.list = this.resolveList(lists, args.list).id;
+        if (args.due !== undefined)
+            details.due = this.validDay(args.due, 'due');
+        if (args.my_day)
+            details.myDay = today;
+        if (args.important)
+            details.important = true;
+        if (args.note)
+            details.note = args.note;
+        if (args.steps)
+            details.steps = args.steps.map((s) => s.trim()).filter(Boolean).map((s) => ({ id: (0, todo_format_js_1.newId)(), text: s, done: false }));
+        if (args.repeat) {
+            details.repeat = args.repeat;
+            // A repeat needs a day to count from, as in the apps.
+            details.due ??= today;
+        }
+        if (remindAt)
+            details.remindAt = remindAt.toISOString();
+        const row = await this.createTask(text, details);
+        if (remindAt)
+            await this.createReminder(row.id, remindAt);
+        const task = { id: row.id, title: text, details, done: false, createdAt: row.createdAt, updatedAt: row.updatedAt };
+        return `Added to-do (id: ${row.id}).\n${this.describe(task, lists)}`;
+    }
+    async updateTodo(args) {
+        const { tasks, lists } = await this.load();
+        const task = tasks.find((t) => t.id === args.id);
+        if (!task)
+            throw new Error(`No to-do with id ${args.id}. Call list_todos to find it.`);
+        const today = this.today();
+        const details = { ...task.details, steps: task.details.steps.map((s) => ({ ...s })) };
+        let text = task.title;
+        if (args.text !== undefined) {
+            if (!args.text.trim())
+                throw new Error('text cannot be empty.');
+            text = args.text.trim();
+        }
+        if (args.due !== undefined)
+            details.due = args.due === null ? null : this.validDay(args.due, 'due');
+        if (args.my_day !== undefined)
+            details.myDay = args.my_day ? today : null;
+        if (args.important !== undefined)
+            details.important = args.important;
+        if (args.note !== undefined)
+            details.note = args.note;
+        if (args.list !== undefined)
+            details.list = args.list === null || args.list.trim() === '' ? null : this.resolveList(lists, args.list).id;
+        if (args.repeat !== undefined) {
+            if (args.repeat !== null && !todo_format_js_1.REPEATS.includes(args.repeat))
+                throw new Error(`repeat must be one of ${todo_format_js_1.REPEATS.join(', ')}.`);
+            details.repeat = args.repeat;
+            if (args.repeat)
+                details.due ??= today;
+        }
+        if (args.add_steps) {
+            details.steps.push(...args.add_steps.map((s) => s.trim()).filter(Boolean).map((s) => ({ id: (0, todo_format_js_1.newId)(), text: s, done: false })));
+        }
+        if (args.complete_steps) {
+            for (const ref of args.complete_steps) {
+                const step = details.steps.find((s) => s.id === ref) ?? details.steps.find((s) => s.text.trim() === ref.trim());
+                if (!step) {
+                    const known = details.steps.map((s) => `"${s.text}"`).join(', ') || 'none';
+                    throw new Error(`No step "${ref}" on this to-do. Its steps: ${known}.`);
+                }
+                step.done = true;
+            }
+        }
+        // The reminder: a new time replaces any pending one; null cancels it.
+        let remindAt;
+        if (args.remind_at !== undefined) {
+            remindAt = args.remind_at === null ? null : this.validRemind(args.remind_at);
+            details.remindAt = remindAt ? remindAt.toISOString() : null;
+        }
+        const completing = args.done === true && !task.done;
+        const reopening = args.done === false && task.done;
+        if (completing)
+            details.completedAt = this.now().toISOString();
+        if (reopening)
+            details.completedAt = null;
+        const done = completing ? true : reopening ? false : task.done;
+        const body = await this.encrypted(text, (0, todo_format_js_1.serializeDetails)(details));
+        if (completing || reopening)
+            body.archived = done;
+        await this.api.updateNote(task.id, body);
+        if (remindAt !== undefined) {
+            await this.clearReminders(task.id);
+            if (remindAt)
+                await this.createReminder(task.id, remindAt);
+        }
+        const lines = [];
+        if (completing) {
+            // A done task needs no reminder.
+            await this.clearReminders(task.id);
+            const next = (0, todo_format_js_1.nextRepeat)({ ...task, title: text, details }, today);
+            if (next) {
+                const at = next.remindAt ? new Date(next.remindAt) : null;
+                const future = at !== null && at.getTime() > this.now().getTime();
+                const nextDetails = { ...next, remindAt: future ? next.remindAt : null };
+                const row = await this.createTask(text, nextDetails);
+                if (future)
+                    await this.createReminder(row.id, at);
+                lines.push(`It repeats ${next.repeat}: the next one (id: ${row.id}) is due ${next.due}.`);
+            }
+        }
+        const updated = { ...task, title: text, details, done };
+        return [`Updated to-do.`, this.describe(updated, lists), ...lines].join('\n');
+    }
+    async createList(args) {
+        const name = args.name?.trim();
+        if (!name)
+            throw new Error('name is required.');
+        if (args.color !== undefined && !HEX.test(args.color))
+            throw new Error(`color must be a hex color like #5c7fb5, got "${args.color}".`);
+        const { lists } = await this.load();
+        if (lists.some((l) => l.name.trim().toLowerCase() === name.toLowerCase())) {
+            throw new Error(`There is already a list called "${name}".`);
+        }
+        const meta = (0, todo_format_js_1.parseListMeta)('');
+        if (args.color)
+            meta.color = args.color.toLowerCase();
+        if (args.emoji?.trim())
+            meta.emoji = args.emoji.trim();
+        const row = await this.api.createNote({
+            ...(await this.encrypted(name, (0, todo_format_js_1.serializeListMeta)(meta))),
+            type: todo_format_js_1.TODO_LIST_NOTE_TYPE,
+            folderId: null,
+        });
+        return `Created the list "${name}" (id: ${row.id}).`;
+    }
+}
+exports.TodoService = TodoService;

package/dist/cjs/tool-annotations.d.ts

@@ -47,6 +47,11 @@ export declare const TOOL_ANNOTATIONS: {
     readonly move_attachment: VirlowToolAnnotations;
     readonly delete_attachment: VirlowToolAnnotations;
     readonly restore_attachment: VirlowToolAnnotations;
+    readonly list_todos: VirlowToolAnnotations;
+    readonly list_todo_lists: VirlowToolAnnotations;
+    readonly add_todo: VirlowToolAnnotations;
+    readonly update_todo: VirlowToolAnnotations;
+    readonly create_todo_list: VirlowToolAnnotations;
 };
 export type ToolName = keyof typeof TOOL_ANNOTATIONS;
 /**

package/dist/cjs/tool-annotations.js

@@ -41,6 +41,8 @@ exports.toolConfig = toolConfig;
  * - unlock and lock change session state, not data, so neither is read-only
  *   and neither is destructive. lock only discards this session's in-memory
  *   key and caches; nothing stored is touched and unlock restores access.
+ * - update_todo is destructive: new text, a note or a list replaces what was
+ *   there. add_todo and create_todo_list only add.
  * - read_attachment depends on the host. Without file access it only returns
  *   the file. With it (local CLI, desktop app) `save_to` writes to the user's
  *   disk and `overwrite: true` replaces an existing file, so it is a
@@ -110,6 +112,12 @@ exports.TOOL_ANNOTATIONS = {
     move_attachment: destructive('Move an attachment'),
     delete_attachment: destructive('Delete an attachment'),
     restore_attachment: additive('Restore an attachment'),
+    // to-do
+    list_todos: read('List to-dos'),
+    list_todo_lists: read('List to-do lists'),
+    add_todo: additive('Add a to-do'),
+    update_todo: destructive('Update a to-do'),
+    create_todo_list: additive('Create a to-do list'),
 };
 /**
  * A tool's annotations for this host. Only read_attachment varies: with file

package/dist/index.d.ts

@@ -22,6 +22,8 @@ export { ATTRS_MAX_BYTES, TAGS_PROP, decodeAttrs, decodeSchema, defineProp, empt
 export type { FolderSchemaV1, NoteAttrsV1, PropDefinition, PropOption, PropType, PropValue, TagsValue } from './attrs.js';
 export { buildTitleMatcher, extractLinkIds, htmlToText } from './attrs-extract.js';
 export type { TitleEntry, TitleMatcher } from './attrs-extract.js';
+export { TodoService } from './todos.js';
+export type { AddTodoArgs, CreateTodoListArgs, ListTodosArgs, UpdateTodoArgs } from './todos.js';
 /**
  * The MCP tool surface is NOT exported here. It lives at the `/tools` subpath,
  * which is ESM-only, because it depends on @modelcontextprotocol/sdk — an

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAC/C,YAAY,EAAE,OAAO,EAAE,eAAe,EAAE,SAAS,EAAE,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,WAAW,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAC1I,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAChD,YAAY,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAC3D,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACtD,YAAY,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAC7D,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC7E,OAAO,EACL,gBAAgB,EAChB,SAAS,EACT,eAAe,EACf,mBAAmB,EACnB,cAAc,GACf,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACrE,OAAO,EACL,yBAAyB,EACzB,qBAAqB,EACrB,uBAAuB,EACvB,gBAAgB,EAChB,kBAAkB,EAClB,iBAAiB,EACjB,aAAa,EACb,eAAe,EACf,aAAa,EACb,cAAc,EACd,iBAAiB,GAClB,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACrF,OAAO,EACL,kBAAkB,EAClB,eAAe,EACf,iBAAiB,GAClB,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAChE,YAAY,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,YAAY,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC/D,OAAO,EAAE,yBAAyB,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACnF,OAAO,EACL,eAAe,EACf,SAAS,EACT,WAAW,EACX,YAAY,EACZ,UAAU,EACV,UAAU,EACV,WAAW,EACX,WAAW,EACX,YAAY,EACZ,SAAS,EACT,UAAU,EACV,YAAY,EACZ,WAAW,EACX,aAAa,EACb,UAAU,EACV,QAAQ,GACT,MAAM,YAAY,CAAC;AACpB,YAAY,EAAE,cAAc,EAAE,WAAW,EAAE,cAAc,EAAE,UAAU,EAAE,QAAQ,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAC1H,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACnF,YAAY,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEnE;;;;;;;;;;GAUG"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAC/C,YAAY,EAAE,OAAO,EAAE,eAAe,EAAE,SAAS,EAAE,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,WAAW,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAC1I,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAChD,YAAY,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAC3D,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACtD,YAAY,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAC7D,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC7E,OAAO,EACL,gBAAgB,EAChB,SAAS,EACT,eAAe,EACf,mBAAmB,EACnB,cAAc,GACf,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACrE,OAAO,EACL,yBAAyB,EACzB,qBAAqB,EACrB,uBAAuB,EACvB,gBAAgB,EAChB,kBAAkB,EAClB,iBAAiB,EACjB,aAAa,EACb,eAAe,EACf,aAAa,EACb,cAAc,EACd,iBAAiB,GAClB,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACrF,OAAO,EACL,kBAAkB,EAClB,eAAe,EACf,iBAAiB,GAClB,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAChE,YAAY,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,YAAY,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC/D,OAAO,EAAE,yBAAyB,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACnF,OAAO,EACL,eAAe,EACf,SAAS,EACT,WAAW,EACX,YAAY,EACZ,UAAU,EACV,UAAU,EACV,WAAW,EACX,WAAW,EACX,YAAY,EACZ,SAAS,EACT,UAAU,EACV,YAAY,EACZ,WAAW,EACX,aAAa,EACb,UAAU,EACV,QAAQ,GACT,MAAM,YAAY,CAAC;AACpB,YAAY,EAAE,cAAc,EAAE,WAAW,EAAE,cAAc,EAAE,UAAU,EAAE,QAAQ,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAC1H,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACnF,YAAY,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACnE,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACzC,YAAY,EAAE,WAAW,EAAE,kBAAkB,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjG;;;;;;;;;;GAUG"}

package/dist/index.js

@@ -11,6 +11,7 @@ export { EmbeddingCache } from './embedding-cache.js';
 export { MEMORIES_DISABLED_MESSAGE, memoriesAllowed } from './memories-enabled.js';
 export { ATTRS_MAX_BYTES, TAGS_PROP, decodeAttrs, decodeSchema, defineProp, emptyAttrs, emptySchema, encodeAttrs, encodeSchema, newPropId, removeProp, reorderProps, sortedProps, tagsFromAttrs, updateProp, withTags, } from './attrs.js';
 export { buildTitleMatcher, extractLinkIds, htmlToText } from './attrs-extract.js';
+export { TodoService } from './todos.js';
 /**
  * The MCP tool surface is NOT exported here. It lives at the `/tools` subpath,
  * which is ESM-only, because it depends on @modelcontextprotocol/sdk — an

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAE/C,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAEhD,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAC3D,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAEtD,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAE7D,OAAO,EACL,gBAAgB,EAChB,SAAS,EACT,eAAe,EACf,mBAAmB,EACnB,cAAc,GACf,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACL,yBAAyB,EACzB,qBAAqB,EACrB,uBAAuB,EACvB,gBAAgB,EAChB,kBAAkB,EAClB,iBAAiB,EACjB,aAAa,EACb,eAAe,EACf,aAAa,EACb,cAAc,EACd,iBAAiB,GAClB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,kBAAkB,EAClB,eAAe,EACf,iBAAiB,GAClB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAEhE,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEtD,OAAO,EAAE,yBAAyB,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACnF,OAAO,EACL,eAAe,EACf,SAAS,EACT,WAAW,EACX,YAAY,EACZ,UAAU,EACV,UAAU,EACV,WAAW,EACX,WAAW,EACX,YAAY,EACZ,SAAS,EACT,UAAU,EACV,YAAY,EACZ,WAAW,EACX,aAAa,EACb,UAAU,EACV,QAAQ,GACT,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAGnF;;;;;;;;;;GAUG"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAE/C,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAEhD,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAC3D,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAEtD,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAE7D,OAAO,EACL,gBAAgB,EAChB,SAAS,EACT,eAAe,EACf,mBAAmB,EACnB,cAAc,GACf,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACL,yBAAyB,EACzB,qBAAqB,EACrB,uBAAuB,EACvB,gBAAgB,EAChB,kBAAkB,EAClB,iBAAiB,EACjB,aAAa,EACb,eAAe,EACf,aAAa,EACb,cAAc,EACd,iBAAiB,GAClB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,kBAAkB,EAClB,eAAe,EACf,iBAAiB,GAClB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAEhE,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEtD,OAAO,EAAE,yBAAyB,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACnF,OAAO,EACL,eAAe,EACf,SAAS,EACT,WAAW,EACX,YAAY,EACZ,UAAU,EACV,UAAU,EACV,WAAW,EACX,WAAW,EACX,YAAY,EACZ,SAAS,EACT,UAAU,EACV,YAAY,EACZ,WAAW,EACX,aAAa,EACb,UAAU,EACV,QAAQ,GACT,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAEnF,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAGzC;;;;;;;;;;GAUG"}

package/dist/todo-format.d.ts

@@ -0,0 +1,112 @@
+/**
+ * To-do: the stored format, shared with the iOS app.
+ *
+ * A task is a note of type `todo`: its text is the encrypted title, its
+ * details are the JSON below as the encrypted content, and the note's
+ * `archived` flag means done. A list is a note of type `todolist`: its name
+ * is the encrypted title and `{v, color, emoji}` the encrypted content. The
+ * API lists neither with notes, so apps that predate them never show them.
+ *
+ * Missing keys read as their defaults (the first iOS build stored tasks with
+ * empty content), and keys this version does not know are kept on write, so
+ * a newer app's additions survive an older app's edit.
+ */
+export declare const TODO_NOTE_TYPE = "todo";
+export declare const TODO_LIST_NOTE_TYPE = "todolist";
+export type Repeat = 'daily' | 'weekdays' | 'weekly' | 'monthly' | 'yearly';
+export declare const REPEATS: Repeat[];
+export interface Step {
+    id: string;
+    text: string;
+    done: boolean;
+}
+export interface TaskDetails {
+    v: 1;
+    /** A todolist note id; null is the built-in Tasks list. */
+    list: string | null;
+    important: boolean;
+    /** The local day the task was put in My Day; it is in My Day only that day. */
+    myDay: string | null;
+    /** Local day, YYYY-MM-DD. */
+    due: string | null;
+    /** ISO time of the pending reminder in /api/reminders for this task. */
+    remindAt: string | null;
+    repeat: Repeat | null;
+    steps: Step[];
+    note: string;
+    completedAt: string | null;
+    /** Keys a newer app wrote, kept as they are. */
+    [key: string]: unknown;
+}
+export interface ListMeta {
+    v: 1;
+    color: string;
+    emoji: string | null;
+    [key: string]: unknown;
+}
+export declare const DEFAULT_LIST_COLOR = "#5c7fb5";
+export declare function parseDetails(raw: string): TaskDetails;
+export declare function serializeDetails(details: TaskDetails): string;
+export declare function parseListMeta(raw: string): ListMeta;
+export declare function serializeListMeta(meta: ListMeta): string;
+export declare function newId(): string;
+/** A local day as YYYY-MM-DD. */
+export declare function dayKey(date: Date): string;
+/** Local midnight of a YYYY-MM-DD day. */
+export declare function fromDayKey(key: string): Date;
+export declare function addDays(key: string, days: number): string;
+/** Whole days from a to b (b later is positive), by local calendar. */
+export declare function daysBetween(a: string, b: string): number;
+/**
+ * The next day a repeating task is due, after `from`. Month and year steps
+ * keep the day of the month where it exists and use the month's last day
+ * where it does not (Jan 31 → Feb 28).
+ */
+export declare function nextOccurrence(repeat: Repeat, from: string): string;
+export interface Task {
+    id: string;
+    title: string;
+    details: TaskDetails;
+    done: boolean;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface TodoList {
+    id: string;
+    name: string;
+    meta: ListMeta;
+    createdAt: string;
+}
+export type SmartListId = 'myday' | 'important' | 'planned' | 'tasks';
+/** A smart list, or a todolist note id. */
+export type ListKey = SmartListId | `list:${string}`;
+export declare const SMART_LISTS: {
+    id: SmartListId;
+    label: string;
+}[];
+export declare function listKey(listId: string): ListKey;
+export declare function listIdOf(key: ListKey): string | null;
+export declare function inList(task: Task, key: ListKey, today: string): boolean;
+/** Open tasks oldest first, the order they were written in. */
+export declare function openTasks(tasks: Task[], key: ListKey, today: string): Task[];
+/** Done tasks, most recently finished first. */
+export declare function completedTasks(tasks: Task[], key: ListKey, today: string): Task[];
+export type PlannedGroup = 'Overdue' | 'Today' | 'Tomorrow' | 'Later';
+/** Planned's open tasks in groups, each by due day then age. Empty groups are left out. */
+export declare function plannedGroups(tasks: Task[], today: string): {
+    group: PlannedGroup;
+    tasks: Task[];
+}[];
+/** What a task added to this list starts with. */
+export declare function detailsForNewTask(key: ListKey, today: string): TaskDetails;
+/**
+ * The task that follows a repeating one when it is done: the same text, list,
+ * importance, repeat, note and steps (all open again), due on the next
+ * occurrence after its due day, or after today when it had none. A reminder
+ * moves by the same number of days.
+ */
+export declare function nextRepeat(task: Task, today: string): TaskDetails | null;
+export declare function repeatLabel(repeat: Repeat): string;
+/** "Today", "Tomorrow", "Yesterday", "Mon, Oct 20", or with the year when not this year. */
+export declare function dueLabel(due: string, today: string): string;
+//# sourceMappingURL=todo-format.d.ts.map

package/dist/todo-format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"todo-format.d.ts","sourceRoot":"","sources":["../src/todo-format.ts"],"names":[],"mappings":"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"}