aibroker 0.25.0 → 0.26.0

package/dist/daemon/todoist-inbox.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"todoist-inbox.d.ts","sourceRoot":"","sources":["../../src/daemon/todoist-inbox.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAuBH,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,uEAAuE;IACvE,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,YAAY,EAAE,CAAC;IACzB,iDAAiD;IACjD,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,KAAK;IACpB,OAAO,EAAE,UAAU,EAAE,CAAC;IACtB,sEAAsE;IACtE,SAAS,EAAE,MAAM,CAAC;IAClB,mDAAmD;IACnD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,6EAA6E;IAC7E,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAkBD,kEAAkE;AAClE,wBAAgB,QAAQ,IAAI,MAAM,GAAG,SAAS,CAE7C;AAED,uDAAuD;AACvD,wBAAgB,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAEzC;AAED,MAAM,WAAW,cAAc;IAC7B,wEAAwE;IACxE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,UAAU,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CACpD;AAED;;;;;;GAMG;AACH,wBAAsB,oBAAoB,CACxC,SAAS,GAAE,OAAO,KAAa,GAC9B,OAAO,CAAC,cAAc,EAAE,CAAC,CAuB3B;AAED;;;;;GAKG;AACH,wBAAsB,UAAU,CAAC,IAAI,GAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,OAAO,CAAC,KAAK,CAAC,CA+C9E;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,CAuBhD"}

package/dist/daemon/todoist-inbox.js

