@remnic/connector-granola 9.15.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Joshua Warren
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,81 @@
+# @remnic/connector-granola
+
+Granola meeting-notes connector for [Remnic](https://github.com/joshuaswarren/remnic).
+
+Pulls your Granola meeting notes + transcripts into Remnic's wearables pipeline
+as source `granola`: day transcripts at `<memoryDir>/wearables/granola/<date>.md`,
+searchable via `remnic wearables search`, with trust-gated memories exactly like
+the pendant connectors.
+
+> **Cloud-service caveat.** These notes/transcripts were produced by Granola's
+> cloud. Remnic ingests them but cannot make them retroactively local. Requires
+> a Granola **Business/Enterprise** plan to create an API key.
+
+## Install
+
+À-la-carte — install alongside `@remnic/core` only if you use Granola:
+
+```sh
+npm install -g @remnic/connector-granola
+```
+
+Installing `@remnic/core` alone never pulls this in; core discovers it at
+runtime. If it is not installed, `remnic wearables` reports a clean install hint.
+
+## API key
+
+Create a key in the Granola desktop app under **Settings → Connectors → API
+keys** (choose the note access scopes). The connector resolves the key in this
+order — the **config value takes precedence**, then the environment variables:
+
+1. `wearables.sources.granola.apiKey` (config; wins when set)
+2. `REMNIC_GRANOLA_API_KEY` (preferred env var)
+3. `GRANOLA_API_KEY` (provider-conventional env var)
+
+On launchd/systemd daemons the process environment is isolated — set the key in
+the unit, not just a shell.
+
+## Configure
+
+```jsonc
+{
+  "wearables": {
+    "sources": {
+      "granola": {
+        "enabled": false,          // OFF until you turn it on
+        "memoryMode": "smart",     // off | review | auto | smart
+        "sourceTrust": 0.85
+      }
+    }
+  }
+}
+```
+
+`enabled` defaults to `false`; nothing syncs until you set it `true`. Enabling
+Granola neither enables nor syncs any other source.
+
+## Verify
+
+```sh
+remnic wearables check granola      # ok / bad-key / unreachable
+remnic wearables sync --source granola --date 2026-03-10
+remnic wearables search "roadmap"
+```
+
+## What it does
+
+- Lists notes for the local day via `GET /v1/notes?created_after=&created_before=`
+  (half-open `[start, end)`, DST-aware), then fetches each note's transcript with
+  `GET /v1/notes/{id}?include=transcript`.
+- Meeting timing prefers the linked calendar event (`scheduled_start/end_time`),
+  falling back to the transcript times, then the note's `created_at`.
+- Speaker keys come from `speaker.source` (`microphone` = the wearer's own audio,
+  `speaker` = other meeting audio) or the iOS `diarization_label`. The wearables
+  speaker registry owns final naming.
+- The notes list returns summaries; a note's detail record may lack a transcript
+  (the field is nullable), so a summary-only note becomes a single `note`
+  segment. A note that 404s on the detail fetch is skipped, not fatal.
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,144 @@
+import { WearableConversation, WearableConnectorFactoryOptions, WearableSourceConnector, WearableConnectorRegistration } from '@remnic/core';
+
+/**
+ * Minimal Granola public API client (raw fetch, no SDK).
+ *
+ * API verified against the official OpenAPI at
+ * https://docs.granola.ai/api-reference/list-notes and
+ * https://docs.granola.ai/api-reference/get-note (fetched 2026-07-21):
+ *   - Base URL: https://public-api.granola.ai
+ *   - Auth: `Authorization: Bearer grn_<key>`
+ *   - `GET /v1/notes?created_after=&created_before=&cursor=&page_size=` →
+ *     `{ notes: NoteSummary[], hasMore, cursor }` (page_size 1..30, default 10);
+ *     `created_after`/`created_before` accept date or date-time. The list only
+ *     returns notes that already have an AI summary + transcript.
+ *   - `GET /v1/notes/{id}?include=transcript` → full Note with `calendar_event`
+ *     (`scheduled_start_time`/`scheduled_end_time`), `attendees`, `summary_text`,
+ *     `summary_markdown`, and `transcript` items
+ *     `{ speaker: { source, diarization_label? }, text, start_time, end_time }`.
+ *   - Rate limits: 5 req/s sustained, 25 burst → 429 on excess.
+ *
+ * A non-2xx or network failure throws GranolaApiError (a backend failure); an
+ * empty `notes` array is a real empty result, never conflated (AGENTS.md §22).
+ */
+declare const GRANOLA_DEFAULT_BASE_URL = "https://public-api.granola.ai";
+/** Hard API maximum for `page_size` on the notes list. */
+declare const NOTES_MAX_PAGE_SIZE = 30;
+interface GranolaSpeaker {
+    source?: string | null;
+    diarization_label?: string | null;
+}
+interface GranolaTranscriptItem {
+    speaker?: GranolaSpeaker | null;
+    text?: string | null;
+    start_time?: string | null;
+    end_time?: string | null;
+}
+interface GranolaCalendarEvent {
+    event_title?: string | null;
+    organiser?: string | null;
+    scheduled_start_time?: string | null;
+    scheduled_end_time?: string | null;
+}
+interface GranolaUser {
+    name?: string | null;
+    email?: string | null;
+}
+interface GranolaNote {
+    id: string;
+    title?: string | null;
+    created_at?: string | null;
+    updated_at?: string | null;
+    calendar_event?: GranolaCalendarEvent | null;
+    attendees?: GranolaUser[] | null;
+    summary_text?: string | null;
+    summary_markdown?: string | null;
+    transcript?: GranolaTranscriptItem[] | null;
+}
+interface NotesPage {
+    notes: GranolaNote[];
+    nextCursor: string | null;
+}
+interface GranolaClientOptions {
+    apiKey: string;
+    baseUrl?: string;
+    fetchImpl?: typeof fetch;
+    timeoutMs?: number;
+    sleep?: (ms: number) => Promise<void>;
+}
+declare class GranolaApiError extends Error {
+    readonly status?: number | undefined;
+    constructor(message: string, status?: number | undefined);
+}
+declare class GranolaClient {
+    private readonly apiKey;
+    private readonly baseUrl;
+    private readonly fetchImpl;
+    private readonly timeoutMs;
+    private readonly sleep;
+    constructor(options: GranolaClientOptions);
+    /** One page of note summaries in the half-open [createdAfter, createdBefore) window. */
+    listNotes(params: {
+        createdAfter: string;
+        createdBefore: string;
+        cursor?: string | null;
+        signal?: AbortSignal;
+    }): Promise<NotesPage>;
+    /** A single note with its transcript, calendar event, summary, and attendees. */
+    getNote(id: string, signal?: AbortSignal): Promise<GranolaNote>;
+    /** Cheap auth probe. */
+    verifyAuth(signal?: AbortSignal): Promise<{
+        ok: boolean;
+        detail?: string;
+    }>;
+    private requestJson;
+}
+
+/**
+ * Normalize Granola notes into Remnic's provider-agnostic
+ * `WearableConversation` shape, plus the timezone-aware day-window helpers the
+ * Granola `created_after`/`created_before` filters need.
+ *
+ * Granola transcript items carry absolute `start_time`/`end_time` (ISO) and a
+ * `speaker.source` of `microphone` (the wearer's own captured audio) or
+ * `speaker` (other meeting audio); iOS adds a `diarization_label`
+ * (`Speaker A/B/...`). The wearables speaker registry owns final naming.
+ * Meeting timing prefers the linked calendar event; notes with a summary but no
+ * transcript degrade to a single `note` segment.
+ */
+
+declare const GRANOLA_SOURCE_ID = "granola";
+/**
+ * Half-open [createdAfter, createdBefore) UTC ISO bounds of a local day — the
+ * window the Granola notes list filters on.
+ */
+declare function granolaDayWindow(date: string, timezone: string): {
+    createdAfter: string;
+    createdBefore: string;
+};
+declare function noteToConversation(note: GranolaNote): WearableConversation;
+
+/**
+ * @remnic/connector-granola — Granola meeting-notes connector.
+ *
+ * À-la-carte optional companion of @remnic/core: installing core alone
+ * never pulls this in; core discovers it at runtime via a
+ * computed-specifier dynamic import (see wearables/registry.ts) or via
+ * a direct import of this module, which self-registers idempotently.
+ *
+ * API key: `wearables.sources.granola.apiKey`, else the
+ * `REMNIC_GRANOLA_API_KEY` / `GRANOLA_API_KEY` environment variables
+ * (checked in that order). Create a key under Settings → Connectors →
+ * API keys in the Granola app (Business/Enterprise plans).
+ */
+
+declare function resolveGranolaApiKey(configuredKey: string | undefined, env?: NodeJS.ProcessEnv): string | undefined;
+declare function createGranolaConnector(options: WearableConnectorFactoryOptions): WearableSourceConnector;
+declare const wearableConnectorRegistration: WearableConnectorRegistration;
+/**
+ * Idempotently register the connector with the core registry. Importing this
+ * module registers it as a side effect; calling again is safe.
+ */
+declare function ensureGranolaConnectorRegistered(): boolean;
+
+export { GRANOLA_DEFAULT_BASE_URL, GRANOLA_SOURCE_ID, GranolaApiError, type GranolaCalendarEvent, GranolaClient, type GranolaClientOptions, type GranolaNote, type GranolaSpeaker, type GranolaTranscriptItem, type GranolaUser, NOTES_MAX_PAGE_SIZE, type NotesPage, createGranolaConnector, ensureGranolaConnectorRegistered, granolaDayWindow, noteToConversation, resolveGranolaApiKey, wearableConnectorRegistration };

package/dist/index.js

@@ -0,0 +1,362 @@
+// openclaw-engram: Local-first memory plugin
+
+// src/index.ts
+import {
+  registerWearableConnector,
+  getWearableConnector
+} from "@remnic/core";
+
+// src/client.ts
+var GRANOLA_DEFAULT_BASE_URL = "https://public-api.granola.ai";
+var NOTES_MAX_PAGE_SIZE = 30;
+var DEFAULT_TIMEOUT_MS = 3e4;
+var MAX_RETRIES = 3;
+var MAX_RETRY_DELAY_MS = 3e4;
+var GranolaApiError = class extends Error {
+  constructor(message, status) {
+    super(message);
+    this.status = status;
+    this.name = "GranolaApiError";
+  }
+  status;
+};
+function isRecord(value) {
+  return typeof value === "object" && value !== null;
+}
+var GranolaClient = class {
+  apiKey;
+  baseUrl;
+  fetchImpl;
+  timeoutMs;
+  sleep;
+  constructor(options) {
+    if (typeof options.apiKey !== "string" || options.apiKey.trim().length === 0) {
+      throw new GranolaApiError(
+        "Granola API key is missing. Set wearables.sources.granola.apiKey or the REMNIC_GRANOLA_API_KEY / GRANOLA_API_KEY environment variable (create a key under Settings \u2192 Connectors \u2192 API keys in the Granola app; requires a Business/Enterprise plan)."
+      );
+    }
+    this.apiKey = options.apiKey.trim();
+    this.baseUrl = stripTrailingSlashes(options.baseUrl ?? GRANOLA_DEFAULT_BASE_URL);
+    this.fetchImpl = options.fetchImpl ?? fetch;
+    this.timeoutMs = options.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+    this.sleep = options.sleep ?? defaultSleep;
+  }
+  /** One page of note summaries in the half-open [createdAfter, createdBefore) window. */
+  async listNotes(params) {
+    const search = new URLSearchParams({
+      created_after: params.createdAfter,
+      created_before: params.createdBefore,
+      page_size: String(NOTES_MAX_PAGE_SIZE)
+    });
+    if (typeof params.cursor === "string" && params.cursor.length > 0) {
+      search.set("cursor", params.cursor);
+    }
+    const payload = await this.requestJson(`/v1/notes?${search.toString()}`, params.signal);
+    const notesRaw = isRecord(payload) ? payload.notes : void 0;
+    if (!Array.isArray(notesRaw)) {
+      throw new GranolaApiError("Granola API returned an unexpected /v1/notes shape (missing notes array)");
+    }
+    const notes = [];
+    for (const entry of notesRaw) {
+      if (!isRecord(entry) || typeof entry.id !== "string") {
+        throw new GranolaApiError("Granola API returned a note row without a string id");
+      }
+      notes.push(entry);
+    }
+    const hasMore = isRecord(payload) && payload.hasMore === true;
+    const cursor = isRecord(payload) && typeof payload.cursor === "string" ? payload.cursor : null;
+    if (hasMore && (cursor === null || cursor.length === 0)) {
+      throw new GranolaApiError("Granola reported hasMore=true but returned no pagination cursor");
+    }
+    return { notes, nextCursor: hasMore ? cursor : null };
+  }
+  /** A single note with its transcript, calendar event, summary, and attendees. */
+  async getNote(id, signal) {
+    const payload = await this.requestJson(
+      `/v1/notes/${encodeURIComponent(id)}?include=transcript`,
+      signal
+    );
+    if (!isRecord(payload) || typeof payload.id !== "string") {
+      throw new GranolaApiError("Granola API returned an unexpected note shape (missing id)");
+    }
+    return payload;
+  }
+  /** Cheap auth probe. */
+  async verifyAuth(signal) {
+    try {
+      await this.requestJson("/v1/notes?page_size=1", signal);
+      return { ok: true };
+    } catch (err) {
+      if (err instanceof GranolaApiError && (err.status === 401 || err.status === 403)) {
+        return {
+          ok: false,
+          detail: "Granola rejected the API key (401/403) \u2014 create a new key under Settings \u2192 Connectors \u2192 API keys"
+        };
+      }
+      return { ok: false, detail: err instanceof Error ? err.message : String(err) };
+    }
+  }
+  async requestJson(pathAndQuery, signal) {
+    let lastError;
+    for (let attempt = 0; attempt <= MAX_RETRIES; attempt++) {
+      signal?.throwIfAborted();
+      const timeoutSignal = AbortSignal.timeout(this.timeoutMs);
+      const combined = signal ? AbortSignal.any([signal, timeoutSignal]) : timeoutSignal;
+      let response;
+      try {
+        response = await this.fetchImpl(`${this.baseUrl}${pathAndQuery}`, {
+          method: "GET",
+          headers: {
+            Authorization: `Bearer ${this.apiKey}`,
+            Accept: "application/json"
+          },
+          signal: combined
+        });
+      } catch (err) {
+        if (signal?.aborted) throw err;
+        lastError = err;
+        if (attempt < MAX_RETRIES) {
+          await this.sleep(backoffMs(attempt));
+          continue;
+        }
+        throw new GranolaApiError(
+          `Granola API request failed after ${MAX_RETRIES + 1} attempts: ${describeNetworkError(err)}`
+        );
+      }
+      if (response.status === 429 || response.status >= 500) {
+        discardBody(response);
+        lastError = new GranolaApiError(`Granola API responded ${response.status}`, response.status);
+        if (attempt < MAX_RETRIES) {
+          await this.sleep(await retryDelayMs(response, attempt));
+          continue;
+        }
+        throw lastError;
+      }
+      if (!response.ok) {
+        discardBody(response);
+        throw new GranolaApiError(
+          `Granola API responded ${response.status} for ${pathAndQuery.split("?")[0]}`,
+          response.status
+        );
+      }
+      try {
+        return await response.json();
+      } catch {
+        throw new GranolaApiError("Granola API returned a non-JSON body");
+      }
+    }
+    throw lastError instanceof Error ? lastError : new GranolaApiError("Granola API request failed");
+  }
+};
+function defaultSleep(ms) {
+  const { promise, resolve } = Promise.withResolvers();
+  setTimeout(resolve, ms);
+  return promise;
+}
+function discardBody(response) {
+  void response.body?.cancel().catch(() => {
+  });
+}
+function describeNetworkError(err) {
+  if (isRecord(err)) {
+    const name = typeof err.name === "string" ? err.name : "Error";
+    const code = err.code;
+    return typeof code === "string" ? `${name} (${code})` : name;
+  }
+  return "network error";
+}
+function stripTrailingSlashes(value) {
+  let end = value.length;
+  while (end > 0 && value.charCodeAt(end - 1) === 47) end--;
+  return value.slice(0, end);
+}
+function backoffMs(attempt) {
+  return Math.min(MAX_RETRY_DELAY_MS, 1e3 * 2 ** attempt);
+}
+async function retryDelayMs(response, attempt) {
+  const header = response.headers.get("retry-after");
+  if (header) {
+    const seconds = Number(header);
+    if (Number.isFinite(seconds) && seconds >= 0) {
+      return Math.min(MAX_RETRY_DELAY_MS, seconds * 1e3);
+    }
+    const when = Date.parse(header);
+    if (Number.isFinite(when)) {
+      return Math.min(MAX_RETRY_DELAY_MS, Math.max(0, when - Date.now()));
+    }
+  }
+  return backoffMs(attempt);
+}
+
+// src/normalize.ts
+var GRANOLA_SOURCE_ID = "granola";
+function timezoneOffsetIso(instant, timezone) {
+  try {
+    const parts = new Intl.DateTimeFormat("en-US", {
+      timeZone: timezone,
+      timeZoneName: "longOffset"
+    }).formatToParts(instant);
+    const name = parts.find((part) => part.type === "timeZoneName")?.value ?? "GMT";
+    const match = name.match(/GMT([+-]\d{2}:\d{2})?/);
+    return match?.[1] ?? "+00:00";
+  } catch {
+    return "+00:00";
+  }
+}
+function zonedDayStartIso(date, timezone) {
+  let offset = timezoneOffsetIso(/* @__PURE__ */ new Date(`${date}T12:00:00Z`), timezone);
+  const candidate = /* @__PURE__ */ new Date(`${date}T00:00:00${offset}`);
+  const refined = timezoneOffsetIso(candidate, timezone);
+  if (refined !== offset) {
+    offset = refined;
+  }
+  return `${date}T00:00:00${offset}`;
+}
+function nextIsoDate(date) {
+  const parsed = /* @__PURE__ */ new Date(`${date}T00:00:00Z`);
+  parsed.setUTCDate(parsed.getUTCDate() + 1);
+  return parsed.toISOString().slice(0, 10);
+}
+function assertValidTimezone(timezone) {
+  try {
+    new Intl.DateTimeFormat("en-US", { timeZone: timezone });
+  } catch {
+    throw new RangeError(
+      `Invalid IANA timezone "${timezone}" for the Granola connector \u2014 check wearables.timezone.`
+    );
+  }
+}
+function granolaDayWindow(date, timezone) {
+  assertValidTimezone(timezone);
+  return {
+    createdAfter: new Date(zonedDayStartIso(date, timezone)).toISOString(),
+    createdBefore: new Date(zonedDayStartIso(nextIsoDate(date), timezone)).toISOString()
+  };
+}
+function trimmed(value) {
+  return typeof value === "string" && value.trim().length > 0 ? value.trim() : void 0;
+}
+function isoOrUndefined(value) {
+  if (typeof value !== "string" || value.trim().length === 0) return void 0;
+  const ms = Date.parse(value);
+  return Number.isFinite(ms) ? new Date(ms).toISOString() : void 0;
+}
+function noteToConversation(note) {
+  const event = note.calendar_event ?? void 0;
+  const items = note.transcript ?? [];
+  const segments = [];
+  for (const item of items) {
+    const text = trimmed(item.text);
+    if (text === void 0) continue;
+    const source = trimmed(item.speaker?.source);
+    const label = trimmed(item.speaker?.diarization_label);
+    const startIso2 = isoOrUndefined(item.start_time);
+    const endIso2 = isoOrUndefined(item.end_time);
+    const isWearer = source === "microphone" && label === void 0;
+    segments.push({
+      text,
+      speakerKey: label ?? source ?? "unknown",
+      ...isWearer ? { isWearer: true } : {},
+      ...startIso2 !== void 0 ? { startIso: startIso2 } : {},
+      ...endIso2 !== void 0 ? { endIso: endIso2 } : {}
+    });
+  }
+  const summary = trimmed(note.summary_text) ?? trimmed(note.summary_markdown);
+  if (segments.length === 0 && summary !== void 0) {
+    segments.push({ text: summary, speakerKey: "note" });
+  }
+  const title = trimmed(event?.event_title) ?? trimmed(note.title);
+  const startIso = isoOrUndefined(event?.scheduled_start_time) ?? segments.find((segment) => segment.startIso !== void 0)?.startIso ?? isoOrUndefined(note.created_at) ?? "";
+  const endIso = isoOrUndefined(event?.scheduled_end_time) ?? [...segments].reverse().find((segment) => segment.endIso !== void 0)?.endIso;
+  return {
+    id: note.id,
+    source: GRANOLA_SOURCE_ID,
+    ...title !== void 0 ? { title } : {},
+    ...summary !== void 0 ? { summary } : {},
+    startIso,
+    ...endIso !== void 0 ? { endIso } : {},
+    segments
+  };
+}
+
+// src/index.ts
+var GRANOLA_DISPLAY_NAME = "Granola";
+function resolveGranolaApiKey(configuredKey, env = process.env) {
+  if (typeof configuredKey === "string" && configuredKey.trim().length > 0) {
+    return configuredKey.trim();
+  }
+  for (const name of ["REMNIC_GRANOLA_API_KEY", "GRANOLA_API_KEY"]) {
+    const value = env[name];
+    if (typeof value === "string" && value.trim().length > 0) {
+      return value.trim();
+    }
+  }
+  return void 0;
+}
+function createGranolaConnector(options) {
+  let client = null;
+  const getClient = () => {
+    if (!client) {
+      client = new GranolaClient({
+        apiKey: resolveGranolaApiKey(options.settings.apiKey) ?? "",
+        baseUrl: options.settings.baseUrl
+      });
+    }
+    return client;
+  };
+  return {
+    id: GRANOLA_SOURCE_ID,
+    displayName: GRANOLA_DISPLAY_NAME,
+    async verifyAuth(signal) {
+      return getClient().verifyAuth(signal);
+    },
+    async fetchConversations(opts) {
+      const { createdAfter, createdBefore } = granolaDayWindow(opts.date, opts.timezone);
+      const activeClient = getClient();
+      const page = await activeClient.listNotes({
+        createdAfter,
+        createdBefore,
+        cursor: opts.cursor,
+        signal: opts.signal
+      });
+      const conversations = [];
+      for (const summary of page.notes) {
+        let full;
+        try {
+          full = await activeClient.getNote(summary.id, opts.signal);
+        } catch (err) {
+          if (err instanceof GranolaApiError && err.status === 404) continue;
+          throw err;
+        }
+        const conversation = noteToConversation(full);
+        if (conversation.startIso !== "") conversations.push(conversation);
+      }
+      return { conversations, nextCursor: page.nextCursor };
+    }
+  };
+}
+var wearableConnectorRegistration = {
+  id: GRANOLA_SOURCE_ID,
+  displayName: GRANOLA_DISPLAY_NAME,
+  factory: createGranolaConnector
+};
+function ensureGranolaConnectorRegistered() {
+  if (getWearableConnector(GRANOLA_SOURCE_ID)) return false;
+  registerWearableConnector(wearableConnectorRegistration);
+  return true;
+}
+ensureGranolaConnectorRegistered();
+export {
+  GRANOLA_DEFAULT_BASE_URL,
+  GRANOLA_SOURCE_ID,
+  GranolaApiError,
+  GranolaClient,
+  NOTES_MAX_PAGE_SIZE,
+  createGranolaConnector,
+  ensureGranolaConnectorRegistered,
+  granolaDayWindow,
+  noteToConversation,
+  resolveGranolaApiKey,
+  wearableConnectorRegistration
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/client.ts","../src/normalize.ts"],"sourcesContent":["/**\n * @remnic/connector-granola — Granola meeting-notes connector.\n *\n * À-la-carte optional companion of @remnic/core: installing core alone\n * never pulls this in; core discovers it at runtime via a\n * computed-specifier dynamic import (see wearables/registry.ts) or via\n * a direct import of this module, which self-registers idempotently.\n *\n * API key: `wearables.sources.granola.apiKey`, else the\n * `REMNIC_GRANOLA_API_KEY` / `GRANOLA_API_KEY` environment variables\n * (checked in that order). Create a key under Settings → Connectors →\n * API keys in the Granola app (Business/Enterprise plans).\n */\n\nimport {\n  registerWearableConnector,\n  getWearableConnector,\n  type WearableConnectorFactoryOptions,\n  type WearableConnectorRegistration,\n  type WearableConversation,\n  type WearableFetchOptions,\n  type WearableFetchPage,\n  type WearableSourceConnector,\n} from \"@remnic/core\";\n\nimport { GranolaApiError, GranolaClient, type GranolaNote } from \"./client.js\";\nimport { GRANOLA_SOURCE_ID, granolaDayWindow, noteToConversation } from \"./normalize.js\";\n\nexport {\n  GranolaClient,\n  GranolaApiError,\n  GRANOLA_DEFAULT_BASE_URL,\n  NOTES_MAX_PAGE_SIZE,\n} from \"./client.js\";\nexport type {\n  GranolaNote,\n  GranolaTranscriptItem,\n  GranolaSpeaker,\n  GranolaCalendarEvent,\n  GranolaUser,\n  NotesPage,\n  GranolaClientOptions,\n} from \"./client.js\";\nexport { GRANOLA_SOURCE_ID, granolaDayWindow, noteToConversation } from \"./normalize.js\";\n\nconst GRANOLA_DISPLAY_NAME = \"Granola\";\n\nexport function resolveGranolaApiKey(\n  configuredKey: string | undefined,\n  env: NodeJS.ProcessEnv = process.env,\n): string | undefined {\n  if (typeof configuredKey === \"string\" && configuredKey.trim().length > 0) {\n    return configuredKey.trim();\n  }\n  for (const name of [\"REMNIC_GRANOLA_API_KEY\", \"GRANOLA_API_KEY\"]) {\n    const value = env[name];\n    if (typeof value === \"string\" && value.trim().length > 0) {\n      return value.trim();\n    }\n  }\n  return undefined;\n}\n\nexport function createGranolaConnector(\n  options: WearableConnectorFactoryOptions,\n): WearableSourceConnector {\n  let client: GranolaClient | null = null;\n  const getClient = (): GranolaClient => {\n    if (!client) {\n      client = new GranolaClient({\n        apiKey: resolveGranolaApiKey(options.settings.apiKey) ?? \"\",\n        baseUrl: options.settings.baseUrl,\n      });\n    }\n    return client;\n  };\n\n  return {\n    id: GRANOLA_SOURCE_ID,\n    displayName: GRANOLA_DISPLAY_NAME,\n    async verifyAuth(signal?: AbortSignal) {\n      return getClient().verifyAuth(signal);\n    },\n    async fetchConversations(opts: WearableFetchOptions): Promise<WearableFetchPage> {\n      const { createdAfter, createdBefore } = granolaDayWindow(opts.date, opts.timezone);\n      const activeClient = getClient();\n      const page = await activeClient.listNotes({\n        createdAfter,\n        createdBefore,\n        cursor: opts.cursor,\n        signal: opts.signal,\n      });\n      // The list returns summaries only; each note's transcript/summary/timing\n      // needs a per-note fetch. Fetch sequentially to respect the 5 req/s rate\n      // limit (the client also backs off on 429).\n      const conversations: WearableConversation[] = [];\n      for (const summary of page.notes) {\n        let full: GranolaNote;\n        try {\n          full = await activeClient.getNote(summary.id, opts.signal);\n        } catch (err) {\n          // A note that 404s (deleted / no longer summarized) is gone, not a\n          // backend outage — skip it. Any other failure is real; rethrow so it\n          // reads as a source failure, not a quiet day (AGENTS.md §22).\n          if (err instanceof GranolaApiError && err.status === 404) continue;\n          throw err;\n        }\n        const conversation = noteToConversation(full);\n        // Drop a record with no resolvable start rather than emit an empty\n        // startIso that fails downstream parsing silently.\n        if (conversation.startIso !== \"\") conversations.push(conversation);\n      }\n      return { conversations, nextCursor: page.nextCursor };\n    },\n  };\n}\n\nexport const wearableConnectorRegistration: WearableConnectorRegistration = {\n  id: GRANOLA_SOURCE_ID,\n  displayName: GRANOLA_DISPLAY_NAME,\n  factory: createGranolaConnector,\n};\n\n/**\n * Idempotently register the connector with the core registry. Importing this\n * module registers it as a side effect; calling again is safe.\n */\nexport function ensureGranolaConnectorRegistered(): boolean {\n  if (getWearableConnector(GRANOLA_SOURCE_ID)) return false;\n  registerWearableConnector(wearableConnectorRegistration);\n  return true;\n}\n\nensureGranolaConnectorRegistered();\n","/**\n * Minimal Granola public API client (raw fetch, no SDK).\n *\n * API verified against the official OpenAPI at\n * https://docs.granola.ai/api-reference/list-notes and\n * https://docs.granola.ai/api-reference/get-note (fetched 2026-07-21):\n *   - Base URL: https://public-api.granola.ai\n *   - Auth: `Authorization: Bearer grn_<key>`\n *   - `GET /v1/notes?created_after=&created_before=&cursor=&page_size=` →\n *     `{ notes: NoteSummary[], hasMore, cursor }` (page_size 1..30, default 10);\n *     `created_after`/`created_before` accept date or date-time. The list only\n *     returns notes that already have an AI summary + transcript.\n *   - `GET /v1/notes/{id}?include=transcript` → full Note with `calendar_event`\n *     (`scheduled_start_time`/`scheduled_end_time`), `attendees`, `summary_text`,\n *     `summary_markdown`, and `transcript` items\n *     `{ speaker: { source, diarization_label? }, text, start_time, end_time }`.\n *   - Rate limits: 5 req/s sustained, 25 burst → 429 on excess.\n *\n * A non-2xx or network failure throws GranolaApiError (a backend failure); an\n * empty `notes` array is a real empty result, never conflated (AGENTS.md §22).\n */\n\nexport const GRANOLA_DEFAULT_BASE_URL = \"https://public-api.granola.ai\";\n\n/** Hard API maximum for `page_size` on the notes list. */\nexport const NOTES_MAX_PAGE_SIZE = 30;\n\nconst DEFAULT_TIMEOUT_MS = 30_000;\nconst MAX_RETRIES = 3;\nconst MAX_RETRY_DELAY_MS = 30_000;\n\nexport interface GranolaSpeaker {\n  source?: string | null;\n  diarization_label?: string | null;\n}\n\nexport interface GranolaTranscriptItem {\n  speaker?: GranolaSpeaker | null;\n  text?: string | null;\n  start_time?: string | null;\n  end_time?: string | null;\n}\n\nexport interface GranolaCalendarEvent {\n  event_title?: string | null;\n  organiser?: string | null;\n  scheduled_start_time?: string | null;\n  scheduled_end_time?: string | null;\n}\n\nexport interface GranolaUser {\n  name?: string | null;\n  email?: string | null;\n}\n\nexport interface GranolaNote {\n  id: string;\n  title?: string | null;\n  created_at?: string | null;\n  updated_at?: string | null;\n  calendar_event?: GranolaCalendarEvent | null;\n  attendees?: GranolaUser[] | null;\n  summary_text?: string | null;\n  summary_markdown?: string | null;\n  transcript?: GranolaTranscriptItem[] | null;\n}\n\nexport interface NotesPage {\n  notes: GranolaNote[];\n  nextCursor: string | null;\n}\n\nexport interface GranolaClientOptions {\n  apiKey: string;\n  baseUrl?: string;\n  fetchImpl?: typeof fetch;\n  timeoutMs?: number;\n  sleep?: (ms: number) => Promise<void>;\n}\n\nexport class GranolaApiError extends Error {\n  constructor(\n    message: string,\n    readonly status?: number,\n  ) {\n    super(message);\n    this.name = \"GranolaApiError\";\n  }\n}\n\n/** Narrow unknown JSON to a plain object so field reads are actually checked. */\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === \"object\" && value !== null;\n}\n\nexport class GranolaClient {\n  private readonly apiKey: string;\n  private readonly baseUrl: string;\n  private readonly fetchImpl: typeof fetch;\n  private readonly timeoutMs: number;\n  private readonly sleep: (ms: number) => Promise<void>;\n\n  constructor(options: GranolaClientOptions) {\n    if (typeof options.apiKey !== \"string\" || options.apiKey.trim().length === 0) {\n      throw new GranolaApiError(\n        \"Granola API key is missing. Set wearables.sources.granola.apiKey \" +\n          \"or the REMNIC_GRANOLA_API_KEY / GRANOLA_API_KEY environment variable \" +\n          \"(create a key under Settings → Connectors → API keys in the Granola app; \" +\n          \"requires a Business/Enterprise plan).\",\n      );\n    }\n    this.apiKey = options.apiKey.trim();\n    this.baseUrl = stripTrailingSlashes(options.baseUrl ?? GRANOLA_DEFAULT_BASE_URL);\n    this.fetchImpl = options.fetchImpl ?? fetch;\n    this.timeoutMs = options.timeoutMs ?? DEFAULT_TIMEOUT_MS;\n    this.sleep = options.sleep ?? defaultSleep;\n  }\n\n  /** One page of note summaries in the half-open [createdAfter, createdBefore) window. */\n  async listNotes(params: {\n    createdAfter: string;\n    createdBefore: string;\n    cursor?: string | null;\n    signal?: AbortSignal;\n  }): Promise<NotesPage> {\n    const search = new URLSearchParams({\n      created_after: params.createdAfter,\n      created_before: params.createdBefore,\n      page_size: String(NOTES_MAX_PAGE_SIZE),\n    });\n    if (typeof params.cursor === \"string\" && params.cursor.length > 0) {\n      search.set(\"cursor\", params.cursor);\n    }\n    const payload = await this.requestJson(`/v1/notes?${search.toString()}`, params.signal);\n    const notesRaw = isRecord(payload) ? payload.notes : undefined;\n    if (!Array.isArray(notesRaw)) {\n      throw new GranolaApiError(\"Granola API returned an unexpected /v1/notes shape (missing notes array)\");\n    }\n    // `id` is required by the List Notes schema; a row missing it is a\n    // backend/schema failure. Reject the page rather than silently dropping\n    // rows and advancing the cursor over an incomplete day (§22).\n    const notes: GranolaNote[] = [];\n    for (const entry of notesRaw) {\n      if (!isRecord(entry) || typeof entry.id !== \"string\") {\n        throw new GranolaApiError(\"Granola API returned a note row without a string id\");\n      }\n      notes.push(entry as unknown as GranolaNote);\n    }\n    const hasMore = isRecord(payload) && payload.hasMore === true;\n    const cursor = isRecord(payload) && typeof payload.cursor === \"string\" ? payload.cursor : null;\n    if (hasMore && (cursor === null || cursor.length === 0)) {\n      // A `hasMore: true` page with no usable cursor is a malformed pagination\n      // response; fail loudly rather than silently sync a partial day (§22).\n      throw new GranolaApiError(\"Granola reported hasMore=true but returned no pagination cursor\");\n    }\n    return { notes, nextCursor: hasMore ? cursor : null };\n  }\n\n  /** A single note with its transcript, calendar event, summary, and attendees. */\n  async getNote(id: string, signal?: AbortSignal): Promise<GranolaNote> {\n    const payload = await this.requestJson(\n      `/v1/notes/${encodeURIComponent(id)}?include=transcript`,\n      signal,\n    );\n    if (!isRecord(payload) || typeof payload.id !== \"string\") {\n      throw new GranolaApiError(\"Granola API returned an unexpected note shape (missing id)\");\n    }\n    // Validated boundary: `id` is confirmed a string above; every other field\n    // is optional and the normalizer re-checks each. Cast through `unknown`\n    // because the external JSON shape can't be proven structurally here.\n    return payload as unknown as GranolaNote;\n  }\n\n  /** Cheap auth probe. */\n  async verifyAuth(signal?: AbortSignal): Promise<{ ok: boolean; detail?: string }> {\n    try {\n      await this.requestJson(\"/v1/notes?page_size=1\", signal);\n      return { ok: true };\n    } catch (err) {\n      if (err instanceof GranolaApiError && (err.status === 401 || err.status === 403)) {\n        return {\n          ok: false,\n          detail: \"Granola rejected the API key (401/403) — create a new key under Settings → Connectors → API keys\",\n        };\n      }\n      return { ok: false, detail: err instanceof Error ? err.message : String(err) };\n    }\n  }\n\n  private async requestJson(pathAndQuery: string, signal?: AbortSignal): Promise<unknown> {\n    let lastError: unknown;\n    for (let attempt = 0; attempt <= MAX_RETRIES; attempt++) {\n      signal?.throwIfAborted();\n      const timeoutSignal = AbortSignal.timeout(this.timeoutMs);\n      const combined = signal ? AbortSignal.any([signal, timeoutSignal]) : timeoutSignal;\n      let response: Response;\n      try {\n        response = await this.fetchImpl(`${this.baseUrl}${pathAndQuery}`, {\n          method: \"GET\",\n          headers: {\n            Authorization: `Bearer ${this.apiKey}`,\n            Accept: \"application/json\",\n          },\n          signal: combined,\n        });\n      } catch (err) {\n        if (signal?.aborted) throw err;\n        lastError = err;\n        if (attempt < MAX_RETRIES) {\n          await this.sleep(backoffMs(attempt));\n          continue;\n        }\n        throw new GranolaApiError(\n          `Granola API request failed after ${MAX_RETRIES + 1} attempts: ${describeNetworkError(err)}`,\n        );\n      }\n\n      if (response.status === 429 || response.status >= 500) {\n        discardBody(response);\n        lastError = new GranolaApiError(`Granola API responded ${response.status}`, response.status);\n        if (attempt < MAX_RETRIES) {\n          await this.sleep(await retryDelayMs(response, attempt));\n          continue;\n        }\n        throw lastError;\n      }\n      if (!response.ok) {\n        discardBody(response);\n        throw new GranolaApiError(\n          `Granola API responded ${response.status} for ${pathAndQuery.split(\"?\")[0]}`,\n          response.status,\n        );\n      }\n      try {\n        return await response.json();\n      } catch {\n        throw new GranolaApiError(\"Granola API returned a non-JSON body\");\n      }\n    }\n    throw lastError instanceof Error ? lastError : new GranolaApiError(\"Granola API request failed\");\n  }\n}\n\nfunction defaultSleep(ms: number): Promise<void> {\n  const { promise, resolve } = Promise.withResolvers<void>();\n  setTimeout(resolve, ms);\n  return promise;\n}\n\n/**\n * Release the socket back to the pool on error paths: an unconsumed response\n * body pins the undici connection (stability review note).\n */\nfunction discardBody(response: Response): void {\n  void response.body?.cancel().catch(() => {});\n}\n\nfunction describeNetworkError(err: unknown): string {\n  if (isRecord(err)) {\n    const name = typeof err.name === \"string\" ? err.name : \"Error\";\n    const code = err.code;\n    return typeof code === \"string\" ? `${name} (${code})` : name;\n  }\n  return \"network error\";\n}\n\n/** Loop instead of `/\\/+$/` — CodeQL js/polynomial-redos on user-set URLs. */\nfunction stripTrailingSlashes(value: string): string {\n  let end = value.length;\n  while (end > 0 && value.charCodeAt(end - 1) === 47) end--;\n  return value.slice(0, end);\n}\n\nfunction backoffMs(attempt: number): number {\n  return Math.min(MAX_RETRY_DELAY_MS, 1_000 * 2 ** attempt);\n}\n\nasync function retryDelayMs(response: Response, attempt: number): Promise<number> {\n  const header = response.headers.get(\"retry-after\");\n  if (header) {\n    const seconds = Number(header);\n    if (Number.isFinite(seconds) && seconds >= 0) {\n      return Math.min(MAX_RETRY_DELAY_MS, seconds * 1_000);\n    }\n    const when = Date.parse(header);\n    if (Number.isFinite(when)) {\n      return Math.min(MAX_RETRY_DELAY_MS, Math.max(0, when - Date.now()));\n    }\n  }\n  return backoffMs(attempt);\n}\n","/**\n * Normalize Granola notes into Remnic's provider-agnostic\n * `WearableConversation` shape, plus the timezone-aware day-window helpers the\n * Granola `created_after`/`created_before` filters need.\n *\n * Granola transcript items carry absolute `start_time`/`end_time` (ISO) and a\n * `speaker.source` of `microphone` (the wearer's own captured audio) or\n * `speaker` (other meeting audio); iOS adds a `diarization_label`\n * (`Speaker A/B/...`). The wearables speaker registry owns final naming.\n * Meeting timing prefers the linked calendar event; notes with a summary but no\n * transcript degrade to a single `note` segment.\n */\n\nimport type {\n  WearableConversation,\n  WearableTranscriptSegment,\n} from \"@remnic/core\";\n\nimport type { GranolaNote } from \"./client.js\";\n\nexport const GRANOLA_SOURCE_ID = \"granola\";\n\n/** \"GMT+05:30\" → \"+05:30\"; plain \"GMT\" → \"+00:00\". */\nexport function timezoneOffsetIso(instant: Date, timezone: string): string {\n  try {\n    const parts = new Intl.DateTimeFormat(\"en-US\", {\n      timeZone: timezone,\n      timeZoneName: \"longOffset\",\n    }).formatToParts(instant);\n    const name = parts.find((part) => part.type === \"timeZoneName\")?.value ?? \"GMT\";\n    const match = name.match(/GMT([+-]\\d{2}:\\d{2})?/);\n    return match?.[1] ?? \"+00:00\";\n  } catch {\n    return \"+00:00\";\n  }\n}\n\n/** ISO instant for local midnight of `date` in `timezone`. */\nexport function zonedDayStartIso(date: string, timezone: string): string {\n  let offset = timezoneOffsetIso(new Date(`${date}T12:00:00Z`), timezone);\n  const candidate = new Date(`${date}T00:00:00${offset}`);\n  const refined = timezoneOffsetIso(candidate, timezone);\n  if (refined !== offset) {\n    offset = refined;\n  }\n  return `${date}T00:00:00${offset}`;\n}\n\nexport function nextIsoDate(date: string): string {\n  const parsed = new Date(`${date}T00:00:00Z`);\n  parsed.setUTCDate(parsed.getUTCDate() + 1);\n  return parsed.toISOString().slice(0, 10);\n}\n\n/**\n * Reject an invalid/unsupported IANA timezone loudly instead of silently\n * coercing to UTC and shifting every meeting's day window (AGENTS.md §39).\n */\nfunction assertValidTimezone(timezone: string): void {\n  try {\n    new Intl.DateTimeFormat(\"en-US\", { timeZone: timezone });\n  } catch {\n    throw new RangeError(\n      `Invalid IANA timezone \"${timezone}\" for the Granola connector — check wearables.timezone.`,\n    );\n  }\n}\n\n/**\n * Half-open [createdAfter, createdBefore) UTC ISO bounds of a local day — the\n * window the Granola notes list filters on.\n */\nexport function granolaDayWindow(\n  date: string,\n  timezone: string,\n): { createdAfter: string; createdBefore: string } {\n  assertValidTimezone(timezone);\n  return {\n    createdAfter: new Date(zonedDayStartIso(date, timezone)).toISOString(),\n    createdBefore: new Date(zonedDayStartIso(nextIsoDate(date), timezone)).toISOString(),\n  };\n}\n\nfunction trimmed(value: string | null | undefined): string | undefined {\n  return typeof value === \"string\" && value.trim().length > 0 ? value.trim() : undefined;\n}\n\nfunction isoOrUndefined(value: string | null | undefined): string | undefined {\n  if (typeof value !== \"string\" || value.trim().length === 0) return undefined;\n  const ms = Date.parse(value);\n  return Number.isFinite(ms) ? new Date(ms).toISOString() : undefined;\n}\n\nexport function noteToConversation(note: GranolaNote): WearableConversation {\n  const event = note.calendar_event ?? undefined;\n  const items = note.transcript ?? [];\n\n  const segments: WearableTranscriptSegment[] = [];\n  for (const item of items) {\n    const text = trimmed(item.text);\n    if (text === undefined) continue;\n    const source = trimmed(item.speaker?.source);\n    const label = trimmed(item.speaker?.diarization_label);\n    const startIso = isoOrUndefined(item.start_time);\n    const endIso = isoOrUndefined(item.end_time);\n    // macOS marks the wearer's own audio as `microphone` (vs `speaker` for\n    // other meeting audio). When a diarization_label is present (iOS single\n    // stream) the source no longer distinguishes the wearer, so don't guess.\n    const isWearer = source === \"microphone\" && label === undefined;\n    segments.push({\n      text,\n      speakerKey: label ?? source ?? \"unknown\",\n      ...(isWearer ? { isWearer: true } : {}),\n      ...(startIso !== undefined ? { startIso } : {}),\n      ...(endIso !== undefined ? { endIso } : {}),\n    });\n  }\n\n  const summary = trimmed(note.summary_text) ?? trimmed(note.summary_markdown);\n\n  // Note-only fallback: a summarized meeting with no transcript still anchors\n  // recall for the day.\n  if (segments.length === 0 && summary !== undefined) {\n    segments.push({ text: summary, speakerKey: \"note\" });\n  }\n\n  const title = trimmed(event?.event_title) ?? trimmed(note.title);\n  const startIso =\n    isoOrUndefined(event?.scheduled_start_time) ??\n    segments.find((segment) => segment.startIso !== undefined)?.startIso ??\n    isoOrUndefined(note.created_at) ??\n    \"\";\n  const endIso =\n    isoOrUndefined(event?.scheduled_end_time) ??\n    [...segments].reverse().find((segment) => segment.endIso !== undefined)?.endIso;\n\n  return {\n    id: note.id,\n    source: GRANOLA_SOURCE_ID,\n    ...(title !== undefined ? { title } : {}),\n    ...(summary !== undefined ? { summary } : {}),\n    startIso,\n    ...(endIso !== undefined ? { endIso } : {}),\n    segments,\n  };\n}\n"],"mappings":"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","names":["startIso","endIso"]}

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "@remnic/connector-granola",
+  "version": "9.15.0",
+  "description": "Granola meeting-notes connector for Remnic — pull, clean, and remember meeting transcripts and notes",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "peerDependencies": {
+    "@remnic/core": "^9.15.0"
+  },
+  "devDependencies": {
+    "tsup": "^8.0.0",
+    "typescript": "^5.7.0",
+    "tsx": "^4.0.0",
+    "@remnic/core": "9.15.0"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/joshuaswarren/remnic.git",
+    "directory": "packages/connector-granola"
+  },
+  "keywords": [
+    "remnic",
+    "memory",
+    "granola",
+    "meeting",
+    "transcript",
+    "wearable"
+  ],
+  "scripts": {
+    "build": "tsup src/index.ts --format esm --dts",
+    "precheck-types": "node ../../scripts/ensure-bench-build-deps.mjs",
+    "check-types": "tsc --noEmit",
+    "test": "NODE_OPTIONS=\"${NODE_OPTIONS:+$NODE_OPTIONS }--conditions=remnic-source\" tsx --test src/client.test.ts src/normalize.test.ts src/index.test.ts"
+  }
+}