@aitne/daemon 0.1.0

package/dist/services/notion.js

@@ -0,0 +1,350 @@
+import { createLogger } from "../logging.js";
+const logger = createLogger("notion-service");
+/**
+ * Local narrowing predicate so this module has no static value import
+ * from `@notionhq/client` — the package is imported dynamically inside
+ * `init()` and treated as optional.
+ *
+ * We discriminate on `object === "page"` rather than duck-typing on
+ * `properties` / `last_edited_time`, because `DataSourceObjectResponse`
+ * also has both of those fields (with different semantics) and would
+ * slip through a structural check.
+ */
+function isFullPage(page) {
+    return page != null && page.object === "page";
+}
+/**
+ * NotionService — sole owner of the `@notionhq/client` instance.
+ *
+ * All Notion reads and writes from the daemon go through this class:
+ *  - NotionPoller calls `queryUpdatedSince` and `queryTrashedSince`
+ *  - The Hono route layer at `api/routes/notion.ts` delegates every
+ *    endpoint here
+ *
+ * Secrets stay in SecretBroker; the client is (re)built in `init()`.
+ */
+export class NotionService {
+    secretBroker;
+    databaseIds;
+    client = null;
+    constructor(config, secretBroker) {
+        this.secretBroker = secretBroker;
+        this.databaseIds = config.notionDatabaseIds;
+    }
+    get available() {
+        return this.client !== null;
+    }
+    async init() {
+        const apiKey = await this.secretBroker.getNotionApiKey();
+        if (!apiKey) {
+            logger.warn("Notion API key not configured");
+            return;
+        }
+        try {
+            const mod = await import("@notionhq/client");
+            this.client = new mod.Client({ auth: apiKey });
+            logger.info({ databases: Object.keys(this.databaseIds) }, "Notion service initialized");
+        }
+        catch {
+            throw new Error("@notionhq/client not installed. Run: pnpm --filter @aitne/daemon add @notionhq/client");
+        }
+    }
+    /** List human-readable database labels configured via `PA_NOTION_DATABASE_IDS`. */
+    listDatabases() {
+        return Object.entries(this.databaseIds).map(([label, id]) => ({ label, id }));
+    }
+    /**
+     * Resolve a label (e.g. `"tasks"`) or raw UUID to a Notion data-source ID.
+     * Returns `null` if the label is unknown — the caller emits a 404.
+     */
+    resolveDatabaseId(labelOrId) {
+        if (this.databaseIds[labelOrId])
+            return this.databaseIds[labelOrId];
+        // Allow raw UUIDs / hyphenated IDs to pass through so the agent can
+        // target databases outside the configured label map.
+        if (/^[0-9a-f-]{32,36}$/i.test(labelOrId))
+            return labelOrId;
+        return null;
+    }
+    requireClient() {
+        if (!this.client) {
+            throw new Error("notion_not_configured");
+        }
+        return this.client;
+    }
+    // ─────────────────────────────────────────────────────────────
+    // Read: query
+    // ─────────────────────────────────────────────────────────────
+    async queryDatabase(params) {
+        const client = this.requireClient();
+        const response = await client.dataSources.query({
+            data_source_id: params.databaseId,
+            filter: params.filter,
+            sorts: params.sorts,
+            page_size: Math.min(params.pageSize ?? 20, 100),
+            start_cursor: params.startCursor,
+            in_trash: params.inTrash,
+        });
+        return {
+            results: response.results
+                .filter(isFullPage)
+                .map((page) => simplifyPage(page)),
+            hasMore: response.has_more,
+            nextCursor: response.next_cursor,
+        };
+    }
+    /**
+     * Paginated async iterator for poller use — yields every page
+     * edited strictly after `lastEditedTime` across all pages of results.
+     * Walks `has_more` / `next_cursor` until the data source is exhausted.
+     */
+    async *queryUpdatedSince(databaseId, lastEditedTime, opts = {}) {
+        const client = this.requireClient();
+        let cursor;
+        do {
+            const response = await client.dataSources.query({
+                data_source_id: databaseId,
+                filter: {
+                    timestamp: "last_edited_time",
+                    last_edited_time: { after: lastEditedTime },
+                },
+                sorts: [{ timestamp: "last_edited_time", direction: "ascending" }],
+                page_size: 100,
+                start_cursor: cursor,
+                in_trash: opts.inTrash,
+            });
+            for (const page of response.results) {
+                if (isFullPage(page))
+                    yield page;
+            }
+            cursor = response.has_more ? (response.next_cursor ?? undefined) : undefined;
+        } while (cursor);
+    }
+    // ─────────────────────────────────────────────────────────────
+    // Read: search
+    // ─────────────────────────────────────────────────────────────
+    async search(params) {
+        const client = this.requireClient();
+        const searchParams = {
+            query: params.query,
+            sort: {
+                timestamp: "last_edited_time",
+                direction: params.sortDirection ?? "descending",
+            },
+            page_size: Math.min(params.pageSize ?? 20, 100),
+            start_cursor: params.startCursor,
+        };
+        if (params.filterType) {
+            searchParams.filter = { property: "object", value: params.filterType };
+        }
+        const response = await client.search(searchParams);
+        return {
+            results: response.results.map(simplifySearchHit).filter((r) => r !== null),
+            hasMore: response.has_more,
+            nextCursor: response.next_cursor,
+        };
+    }
+    // ─────────────────────────────────────────────────────────────
+    // Read: page
+    // ─────────────────────────────────────────────────────────────
+    async getPage(pageId, opts = {}) {
+        const client = this.requireClient();
+        const page = await client.pages.retrieve({ page_id: pageId });
+        if (!isFullPage(page)) {
+            throw new Error("notion_page_partial_response");
+        }
+        let markdown = null;
+        let markdownTruncated = false;
+        let unknownBlockIds = [];
+        if (opts.includeMarkdown ?? true) {
+            try {
+                const md = await client.pages.retrieveMarkdown({
+                    page_id: pageId,
+                    include_transcript: opts.includeTranscript,
+                });
+                markdown = md.markdown;
+                markdownTruncated = md.truncated;
+                unknownBlockIds = md.unknown_block_ids;
+            }
+            catch (err) {
+                // Markdown fetch is best-effort — some block types (databases,
+                // embeds) may not be representable as markdown. Log but still
+                // return the properties so the caller can keep working.
+                logger.warn({ err, pageId }, "Notion markdown fetch failed");
+            }
+        }
+        return {
+            ...simplifyPage(page),
+            markdown,
+            markdownTruncated,
+            unknownBlockIds,
+        };
+    }
+    // ─────────────────────────────────────────────────────────────
+    // Write: create / update / archive
+    // ─────────────────────────────────────────────────────────────
+    async createPage(params) {
+        const client = this.requireClient();
+        const response = await client.pages.create({
+            parent: params.parent,
+            properties: params.properties,
+            icon: params.icon,
+            cover: params.cover,
+            markdown: params.markdown,
+            children: params.children,
+        });
+        if (!isFullPage(response)) {
+            throw new Error("notion_create_partial_response");
+        }
+        return simplifyPage(response);
+    }
+    async updatePageProperties(pageId, body) {
+        const client = this.requireClient();
+        const response = await client.pages.update({ page_id: pageId, ...body });
+        if (!isFullPage(response)) {
+            throw new Error("notion_update_partial_response");
+        }
+        return simplifyPage(response);
+    }
+    /** Edit the markdown content of a page via v5's `pages.updateMarkdown` endpoint. */
+    async updatePageContent(pageId, mode) {
+        const client = this.requireClient();
+        await client.pages.updateMarkdown(buildMarkdownUpdateArgs(pageId, mode));
+    }
+    /** Move a page to trash (recoverable for 30 days — Notion's own retention). */
+    async archivePage(pageId) {
+        return this.updatePageProperties(pageId, { in_trash: true });
+    }
+}
+/* ------------------------------------------------------------------ *
+ * Helpers
+ * ------------------------------------------------------------------ */
+export function simplifyPage(page) {
+    return {
+        id: page.id,
+        url: page.url,
+        lastEditedTime: page.last_edited_time,
+        createdTime: page.created_time,
+        inTrash: Boolean(page.in_trash ?? page.archived),
+        icon: page.icon,
+        cover: page.cover,
+        parent: page.parent,
+        properties: flattenProperties(page.properties),
+    };
+}
+export function flattenProperties(props) {
+    const out = {};
+    for (const [name, prop] of Object.entries(props)) {
+        out[name] = extractPropertyValue(prop);
+    }
+    return out;
+}
+function extractPropertyValue(prop) {
+    switch (prop.type) {
+        case "title":
+        case "rich_text": {
+            const arr = prop[prop.type];
+            return arr?.map((t) => t.plain_text).join("") ?? "";
+        }
+        case "number":
+            return prop.number ?? null;
+        case "select":
+            return prop.select?.name ?? null;
+        case "multi_select":
+            return prop.multi_select?.map((s) => s.name) ?? [];
+        case "date":
+            return prop.date ?? null;
+        case "checkbox":
+            return Boolean(prop.checkbox);
+        case "url":
+            return prop.url ?? null;
+        case "email":
+            return prop.email ?? null;
+        case "phone_number":
+            return prop.phone_number ?? null;
+        case "status":
+            return prop.status?.name ?? null;
+        case "relation":
+            return prop.relation?.map((r) => r.id) ?? [];
+        case "people":
+            return prop.people?.map((p) => p.id) ?? [];
+        case "files":
+            return prop.files?.map((f) => f.name) ?? [];
+        case "formula":
+            return prop.formula ?? null;
+        case "created_time":
+        case "last_edited_time":
+            return prop[prop.type] ?? null;
+        case "unique_id":
+            return prop.unique_id ?? null;
+        default:
+            return null;
+    }
+}
+function simplifySearchHit(hit) {
+    const object = hit.object;
+    if (object !== "page" && object !== "data_source")
+        return null;
+    let title = "";
+    if (object === "page" && hit.properties) {
+        for (const prop of Object.values(hit.properties)) {
+            if (prop.type === "title") {
+                const arr = prop.title;
+                title = arr?.map((t) => t.plain_text).join("") ?? "";
+                break;
+            }
+        }
+    }
+    else if (object === "data_source") {
+        const arr = hit.title;
+        title = arr?.map((t) => t.plain_text).join("") ?? "";
+    }
+    return {
+        id: hit.id,
+        object: object,
+        title,
+        url: hit.url ?? null,
+        lastEditedTime: hit.last_edited_time ?? null,
+        parent: hit.parent ?? null,
+    };
+}
+function buildMarkdownUpdateArgs(pageId, mode) {
+    switch (mode.kind) {
+        case "append":
+            return {
+                page_id: pageId,
+                type: "insert_content",
+                insert_content: { content: mode.content, after: mode.after },
+            };
+        case "replace_all":
+            return {
+                page_id: pageId,
+                type: "replace_content",
+                replace_content: { new_str: mode.content, allow_deleting_content: true },
+            };
+        case "replace_range":
+            return {
+                page_id: pageId,
+                type: "replace_content_range",
+                replace_content_range: {
+                    content: mode.content,
+                    content_range: mode.contentRange,
+                    allow_deleting_content: mode.allowDeleting,
+                },
+            };
+        case "update":
+            return {
+                page_id: pageId,
+                type: "update_content",
+                update_content: {
+                    content_updates: mode.updates.map((u) => ({
+                        old_str: u.oldStr,
+                        new_str: u.newStr,
+                        replace_all_matches: u.replaceAll,
+                    })),
+                    allow_deleting_content: mode.allowDeleting,
+                },
+            };
+    }
+}
+//# sourceMappingURL=notion.js.map