@@ -0,0 +1,169 @@
+/**
+ * daemon/todoist-inbox.ts — what has been commented on since you last looked.
+ *
+ * A push per reply tells you something happened the moment it happens. That is
+ * the wrong shape for the actual problem: a tree of hundreds of tasks, comments
+ * arriving on any of them, and no way to see which ones are waiting for you.
+ * Todoist itself will not help — it does not notify an account about its own
+ * activity, and every comment the bridge writes is written as you, so the one
+ * event you most want to know about is precisely the one Todoist stays quiet
+ * about.
+ *
+ * So this reads the activity log — one request, not one per task — groups the
+ * comments by the task they landed on, and hands back a list you can jump from.
+ * The read marker is stored, so "what's new" means new since you last asked
+ * rather than new since some arbitrary window.
+ *
+ * The marker is only advanced when the caller says so. A digest that marks
+ * everything read as a side effect of being built would lose the whole backlog
+ * the first time a scheduled job ran before you saw it.
+ */
+import { join } from "node:path";
+import { homedir } from "node:os";
+import { loadJson, saveJson } from "../core/json-store.js";
+import { log } from "../core/log.js";
+import { getAccessToken } from "./todoist-oauth.js";
+import { fetchTaskBrief } from "./todoist-reply.js";
+const FILE = join(homedir(), ".aibroker", "todoist-inbox.json");
+/** How many activity records to pull. Todoist caps the page; this is the ask. */
+const ACTIVITY_LIMIT = 100;
+/**
+ * How many tasks get their title resolved.
+ *
+ * Each title is one API call. A digest of forty tasks is not a digest, and
+ * forty extra calls to build one is worse, so the list is capped and the
+ * remainder is reported as a count rather than silently dropped.
+ */
+const RESOLVE_LIMIT = 20;
+function read() {
+    const r = loadJson(FILE);
+    if (r.status === "ok" && r.data)
+        return r.data;
+    if (r.status === "unreadable") {
+        // Treat an unreadable marker as "never looked" rather than "all seen":
+        // showing a comment twice is a nuisance, hiding one is the failure this
+        // whole module exists to end.
+        log(`todoist-inbox: ${FILE} is unreadable — treating as never read`);
+    }
+    return {};
+}
+/** When the inbox was last marked read. Undefined means never. */
+export function lastSeen() {
+    return read().lastSeen;
+}
+/** Record that everything up to `at` has been seen. */
+export function markSeen(at) {
+    saveJson(FILE, { lastSeen: at });
+}
+/**
+ * Comment events, newest first.
+ *
+ * Returns an empty list rather than throwing when Todoist cannot be reached —
+ * the caller is building a digest, and a digest that fails loudly on a network
+ * blip is a digest that gets turned off.
+ */
+export async function fetchCommentActivity(fetchImpl = fetch) {
+    const token = await getAccessToken();
+    if (!token) {
+        log("todoist-inbox: no Todoist authorisation on file");
+        return [];
+    }
+    const url = `https://api.todoist.com/api/v1/activities` +
+        `?object_type=note&event_type=added&limit=${ACTIVITY_LIMIT}`;
+    try {
+        const res = await fetchImpl(url, {
+            headers: { authorization: `${token.token_type} ${token.access_token}` },
+        });
+        if (!res.ok) {
+            log(`todoist-inbox: activity request failed with ${res.status}`);
+            return [];
+        }
+        const body = JSON.parse(await res.text());
+        return Array.isArray(body.results) ? body.results : [];
+    }
+    catch (e) {
+        log(`todoist-inbox: could not read activity — ${e instanceof Error ? e.message : String(e)}`);
+        return [];
+    }
+}
+/**
+ * Group new comments by the task they landed on.
+ *
+ * `since` defaults to the stored read marker. Pass it explicitly to look
+ * further back without disturbing the marker.
+ */
+export async function buildInbox(opts = {}) {
+    const since = opts.since ?? lastSeen();
+    const records = await fetchCommentActivity();
+    const fresh = records.filter((r) => {
+        if (!r.event_date || !r.parent_item_id)
+            return false;
+        return since ? r.event_date > since : true;
+    });
+    const newest = records.map((r) => r.event_date).filter(Boolean).sort().pop();
+    const byTask = new Map();
+    for (const r of fresh) {
+        const id = r.parent_item_id;
+        const entry = byTask.get(id) ?? {
+            taskId: id,
+            projectId: r.parent_project_id,
+            comments: [],
+            latest: r.event_date,
+        };
+        entry.comments.push({
+            at: r.event_date,
+            content: r.extra_data?.content ?? "",
+            client: r.extra_data?.client,
+        });
+        if (r.event_date > entry.latest)
+            entry.latest = r.event_date;
+        byTask.set(id, entry);
+    }
+    const entries = [...byTask.values()].sort((a, b) => b.latest.localeCompare(a.latest));
+    const resolve = entries.slice(0, RESOLVE_LIMIT);
+    // Titles in parallel — a serial loop over twenty tasks is a visible pause.
+    await Promise.all(resolve.map(async (e) => {
+        const brief = await fetchTaskBrief(e.taskId);
+        e.title = brief.title;
+        e.url = brief.url;
+    }));
+    return {
+        entries: resolve,
+        truncated: Math.max(0, entries.length - resolve.length),
+        since,
+        newest,
+    };
+}
+/**
+ * The digest as text, ready for a phone.
+ *
+ * A deleted task resolves to no title; it is still listed, because "a comment
+ * arrived on something that no longer exists" is information, not noise.
+ */
+export function formatInbox(inbox) {
+    if (inbox.entries.length === 0) {
+        return inbox.since
+            ? `No new Todoist comments since ${inbox.since.slice(0, 16).replace("T", " ")}.`
+            : "No Todoist comments found.";
+    }
+    const lines = [
+        `📋 ${inbox.entries.length} task${inbox.entries.length === 1 ? "" : "s"} with new comments`,
+        "",
+    ];
+    for (const e of inbox.entries) {
+        const when = e.latest.slice(11, 16);
+        lines.push(`• ${e.title ?? `(task ${e.taskId})`} — ${when}`);
+        const last = e.comments[0];
+        if (last?.content)
+            lines.push(`  ${last.content.replace(/\s+/g, " ").slice(0, 140)}`);
+        if (e.comments.length > 1)
+            lines.push(`  (+${e.comments.length - 1} more)`);
+        if (e.url)
+            lines.push(`  ${e.url}`);
+    }
+    if (inbox.truncated > 0) {
+        lines.push("", `…and ${inbox.truncated} more task${inbox.truncated === 1 ? "" : "s"} not shown.`);
+    }
+    return lines.join("\n");
+}
+//# sourceMappingURL=todoist-inbox.js.map

package/dist/daemon/todoist-inbox.js.map

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

package/dist/daemon/todoist-mirror.d.ts

