@arbidocs/sdk 0.3.140 → 0.3.142

package/dist/{browser-B9JRGjYZ.d.cts → browser-Cj68Nzgn.d.cts}

@@ -1414,7 +1414,7 @@ declare namespace assistant {
  */
 
 declare function listContacts(arbi: ArbiClient): Promise<{
-    external_id: string;
+    external_id?: string | null | undefined;
     email: string;
     user?: {
         external_id: string;
@@ -1426,11 +1426,13 @@ declare function listContacts(arbi: ArbiClient): Promise<{
         encryption_public_key: string;
         is_sso: boolean;
     } | null | undefined;
-    status: "invitation_pending" | "invitation_expired" | "registered";
+    status: "invitation_pending" | "invitation_expired" | "registered" | "failed";
     created_at: string;
+    outcome?: ("invited" | "reinvited" | "not_resent_still_pending" | "contact_added" | "already_contact" | "failed") | null | undefined;
+    outcome_detail?: string | null | undefined;
 }[]>;
 declare function addContacts(arbi: ArbiClient, emails: string[]): Promise<{
-    external_id: string;
+    external_id?: string | null | undefined;
     email: string;
     user?: {
         external_id: string;
@@ -1442,8 +1444,10 @@ declare function addContacts(arbi: ArbiClient, emails: string[]): Promise<{
         encryption_public_key: string;
         is_sso: boolean;
     } | null | undefined;
-    status: "invitation_pending" | "invitation_expired" | "registered";
+    status: "invitation_pending" | "invitation_expired" | "registered" | "failed";
     created_at: string;
+    outcome?: ("invited" | "reinvited" | "not_resent_still_pending" | "contact_added" | "already_contact" | "failed") | null | undefined;
+    outcome_detail?: string | null | undefined;
 }[]>;
 declare function removeContacts(arbi: ArbiClient, contactIds: string[]): Promise<void>;
 /**
@@ -1901,13 +1905,35 @@ type NoteSearchResponse = components['schemas']['NoteSearchResponse'];
 /** Create a note. `content` is required; `shared` makes it workspace-wide. */
 declare function createNote(arbi: ArbiClient, body: CreateNoteRequest): Promise<NoteResponse>;
 /** List the open workspace's notes (newest first). */
+/**
+ * List notes. Passing a date range — or `datedOnly` — turns this into the
+ * TIMELINE: only dated notes, ordered by when they happened rather than when
+ * they were written. Each bound is read at its own precision and widened
+ * outward, so `to: '2019'` runs through 31 December.
+ *
+ * The range selects by overlap, so a note spanning all of 2019 shows up in a
+ * one-month window it covers.
+ */
 declare function listNotes(arbi: ArbiClient, options?: {
     pinnedOnly?: boolean;
+    from?: string;
+    to?: string;
+    datedOnly?: boolean;
 }): Promise<NoteResponse[]>;
 /** Semantic/keyword/hybrid search across the workspace's notes. */
 declare function searchNotes(arbi: ArbiClient, body: NoteSearchRequest): Promise<NoteSearchResponse>;
 declare function updateNote(arbi: ArbiClient, memoryId: string, body: UpdateNoteRequest): Promise<NoteResponse>;
 declare function deleteNote(arbi: ArbiClient, memoryId: string): Promise<void>;
+/**
+ * Set a one-off reminder on a dated note. Give `remindAt` for an explicit time,
+ * or `leadMinutes` to fire that long before the note's date; with neither it
+ * fires when the note's span starts. A reminder whose time has already passed
+ * is rejected rather than silently never firing.
+ */
+declare function remindNote(arbi: ArbiClient, noteId: string, options?: {
+    remindAt?: string;
+    leadMinutes?: number;
+}): Promise<NoteResponse>;
 
 type notes_CreateNoteRequest = CreateNoteRequest;
 type notes_NoteResponse = NoteResponse;
@@ -1917,10 +1943,11 @@ type notes_UpdateNoteRequest = UpdateNoteRequest;
 declare const notes_createNote: typeof createNote;
 declare const notes_deleteNote: typeof deleteNote;
 declare const notes_listNotes: typeof listNotes;
+declare const notes_remindNote: typeof remindNote;
 declare const notes_searchNotes: typeof searchNotes;
 declare const notes_updateNote: typeof updateNote;
 declare namespace notes {
-  export { type notes_CreateNoteRequest as CreateNoteRequest, type notes_NoteResponse as NoteResponse, type notes_NoteSearchRequest as NoteSearchRequest, type notes_NoteSearchResponse as NoteSearchResponse, type notes_UpdateNoteRequest as UpdateNoteRequest, notes_createNote as createNote, notes_deleteNote as deleteNote, notes_listNotes as listNotes, notes_searchNotes as searchNotes, notes_updateNote as updateNote };
+  export { type notes_CreateNoteRequest as CreateNoteRequest, type notes_NoteResponse as NoteResponse, type notes_NoteSearchRequest as NoteSearchRequest, type notes_NoteSearchResponse as NoteSearchResponse, type notes_UpdateNoteRequest as UpdateNoteRequest, notes_createNote as createNote, notes_deleteNote as deleteNote, notes_listNotes as listNotes, notes_remindNote as remindNote, notes_searchNotes as searchNotes, notes_updateNote as updateNote };
 }
 
 type DocUpdateRequest = components['schemas']['DocUpdateRequest'];
@@ -3121,7 +3148,7 @@ declare class Arbi {
     };
     readonly contacts: {
         list: () => Promise<{
-            external_id: string;
+            external_id?: string | null | undefined;
             email: string;
             user?: {
                 external_id: string;
@@ -3133,11 +3160,13 @@ declare class Arbi {
                 encryption_public_key: string;
                 is_sso: boolean;
             } | null | undefined;
-            status: "invitation_pending" | "invitation_expired" | "registered";
+            status: "invitation_pending" | "invitation_expired" | "registered" | "failed";
             created_at: string;
+            outcome?: ("invited" | "reinvited" | "not_resent_still_pending" | "contact_added" | "already_contact" | "failed") | null | undefined;
+            outcome_detail?: string | null | undefined;
         }[]>;
         add: (emails: string[]) => Promise<{
-            external_id: string;
+            external_id?: string | null | undefined;
             email: string;
             user?: {
                 external_id: string;
@@ -3149,8 +3178,10 @@ declare class Arbi {
                 encryption_public_key: string;
                 is_sso: boolean;
             } | null | undefined;
-            status: "invitation_pending" | "invitation_expired" | "registered";
+            status: "invitation_pending" | "invitation_expired" | "registered" | "failed";
             created_at: string;
+            outcome?: ("invited" | "reinvited" | "not_resent_still_pending" | "contact_added" | "already_contact" | "failed") | null | undefined;
+            outcome_detail?: string | null | undefined;
         }[]>;
         remove: (contactIds: string[]) => Promise<void>;
         groupByStatus: typeof groupContactsByStatus;
@@ -4278,14 +4309,22 @@ declare class Arbi {
             pinned: boolean;
             shared: boolean;
             source: string;
-            note_date?: string | null;
+            date_start?: string | null;
+            date_end?: string | null;
+            timezone?: string | null;
+            reminder_task_ext_ids: string[];
             tags: components["schemas"]["NoteTagResponse"][];
             created_by_ext_id: string;
             created_at: string;
             updated_at: string;
         }>;
+        /** Pass `from`/`to`/`datedOnly` for the timeline view — dated notes only,
+         *  ordered by when they happened. */
         list: (options?: {
             pinnedOnly?: boolean;
+            from?: string;
+            to?: string;
+            datedOnly?: boolean;
         }) => Promise<{
             text: string;
             citations?: components["schemas"]["CitationSources"] | null;
@@ -4294,7 +4333,10 @@ declare class Arbi {
             pinned: boolean;
             shared: boolean;
             source: string;
-            note_date?: string | null;
+            date_start?: string | null;
+            date_end?: string | null;
+            timezone?: string | null;
+            reminder_task_ext_ids: string[];
             tags: components["schemas"]["NoteTagResponse"][];
             created_by_ext_id: string;
             created_at: string;
@@ -4311,13 +4353,38 @@ declare class Arbi {
             pinned: boolean;
             shared: boolean;
             source: string;
-            note_date?: string | null;
+            date_start?: string | null;
+            date_end?: string | null;
+            timezone?: string | null;
+            reminder_task_ext_ids: string[];
             tags: components["schemas"]["NoteTagResponse"][];
             created_by_ext_id: string;
             created_at: string;
             updated_at: string;
         }>;
         delete: (noteId: string) => Promise<void>;
+        /** One-off reminder on a dated note: an explicit `remindAt`, or
+         *  `leadMinutes` before its date. */
+        remind: (noteId: string, options?: {
+            remindAt?: string;
+            leadMinutes?: number;
+        }) => Promise<{
+            text: string;
+            citations?: components["schemas"]["CitationSources"] | null;
+            external_id: string;
+            workspace_ext_id: string;
+            pinned: boolean;
+            shared: boolean;
+            source: string;
+            date_start?: string | null;
+            date_end?: string | null;
+            timezone?: string | null;
+            reminder_task_ext_ids: string[];
+            tags: components["schemas"]["NoteTagResponse"][];
+            created_by_ext_id: string;
+            created_at: string;
+            updated_at: string;
+        }>;
     };
     readonly sessions: {
         list: () => Promise<{

package/dist/{browser-B9JRGjYZ.d.ts → browser-Cj68Nzgn.d.ts}

@@ -1414,7 +1414,7 @@ declare namespace assistant {
  */
 
 declare function listContacts(arbi: ArbiClient): Promise<{
-    external_id: string;
+    external_id?: string | null | undefined;
     email: string;
     user?: {
         external_id: string;
@@ -1426,11 +1426,13 @@ declare function listContacts(arbi: ArbiClient): Promise<{
         encryption_public_key: string;
         is_sso: boolean;
     } | null | undefined;
-    status: "invitation_pending" | "invitation_expired" | "registered";
+    status: "invitation_pending" | "invitation_expired" | "registered" | "failed";
     created_at: string;
+    outcome?: ("invited" | "reinvited" | "not_resent_still_pending" | "contact_added" | "already_contact" | "failed") | null | undefined;
+    outcome_detail?: string | null | undefined;
 }[]>;
 declare function addContacts(arbi: ArbiClient, emails: string[]): Promise<{
-    external_id: string;
+    external_id?: string | null | undefined;
     email: string;
     user?: {
         external_id: string;
@@ -1442,8 +1444,10 @@ declare function addContacts(arbi: ArbiClient, emails: string[]): Promise<{
         encryption_public_key: string;
         is_sso: boolean;
     } | null | undefined;
-    status: "invitation_pending" | "invitation_expired" | "registered";
+    status: "invitation_pending" | "invitation_expired" | "registered" | "failed";
     created_at: string;
+    outcome?: ("invited" | "reinvited" | "not_resent_still_pending" | "contact_added" | "already_contact" | "failed") | null | undefined;
+    outcome_detail?: string | null | undefined;
 }[]>;
 declare function removeContacts(arbi: ArbiClient, contactIds: string[]): Promise<void>;
 /**
@@ -1901,13 +1905,35 @@ type NoteSearchResponse = components['schemas']['NoteSearchResponse'];
 /** Create a note. `content` is required; `shared` makes it workspace-wide. */
 declare function createNote(arbi: ArbiClient, body: CreateNoteRequest): Promise<NoteResponse>;
 /** List the open workspace's notes (newest first). */
+/**
+ * List notes. Passing a date range — or `datedOnly` — turns this into the
+ * TIMELINE: only dated notes, ordered by when they happened rather than when
+ * they were written. Each bound is read at its own precision and widened
+ * outward, so `to: '2019'` runs through 31 December.
+ *
+ * The range selects by overlap, so a note spanning all of 2019 shows up in a
+ * one-month window it covers.
+ */
 declare function listNotes(arbi: ArbiClient, options?: {
     pinnedOnly?: boolean;
+    from?: string;
+    to?: string;
+    datedOnly?: boolean;
 }): Promise<NoteResponse[]>;
 /** Semantic/keyword/hybrid search across the workspace's notes. */
 declare function searchNotes(arbi: ArbiClient, body: NoteSearchRequest): Promise<NoteSearchResponse>;
 declare function updateNote(arbi: ArbiClient, memoryId: string, body: UpdateNoteRequest): Promise<NoteResponse>;
 declare function deleteNote(arbi: ArbiClient, memoryId: string): Promise<void>;
+/**
+ * Set a one-off reminder on a dated note. Give `remindAt` for an explicit time,
+ * or `leadMinutes` to fire that long before the note's date; with neither it
+ * fires when the note's span starts. A reminder whose time has already passed
+ * is rejected rather than silently never firing.
+ */
+declare function remindNote(arbi: ArbiClient, noteId: string, options?: {
+    remindAt?: string;
+    leadMinutes?: number;
+}): Promise<NoteResponse>;
 
 type notes_CreateNoteRequest = CreateNoteRequest;
 type notes_NoteResponse = NoteResponse;
@@ -1917,10 +1943,11 @@ type notes_UpdateNoteRequest = UpdateNoteRequest;
 declare const notes_createNote: typeof createNote;
 declare const notes_deleteNote: typeof deleteNote;
 declare const notes_listNotes: typeof listNotes;
+declare const notes_remindNote: typeof remindNote;
 declare const notes_searchNotes: typeof searchNotes;
 declare const notes_updateNote: typeof updateNote;
 declare namespace notes {
-  export { type notes_CreateNoteRequest as CreateNoteRequest, type notes_NoteResponse as NoteResponse, type notes_NoteSearchRequest as NoteSearchRequest, type notes_NoteSearchResponse as NoteSearchResponse, type notes_UpdateNoteRequest as UpdateNoteRequest, notes_createNote as createNote, notes_deleteNote as deleteNote, notes_listNotes as listNotes, notes_searchNotes as searchNotes, notes_updateNote as updateNote };
+  export { type notes_CreateNoteRequest as CreateNoteRequest, type notes_NoteResponse as NoteResponse, type notes_NoteSearchRequest as NoteSearchRequest, type notes_NoteSearchResponse as NoteSearchResponse, type notes_UpdateNoteRequest as UpdateNoteRequest, notes_createNote as createNote, notes_deleteNote as deleteNote, notes_listNotes as listNotes, notes_remindNote as remindNote, notes_searchNotes as searchNotes, notes_updateNote as updateNote };
 }
 
 type DocUpdateRequest = components['schemas']['DocUpdateRequest'];
@@ -3121,7 +3148,7 @@ declare class Arbi {
     };
     readonly contacts: {
         list: () => Promise<{
-            external_id: string;
+            external_id?: string | null | undefined;
             email: string;
             user?: {
                 external_id: string;
@@ -3133,11 +3160,13 @@ declare class Arbi {
                 encryption_public_key: string;
                 is_sso: boolean;
             } | null | undefined;
-            status: "invitation_pending" | "invitation_expired" | "registered";
+            status: "invitation_pending" | "invitation_expired" | "registered" | "failed";
             created_at: string;
+            outcome?: ("invited" | "reinvited" | "not_resent_still_pending" | "contact_added" | "already_contact" | "failed") | null | undefined;
+            outcome_detail?: string | null | undefined;
         }[]>;
         add: (emails: string[]) => Promise<{
-            external_id: string;
+            external_id?: string | null | undefined;
             email: string;
             user?: {
                 external_id: string;
@@ -3149,8 +3178,10 @@ declare class Arbi {
                 encryption_public_key: string;
                 is_sso: boolean;
             } | null | undefined;
-            status: "invitation_pending" | "invitation_expired" | "registered";
+            status: "invitation_pending" | "invitation_expired" | "registered" | "failed";
             created_at: string;
+            outcome?: ("invited" | "reinvited" | "not_resent_still_pending" | "contact_added" | "already_contact" | "failed") | null | undefined;
+            outcome_detail?: string | null | undefined;
         }[]>;
         remove: (contactIds: string[]) => Promise<void>;
         groupByStatus: typeof groupContactsByStatus;
@@ -4278,14 +4309,22 @@ declare class Arbi {
             pinned: boolean;
             shared: boolean;
             source: string;
-            note_date?: string | null;
+            date_start?: string | null;
+            date_end?: string | null;
+            timezone?: string | null;
+            reminder_task_ext_ids: string[];
             tags: components["schemas"]["NoteTagResponse"][];
             created_by_ext_id: string;
             created_at: string;
             updated_at: string;
         }>;
+        /** Pass `from`/`to`/`datedOnly` for the timeline view — dated notes only,
+         *  ordered by when they happened. */
         list: (options?: {
             pinnedOnly?: boolean;
+            from?: string;
+            to?: string;
+            datedOnly?: boolean;
         }) => Promise<{
             text: string;
             citations?: components["schemas"]["CitationSources"] | null;
@@ -4294,7 +4333,10 @@ declare class Arbi {
             pinned: boolean;
             shared: boolean;
             source: string;
-            note_date?: string | null;
+            date_start?: string | null;
+            date_end?: string | null;
+            timezone?: string | null;
+            reminder_task_ext_ids: string[];
             tags: components["schemas"]["NoteTagResponse"][];
             created_by_ext_id: string;
             created_at: string;
@@ -4311,13 +4353,38 @@ declare class Arbi {
             pinned: boolean;
             shared: boolean;
             source: string;
-            note_date?: string | null;
+            date_start?: string | null;
+            date_end?: string | null;
+            timezone?: string | null;
+            reminder_task_ext_ids: string[];
             tags: components["schemas"]["NoteTagResponse"][];
             created_by_ext_id: string;
             created_at: string;
             updated_at: string;
         }>;
         delete: (noteId: string) => Promise<void>;
+        /** One-off reminder on a dated note: an explicit `remindAt`, or
+         *  `leadMinutes` before its date. */
+        remind: (noteId: string, options?: {
+            remindAt?: string;
+            leadMinutes?: number;
+        }) => Promise<{
+            text: string;
+            citations?: components["schemas"]["CitationSources"] | null;
+            external_id: string;
+            workspace_ext_id: string;
+            pinned: boolean;
+            shared: boolean;
+            source: string;
+            date_start?: string | null;
+            date_end?: string | null;
+            timezone?: string | null;
+            reminder_task_ext_ids: string[];
+            tags: components["schemas"]["NoteTagResponse"][];
+            created_by_ext_id: string;
+            created_at: string;
+            updated_at: string;
+        }>;
     };
     readonly sessions: {
         list: () => Promise<{

package/dist/browser.cjs

@@ -5567,6 +5567,7 @@ __export(notes_exports, {
   createNote: () => createNote,
   deleteNote: () => deleteNote,
   listNotes: () => listNotes,
+  remindNote: () => remindNote,
   searchNotes: () => searchNotes,
   updateNote: () => updateNote
 });
@@ -5576,7 +5577,14 @@ async function createNote(arbi, body) {
 async function listNotes(arbi, options) {
   return requireData(
     await arbi.fetch.GET("/v1/notes/list", {
-      params: { query: { pinned_only: options?.pinnedOnly ?? false } }
+      params: {
+        query: {
+          pinned_only: options?.pinnedOnly ?? false,
+          date_from: options?.from,
+          date_to: options?.to,
+          dated_only: options?.datedOnly
+        }
+      }
     }),
     "Failed to list notes"
   );
@@ -5599,6 +5607,18 @@ async function deleteNote(arbi, memoryId) {
   });
   if (error) throw new Error("Failed to delete note");
 }
+async function remindNote(arbi, noteId, options = {}) {
+  return requireData(
+    await arbi.fetch.POST("/v1/notes/{note_ext_id}/remind", {
+      params: { path: { note_ext_id: noteId } },
+      body: {
+        remind_at: options.remindAt ?? null,
+        lead_minutes: options.leadMinutes ?? null
+      }
+    }),
+    "Failed to set reminder"
+  );
+}
 
 // src/arbi.ts
 var Arbi = class {
@@ -6079,10 +6099,15 @@ var Arbi = class {
   // ── Workspace notes ─────────────────────────────────────────────────
   notes = {
     create: (body) => createNote(this.requireClient(), body),
+    /** Pass `from`/`to`/`datedOnly` for the timeline view — dated notes only,
+     *  ordered by when they happened. */
     list: (options) => listNotes(this.requireClient(), options),
     search: (body) => searchNotes(this.requireClient(), body),
     update: (noteId, body) => updateNote(this.requireClient(), noteId, body),
-    delete: (noteId) => deleteNote(this.requireClient(), noteId)
+    delete: (noteId) => deleteNote(this.requireClient(), noteId),
+    /** One-off reminder on a dated note: an explicit `remindAt`, or
+     *  `leadMinutes` before its date. */
+    remind: (noteId, options = {}) => remindNote(this.requireClient(), noteId, options)
   };
   // ── Sessions ────────────────────────────────────────────────────────
   sessions = {