package/dist/services/notion.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"notion.js","sourceRoot":"","sources":["../../src/services/notion.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAa7C,MAAM,MAAM,GAAG,YAAY,CAAC,gBAAgB,CAAC,CAAC;AAK9C;;;;;;;;;GASG;AACH,SAAS,UAAU,CAAC,IAAyB;IAC3C,OAAO,IAAI,IAAI,IAAI,IAAK,IAA4B,CAAC,MAAM,KAAK,MAAM,CAAC;AACzE,CAAC;AAuDD;;;;;;;;;GASG;AACH,MAAM,OAAO,aAAa;IAML;IALF,WAAW,CAAyB;IAC7C,MAAM,GAAwB,IAAI,CAAC;IAE3C,YACE,MAA8C,EAC7B,YAA0B;QAA1B,iBAAY,GAAZ,YAAY,CAAc;QAE3C,IAAI,CAAC,WAAW,GAAG,MAAM,CAAC,iBAAiB,CAAC;IAC9C,CAAC;IAED,IAAI,SAAS;QACX,OAAO,IAAI,CAAC,MAAM,KAAK,IAAI,CAAC;IAC9B,CAAC;IAED,KAAK,CAAC,IAAI;QACR,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,eAAe,EAAE,CAAC;QACzD,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,CAAC,IAAI,CAAC,+BAA+B,CAAC,CAAC;YAC7C,OAAO;QACT,CAAC;QAED,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,kBAAkB,CAAC,CAAC;YAC7C,IAAI,CAAC,MAAM,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;YAC/C,MAAM,CAAC,IAAI,CACT,EAAE,SAAS,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE,EAC5C,4BAA4B,CAC7B,CAAC;QACJ,CAAC;QAAC,MAAM,CAAC;YACP,MAAM,IAAI,KAAK,CACb,uFAAuF,CACxF,CAAC;QACJ,CAAC;IACH,CAAC;IAED,mFAAmF;IACnF,aAAa;QACX,OAAO,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC;IAChF,CAAC;IAED;;;OAGG;IACH,iBAAiB,CAAC,SAAiB;QACjC,IAAI,IAAI,CAAC,WAAW,CAAC,SAAS,CAAC;YAAE,OAAO,IAAI,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC;QACpE,oEAAoE;QACpE,qDAAqD;QACrD,IAAI,qBAAqB,CAAC,IAAI,CAAC,SAAS,CAAC;YAAE,OAAO,SAAS,CAAC;QAC5D,OAAO,IAAI,CAAC;IACd,CAAC;IAEO,aAAa;QACnB,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAC;QAC3C,CAAC;QACD,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED,gEAAgE;IAChE,cAAc;IACd,gEAAgE;IAEhE,KAAK,CAAC,aAAa,CAAC,MAOnB;QACC,MAAM,MAAM,GAAG,IAAI,CAAC,aAAa,EAAE,CAAC;QACpC,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,WAAW,CAAC,KAAK,CAAC;YAC9C,cAAc,EAAE,MAAM,CAAC,UAAU;YACjC,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,SAAS,EAAE,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,QAAQ,IAAI,EAAE,EAAE,GAAG,CAAC;YAC/C,YAAY,EAAE,MAAM,CAAC,WAAW;YAChC,QAAQ,EAAE,MAAM,CAAC,OAAO;SACzB,CAAC,CAAC;QACH,OAAO;YACL,OAAO,EAAE,QAAQ,CAAC,OAAO;iBACtB,MAAM,CAAC,UAAU,CAAC;iBAClB,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;YACpC,OAAO,EAAE,QAAQ,CAAC,QAAQ;YAC1B,UAAU,EAAE,QAAQ,CAAC,WAAW;SACjC,CAAC;IACJ,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,CAAC,iBAAiB,CACtB,UAAkB,EAClB,cAAsB,EACtB,OAA8B,EAAE;QAEhC,MAAM,MAAM,GAAG,IAAI,CAAC,aAAa,EAAE,CAAC;QACpC,IAAI,MAA0B,CAAC;QAC/B,GAAG,CAAC;YACF,MAAM,QAAQ,GAA4B,MAAM,MAAM,CAAC,WAAW,CAAC,KAAK,CAAC;gBACvE,cAAc,EAAE,UAAU;gBAC1B,MAAM,EAAE;oBACN,SAAS,EAAE,kBAAkB;oBAC7B,gBAAgB,EAAE,EAAE,KAAK,EAAE,cAAc,EAAE;iBAC5C;gBACD,KAAK,EAAE,CAAC,EAAE,SAAS,EAAE,kBAAkB,EAAE,SAAS,EAAE,WAAW,EAAE,CAAC;gBAClE,SAAS,EAAE,GAAG;gBACd,YAAY,EAAE,MAAM;gBACpB,QAAQ,EAAE,IAAI,CAAC,OAAO;aACvB,CAAC,CAAC;YACH,KAAK,MAAM,IAAI,IAAI,QAAQ,CAAC,OAAO,EAAE,CAAC;gBACpC,IAAI,UAAU,CAAC,IAAI,CAAC;oBAAE,MAAM,IAAI,CAAC;YACnC,CAAC;YACD,MAAM,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,WAAW,IAAI,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QAC/E,CAAC,QAAQ,MAAM,EAAE;IACnB,CAAC;IAED,gEAAgE;IAChE,eAAe;IACf,gEAAgE;IAEhE,KAAK,CAAC,MAAM,CAAC,MAMZ;QACC,MAAM,MAAM,GAAG,IAAI,CAAC,aAAa,EAAE,CAAC;QACpC,MAAM,YAAY,GAAqB;YACrC,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,IAAI,EAAE;gBACJ,SAAS,EAAE,kBAAkB;gBAC7B,SAAS,EAAE,MAAM,CAAC,aAAa,IAAI,YAAY;aAChD;YACD,SAAS,EAAE,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,QAAQ,IAAI,EAAE,EAAE,GAAG,CAAC;YAC/C,YAAY,EAAE,MAAM,CAAC,WAAW;SACjC,CAAC;QACF,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;YACtB,YAAY,CAAC,MAAM,GAAG,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,CAAC,UAAU,EAAE,CAAC;QACzE,CAAC;QACD,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;QACnD,OAAO;YACL,OAAO,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAwB,EAAE,CAAC,CAAC,KAAK,IAAI,CAAC;YAChG,OAAO,EAAE,QAAQ,CAAC,QAAQ;YAC1B,UAAU,EAAE,QAAQ,CAAC,WAAW;SACjC,CAAC;IACJ,CAAC;IAED,gEAAgE;IAChE,aAAa;IACb,gEAAgE;IAEhE,KAAK,CAAC,OAAO,CACX,MAAc,EACd,OAAmE,EAAE;QAErE,MAAM,MAAM,GAAG,IAAI,CAAC,aAAa,EAAE,CAAC;QACpC,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;QAC9D,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YACtB,MAAM,IAAI,KAAK,CAAC,8BAA8B,CAAC,CAAC;QAClD,CAAC;QAED,IAAI,QAAQ,GAAkB,IAAI,CAAC;QACnC,IAAI,iBAAiB,GAAG,KAAK,CAAC;QAC9B,IAAI,eAAe,GAAa,EAAE,CAAC;QAEnC,IAAI,IAAI,CAAC,eAAe,IAAI,IAAI,EAAE,CAAC;YACjC,IAAI,CAAC;gBACH,MAAM,EAAE,GAAG,MAAM,MAAM,CAAC,KAAK,CAAC,gBAAgB,CAAC;oBAC7C,OAAO,EAAE,MAAM;oBACf,kBAAkB,EAAE,IAAI,CAAC,iBAAiB;iBAC3C,CAAC,CAAC;gBACH,QAAQ,GAAG,EAAE,CAAC,QAAQ,CAAC;gBACvB,iBAAiB,GAAG,EAAE,CAAC,SAAS,CAAC;gBACjC,eAAe,GAAG,EAAE,CAAC,iBAAiB,CAAC;YACzC,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,+DAA+D;gBAC/D,8DAA8D;gBAC9D,wDAAwD;gBACxD,MAAM,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,EAAE,8BAA8B,CAAC,CAAC;YAC/D,CAAC;QACH,CAAC;QAED,OAAO;YACL,GAAG,YAAY,CAAC,IAAI,CAAC;YACrB,QAAQ;YACR,iBAAiB;YACjB,eAAe;SAChB,CAAC;IACJ,CAAC;IAED,gEAAgE;IAChE,mCAAmC;IACnC,gEAAgE;IAEhE,KAAK,CAAC,UAAU,CAAC,MAOhB;QACC,MAAM,MAAM,GAAG,IAAI,CAAC,aAAa,EAAE,CAAC;QACpC,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC;YACzC,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,UAAU,EAAE,MAAM,CAAC,UAAU;YAC7B,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,QAAQ,EAAE,MAAM,CAAC,QAAQ;SAC1B,CAAC,CAAC;QACH,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC1B,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC;QACpD,CAAC;QACD,OAAO,YAAY,CAAC,QAAQ,CAAC,CAAC;IAChC,CAAC;IAED,KAAK,CAAC,oBAAoB,CACxB,MAAc,EACd,IAA2C;QAE3C,MAAM,MAAM,GAAG,IAAI,CAAC,aAAa,EAAE,CAAC;QACpC,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,CAAC,CAAC;QACzE,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC1B,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC;QACpD,CAAC;QACD,OAAO,YAAY,CAAC,QAAQ,CAAC,CAAC;IAChC,CAAC;IAED,oFAAoF;IACpF,KAAK,CAAC,iBAAiB,CAAC,MAAc,EAAE,IAAuB;QAC7D,MAAM,MAAM,GAAG,IAAI,CAAC,aAAa,EAAE,CAAC;QACpC,MAAM,MAAM,CAAC,KAAK,CAAC,cAAc,CAAC,uBAAuB,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC;IAC3E,CAAC;IAED,+EAA+E;IAC/E,KAAK,CAAC,WAAW,CAAC,MAAc;QAC9B,OAAO,IAAI,CAAC,oBAAoB,CAAC,MAAM,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;IAC/D,CAAC;CAKF;AAED;;wEAEwE;AAExE,MAAM,UAAU,YAAY,CAAC,IAAwB;IACnD,OAAO;QACL,EAAE,EAAE,IAAI,CAAC,EAAE;QACX,GAAG,EAAE,IAAI,CAAC,GAAG;QACb,cAAc,EAAE,IAAI,CAAC,gBAAgB;QACrC,WAAW,EAAE,IAAI,CAAC,YAAY;QAC9B,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,QAAQ,CAAC;QAChD,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,UAAU,EAAE,iBAAiB,CAAC,IAAI,CAAC,UAAU,CAAC;KAC/C,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,iBAAiB,CAC/B,KAAuC;IAEvC,MAAM,GAAG,GAA4B,EAAE,CAAC;IACxC,KAAK,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACjD,GAAG,CAAC,IAAI,CAAC,GAAG,oBAAoB,CAAC,IAAI,CAAC,CAAC;IACzC,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAS,oBAAoB,CAAC,IAA6B;IACzD,QAAQ,IAAI,CAAC,IAAI,EAAE,CAAC;QAClB,KAAK,OAAO,CAAC;QACb,KAAK,WAAW,CAAC,CAAC,CAAC;YACjB,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,IAAc,CAA8C,CAAC;YACnF,OAAO,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC;QACtD,CAAC;QACD,KAAK,QAAQ;YACX,OAAO,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC;QAC7B,KAAK,QAAQ;YACX,OAAQ,IAAI,CAAC,MAAkC,EAAE,IAAI,IAAI,IAAI,CAAC;QAChE,KAAK,cAAc;YACjB,OAAQ,IAAI,CAAC,YAA+C,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;QACzF,KAAK,MAAM;YACT,OAAO,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC;QAC3B,KAAK,UAAU;YACb,OAAO,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAChC,KAAK,KAAK;YACR,OAAQ,IAAI,CAAC,GAAqB,IAAI,IAAI,CAAC;QAC7C,KAAK,OAAO;YACV,OAAQ,IAAI,CAAC,KAAuB,IAAI,IAAI,CAAC;QAC/C,KAAK,cAAc;YACjB,OAAQ,IAAI,CAAC,YAA8B,IAAI,IAAI,CAAC;QACtD,KAAK,QAAQ;YACX,OAAQ,IAAI,CAAC,MAAkC,EAAE,IAAI,IAAI,IAAI,CAAC;QAChE,KAAK,UAAU;YACb,OAAQ,IAAI,CAAC,QAAyC,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC;QACjF,KAAK,QAAQ;YACX,OAAQ,IAAI,CAAC,MAAuC,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC;QAC/E,KAAK,OAAO;YACV,OAAQ,IAAI,CAAC,KAAwC,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;QAClF,KAAK,SAAS;YACZ,OAAQ,IAAI,CAAC,OAA0F,IAAI,IAAI,CAAC;QAClH,KAAK,cAAc,CAAC;QACpB,KAAK,kBAAkB;YACrB,OAAO,IAAI,CAAC,IAAI,CAAC,IAAc,CAAC,IAAI,IAAI,CAAC;QAC3C,KAAK,WAAW;YACd,OAAO,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC;QAChC;YACE,OAAO,IAAI,CAAC;IAChB,CAAC;AACH,CAAC;AAED,SAAS,iBAAiB,CACxB,GAA4B;IAE5B,MAAM,MAAM,GAAG,GAAG,CAAC,MAAgB,CAAC;IACpC,IAAI,MAAM,KAAK,MAAM,IAAI,MAAM,KAAK,aAAa;QAAE,OAAO,IAAI,CAAC;IAE/D,IAAI,KAAK,GAAG,EAAE,CAAC;IACf,IAAI,MAAM,KAAK,MAAM,IAAI,GAAG,CAAC,UAAU,EAAE,CAAC;QACxC,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,MAAM,CAC9B,GAAG,CAAC,UAAqD,CAC1D,EAAE,CAAC;YACF,IAAI,IAAI,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;gBAC1B,MAAM,GAAG,GAAG,IAAI,CAAC,KAAkD,CAAC;gBACpE,KAAK,GAAG,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC;gBACrD,MAAM;YACR,CAAC;QACH,CAAC;IACH,CAAC;SAAM,IAAI,MAAM,KAAK,aAAa,EAAE,CAAC;QACpC,MAAM,GAAG,GAAG,GAAG,CAAC,KAAkD,CAAC;QACnE,KAAK,GAAG,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC;IACvD,CAAC;IAED,OAAO;QACL,EAAE,EAAE,GAAG,CAAC,EAAY;QACpB,MAAM,EAAE,MAAgC;QACxC,KAAK;QACL,GAAG,EAAG,GAAG,CAAC,GAA0B,IAAI,IAAI;QAC5C,cAAc,EAAG,GAAG,CAAC,gBAAuC,IAAI,IAAI;QACpE,MAAM,EAAE,GAAG,CAAC,MAAM,IAAI,IAAI;KAC3B,CAAC;AACJ,CAAC;AAED,SAAS,uBAAuB,CAC9B,MAAc,EACd,IAAuB;IAEvB,QAAQ,IAAI,CAAC,IAAI,EAAE,CAAC;QAClB,KAAK,QAAQ;YACX,OAAO;gBACL,OAAO,EAAE,MAAM;gBACf,IAAI,EAAE,gBAAgB;gBACtB,cAAc,EAAE,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE;aAC7D,CAAC;QACJ,KAAK,aAAa;YAChB,OAAO;gBACL,OAAO,EAAE,MAAM;gBACf,IAAI,EAAE,iBAAiB;gBACvB,eAAe,EAAE,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,sBAAsB,EAAE,IAAI,EAAE;aACzE,CAAC;QACJ,KAAK,eAAe;YAClB,OAAO;gBACL,OAAO,EAAE,MAAM;gBACf,IAAI,EAAE,uBAAuB;gBAC7B,qBAAqB,EAAE;oBACrB,OAAO,EAAE,IAAI,CAAC,OAAO;oBACrB,aAAa,EAAE,IAAI,CAAC,YAAY;oBAChC,sBAAsB,EAAE,IAAI,CAAC,aAAa;iBAC3C;aACF,CAAC;QACJ,KAAK,QAAQ;YACX,OAAO;gBACL,OAAO,EAAE,MAAM;gBACf,IAAI,EAAE,gBAAgB;gBACtB,cAAc,EAAE;oBACd,eAAe,EAAE,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;wBACxC,OAAO,EAAE,CAAC,CAAC,MAAM;wBACjB,OAAO,EAAE,CAAC,CAAC,MAAM;wBACjB,mBAAmB,EAAE,CAAC,CAAC,UAAU;qBAClC,CAAC,CAAC;oBACH,sBAAsB,EAAE,IAAI,CAAC,aAAa;iBAC3C;aACF,CAAC;IACN,CAAC;AACH,CAAC"}