@@ -0,0 +1,97 @@
+/**
+ * daemon/todoist-mirror.ts — new comments, filed where you will actually see them.
+ *
+ * Todoist never notifies an account about its own activity, and every comment a
+ * session writes is written as the account owner. So a reply lands on a task
+ * somewhere in a tree of hundreds and is, from the outside, indistinguishable
+ * from nothing having happened. `todoist-inbox.ts` answers that on demand. This
+ * answers it without being asked: each new comment becomes a task in a mirror
+ * project, grouped into a section named after the project the comment came
+ * from, linking straight back to the conversation.
+ *
+ * The sections are managed, not configured. A project that gets commented on
+ * gains a section; a section whose items have all been dealt with is removed
+ * again on the next run. That keeps the mirror shaped like what is currently
+ * outstanding rather than like a history of everything that ever happened —
+ * a list nobody prunes is a list nobody reads.
+ *
+ * Three things this must never do, each of which it would do naturally:
+ *
+ *  - **Feed itself.** A comment on a mirror task is a comment, and mirroring it
+ *    would create a task, whose comments would create tasks. Anything parented
+ *    in the mirror project is skipped, and the mirror project is never an
+ *    ingress project, so its tasks cannot be dispatched as work either.
+ *  - **Replay.** The read marker moves only after a successful pass, and every
+ *    mirrored comment id is remembered, because a marker alone loses a race
+ *    with a comment posted in the same second it was written.
+ *  - **Delete a section someone else made.** Only sections this module created
+ *    are pruned, tracked by id, never by name.
+ */
+/** The mirror project, or undefined when mirroring is switched off. */
+export declare function mirrorProjectId(): string | undefined;
+export interface MirrorResult {
+    mirrored: number;
+    sectionsCreated: number;
+    sectionsRemoved: number;
+    skipped: number;
+}
+/**
+ * Mirror everything commented on since the last pass.
+ *
+ * Safe to call repeatedly: the marker only advances at the end, the seen-set
+ * makes a repeated pass a no-op rather than a duplicate, and concurrent callers
+ * share one run.
+ */
+export declare function syncMirror(fetchImpl?: typeof fetch): Promise<MirrorResult>;
+/**
+ * Mirror a comment we just wrote, without going back to Todoist to find it.
+ *
+ * This is the primary path, and polling is not the fallback for it — retrying
+ * is. The reasoning: Todoist stays silent only about the account's OWN
+ * activity, and the bridge writes as the account. Everyone else's comments it
+ * already notifies about. So the set of comments that need mirroring is exactly
+ * the set we produced, and we know each one at the moment we write it. Reading
+ * the activity log to rediscover our own writes was a round trip to learn what
+ * we already knew, and it put a five-minute delay on the one case somebody is
+ * actually watching.
+ *
+ * Failures are queued rather than dropped and retried on the next write, so
+ * removing the poll does not reintroduce silent loss.
+ */
+export declare function mirrorComment(comment: {
+    taskId: string;
+    commentId?: string;
+    text: string;
+}, fetchImpl?: typeof fetch): Promise<boolean>;
+/**
+ * The source task a mirror entry points at, read from its description link.
+ *
+ * Stateless on purpose. A stored map would have to survive restarts, stay in
+ * step with tasks the user deletes by hand, and be pruned; the link is already
+ * in the entry, is the thing the human clicks, and cannot drift out of sync
+ * with the entry it belongs to.
+ */
+export declare function sourceTaskOf(description: string | undefined): string | undefined;
+/**
+ * Carry a comment written on a mirror entry back to the real task.
+ *
+ * The mirror is where the reader's attention is, so replying there instead of
+ * on the source task is not a mistake anyone will stop making — it is the
+ * obvious thing to do, and Todoist offers no way to deep-link to an individual
+ * comment that would make the source easier to reach than the entry in front of
+ * you. So rather than train the human, carry the comment.
+ *
+ * Loop safety rests on one asymmetry: this writes to the SOURCE task, and the
+ * direct mirror path is only ever invoked by `todoist_reply`. Nothing re-reads
+ * this write, so there is no cycle to break. Agent-marked comments are ignored
+ * regardless, so a session answering inside the mirror cannot bounce either.
+ */
+export declare function mirrorBack(ev: {
+    taskId: string;
+    text: string;
+    projectId?: string;
+}, fetchImpl?: typeof fetch): Promise<{
+    carried: boolean;
+    reason?: string;
+}>;
+//# sourceMappingURL=todoist-mirror.d.ts.map

package/dist/daemon/todoist-mirror.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"todoist-mirror.d.ts","sourceRoot":"","sources":["../../src/daemon/todoist-mirror.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAqEH,uEAAuE;AACvE,wBAAgB,eAAe,IAAI,MAAM,GAAG,SAAS,CAGpD;AA2HD,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe,EAAE,MAAM,CAAC;IACxB,eAAe,EAAE,MAAM,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;CACjB;AAaD;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,SAAS,GAAE,OAAO,KAAa,GAAG,OAAO,CAAC,YAAY,CAAC,CAIjF;AAgID;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,aAAa,CACjC,OAAO,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,EAC7D,SAAS,GAAE,OAAO,KAAa,GAC9B,OAAO,CAAC,OAAO,CAAC,CA+BlB;AAsED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAGhF;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,UAAU,CAC9B,EAAE,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,EACxD,SAAS,GAAE,OAAO,KAAa,GAC9B,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAwBhD"}