@remnic/connector-omi 9.3.631

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,86 @@
+# @remnic/connector-omi
+
+Omi AI wearable connector for [Remnic](https://github.com/joshuaswarren/remnic).
+Pulls your Omi necklace conversations into Remnic's wearable-transcript
+pipeline: cleaned, speaker-labeled, redacted, searchable day
+transcripts — and, under per-source trust gates, memories. Optionally
+imports Omi's own "memories" (extracted facts) into the review queue.
+
+This is an **à-la-carte optional companion** of `@remnic/core`:
+
+```bash
+npm install -g @remnic/connector-omi
+```
+
+Remnic discovers it at runtime. No further registration is needed.
+
+## Setup
+
+The connector uses Omi's Integrations API, which is scoped to an app
+you create:
+
+1. In the Omi app: **Apps → Create App → External Integration**, and
+   grant the **read conversations** capability (plus **read memories**
+   if you want native-memory import). Install/enable the app for your
+   account.
+2. On the app's management page, create an **API key** (`sk_...`).
+3. Note your **app id** and your **uid** (Omi passes `?uid=` to your
+   app's links; it identifies the account to read).
+4. Configure:
+
+```jsonc
+{
+  "wearables": {
+    "enabled": true,
+    "sources": {
+      "omi": {
+        "enabled": true,
+        "appId": "your-omi-app-id",
+        "userId": "your-omi-uid",
+        "memoryMode": "smart",             // smart (default) | off | review | auto
+        "importNativeMemories": "smart"    // Omi memories through the same trust pipeline
+      }
+    }
+  }
+}
+```
+
+Provide the key via `OMI_API_KEY` (or `REMNIC_OMI_API_KEY`, or `apiKey`
+in config).
+
+## Usage
+
+```bash
+remnic wearables check omi
+remnic wearables sync --source omi --days 7
+remnic wearables transcript --date 2026-06-10 --source omi
+```
+
+## Speaker labels
+
+Omi marks the wearer (`is_user`) automatically. Other voices arrive as
+`SPEAKER_NN` diarization labels — or stable person ids once you tag
+people in Omi. Map either form to a display name once:
+
+```bash
+remnic wearables speakers set omi SPEAKER_01 "Jane Doe"
+```
+
+## Notes
+
+- Transcripts are fetched **unabridged**: the connector passes
+  `max_transcript_segments=-1` because the API's default silently
+  truncates conversations to their first 100 segments.
+- Day windows are timezone-correct: the connector computes local-day
+  ISO bounds (DST-aware) for the API's `start_date`/`end_date` filters,
+  and only `completed`, non-discarded conversations sync.
+- Default `memoryMode: "smart"`: the LLM judge + per-source trust prior
+  + cross-device corroboration write high-trust facts active, queue
+  borderline ones, and drop the rest. Omi-native memories run through
+  the same pipeline with a reduced prior.
+
+Full documentation: [docs/wearables.md](https://github.com/joshuaswarren/remnic/blob/main/docs/wearables.md).
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,165 @@
+import { WearableConversation, WearableNativeMemory, WearableConnectorFactoryOptions, WearableSourceConnector, WearableConnectorRegistration } from '@remnic/core';
+
+/**
+ * Minimal Omi Integrations API client (raw fetch, no SDK).
+ *
+ * Contract verified against docs.omi.me and the open-source backend
+ * (`backend/routers/integration.py`, `models/integrations.py`) in
+ * 2026-06:
+ *
+ *  - base `https://api.omi.me`, auth `Authorization: Bearer sk_...`
+ *    (an app API key created in the Omi app; the app needs the
+ *    External Integration `read_conversations` / `read_memories`
+ *    capabilities and must be enabled for the target user)
+ *  - `uid` rides as a query parameter on every endpoint
+ *  - `GET /v2/integrations/{app_id}/conversations` with
+ *    `limit`/`offset` pagination, `start_date`/`end_date` (ISO 8601),
+ *    repeated `statuses` params, and `max_transcript_segments=-1`
+ *    (the API default silently truncates to the first 100 segments)
+ *  - `GET /v2/integrations/{app_id}/memories` with `limit`/`offset`
+ *  - responses serialize with exclude_none — every optional field may
+ *    be entirely absent
+ *  - errors are FastAPI-shaped `{"detail": "..."}`
+ *
+ * The API key is never logged and never appears in thrown error
+ * messages.
+ */
+declare const OMI_DEFAULT_BASE_URL = "https://api.omi.me";
+interface OmiTranscriptSegment {
+    text?: string;
+    speaker?: string;
+    is_user?: boolean;
+    person_id?: string | null;
+    start?: number;
+    end?: number;
+}
+interface OmiConversation {
+    id: string;
+    created_at?: string;
+    started_at?: string;
+    finished_at?: string;
+    structured?: {
+        title?: string;
+        overview?: string;
+        category?: string;
+        action_items?: Array<{
+            description?: string;
+            completed?: boolean;
+        }>;
+    };
+    transcript_segments?: OmiTranscriptSegment[];
+    geolocation?: {
+        address?: string | null;
+    } | null;
+    status?: string;
+    discarded?: boolean;
+}
+interface OmiMemory {
+    id: string;
+    content?: string;
+    category?: string;
+    tags?: string[];
+    created_at?: string;
+}
+interface OmiConversationsPage {
+    conversations: OmiConversation[];
+    nextOffset: number | null;
+}
+interface OmiMemoriesPage {
+    memories: OmiMemory[];
+    nextOffset: number | null;
+}
+interface OmiClientOptions {
+    apiKey: string;
+    appId: string;
+    userId: string;
+    baseUrl?: string;
+    fetchImpl?: typeof fetch;
+    timeoutMs?: number;
+    sleep?: (ms: number) => Promise<void>;
+}
+declare class OmiApiError extends Error {
+    readonly status?: number | undefined;
+    /** FastAPI `detail` string when the body carried one. */
+    readonly detail?: string | undefined;
+    constructor(message: string, status?: number | undefined, 
+    /** FastAPI `detail` string when the body carried one. */
+    detail?: string | undefined);
+}
+declare class OmiClient {
+    private readonly apiKey;
+    private readonly appId;
+    private readonly userId;
+    private readonly baseUrl;
+    private readonly fetchImpl;
+    private readonly timeoutMs;
+    private readonly sleep;
+    constructor(options: OmiClientOptions);
+    /** One page of completed conversations inside [startIso, endIso). */
+    listConversations(params: {
+        startIso: string;
+        endIso: string;
+        offset?: number;
+        signal?: AbortSignal;
+    }): Promise<OmiConversationsPage>;
+    /** One page of Omi memories (provider-extracted facts). */
+    listMemories(params?: {
+        offset?: number;
+        signal?: AbortSignal;
+    }): Promise<OmiMemoriesPage>;
+    verifyAuth(signal?: AbortSignal): Promise<{
+        ok: boolean;
+        detail?: string;
+    }>;
+    private requestJson;
+}
+
+/**
+ * Normalize Omi conversations into Remnic's provider-agnostic
+ * `WearableConversation` shape, plus the timezone-aware day-window
+ * helpers the Omi API needs (its date filters are ISO datetimes).
+ *
+ * Omi segments carry `is_user` for the wearer, opaque `SPEAKER_NN`
+ * diarization labels, optional `person_id`s (user-defined people), and
+ * start/end offsets in seconds relative to the conversation start.
+ */
+
+declare const OMI_SOURCE_ID = "omi";
+/** "GMT+05:30" → "+05:30"; plain "GMT" → "+00:00". */
+declare function timezoneOffsetIso(instant: Date, timezone: string): string;
+/** ISO instant for local midnight of `date` in `timezone`. */
+declare function zonedDayStartIso(date: string, timezone: string): string;
+declare function nextIsoDate(date: string): string;
+/** Half-open [start, end) ISO bounds of a local day. */
+declare function zonedDayBounds(date: string, timezone: string): {
+    startIso: string;
+    endIso: string;
+};
+declare function conversationToWearable(conversation: OmiConversation): WearableConversation;
+declare function memoryToNativeMemory(memory: OmiMemory): WearableNativeMemory | null;
+
+/**
+ * @remnic/connector-omi — Omi AI wearable connector.
+ *
+ * À-la-carte optional companion of @remnic/core (computed-specifier
+ * discovery; importing this module self-registers idempotently).
+ *
+ * Requires an Omi integration app with the External Integration
+ * `read_conversations` (and, for native-memory import,
+ * `read_memories`) capabilities:
+ *   - `wearables.sources.omi.appId`  — the app id
+ *   - `wearables.sources.omi.userId` — the target uid
+ *   - key via `REMNIC_OMI_API_KEY` / `OMI_API_KEY` env (or `apiKey`)
+ */
+
+declare function resolveOmiApiKey(configuredKey: string | undefined, env?: NodeJS.ProcessEnv): string | undefined;
+declare function createOmiConnector(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 this again is safe
+ * (returns false when already registered).
+ */
+declare function ensureOmiConnectorRegistered(): boolean;
+
+export { OMI_DEFAULT_BASE_URL, OMI_SOURCE_ID, OmiApiError, OmiClient, type OmiClientOptions, type OmiConversation, type OmiConversationsPage, type OmiMemoriesPage, type OmiMemory, type OmiTranscriptSegment, conversationToWearable, createOmiConnector, ensureOmiConnectorRegistered, memoryToNativeMemory, nextIsoDate, resolveOmiApiKey, timezoneOffsetIso, wearableConnectorRegistration, zonedDayBounds, zonedDayStartIso };

package/dist/index.js

@@ -0,0 +1,409 @@
+// openclaw-engram: Local-first memory plugin
+
+// src/index.ts
+import {
+  registerWearableConnector,
+  getWearableConnector
+} from "@remnic/core";
+
+// src/client.ts
+var OMI_DEFAULT_BASE_URL = "https://api.omi.me";
+var DEFAULT_TIMEOUT_MS = 3e4;
+var MAX_RETRIES = 3;
+var MAX_RETRY_DELAY_MS = 3e4;
+var PAGE_SIZE = 100;
+var OmiApiError = class extends Error {
+  constructor(message, status, detail) {
+    super(message);
+    this.status = status;
+    this.detail = detail;
+    this.name = "OmiApiError";
+  }
+  status;
+  detail;
+};
+var OmiClient = class {
+  apiKey;
+  appId;
+  userId;
+  baseUrl;
+  fetchImpl;
+  timeoutMs;
+  sleep;
+  constructor(options) {
+    if (typeof options.apiKey !== "string" || options.apiKey.trim().length === 0) {
+      throw new OmiApiError(
+        "Omi API key is missing. Set wearables.sources.omi.apiKey or the OMI_API_KEY environment variable (create a key under your app's API Keys in the Omi app)."
+      );
+    }
+    if (typeof options.appId !== "string" || options.appId.trim().length === 0) {
+      throw new OmiApiError(
+        "Omi app id is missing. Set wearables.sources.omi.appId to your integration app's id."
+      );
+    }
+    if (typeof options.userId !== "string" || options.userId.trim().length === 0) {
+      throw new OmiApiError(
+        "Omi user id is missing. Set wearables.sources.omi.userId to the target uid (shown when the user installs/opens your Omi app)."
+      );
+    }
+    this.apiKey = options.apiKey.trim();
+    this.appId = options.appId.trim();
+    this.userId = options.userId.trim();
+    this.baseUrl = stripTrailingSlashes(options.baseUrl ?? OMI_DEFAULT_BASE_URL);
+    this.fetchImpl = options.fetchImpl ?? fetch;
+    this.timeoutMs = options.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+    this.sleep = options.sleep ?? ((ms) => new Promise((resolve) => setTimeout(resolve, ms)));
+  }
+  /** One page of completed conversations inside [startIso, endIso). */
+  async listConversations(params) {
+    const offset = params.offset ?? 0;
+    const search = new URLSearchParams({
+      uid: this.userId,
+      limit: String(PAGE_SIZE),
+      offset: String(offset),
+      start_date: params.startIso,
+      end_date: params.endIso,
+      include_discarded: "false",
+      // -1 = unlimited; the API default silently truncates transcripts
+      // to their first 100 segments.
+      max_transcript_segments: "-1"
+    });
+    search.append("statuses", "completed");
+    const payload = await this.requestJson(
+      `/v2/integrations/${encodeURIComponent(this.appId)}/conversations?${search.toString()}`,
+      params.signal
+    );
+    const conversations = payload.conversations;
+    if (!Array.isArray(conversations)) {
+      throw new OmiApiError(
+        "Omi API returned an unexpected conversations shape (missing conversations array)"
+      );
+    }
+    const valid = conversations.filter(
+      (entry) => entry !== null && typeof entry === "object" && typeof entry.id === "string"
+    );
+    return {
+      conversations: valid,
+      nextOffset: conversations.length === PAGE_SIZE ? offset + PAGE_SIZE : null
+    };
+  }
+  /** One page of Omi memories (provider-extracted facts). */
+  async listMemories(params = {}) {
+    const offset = params.offset ?? 0;
+    const search = new URLSearchParams({
+      uid: this.userId,
+      limit: String(PAGE_SIZE),
+      offset: String(offset)
+    });
+    const payload = await this.requestJson(
+      `/v2/integrations/${encodeURIComponent(this.appId)}/memories?${search.toString()}`,
+      params.signal
+    );
+    const memories = payload.memories;
+    if (!Array.isArray(memories)) {
+      throw new OmiApiError(
+        "Omi API returned an unexpected memories shape (missing memories array)"
+      );
+    }
+    const valid = memories.filter(
+      (entry) => entry !== null && typeof entry === "object" && typeof entry.id === "string"
+    );
+    return {
+      memories: valid,
+      nextOffset: memories.length === PAGE_SIZE ? offset + PAGE_SIZE : null
+    };
+  }
+  async verifyAuth(signal) {
+    try {
+      const search = new URLSearchParams({
+        uid: this.userId,
+        limit: "1",
+        offset: "0",
+        max_transcript_segments: "1"
+      });
+      await this.requestJson(
+        `/v2/integrations/${encodeURIComponent(this.appId)}/conversations?${search.toString()}`,
+        signal
+      );
+      return { ok: true };
+    } catch (err) {
+      if (err instanceof OmiApiError && err.status !== void 0) {
+        const hint = err.status === 401 ? "missing/malformed Authorization header" : err.status === 403 ? "key rejected, app not enabled for this uid, or missing read_conversations capability" : err.status === 404 ? "app not found \u2014 check wearables.sources.omi.appId" : void 0;
+        return {
+          ok: false,
+          detail: [err.detail, hint].filter(Boolean).join(" \u2014 ") || err.message
+        };
+      }
+      return {
+        ok: false,
+        detail: err instanceof OmiApiError ? err.message : describeNetworkError(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 OmiApiError(
+          `Omi API request failed after ${MAX_RETRIES + 1} attempts: ${describeNetworkError(err)}`
+        );
+      }
+      if (response.status === 429 || response.status >= 500) {
+        lastError = new OmiApiError(
+          `Omi API responded ${response.status}`,
+          response.status,
+          await readDetail(response)
+        );
+        if (attempt < MAX_RETRIES) {
+          await this.sleep(retryDelayMs(response, attempt));
+          continue;
+        }
+        throw lastError;
+      }
+      if (!response.ok) {
+        throw new OmiApiError(
+          `Omi API responded ${response.status} for ${pathAndQuery.split("?")[0]}`,
+          response.status,
+          await readDetail(response)
+        );
+      }
+      try {
+        return await response.json();
+      } catch {
+        throw new OmiApiError("Omi API returned a non-JSON body");
+      }
+    }
+    throw lastError instanceof Error ? lastError : new OmiApiError("Omi API request failed");
+  }
+};
+function describeNetworkError(err) {
+  if (!(err instanceof Error)) return "unexpected non-Error failure";
+  const code = err.code;
+  return typeof code === "string" && code.length > 0 ? `${err.name} (${code})` : err.name;
+}
+function stripTrailingSlashes(value) {
+  let end = value.length;
+  while (end > 0 && value.charCodeAt(end - 1) === 47) end--;
+  return value.slice(0, end);
+}
+async function readDetail(response) {
+  try {
+    const body = await response.clone().json();
+    return typeof body?.detail === "string" ? body.detail : void 0;
+  } catch {
+    return void 0;
+  }
+}
+function backoffMs(attempt) {
+  return Math.min(MAX_RETRY_DELAY_MS, 1e3 * 2 ** attempt);
+}
+function retryDelayMs(response, attempt) {
+  const headerValue = response.headers.get("retry-after");
+  if (headerValue !== null) {
+    const parsed = Number(headerValue);
+    if (Number.isFinite(parsed) && parsed > 0) {
+      return Math.min(MAX_RETRY_DELAY_MS, Math.ceil(parsed * 1e3));
+    }
+  }
+  return backoffMs(attempt);
+}
+
+// src/normalize.ts
+var OMI_SOURCE_ID = "omi";
+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 zonedDayBounds(date, timezone) {
+  return {
+    startIso: zonedDayStartIso(date, timezone),
+    endIso: zonedDayStartIso(nextIsoDate(date), timezone)
+  };
+}
+function conversationToWearable(conversation) {
+  const startedAtMs = conversation.started_at ? Date.parse(conversation.started_at) : Number.NaN;
+  const segments = [];
+  for (const segment of conversation.transcript_segments ?? []) {
+    const text = typeof segment.text === "string" ? segment.text.trim() : "";
+    if (text.length === 0) continue;
+    const isWearer = segment.is_user === true;
+    const personId = typeof segment.person_id === "string" && segment.person_id.length > 0 ? segment.person_id : void 0;
+    const label = typeof segment.speaker === "string" && segment.speaker.trim().length > 0 ? segment.speaker.trim() : void 0;
+    const startIso = !Number.isNaN(startedAtMs) && typeof segment.start === "number" ? new Date(startedAtMs + segment.start * 1e3).toISOString() : void 0;
+    const endIso = !Number.isNaN(startedAtMs) && typeof segment.end === "number" ? new Date(startedAtMs + segment.end * 1e3).toISOString() : void 0;
+    segments.push({
+      text,
+      // person_id is the most stable key when the user has tagged the
+      // speaker as a known person in Omi; the diarization label
+      // otherwise.
+      speakerKey: isWearer ? "user" : personId ?? label ?? "unknown",
+      ...label !== void 0 ? { speakerName: label } : {},
+      ...isWearer ? { isWearer: true } : {},
+      ...startIso !== void 0 ? { startIso } : {},
+      ...endIso !== void 0 ? { endIso } : {}
+    });
+  }
+  const title = conversation.structured?.title?.trim();
+  const overview = conversation.structured?.overview?.trim();
+  const address = conversation.geolocation?.address;
+  return {
+    id: conversation.id,
+    source: OMI_SOURCE_ID,
+    ...title && title.length > 0 ? { title } : {},
+    ...overview && overview.length > 0 ? { summary: overview } : {},
+    startIso: conversation.started_at ?? conversation.created_at ?? "",
+    ...conversation.finished_at !== void 0 ? { endIso: conversation.finished_at } : {},
+    ...typeof address === "string" && address.length > 0 ? { location: address } : {},
+    segments
+  };
+}
+function memoryToNativeMemory(memory) {
+  const content = typeof memory.content === "string" ? memory.content.trim() : "";
+  if (content.length === 0) return null;
+  return {
+    id: memory.id,
+    content,
+    ...memory.created_at !== void 0 ? { createdIso: memory.created_at } : {},
+    ...Array.isArray(memory.tags) && memory.tags.length > 0 ? { tags: memory.tags } : {}
+  };
+}
+
+// src/index.ts
+function resolveOmiApiKey(configuredKey, env = process.env) {
+  if (typeof configuredKey === "string" && configuredKey.trim().length > 0) {
+    return configuredKey.trim();
+  }
+  for (const name of ["REMNIC_OMI_API_KEY", "OMI_API_KEY"]) {
+    const value = env[name];
+    if (typeof value === "string" && value.trim().length > 0) {
+      return value.trim();
+    }
+  }
+  return void 0;
+}
+function parseOffsetCursor(cursor) {
+  if (typeof cursor !== "string" || cursor.length === 0) return 0;
+  const parsed = Number(cursor);
+  return Number.isInteger(parsed) && parsed > 0 ? parsed : 0;
+}
+function createOmiConnector(options) {
+  let client = null;
+  const getClient = () => {
+    if (!client) {
+      client = new OmiClient({
+        apiKey: resolveOmiApiKey(options.settings.apiKey) ?? "",
+        appId: options.settings.appId ?? "",
+        userId: options.settings.userId ?? "",
+        baseUrl: options.settings.baseUrl
+      });
+    }
+    return client;
+  };
+  return {
+    id: OMI_SOURCE_ID,
+    displayName: "Omi",
+    async verifyAuth(signal) {
+      return getClient().verifyAuth(signal);
+    },
+    async fetchConversations(opts) {
+      const bounds = zonedDayBounds(opts.date, opts.timezone);
+      const page = await getClient().listConversations({
+        startIso: bounds.startIso,
+        endIso: bounds.endIso,
+        offset: parseOffsetCursor(opts.cursor),
+        signal: opts.signal
+      });
+      return {
+        conversations: page.conversations.filter((conversation) => conversation.discarded !== true).map(conversationToWearable),
+        nextCursor: page.nextOffset !== null ? String(page.nextOffset) : null
+      };
+    },
+    async fetchNativeMemories(opts) {
+      const page = await getClient().listMemories({
+        offset: parseOffsetCursor(opts.cursor),
+        signal: opts.signal
+      });
+      const memories = [];
+      for (const memory of page.memories) {
+        const mapped = memoryToNativeMemory(memory);
+        if (mapped !== null) memories.push(mapped);
+      }
+      return {
+        memories,
+        nextCursor: page.nextOffset !== null ? String(page.nextOffset) : null
+      };
+    }
+  };
+}
+var wearableConnectorRegistration = {
+  id: OMI_SOURCE_ID,
+  displayName: "Omi",
+  factory: createOmiConnector
+};
+function ensureOmiConnectorRegistered() {
+  if (getWearableConnector(OMI_SOURCE_ID) !== void 0) {
+    return false;
+  }
+  registerWearableConnector(wearableConnectorRegistration);
+  return true;
+}
+ensureOmiConnectorRegistered();
+export {
+  OMI_DEFAULT_BASE_URL,
+  OMI_SOURCE_ID,
+  OmiApiError,
+  OmiClient,
+  conversationToWearable,
+  createOmiConnector,
+  ensureOmiConnectorRegistered,
+  memoryToNativeMemory,
+  nextIsoDate,
+  resolveOmiApiKey,
+  timezoneOffsetIso,
+  wearableConnectorRegistration,
+  zonedDayBounds,
+  zonedDayStartIso
+};
+//# 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-omi — Omi AI wearable connector.\n *\n * À-la-carte optional companion of @remnic/core (computed-specifier\n * discovery; importing this module self-registers idempotently).\n *\n * Requires an Omi integration app with the External Integration\n * `read_conversations` (and, for native-memory import,\n * `read_memories`) capabilities:\n *   - `wearables.sources.omi.appId`  — the app id\n *   - `wearables.sources.omi.userId` — the target uid\n *   - key via `REMNIC_OMI_API_KEY` / `OMI_API_KEY` env (or `apiKey`)\n */\n\nimport {\n  registerWearableConnector,\n  getWearableConnector,\n  type WearableConnectorFactoryOptions,\n  type WearableConnectorRegistration,\n  type WearableFetchOptions,\n  type WearableFetchPage,\n  type WearableNativeMemoryPage,\n  type WearableSourceConnector,\n} from \"@remnic/core\";\n\nimport { OmiClient } from \"./client.js\";\nimport {\n  conversationToWearable,\n  memoryToNativeMemory,\n  OMI_SOURCE_ID,\n  zonedDayBounds,\n} from \"./normalize.js\";\n\nexport { OmiApiError, OmiClient, OMI_DEFAULT_BASE_URL } from \"./client.js\";\nexport type {\n  OmiClientOptions,\n  OmiConversation,\n  OmiConversationsPage,\n  OmiMemoriesPage,\n  OmiMemory,\n  OmiTranscriptSegment,\n} from \"./client.js\";\nexport {\n  conversationToWearable,\n  memoryToNativeMemory,\n  nextIsoDate,\n  OMI_SOURCE_ID,\n  timezoneOffsetIso,\n  zonedDayBounds,\n  zonedDayStartIso,\n} from \"./normalize.js\";\n\nexport function resolveOmiApiKey(\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_OMI_API_KEY\", \"OMI_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\nfunction parseOffsetCursor(cursor: string | null | undefined): number {\n  if (typeof cursor !== \"string\" || cursor.length === 0) return 0;\n  const parsed = Number(cursor);\n  return Number.isInteger(parsed) && parsed > 0 ? parsed : 0;\n}\n\nexport function createOmiConnector(\n  options: WearableConnectorFactoryOptions,\n): WearableSourceConnector {\n  // Construction is lazy so `wearables status` works without\n  // credentials; the client constructor throws the actionable\n  // missing-credential messages at call time.\n  let client: OmiClient | null = null;\n  const getClient = (): OmiClient => {\n    if (!client) {\n      client = new OmiClient({\n        apiKey: resolveOmiApiKey(options.settings.apiKey) ?? \"\",\n        appId: options.settings.appId ?? \"\",\n        userId: options.settings.userId ?? \"\",\n        baseUrl: options.settings.baseUrl,\n      });\n    }\n    return client;\n  };\n\n  return {\n    id: OMI_SOURCE_ID,\n    displayName: \"Omi\",\n    async verifyAuth(signal?: AbortSignal) {\n      return getClient().verifyAuth(signal);\n    },\n    async fetchConversations(opts: WearableFetchOptions): Promise<WearableFetchPage> {\n      const bounds = zonedDayBounds(opts.date, opts.timezone);\n      const page = await getClient().listConversations({\n        startIso: bounds.startIso,\n        endIso: bounds.endIso,\n        offset: parseOffsetCursor(opts.cursor),\n        signal: opts.signal,\n      });\n      return {\n        conversations: page.conversations\n          .filter((conversation) => conversation.discarded !== true)\n          .map(conversationToWearable),\n        nextCursor: page.nextOffset !== null ? String(page.nextOffset) : null,\n      };\n    },\n    async fetchNativeMemories(opts: {\n      cursor?: string | null;\n      signal?: AbortSignal;\n    }): Promise<WearableNativeMemoryPage> {\n      const page = await getClient().listMemories({\n        offset: parseOffsetCursor(opts.cursor),\n        signal: opts.signal,\n      });\n      const memories = [];\n      for (const memory of page.memories) {\n        const mapped = memoryToNativeMemory(memory);\n        if (mapped !== null) memories.push(mapped);\n      }\n      return {\n        memories,\n        nextCursor: page.nextOffset !== null ? String(page.nextOffset) : null,\n      };\n    },\n  };\n}\n\nexport const wearableConnectorRegistration: WearableConnectorRegistration = {\n  id: OMI_SOURCE_ID,\n  displayName: \"Omi\",\n  factory: createOmiConnector,\n};\n\n/**\n * Idempotently register the connector with the core registry. Importing\n * this module registers it as a side effect; calling this again is safe\n * (returns false when already registered).\n */\nexport function ensureOmiConnectorRegistered(): boolean {\n  if (getWearableConnector(OMI_SOURCE_ID) !== undefined) {\n    return false;\n  }\n  registerWearableConnector(wearableConnectorRegistration);\n  return true;\n}\n\nensureOmiConnectorRegistered();\n","/**\n * Minimal Omi Integrations API client (raw fetch, no SDK).\n *\n * Contract verified against docs.omi.me and the open-source backend\n * (`backend/routers/integration.py`, `models/integrations.py`) in\n * 2026-06:\n *\n *  - base `https://api.omi.me`, auth `Authorization: Bearer sk_...`\n *    (an app API key created in the Omi app; the app needs the\n *    External Integration `read_conversations` / `read_memories`\n *    capabilities and must be enabled for the target user)\n *  - `uid` rides as a query parameter on every endpoint\n *  - `GET /v2/integrations/{app_id}/conversations` with\n *    `limit`/`offset` pagination, `start_date`/`end_date` (ISO 8601),\n *    repeated `statuses` params, and `max_transcript_segments=-1`\n *    (the API default silently truncates to the first 100 segments)\n *  - `GET /v2/integrations/{app_id}/memories` with `limit`/`offset`\n *  - responses serialize with exclude_none — every optional field may\n *    be entirely absent\n *  - errors are FastAPI-shaped `{\"detail\": \"...\"}`\n *\n * The API key is never logged and never appears in thrown error\n * messages.\n */\n\nexport const OMI_DEFAULT_BASE_URL = \"https://api.omi.me\";\n\nconst DEFAULT_TIMEOUT_MS = 30_000;\nconst MAX_RETRIES = 3;\nconst MAX_RETRY_DELAY_MS = 30_000;\n/** Page size for both conversations and memories (API max is 1000). */\nconst PAGE_SIZE = 100;\n\nexport interface OmiTranscriptSegment {\n  text?: string;\n  speaker?: string;\n  is_user?: boolean;\n  person_id?: string | null;\n  start?: number;\n  end?: number;\n}\n\nexport interface OmiConversation {\n  id: string;\n  created_at?: string;\n  started_at?: string;\n  finished_at?: string;\n  structured?: {\n    title?: string;\n    overview?: string;\n    category?: string;\n    action_items?: Array<{ description?: string; completed?: boolean }>;\n  };\n  transcript_segments?: OmiTranscriptSegment[];\n  geolocation?: { address?: string | null } | null;\n  status?: string;\n  discarded?: boolean;\n}\n\nexport interface OmiMemory {\n  id: string;\n  content?: string;\n  category?: string;\n  tags?: string[];\n  created_at?: string;\n}\n\nexport interface OmiConversationsPage {\n  conversations: OmiConversation[];\n  nextOffset: number | null;\n}\n\nexport interface OmiMemoriesPage {\n  memories: OmiMemory[];\n  nextOffset: number | null;\n}\n\nexport interface OmiClientOptions {\n  apiKey: string;\n  appId: string;\n  userId: string;\n  baseUrl?: string;\n  fetchImpl?: typeof fetch;\n  timeoutMs?: number;\n  sleep?: (ms: number) => Promise<void>;\n}\n\nexport class OmiApiError extends Error {\n  constructor(\n    message: string,\n    readonly status?: number,\n    /** FastAPI `detail` string when the body carried one. */\n    readonly detail?: string,\n  ) {\n    super(message);\n    this.name = \"OmiApiError\";\n  }\n}\n\nexport class OmiClient {\n  private readonly apiKey: string;\n  private readonly appId: string;\n  private readonly userId: 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: OmiClientOptions) {\n    if (typeof options.apiKey !== \"string\" || options.apiKey.trim().length === 0) {\n      throw new OmiApiError(\n        \"Omi API key is missing. Set wearables.sources.omi.apiKey or the \" +\n          \"OMI_API_KEY environment variable (create a key under your app's \" +\n          \"API Keys in the Omi app).\",\n      );\n    }\n    if (typeof options.appId !== \"string\" || options.appId.trim().length === 0) {\n      throw new OmiApiError(\n        \"Omi app id is missing. Set wearables.sources.omi.appId to your \" +\n          \"integration app's id.\",\n      );\n    }\n    if (typeof options.userId !== \"string\" || options.userId.trim().length === 0) {\n      throw new OmiApiError(\n        \"Omi user id is missing. Set wearables.sources.omi.userId to the \" +\n          \"target uid (shown when the user installs/opens your Omi app).\",\n      );\n    }\n    this.apiKey = options.apiKey.trim();\n    this.appId = options.appId.trim();\n    this.userId = options.userId.trim();\n    this.baseUrl = stripTrailingSlashes(options.baseUrl ?? OMI_DEFAULT_BASE_URL);\n    this.fetchImpl = options.fetchImpl ?? fetch;\n    this.timeoutMs = options.timeoutMs ?? DEFAULT_TIMEOUT_MS;\n    this.sleep =\n      options.sleep ?? ((ms: number) => new Promise((resolve) => setTimeout(resolve, ms)));\n  }\n\n  /** One page of completed conversations inside [startIso, endIso). */\n  async listConversations(params: {\n    startIso: string;\n    endIso: string;\n    offset?: number;\n    signal?: AbortSignal;\n  }): Promise<OmiConversationsPage> {\n    const offset = params.offset ?? 0;\n    const search = new URLSearchParams({\n      uid: this.userId,\n      limit: String(PAGE_SIZE),\n      offset: String(offset),\n      start_date: params.startIso,\n      end_date: params.endIso,\n      include_discarded: \"false\",\n      // -1 = unlimited; the API default silently truncates transcripts\n      // to their first 100 segments.\n      max_transcript_segments: \"-1\",\n    });\n    // Repeated param (FastAPI List[str]) — comma-joining does NOT work.\n    search.append(\"statuses\", \"completed\");\n    const payload = await this.requestJson(\n      `/v2/integrations/${encodeURIComponent(this.appId)}/conversations?${search.toString()}`,\n      params.signal,\n    );\n    const conversations = (payload as { conversations?: unknown }).conversations;\n    if (!Array.isArray(conversations)) {\n      throw new OmiApiError(\n        \"Omi API returned an unexpected conversations shape (missing conversations array)\",\n      );\n    }\n    const valid = conversations.filter(\n      (entry): entry is OmiConversation =>\n        entry !== null &&\n        typeof entry === \"object\" &&\n        typeof (entry as { id?: unknown }).id === \"string\",\n    );\n    return {\n      conversations: valid,\n      nextOffset: conversations.length === PAGE_SIZE ? offset + PAGE_SIZE : null,\n    };\n  }\n\n  /** One page of Omi memories (provider-extracted facts). */\n  async listMemories(params: {\n    offset?: number;\n    signal?: AbortSignal;\n  } = {}): Promise<OmiMemoriesPage> {\n    const offset = params.offset ?? 0;\n    const search = new URLSearchParams({\n      uid: this.userId,\n      limit: String(PAGE_SIZE),\n      offset: String(offset),\n    });\n    const payload = await this.requestJson(\n      `/v2/integrations/${encodeURIComponent(this.appId)}/memories?${search.toString()}`,\n      params.signal,\n    );\n    const memories = (payload as { memories?: unknown }).memories;\n    if (!Array.isArray(memories)) {\n      throw new OmiApiError(\n        \"Omi API returned an unexpected memories shape (missing memories array)\",\n      );\n    }\n    const valid = memories.filter(\n      (entry): entry is OmiMemory =>\n        entry !== null &&\n        typeof entry === \"object\" &&\n        typeof (entry as { id?: unknown }).id === \"string\",\n    );\n    return {\n      memories: valid,\n      nextOffset: memories.length === PAGE_SIZE ? offset + PAGE_SIZE : null,\n    };\n  }\n\n  async verifyAuth(signal?: AbortSignal): Promise<{ ok: boolean; detail?: string }> {\n    try {\n      const search = new URLSearchParams({\n        uid: this.userId,\n        limit: \"1\",\n        offset: \"0\",\n        max_transcript_segments: \"1\",\n      });\n      await this.requestJson(\n        `/v2/integrations/${encodeURIComponent(this.appId)}/conversations?${search.toString()}`,\n        signal,\n      );\n      return { ok: true };\n    } catch (err) {\n      if (err instanceof OmiApiError && err.status !== undefined) {\n        // The backend's authorization chain yields distinct, actionable\n        // detail strings: bad key (403), app not enabled for the user\n        // (403), missing capability (403), app not found (404).\n        const hint =\n          err.status === 401\n            ? \"missing/malformed Authorization header\"\n            : err.status === 403\n              ? \"key rejected, app not enabled for this uid, or missing read_conversations capability\"\n              : err.status === 404\n                ? \"app not found — check wearables.sources.omi.appId\"\n                : undefined;\n        return {\n          ok: false,\n          detail: [err.detail, hint].filter(Boolean).join(\" — \") || err.message,\n        };\n      }\n      // OmiApiError messages are our own constructed strings (already\n      // scrubbed — network text is reduced to name + code inside\n      // requestJson); foreign errors reduce to name + errno code so raw\n      // Node text (paths, loader stacks) never reaches operator\n      // surfaces.\n      return {\n        ok: false,\n        detail: err instanceof OmiApiError ? err.message : describeNetworkError(err),\n      };\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 OmiApiError(\n          `Omi API request failed after ${MAX_RETRIES + 1} attempts: ${describeNetworkError(err)}`,\n        );\n      }\n\n      if (response.status === 429 || response.status >= 500) {\n        lastError = new OmiApiError(\n          `Omi API responded ${response.status}`,\n          response.status,\n          await readDetail(response),\n        );\n        if (attempt < MAX_RETRIES) {\n          await this.sleep(retryDelayMs(response, attempt));\n          continue;\n        }\n        throw lastError;\n      }\n      if (!response.ok) {\n        throw new OmiApiError(\n          `Omi API responded ${response.status} for ${pathAndQuery.split(\"?\")[0]}`,\n          response.status,\n          await readDetail(response),\n        );\n      }\n      try {\n        return await response.json();\n      } catch {\n        throw new OmiApiError(\"Omi API returned a non-JSON body\");\n      }\n    }\n    throw lastError instanceof Error ? lastError : new OmiApiError(\"Omi API request failed\");\n  }\n}\n\n/**\n * Network/timeout failures wrap Node error text that can carry loader\n * paths or stack fragments; sync errors reach MCP clients verbatim, so\n * only the error name + code survive.\n */\nfunction describeNetworkError(err: unknown): string {\n  if (!(err instanceof Error)) return \"unexpected non-Error failure\";\n  const code = (err as NodeJS.ErrnoException).code;\n  return typeof code === \"string\" && code.length > 0 ? `${err.name} (${code})` : err.name;\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) === 0x2f) end--;\n  return value.slice(0, end);\n}\n\nasync function readDetail(response: Response): Promise<string | undefined> {\n  try {\n    const body = (await response.clone().json()) as { detail?: unknown };\n    return typeof body?.detail === \"string\" ? body.detail : undefined;\n  } catch {\n    return undefined;\n  }\n}\n\nfunction backoffMs(attempt: number): number {\n  return Math.min(MAX_RETRY_DELAY_MS, 1_000 * 2 ** attempt);\n}\n\nfunction retryDelayMs(response: Response, attempt: number): number {\n  const headerValue = response.headers.get(\"retry-after\");\n  if (headerValue !== null) {\n    const parsed = Number(headerValue);\n    if (Number.isFinite(parsed) && parsed > 0) {\n      return Math.min(MAX_RETRY_DELAY_MS, Math.ceil(parsed * 1_000));\n    }\n  }\n  return backoffMs(attempt);\n}\n","/**\n * Normalize Omi conversations into Remnic's provider-agnostic\n * `WearableConversation` shape, plus the timezone-aware day-window\n * helpers the Omi API needs (its date filters are ISO datetimes).\n *\n * Omi segments carry `is_user` for the wearer, opaque `SPEAKER_NN`\n * diarization labels, optional `person_id`s (user-defined people), and\n * start/end offsets in seconds relative to the conversation start.\n */\n\nimport type {\n  WearableConversation,\n  WearableNativeMemory,\n  WearableTranscriptSegment,\n} from \"@remnic/core\";\n\nimport type { OmiConversation, OmiMemory } from \"./client.js\";\n\nexport const OMI_SOURCE_ID = \"omi\";\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  // Two-pass offset resolution: guess from midday (stable away from DST\n  // transitions), then re-derive at the candidate midnight itself.\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/** Half-open [start, end) ISO bounds of a local day. */\nexport function zonedDayBounds(\n  date: string,\n  timezone: string,\n): { startIso: string; endIso: string } {\n  return {\n    startIso: zonedDayStartIso(date, timezone),\n    endIso: zonedDayStartIso(nextIsoDate(date), timezone),\n  };\n}\n\nexport function conversationToWearable(\n  conversation: OmiConversation,\n): WearableConversation {\n  const startedAtMs = conversation.started_at\n    ? Date.parse(conversation.started_at)\n    : Number.NaN;\n  const segments: WearableTranscriptSegment[] = [];\n  for (const segment of conversation.transcript_segments ?? []) {\n    const text = typeof segment.text === \"string\" ? segment.text.trim() : \"\";\n    if (text.length === 0) continue;\n    const isWearer = segment.is_user === true;\n    const personId =\n      typeof segment.person_id === \"string\" && segment.person_id.length > 0\n        ? segment.person_id\n        : undefined;\n    const label =\n      typeof segment.speaker === \"string\" && segment.speaker.trim().length > 0\n        ? segment.speaker.trim()\n        : undefined;\n    const startIso =\n      !Number.isNaN(startedAtMs) && typeof segment.start === \"number\"\n        ? new Date(startedAtMs + segment.start * 1_000).toISOString()\n        : undefined;\n    const endIso =\n      !Number.isNaN(startedAtMs) && typeof segment.end === \"number\"\n        ? new Date(startedAtMs + segment.end * 1_000).toISOString()\n        : undefined;\n    segments.push({\n      text,\n      // person_id is the most stable key when the user has tagged the\n      // speaker as a known person in Omi; the diarization label\n      // otherwise.\n      speakerKey: isWearer ? \"user\" : (personId ?? label ?? \"unknown\"),\n      ...(label !== undefined ? { speakerName: label } : {}),\n      ...(isWearer ? { isWearer: true } : {}),\n      ...(startIso !== undefined ? { startIso } : {}),\n      ...(endIso !== undefined ? { endIso } : {}),\n    });\n  }\n\n  const title = conversation.structured?.title?.trim();\n  const overview = conversation.structured?.overview?.trim();\n  const address = conversation.geolocation?.address;\n\n  return {\n    id: conversation.id,\n    source: OMI_SOURCE_ID,\n    ...(title && title.length > 0 ? { title } : {}),\n    ...(overview && overview.length > 0 ? { summary: overview } : {}),\n    startIso: conversation.started_at ?? conversation.created_at ?? \"\",\n    ...(conversation.finished_at !== undefined\n      ? { endIso: conversation.finished_at }\n      : {}),\n    ...(typeof address === \"string\" && address.length > 0\n      ? { location: address }\n      : {}),\n    segments,\n  };\n}\n\nexport function memoryToNativeMemory(memory: OmiMemory): WearableNativeMemory | null {\n  const content = typeof memory.content === \"string\" ? memory.content.trim() : \"\";\n  if (content.length === 0) return null;\n  return {\n    id: memory.id,\n    content,\n    ...(memory.created_at !== undefined ? { createdIso: memory.created_at } : {}),\n    ...(Array.isArray(memory.tags) && memory.tags.length > 0\n      ? { tags: memory.tags }\n      : {}),\n  };\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "@remnic/connector-omi",
+  "version": "9.3.631",
+  "description": "Omi AI wearable connector for Remnic — pull, clean, and remember necklace transcripts via the Omi Integrations API",
+  "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"
+  },
+  "peerDependencies": {
+    "@remnic/core": "^9.3.631"
+  },
+  "devDependencies": {
+    "tsup": "^8.0.0",
+    "typescript": "^5.7.0",
+    "tsx": "^4.0.0",
+    "@remnic/core": "9.3.631"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/joshuaswarren/remnic.git",
+    "directory": "packages/connector-omi"
+  },
+  "keywords": [
+    "remnic",
+    "memory",
+    "omi",
+    "omi.me",
+    "wearable",
+    "transcript"
+  ],
+  "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"
+  }
+}