package/dist/services/obsidian.d.ts

@@ -0,0 +1,116 @@
+import type { AgentConfig } from "../config.js";
+export interface ObsidianSearchResult {
+    path: string;
+    title: string;
+    excerpt: string;
+}
+/**
+ * ObsidianService — wraps Obsidian CLI (1.12+).
+ *
+ * The CLI communicates with the running Obsidian process, so it works
+ * transparently with iCloud vaults. All writes go through the CLI;
+ * reads can use Claude Code's Read tool directly (vault path is injected
+ * by ContextBuilder).
+ *
+ * Prerequisites:
+ * - Obsidian 1.12+ installed
+ * - Settings > General > "Command line interface" enabled
+ * - Obsidian running (CLI communicates with the Obsidian process)
+ * - CLI in PATH (~/.zprofile auto-updated when CLI is enabled)
+ */
+export declare class ObsidianService {
+    private readonly vaultName;
+    private readonly vaultPath;
+    constructor(config: AgentConfig);
+    /** Whether Obsidian integration is configured */
+    get available(): boolean;
+    /** Get the vault name (for status endpoint) */
+    get vault(): string | null;
+    /** Get the absolute vault path (for attribution tracking) */
+    get absoluteVaultPath(): string | null;
+    /**
+     * Append `.md` to a note path when the caller omitted an extension.
+     * Exposed so route handlers and this service agree on the same path
+     * normalization before passing values to the CLI or AgentWriteTracker.
+     */
+    static ensureMdExtension(notePath: string): string;
+    /**
+     * Resolve a logical note name to an absolute file path inside the vault.
+     * Returns `null` if the vault path is not configured. The daemon uses
+     * this to pre-mark agent writes in AgentWriteTracker so the observer
+     * correctly attributes subsequent chokidar events to the agent rather
+     * than the user. Adds a `.md` suffix when the caller omits it.
+     */
+    resolveNotePath(noteName: string): string | null;
+    /**
+     * Check if Obsidian CLI is accessible and the app is running.
+     *
+     * On macOS the CLI binary installed by Obsidian (at
+     * `/Applications/Obsidian.app/Contents/MacOS/obsidian`) doubles as the GUI
+     * launcher: invoking it with no running Obsidian process spawns Electron
+     * instead of answering `--version`, and that never exits. Check first that
+     * an Obsidian process is already running, and enforce a short timeout on
+     * the probe as a belt-and-braces guard.
+     */
+    isRunning(): Promise<boolean>;
+    /** Create a new note */
+    createNote(name: string, content: string): Promise<void>;
+    /**
+     * Overwrite an existing note (or create it if missing).
+     *
+     * Wraps `obsidian create path=… overwrite`, which is idempotent: the
+     * CLI replaces the file's contents if it exists and creates it
+     * otherwise. This is PUT semantics — use `createNote` when strict
+     * create-only behavior is required.
+     *
+     * **Must use `path=`, not `name=`.** The CLI's `name=` resolves like a
+     * wikilink (basename match across the vault), which combined with the
+     * `overwrite` flag could silently clobber an unrelated note that
+     * happens to share a basename. `path=` is exact (folder/note.md).
+     */
+    updateNote(filePath: string, content: string): Promise<void>;
+    /**
+     * Delete a note.
+     *
+     * Defaults to Obsidian's trash (recoverable via the vault UI). Pass
+     * `permanent=true` to skip the trash — irreversible, use sparingly.
+     *
+     * Uses `path=` (not `file=`) for the same reason as `updateNote`:
+     * wikilink resolution on a shared basename would let a destructive
+     * call silently target the wrong vault file.
+     */
+    deleteNote(filePath: string, permanent?: boolean): Promise<void>;
+    /** Append content to an existing note */
+    appendToNote(file: string, content: string): Promise<void>;
+    /** Search notes by query */
+    search(query: string, limit?: number): Promise<ObsidianSearchResult[]>;
+    /**
+     * Read a note's content.
+     *
+     * Uses `path=` (not `file=`) so the lookup is exact and doesn't
+     * depend on Obsidian's wikilink index — the wikilink index is
+     * populated asynchronously and can briefly miss a file that was
+     * just written via `create path=…`. `path=` hits the filesystem
+     * directly and avoids that race.
+     *
+     * Also detects the CLI's "Error: File … not found." stdout pattern:
+     * the `read` command reports missing files on stdout with exit 0,
+     * so we must promote it to an exception for the caller to get a
+     * meaningful "not found" signal.
+     */
+    readNote(filePath: string): Promise<string>;
+    /** Append to the daily note */
+    appendToDaily(content: string): Promise<void>;
+    /** Set a property on a note */
+    setProperty(file: string, name: string, value: string): Promise<void>;
+    /**
+     * Execute an Obsidian CLI command.
+     *
+     * Uses execFile with args array (not shell) to prevent injection.
+     * Prepends vault name if configured.
+     */
+    private exec;
+    /** Parse the CLI search output into structured results */
+    private parseSearchResult;
+}
+//# sourceMappingURL=obsidian.d.ts.map

package/dist/services/obsidian.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"obsidian.d.ts","sourceRoot":"","sources":["../../src/services/obsidian.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAiEhD,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;;;;;;GAaG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAgB;IAC1C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAgB;gBAE9B,MAAM,EAAE,WAAW;IAS/B,iDAAiD;IACjD,IAAI,SAAS,IAAI,OAAO,CAEvB;IAED,+CAA+C;IAC/C,IAAI,KAAK,IAAI,MAAM,GAAG,IAAI,CAEzB;IAED,6DAA6D;IAC7D,IAAI,iBAAiB,IAAI,MAAM,GAAG,IAAI,CAErC;IAED;;;;OAIG;IACH,MAAM,CAAC,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM;IAIlD;;;;;;OAMG;IACH,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAKhD;;;;;;;;;OASG;IACG,SAAS,IAAI,OAAO,CAAC,OAAO,CAAC;IAoBnC,wBAAwB;IAClB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAK9D;;;;;;;;;;;;OAYG;IACG,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAYlE;;;;;;;;;OASG;IACG,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,UAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAQpE,yCAAyC;IACnC,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKhE,4BAA4B;IACtB,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,SAAK,GAAG,OAAO,CAAC,oBAAoB,EAAE,CAAC;IASxE;;;;;;;;;;;;;OAaG;IACG,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IASjD,+BAA+B;IACzB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKnD,+BAA+B;IACzB,WAAW,CACf,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,IAAI,CAAC;IAShB;;;;;OAKG;YACW,IAAI;IA+BlB,0DAA0D;IAC1D,OAAO,CAAC,iBAAiB;CA6B1B"}