@plotday/twister 0.34.0 → 0.35.0

package/dist/common/calendar.d.ts

@@ -1,15 +1,4 @@
-import type { ActivityLink, NewActivityWithNotes, Serializable } from "../index";
-/**
- * Represents successful calendar authorization.
- *
- * Returned by calendar tools when authorization completes successfully.
- * The auth token is an opaque identifier that can be used for subsequent
- * calendar operations.
- */
-export type CalendarAuth = {
-    /** Opaque token for calendar operations */
-    authToken: string;
-};
+import type { NewActivityWithNotes, Serializable } from "../index";
 /**
  * Represents a calendar from an external calendar service.
  *
@@ -73,13 +62,12 @@ export type SyncOptions = {
  * - Easier testing of tools in isolation
  *
  * **Implementation Pattern:**
- * 1. Request an ActivityLink for authorization
- * 2. Create an Activity with the ActivityLink to prompt user (via twist)
- * 3. Receive a CalendarAuth in the specified callback
- * 4. Fetch list of available calendars
- * 5. Start sync for selected calendars
- * 6. **Tool builds NewActivity objects** and passes them to the twist via callback
- * 7. **Twist decides** whether to save using createActivity/updateActivity
+ * 1. Authorization is handled via the twist edit modal (Integrations provider config)
+ * 2. Tool declares providers and lifecycle callbacks in build()
+ * 3. onAuthorized lists available calendars and calls setSyncables()
+ * 4. User enables calendars in the modal → onSyncEnabled fires
+ * 5. **Tool builds NewActivity objects** and passes them to the twist via callback
+ * 6. **Twist decides** whether to save using createActivity/updateActivity
  *
  * **Tool Implementation Rules:**
  * - **DO** build Activity/Note objects from external data
@@ -93,70 +81,28 @@ export type SyncOptions = {
  *
  * @example
  * ```typescript
- * // Typical calendar integration flow using source/key upserts
  * class MyCalendarTwist extends Twist {
- *   private googleCalendar: GoogleCalendar;
- *
- *   async activate() {
- *     // Step 1: Request authorization
- *     const authLink = await this.googleCalendar.requestAuth("onAuthComplete");
- *     await this.plot.createActivity({
- *       type: ActivityType.Action,
- *       title: "Connect Google Calendar",
- *       links: [authLink],
- *     });
- *   }
- *
- *   async onAuthComplete(auth: CalendarAuth) {
- *     // Step 2: Get available calendars
- *     const calendars = await this.googleCalendar.getCalendars(auth.authToken);
- *
- *     // Step 3: Start sync for primary calendar
- *     const primaryCalendar = calendars.find(c => c.primary);
- *     if (primaryCalendar) {
- *       await this.googleCalendar.startSync(
- *         {
- *           authToken: auth.authToken,
- *           calendarId: primaryCalendar.id
- *         },
- *         this.onCalendarEvent,  // Callback receives data from tool
- *         { initialSync: true }
- *       );
- *     }
+ *   build(build: ToolBuilder) {
+ *     return {
+ *       googleCalendar: build(GoogleCalendar),
+ *       plot: build(Plot, { activity: { access: ActivityAccess.Create } }),
+ *     };
  *   }
  *
- *   async onCalendarEvent(
- *     activity: NewActivityWithNotes,
- *     syncMeta: { initialSync: boolean }
- *   ) {
- *     // Step 4: Twist decides what to do with the data
- *     // Tool built the NewActivity, twist saves it
- *     await this.plot.createActivity(activity);
- *   }
+ *   // Auth and calendar selection handled in the twist edit modal.
+ *   // Events are delivered via the startSync callback.
  * }
  * ```
  */
 export type CalendarTool = {
-    /**
-     * Initiates the authorization flow for the calendar service.
-     *
-     * @param callback - Function receiving (auth, ...extraArgs) when auth completes
-     * @param extraArgs - Additional arguments to pass to the callback (type-checked)
-     * @returns Promise resolving to an ActivityLink to initiate the auth flow
-     */
-    requestAuth<TArgs extends Serializable[], TCallback extends (auth: CalendarAuth, ...args: TArgs) => any>(callback: TCallback, ...extraArgs: TArgs): Promise<ActivityLink>;
     /**
      * Retrieves the list of calendars accessible to the authenticated user.
      *
-     * Returns metadata for all calendars the user has access to, including
-     * their primary calendar and any shared calendars. This list can be
-     * presented to users for calendar selection.
-     *
-     * @param authToken - Authorization token from successful auth flow
+     * @param calendarId - A calendar ID to use for auth lookup
      * @returns Promise resolving to array of available calendars
-     * @throws When the auth token is invalid or expired
+     * @throws When no valid authorization is available
      */
-    getCalendars(authToken: string): Promise<Calendar[]>;
+    getCalendars(calendarId: string): Promise<Calendar[]>;
     /**
      * Begins synchronizing events from a specific calendar.
      *
@@ -164,42 +110,26 @@ export type CalendarTool = {
      * event import and ongoing change notifications. The callback function
      * will be invoked for each synced event.
      *
-     * **Recommended Implementation** (Strategy 2 - Upsert via Source/Key):
-     * - Set Activity.source to the event's canonical URL (e.g., event.htmlLink)
-     * - Use Note.key for event details (description, attendees, etc.) to enable upserts
-     * - No manual ID tracking needed - Plot handles deduplication automatically
-     * - Send NewActivityWithNotes for all events (creates new or updates existing)
-     * - Set activity.unread = false for initial sync, omit for incremental updates
-     *
-     * **Alternative** (Strategy 3 - Advanced cases):
-     * - Use Uuid.Generate() and store ID mappings when creating multiple activities per event
-     * - See SYNC_STRATEGIES.md for when this is appropriate
+     * Auth is obtained automatically via integrations.get(provider, calendarId).
      *
      * @param options - Sync configuration options
-     * @param options.authToken - Authorization token for calendar access
      * @param options.calendarId - ID of the calendar to sync
      * @param options.timeMin - Earliest date to sync events from (inclusive)
      * @param options.timeMax - Latest date to sync events to (exclusive)
      * @param callback - Function receiving (activity, ...extraArgs) for each synced event
      * @param extraArgs - Additional arguments to pass to the callback (type-checked, no functions allowed)
      * @returns Promise that resolves when sync setup is complete
-     * @throws When auth token is invalid or calendar doesn't exist
+     * @throws When no valid authorization or calendar doesn't exist
      */
     startSync<TArgs extends Serializable[], TCallback extends (activity: NewActivityWithNotes, ...args: TArgs) => any>(options: {
-        authToken: string;
         calendarId: string;
     } & SyncOptions, callback: TCallback, ...extraArgs: TArgs): Promise<void>;
     /**
      * Stops synchronizing events from a specific calendar.
      *
-     * Disables real-time sync and cleans up any webhooks or polling
-     * mechanisms for the specified calendar. No further events will
-     * be synced after this call.
-     *
-     * @param authToken - Authorization token for calendar access
      * @param calendarId - ID of the calendar to stop syncing
      * @returns Promise that resolves when sync is stopped
      */
-    stopSync(authToken: string, calendarId: string): Promise<void>;
+    stopSync(calendarId: string): Promise<void>;
 };
 //# sourceMappingURL=calendar.d.ts.map

package/dist/common/calendar.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"calendar.d.ts","sourceRoot":"","sources":["../../src/common/calendar.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,oBAAoB,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAEjF;;;;;;GAMG;AACH,MAAM,MAAM,YAAY,GAAG;IACzB,2CAA2C;IAC3C,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,MAAM,QAAQ,GAAG;IACrB,6DAA6D;IAC7D,EAAE,EAAE,MAAM,CAAC;IACX,0CAA0C;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,oEAAoE;IACpE,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,0DAA0D;IAC1D,OAAO,EAAE,OAAO,CAAC;CAClB,CAAC;AAEF;;;;;GAKG;AACH,MAAM,MAAM,WAAW,GAAG;IACxB;;;;;OAKG;IACH,OAAO,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC;IACtB;;;;;;;;;;OAUG;IACH,OAAO,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC;CACvB,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiFG;AACH,MAAM,MAAM,YAAY,GAAG;IACzB;;;;;;OAMG;IACH,WAAW,CACT,KAAK,SAAS,YAAY,EAAE,EAC5B,SAAS,SAAS,CAAC,IAAI,EAAE,YAAY,EAAE,GAAG,IAAI,EAAE,KAAK,KAAK,GAAG,EAE7D,QAAQ,EAAE,SAAS,EACnB,GAAG,SAAS,EAAE,KAAK,GAClB,OAAO,CAAC,YAAY,CAAC,CAAC;IAEzB;;;;;;;;;;OAUG;IACH,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;IAErD;;;;;;;;;;;;;;;;;;;;;;;;;;;OA2BG;IACH,SAAS,CACP,KAAK,SAAS,YAAY,EAAE,EAC5B,SAAS,SAAS,CAAC,QAAQ,EAAE,oBAAoB,EAAE,GAAG,IAAI,EAAE,KAAK,KAAK,GAAG,EAEzE,OAAO,EAAE;QACP,SAAS,EAAE,MAAM,CAAC;QAClB,UAAU,EAAE,MAAM,CAAC;KACpB,GAAG,WAAW,EACf,QAAQ,EAAE,SAAS,EACnB,GAAG,SAAS,EAAE,KAAK,GAClB,OAAO,CAAC,IAAI,CAAC,CAAC;IAEjB;;;;;;;;;;OAUG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAChE,CAAC"}
+{"version":3,"file":"calendar.d.ts","sourceRoot":"","sources":["../../src/common/calendar.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAEnE;;;;;;GAMG;AACH,MAAM,MAAM,QAAQ,GAAG;IACrB,6DAA6D;IAC7D,EAAE,EAAE,MAAM,CAAC;IACX,0CAA0C;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,oEAAoE;IACpE,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,0DAA0D;IAC1D,OAAO,EAAE,OAAO,CAAC;CAClB,CAAC;AAEF;;;;;GAKG;AACH,MAAM,MAAM,WAAW,GAAG;IACxB;;;;;OAKG;IACH,OAAO,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC;IACtB;;;;;;;;;;OAUG;IACH,OAAO,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC;CACvB,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkDG;AACH,MAAM,MAAM,YAAY,GAAG;IACzB;;;;;;OAMG;IACH,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;IAEtD;;;;;;;;;;;;;;;;;OAiBG;IACH,SAAS,CACP,KAAK,SAAS,YAAY,EAAE,EAC5B,SAAS,SAAS,CAAC,QAAQ,EAAE,oBAAoB,EAAE,GAAG,IAAI,EAAE,KAAK,KAAK,GAAG,EAEzE,OAAO,EAAE;QACP,UAAU,EAAE,MAAM,CAAC;KACpB,GAAG,WAAW,EACf,QAAQ,EAAE,SAAS,EACnB,GAAG,SAAS,EAAE,KAAK,GAClB,OAAO,CAAC,IAAI,CAAC,CAAC;IAEjB;;;;;OAKG;IACH,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC7C,CAAC"}

package/dist/common/documents.d.ts

@@ -1,15 +1,4 @@
-import type { ActivityLink, ActivityMeta, NewActivityWithNotes, Serializable } from "../index";
-/**
- * Represents a successful document service authorization.
- *
- * Returned by document tools when authorization completes successfully.
- * The auth token is an opaque identifier that can be used for subsequent
- * document operations.
- */
-export type DocumentAuth = {
-    /** Opaque token for document operations */
-    authToken: string;
-};
+import type { ActivityMeta, NewActivityWithNotes, Serializable } from "../index";
 /**
  * Represents a folder from an external document service.
  *
@@ -43,6 +32,20 @@ export type DocumentSyncOptions = {
  * All synced documents are converted to ActivityWithNotes objects.
  * Each document becomes an Activity with Notes for the description and comments.
  *
+ * **Architecture: Tools Build, Twists Save**
+ *
+ * Document tools follow Plot's core architectural principle:
+ * - **Tools**: Fetch external data and transform it into Plot format (NewActivity objects)
+ * - **Twists**: Receive the data and decide what to do with it (create, update, filter, etc.)
+ *
+ * **Implementation Pattern:**
+ * 1. Authorization is handled via the twist edit modal (Integrations provider config)
+ * 2. Tool declares providers and lifecycle callbacks in build()
+ * 3. onAuthorized lists available folders and calls setSyncables()
+ * 4. User enables folders in the modal → onSyncEnabled fires
+ * 5. **Tool builds NewActivity objects** and passes them to the twist via callback
+ * 6. **Twist decides** whether to save using createActivity/updateActivity
+ *
  * **Recommended Data Sync Strategy:**
  * Use Activity.source and Note.key for automatic upserts.
  *
@@ -56,37 +59,21 @@ export type DocumentSyncOptions = {
  * - Set `activity.unread = false` for initial sync, omit for incremental updates
  */
 export type DocumentTool = {
-    /**
-     * Initiates the authorization flow for the document service.
-     *
-     * @param callback - Function receiving (auth, ...extraArgs) when auth completes
-     * @param extraArgs - Additional arguments to pass to the callback (type-checked)
-     * @returns Promise resolving to an ActivityLink to initiate the auth flow
-     */
-    requestAuth<TArgs extends Serializable[], TCallback extends (auth: DocumentAuth, ...args: TArgs) => any>(callback: TCallback, ...extraArgs: TArgs): Promise<ActivityLink>;
     /**
      * Retrieves the list of folders accessible to the user.
      *
-     * @param authToken - Authorization token from successful auth flow
+     * @param folderId - A folder ID to use for auth lookup
      * @returns Promise resolving to array of available folders
      */
-    getFolders(authToken: string): Promise<DocumentFolder[]>;
+    getFolders(folderId: string): Promise<DocumentFolder[]>;
     /**
      * Begins synchronizing documents from a specific folder.
      *
      * Documents are converted to NewActivityWithNotes objects.
      *
-     * **Recommended Implementation:**
-     * - Set Activity.source to `"{provider}:file:{fileId}"`
-     * - Use Note.key for document details:
-     *   - key: "summary" for description (upserts on changes)
-     *   - key: "comment-{commentId}" for individual comments (unique per comment)
-     *   - key: "reply-{commentId}-{replyId}" for comment replies
-     * - Send NewActivityWithNotes for all documents (creates new or updates existing)
-     * - Set activity.unread = false for initial sync, omit for incremental updates
+     * Auth is obtained automatically via integrations.get(provider, folderId).
      *
      * @param options - Sync configuration options
-     * @param options.authToken - Authorization token for access
      * @param options.folderId - ID of the folder to sync
      * @param options.timeMin - Earliest date to sync documents from (inclusive)
      * @param callback - Function receiving (activity, ...extraArgs) for each synced document
@@ -94,42 +81,42 @@ export type DocumentTool = {
      * @returns Promise that resolves when sync setup is complete
      */
     startSync<TArgs extends Serializable[], TCallback extends (activity: NewActivityWithNotes, ...args: TArgs) => any>(options: {
-        authToken: string;
         folderId: string;
     } & DocumentSyncOptions, callback: TCallback, ...extraArgs: TArgs): Promise<void>;
     /**
      * Stops synchronizing documents from a specific folder.
      *
-     * @param authToken - Authorization token for access
      * @param folderId - ID of the folder to stop syncing
      * @returns Promise that resolves when sync is stopped
      */
-    stopSync(authToken: string, folderId: string): Promise<void>;
+    stopSync(folderId: string): Promise<void>;
     /**
      * Adds a comment to a document.
      *
      * Optional method for bidirectional sync. When implemented, allows Plot to
      * sync notes added to activities back as comments on the external document.
      *
-     * The tool should extract its own ID from meta (e.g., fileId).
+     * Auth is obtained automatically. The tool should extract its own ID
+     * from meta (e.g., fileId).
      *
-     * @param authToken - Authorization token for access
      * @param meta - Activity metadata containing the tool's document identifier
      * @param body - The comment text content
      * @param noteId - Optional Plot note ID for deduplication
      * @returns The external comment key (e.g. "comment-123") for dedup, or void
      */
-    addDocumentComment?(authToken: string, meta: ActivityMeta, body: string, noteId?: string): Promise<string | void>;
+    addDocumentComment?(meta: ActivityMeta, body: string, noteId?: string): Promise<string | void>;
     /**
      * Adds a reply to an existing comment thread on a document.
      *
-     * @param authToken - Authorization token for access
+     * Auth is obtained automatically. The tool should extract its own ID
+     * from meta (e.g., fileId).
+     *
      * @param meta - Activity metadata containing the tool's document identifier
      * @param commentId - The external comment ID to reply to
      * @param body - The reply text content
      * @param noteId - Optional Plot note ID for deduplication
      * @returns The external reply key (e.g. "reply-123-456") for dedup, or void
      */
-    addDocumentReply?(authToken: string, meta: ActivityMeta, commentId: string, body: string, noteId?: string): Promise<string | void>;
+    addDocumentReply?(meta: ActivityMeta, commentId: string, body: string, noteId?: string): Promise<string | void>;
 };
 //# sourceMappingURL=documents.d.ts.map

package/dist/common/documents.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"documents.d.ts","sourceRoot":"","sources":["../../src/common/documents.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,YAAY,EACZ,YAAY,EACZ,oBAAoB,EACpB,YAAY,EACb,MAAM,UAAU,CAAC;AAElB;;;;;;GAMG;AACH,MAAM,MAAM,YAAY,GAAG;IACzB,2CAA2C;IAC3C,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,MAAM,cAAc,GAAG;IAC3B,2DAA2D;IAC3D,EAAE,EAAE,MAAM,CAAC;IACX,wCAAwC;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,kEAAkE;IAClE,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,6EAA6E;IAC7E,IAAI,EAAE,OAAO,CAAC;CACf,CAAC;AAEF;;;;;GAKG;AACH,MAAM,MAAM,mBAAmB,GAAG;IAChC,uDAAuD;IACvD,OAAO,CAAC,EAAE,IAAI,CAAC;CAChB,CAAC;AAEF;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,MAAM,YAAY,GAAG;IACzB;;;;;;OAMG;IACH,WAAW,CACT,KAAK,SAAS,YAAY,EAAE,EAC5B,SAAS,SAAS,CAAC,IAAI,EAAE,YAAY,EAAE,GAAG,IAAI,EAAE,KAAK,KAAK,GAAG,EAE7D,QAAQ,EAAE,SAAS,EACnB,GAAG,SAAS,EAAE,KAAK,GAClB,OAAO,CAAC,YAAY,CAAC,CAAC;IAEzB;;;;;OAKG;IACH,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC;IAEzD;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,SAAS,CACP,KAAK,SAAS,YAAY,EAAE,EAC5B,SAAS,SAAS,CAAC,QAAQ,EAAE,oBAAoB,EAAE,GAAG,IAAI,EAAE,KAAK,KAAK,GAAG,EAEzE,OAAO,EAAE;QACP,SAAS,EAAE,MAAM,CAAC;QAClB,QAAQ,EAAE,MAAM,CAAC;KAClB,GAAG,mBAAmB,EACvB,QAAQ,EAAE,SAAS,EACnB,GAAG,SAAS,EAAE,KAAK,GAClB,OAAO,CAAC,IAAI,CAAC,CAAC;IAEjB;;;;;;OAMG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE7D;;;;;;;;;;;;;OAaG;IACH,kBAAkB,CAAC,CACjB,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,YAAY,EAClB,IAAI,EAAE,MAAM,EACZ,MAAM,CAAC,EAAE,MAAM,GACd,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAE1B;;;;;;;;;OASG;IACH,gBAAgB,CAAC,CACf,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,YAAY,EAClB,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,EACZ,MAAM,CAAC,EAAE,MAAM,GACd,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;CAC3B,CAAC"}
+{"version":3,"file":"documents.d.ts","sourceRoot":"","sources":["../../src/common/documents.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,YAAY,EACZ,oBAAoB,EACpB,YAAY,EACb,MAAM,UAAU,CAAC;AAElB;;;;;;GAMG;AACH,MAAM,MAAM,cAAc,GAAG;IAC3B,2DAA2D;IAC3D,EAAE,EAAE,MAAM,CAAC;IACX,wCAAwC;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,kEAAkE;IAClE,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,6EAA6E;IAC7E,IAAI,EAAE,OAAO,CAAC;CACf,CAAC;AAEF;;;;;GAKG;AACH,MAAM,MAAM,mBAAmB,GAAG;IAChC,uDAAuD;IACvD,OAAO,CAAC,EAAE,IAAI,CAAC;CAChB,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,MAAM,MAAM,YAAY,GAAG;IACzB;;;;;OAKG;IACH,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC;IAExD;;;;;;;;;;;;;OAaG;IACH,SAAS,CACP,KAAK,SAAS,YAAY,EAAE,EAC5B,SAAS,SAAS,CAAC,QAAQ,EAAE,oBAAoB,EAAE,GAAG,IAAI,EAAE,KAAK,KAAK,GAAG,EAEzE,OAAO,EAAE;QACP,QAAQ,EAAE,MAAM,CAAC;KAClB,GAAG,mBAAmB,EACvB,QAAQ,EAAE,SAAS,EACnB,GAAG,SAAS,EAAE,KAAK,GAClB,OAAO,CAAC,IAAI,CAAC,CAAC;IAEjB;;;;;OAKG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE1C;;;;;;;;;;;;;OAaG;IACH,kBAAkB,CAAC,CACjB,IAAI,EAAE,YAAY,EAClB,IAAI,EAAE,MAAM,EACZ,MAAM,CAAC,EAAE,MAAM,GACd,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAE1B;;;;;;;;;;;OAWG;IACH,gBAAgB,CAAC,CACf,IAAI,EAAE,YAAY,EAClB,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,EACZ,MAAM,CAAC,EAAE,MAAM,GACd,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;CAC3B,CAAC"}

package/dist/common/messaging.d.ts

@@ -1,20 +1,10 @@
-import type { ActivityLink, NewActivityWithNotes, Serializable } from "../index";
-/**
- * Represents a successful messaging service authorization.
- *
- * Returned by messaging tools when authorization completes successfully.
- * The auth token is an opaque identifier that can be used for subsequent
- * messaging operations.
- */
-export type MessagingAuth = {
-    /** Opaque token for messaging operations */
-    authToken: string;
-};
+import type { NewActivityWithNotes, Serializable } from "../index";
 /**
  * Represents a channel from an external messaging service.
  *
  * Contains metadata about a specific channel that can be synced
- * with Plot.
+ * with Plot. Different messaging providers may have additional
+ * provider-specific properties.
  */
 export type MessageChannel = {
     /** Unique identifier for the channel within the provider */
@@ -42,45 +32,38 @@ export type MessageSyncOptions = {
  * All synced messages/emails are converted to ActivityWithNotes objects.
  * Each email thread or chat conversation becomes an Activity with Notes for each message.
  *
+ * **Architecture: Tools Build, Twists Save**
+ *
+ * Messaging tools follow Plot's core architectural principle:
+ * - **Tools**: Fetch external data and transform it into Plot format (NewActivity objects)
+ * - **Twists**: Receive the data and decide what to do with it (create, update, filter, etc.)
+ *
+ * **Implementation Pattern:**
+ * 1. Authorization is handled via the twist edit modal (Integrations provider config)
+ * 2. Tool declares providers and lifecycle callbacks in build()
+ * 3. onAuthorized lists available channels and calls setSyncables()
+ * 4. User enables channels in the modal → onSyncEnabled fires
+ * 5. **Tool builds NewActivity objects** and passes them to the twist via callback
+ * 6. **Twist decides** whether to save using createActivity/updateActivity
+ *
  * **Recommended Data Sync Strategy:**
  * Use Activity.source (thread URL or ID) and Note.key (message ID) for automatic upserts.
  * See SYNC_STRATEGIES.md for detailed patterns.
  */
 export type MessagingTool = {
-    /**
-     * Initiates the authorization flow for the service.
-     *
-     * @param callback - Function receiving (auth, ...extraArgs) when auth completes
-     * @param extraArgs - Additional arguments to pass to the callback (type-checked)
-     * @returns Promise resolving to an ActivityLink to initiate the auth flow
-     */
-    requestAuth<TArgs extends Serializable[], TCallback extends (auth: MessagingAuth, ...args: TArgs) => any>(callback: TCallback, ...extraArgs: TArgs): Promise<ActivityLink>;
     /**
      * Retrieves the list of conversation channels (inboxes, channels) accessible to the user.
      *
-     * @param authToken - Authorization token from successful auth flow
+     * @param channelId - A channel ID to use for auth lookup
      * @returns Promise resolving to array of available conversation channels
      */
-    getChannels(authToken: string): Promise<MessageChannel[]>;
+    getChannels(channelId: string): Promise<MessageChannel[]>;
     /**
      * Begins synchronizing messages from a specific channel.
      *
-     * Email threads and chat conversations are converted to NewActivityWithNotes objects.
-     *
-     * **Recommended Implementation** (Strategy 2 - Upsert via Source/Key):
-     * - Set Activity.source to the thread/conversation URL or stable ID (e.g., "slack:{channelId}:{threadTs}")
-     * - Use Note.key for individual messages (e.g., "message-{messageId}")
-     * - Each message becomes a separate note with unique key for upserts
-     * - No manual ID tracking needed - Plot handles deduplication automatically
-     * - Send NewActivityWithNotes for all threads (creates new or updates existing)
-     * - Set activity.unread = false for initial sync, omit for incremental updates
-     *
-     * **Alternative** (Strategy 3 - Advanced cases):
-     * - Use Uuid.Generate() and store ID mappings when creating multiple activities per thread
-     * - See SYNC_STRATEGIES.md for when this is appropriate
+     * Auth is obtained automatically via integrations.get(provider, channelId).
      *
      * @param options - Sync configuration options
-     * @param options.authToken - Authorization token for access
      * @param options.channelId - ID of the channel (e.g., channel, inbox) to sync
      * @param options.timeMin - Earliest date to sync events from (inclusive)
      * @param callback - Function receiving (thread, ...extraArgs) for each synced conversation
@@ -88,16 +71,14 @@ export type MessagingTool = {
      * @returns Promise that resolves when sync setup is complete
      */
     startSync<TArgs extends Serializable[], TCallback extends (thread: NewActivityWithNotes, ...args: TArgs) => any>(options: {
-        authToken: string;
         channelId: string;
     } & MessageSyncOptions, callback: TCallback, ...extraArgs: TArgs): Promise<void>;
     /**
      * Stops synchronizing messages from a specific channel.
      *
-     * @param authToken - Authorization token for access
      * @param channelId - ID of the channel to stop syncing
      * @returns Promise that resolves when sync is stopped
      */
-    stopSync(authToken: string, channelId: string): Promise<void>;
+    stopSync(channelId: string): Promise<void>;
 };
 //# sourceMappingURL=messaging.d.ts.map

package/dist/common/messaging.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"messaging.d.ts","sourceRoot":"","sources":["../../src/common/messaging.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,oBAAoB,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAEjF;;;;;;GAMG;AACH,MAAM,MAAM,aAAa,GAAG;IAC1B,4CAA4C;IAC5C,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF;;;;;GAKG;AACH,MAAM,MAAM,cAAc,GAAG;IAC3B,4DAA4D;IAC5D,EAAE,EAAE,MAAM,CAAC;IACX,uFAAuF;IACvF,IAAI,EAAE,MAAM,CAAC;IACb,mEAAmE;IACnE,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,4EAA4E;IAC5E,OAAO,EAAE,OAAO,CAAC;CAClB,CAAC;AAEF;;;;;GAKG;AACH,MAAM,MAAM,kBAAkB,GAAG;IAC/B,oDAAoD;IACpD,OAAO,CAAC,EAAE,IAAI,CAAC;CAChB,CAAC;AAEF;;;;;;;;;GASG;AACH,MAAM,MAAM,aAAa,GAAG;IAC1B;;;;;;OAMG;IACH,WAAW,CACT,KAAK,SAAS,YAAY,EAAE,EAC5B,SAAS,SAAS,CAAC,IAAI,EAAE,aAAa,EAAE,GAAG,IAAI,EAAE,KAAK,KAAK,GAAG,EAE9D,QAAQ,EAAE,SAAS,EACnB,GAAG,SAAS,EAAE,KAAK,GAClB,OAAO,CAAC,YAAY,CAAC,CAAC;IAEzB;;;;;OAKG;IACH,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC;IAE1D;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IACH,SAAS,CACP,KAAK,SAAS,YAAY,EAAE,EAC5B,SAAS,SAAS,CAAC,MAAM,EAAE,oBAAoB,EAAE,GAAG,IAAI,EAAE,KAAK,KAAK,GAAG,EAEvE,OAAO,EAAE;QACP,SAAS,EAAE,MAAM,CAAC;QAClB,SAAS,EAAE,MAAM,CAAC;KACnB,GAAG,kBAAkB,EACtB,QAAQ,EAAE,SAAS,EACnB,GAAG,SAAS,EAAE,KAAK,GAClB,OAAO,CAAC,IAAI,CAAC,CAAC;IAEjB;;;;;;OAMG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC/D,CAAC"}
+{"version":3,"file":"messaging.d.ts","sourceRoot":"","sources":["../../src/common/messaging.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAEnE;;;;;;GAMG;AACH,MAAM,MAAM,cAAc,GAAG;IAC3B,4DAA4D;IAC5D,EAAE,EAAE,MAAM,CAAC;IACX,uFAAuF;IACvF,IAAI,EAAE,MAAM,CAAC;IACb,mEAAmE;IACnE,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,4EAA4E;IAC5E,OAAO,EAAE,OAAO,CAAC;CAClB,CAAC;AAEF;;;;;GAKG;AACH,MAAM,MAAM,kBAAkB,GAAG;IAC/B,oDAAoD;IACpD,OAAO,CAAC,EAAE,IAAI,CAAC;CAChB,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,MAAM,aAAa,GAAG;IAC1B;;;;;OAKG;IACH,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC;IAE1D;;;;;;;;;;;OAWG;IACH,SAAS,CACP,KAAK,SAAS,YAAY,EAAE,EAC5B,SAAS,SAAS,CAAC,MAAM,EAAE,oBAAoB,EAAE,GAAG,IAAI,EAAE,KAAK,KAAK,GAAG,EAEvE,OAAO,EAAE;QACP,SAAS,EAAE,MAAM,CAAC;KACnB,GAAG,kBAAkB,EACtB,QAAQ,EAAE,SAAS,EACnB,GAAG,SAAS,EAAE,KAAK,GAClB,OAAO,CAAC,IAAI,CAAC,CAAC;IAEjB;;;;;OAKG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5C,CAAC"}

package/dist/common/projects.d.ts

@@ -1,20 +1,10 @@
-import type { Activity, ActivityLink, ActivityMeta, NewActivityWithNotes, Serializable } from "../index";
-/**
- * Represents a successful project management service authorization.
- *
- * Returned by project management tools when authorization completes successfully.
- * The auth token is an opaque identifier that can be used for subsequent
- * project operations.
- */
-export type ProjectAuth = {
-    /** Opaque token for project management operations */
-    authToken: string;
-};
+import type { Activity, ActivityMeta, NewActivityWithNotes, Serializable } from "../index";
 /**
  * Represents a project from an external project management service.
  *
  * Contains metadata about a specific project/board/workspace that can be synced
- * with Plot.
+ * with Plot. Different project providers may have additional
+ * provider-specific properties.
  */
 export type Project = {
     /** Unique identifier for the project within the provider */
@@ -42,47 +32,38 @@ export type ProjectSyncOptions = {
  * All synced issues/tasks are converted to ActivityWithNotes objects.
  * Each issue becomes an Activity with Notes for the description and comments.
  *
+ * **Architecture: Tools Build, Twists Save**
+ *
+ * Project tools follow Plot's core architectural principle:
+ * - **Tools**: Fetch external data and transform it into Plot format (NewActivity objects)
+ * - **Twists**: Receive the data and decide what to do with it (create, update, filter, etc.)
+ *
+ * **Implementation Pattern:**
+ * 1. Authorization is handled via the twist edit modal (Integrations provider config)
+ * 2. Tool declares providers and lifecycle callbacks in build()
+ * 3. onAuthorized lists available projects and calls setSyncables()
+ * 4. User enables projects in the modal → onSyncEnabled fires
+ * 5. **Tool builds NewActivity objects** and passes them to the twist via callback
+ * 6. **Twist decides** whether to save using createActivity/updateActivity
+ *
  * **Recommended Data Sync Strategy:**
  * Use Activity.source (issue URL) and Note.key for automatic upserts.
  * See SYNC_STRATEGIES.md for detailed patterns.
  */
 export type ProjectTool = {
-    /**
-     * Initiates the authorization flow for the service.
-     *
-     * @param callback - Function receiving (auth, ...extraArgs) when auth completes
-     * @param extraArgs - Additional arguments to pass to the callback (type-checked)
-     * @returns Promise resolving to an ActivityLink to initiate the auth flow
-     */
-    requestAuth<TArgs extends Serializable[], TCallback extends (auth: ProjectAuth, ...args: TArgs) => any>(callback: TCallback, ...extraArgs: TArgs): Promise<ActivityLink>;
     /**
      * Retrieves the list of projects accessible to the user.
      *
-     * @param authToken - Authorization token from successful auth flow
+     * @param projectId - A project ID to use for auth lookup
      * @returns Promise resolving to array of available projects
      */
-    getProjects(authToken: string): Promise<Project[]>;
+    getProjects(projectId: string): Promise<Project[]>;
     /**
      * Begins synchronizing issues from a specific project.
      *
-     * Issues and tasks are converted to NewActivityWithNotes objects.
-     *
-     * **Recommended Implementation** (Strategy 2 - Upsert via Source/Key):
-     * - Set Activity.source to the issue's canonical URL (e.g., Linear issue URL, Jira issue URL)
-     * - Use Note.key for issue details:
-     *   - key: "description" for issue description (upserts on changes)
-     *   - key: "metadata" for status, priority, assignee, etc.
-     *   - key: "comment-{commentId}" for individual comments (unique per comment)
-     * - No manual ID tracking needed - Plot handles deduplication automatically
-     * - Send NewActivityWithNotes for all issues (creates new or updates existing)
-     * - Set activity.unread = false for initial sync, omit for incremental updates
-     *
-     * **Alternative** (Strategy 3 - Advanced cases):
-     * - Use Uuid.Generate() and store ID mappings when creating multiple activities per issue
-     * - See SYNC_STRATEGIES.md for when this is appropriate
+     * Auth is obtained automatically via integrations.get(provider, projectId).
      *
      * @param options - Sync configuration options
-     * @param options.authToken - Authorization token for access
      * @param options.projectId - ID of the project to sync
      * @param options.timeMin - Earliest date to sync issues from (inclusive)
      * @param callback - Function receiving (activity, ...extraArgs) for each synced issue
@@ -90,47 +71,42 @@ export type ProjectTool = {
      * @returns Promise that resolves when sync setup is complete
      */
     startSync<TArgs extends Serializable[], TCallback extends (activity: NewActivityWithNotes, ...args: TArgs) => any>(options: {
-        authToken: string;
         projectId: string;
     } & ProjectSyncOptions, callback: TCallback, ...extraArgs: TArgs): Promise<void>;
     /**
      * Stops synchronizing issues from a specific project.
      *
-     * @param authToken - Authorization token for access
      * @param projectId - ID of the project to stop syncing
      * @returns Promise that resolves when sync is stopped
      */
-    stopSync(authToken: string, projectId: string): Promise<void>;
+    stopSync(projectId: string): Promise<void>;
     /**
      * Updates an issue/task with new values.
      *
      * Optional method for bidirectional sync. When implemented, allows Plot to
      * sync activity updates back to the external service.
      *
-     * Uses the combination of start and done to determine workflow state:
-     * - done set → Completed/Done state
-     * - done null + start set → In Progress/Active state
-     * - done null + start null → Backlog/Todo state
+     * Auth is obtained automatically via integrations.get(provider, projectId)
+     * using the projectId from activity.meta.
      *
-     * @param authToken - Authorization token for access
      * @param activity - The updated activity
      * @returns Promise that resolves when the update is synced
      */
-    updateIssue?(authToken: string, activity: Activity): Promise<void>;
+    updateIssue?(activity: Activity): Promise<void>;
     /**
      * Adds a comment to an issue/task.
      *
      * Optional method for bidirectional sync. When implemented, allows Plot to
      * sync notes added to activities back as comments on the external service.
      *
-     * The tool should extract its own ID from meta (e.g., linearId, taskGid, issueKey).
+     * Auth is obtained automatically. The tool should extract its own ID
+     * from meta (e.g., linearId, taskGid, issueKey).
      *
-     * @param authToken - Authorization token for access
      * @param meta - Activity metadata containing the tool's issue/task identifier
      * @param body - The comment text content
      * @param noteId - Optional Plot note ID, used by tools that support comment metadata (e.g. Jira)
      * @returns The external comment key (e.g. "comment-123") for dedup, or void
      */
-    addIssueComment?(authToken: string, meta: ActivityMeta, body: string, noteId?: string): Promise<string | void>;
+    addIssueComment?(meta: ActivityMeta, body: string, noteId?: string): Promise<string | void>;
 };
 //# sourceMappingURL=projects.d.ts.map

package/dist/common/projects.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"projects.d.ts","sourceRoot":"","sources":["../../src/common/projects.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,QAAQ,EACR,YAAY,EACZ,YAAY,EACZ,oBAAoB,EACpB,YAAY,EACb,MAAM,UAAU,CAAC;AAElB;;;;;;GAMG;AACH,MAAM,MAAM,WAAW,GAAG;IACxB,qDAAqD;IACrD,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF;;;;;GAKG;AACH,MAAM,MAAM,OAAO,GAAG;IACpB,4DAA4D;IAC5D,EAAE,EAAE,MAAM,CAAC;IACX,6EAA6E;IAC7E,IAAI,EAAE,MAAM,CAAC;IACb,mEAAmE;IACnE,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,gFAAgF;IAChF,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;CACpB,CAAC;AAEF;;;;;GAKG;AACH,MAAM,MAAM,kBAAkB,GAAG;IAC/B,oDAAoD;IACpD,OAAO,CAAC,EAAE,IAAI,CAAC;CAChB,CAAC;AAEF;;;;;;;;;GASG;AACH,MAAM,MAAM,WAAW,GAAG;IACxB;;;;;;OAMG;IACH,WAAW,CACT,KAAK,SAAS,YAAY,EAAE,EAC5B,SAAS,SAAS,CAAC,IAAI,EAAE,WAAW,EAAE,GAAG,IAAI,EAAE,KAAK,KAAK,GAAG,EAE5D,QAAQ,EAAE,SAAS,EACnB,GAAG,SAAS,EAAE,KAAK,GAClB,OAAO,CAAC,YAAY,CAAC,CAAC;IAEzB;;;;;OAKG;IACH,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;IAEnD;;;;;;;;;;;;;;;;;;;;;;;;;;OA0BG;IACH,SAAS,CACP,KAAK,SAAS,YAAY,EAAE,EAC5B,SAAS,SAAS,CAAC,QAAQ,EAAE,oBAAoB,EAAE,GAAG,IAAI,EAAE,KAAK,KAAK,GAAG,EAEzE,OAAO,EAAE;QACP,SAAS,EAAE,MAAM,CAAC;QAClB,SAAS,EAAE,MAAM,CAAC;KACnB,GAAG,kBAAkB,EACtB,QAAQ,EAAE,SAAS,EACnB,GAAG,SAAS,EAAE,KAAK,GAClB,OAAO,CAAC,IAAI,CAAC,CAAC;IAEjB;;;;;;OAMG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE9D;;;;;;;;;;;;;;OAcG;IACH,WAAW,CAAC,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEnE;;;;;;;;;;;;;OAaG;IACH,eAAe,CAAC,CACd,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,YAAY,EAClB,IAAI,EAAE,MAAM,EACZ,MAAM,CAAC,EAAE,MAAM,GACd,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;CAC3B,CAAC"}
+{"version":3,"file":"projects.d.ts","sourceRoot":"","sources":["../../src/common/projects.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,QAAQ,EACR,YAAY,EACZ,oBAAoB,EACpB,YAAY,EACb,MAAM,UAAU,CAAC;AAElB;;;;;;GAMG;AACH,MAAM,MAAM,OAAO,GAAG;IACpB,4DAA4D;IAC5D,EAAE,EAAE,MAAM,CAAC;IACX,6EAA6E;IAC7E,IAAI,EAAE,MAAM,CAAC;IACb,mEAAmE;IACnE,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,gFAAgF;IAChF,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;CACpB,CAAC;AAEF;;;;;GAKG;AACH,MAAM,MAAM,kBAAkB,GAAG;IAC/B,oDAAoD;IACpD,OAAO,CAAC,EAAE,IAAI,CAAC;CAChB,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,MAAM,WAAW,GAAG;IACxB;;;;;OAKG;IACH,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;IAEnD;;;;;;;;;;;OAWG;IACH,SAAS,CACP,KAAK,SAAS,YAAY,EAAE,EAC5B,SAAS,SAAS,CAAC,QAAQ,EAAE,oBAAoB,EAAE,GAAG,IAAI,EAAE,KAAK,KAAK,GAAG,EAEzE,OAAO,EAAE;QACP,SAAS,EAAE,MAAM,CAAC;KACnB,GAAG,kBAAkB,EACtB,QAAQ,EAAE,SAAS,EACnB,GAAG,SAAS,EAAE,KAAK,GAClB,OAAO,CAAC,IAAI,CAAC,CAAC;IAEjB;;;;;OAKG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE3C;;;;;;;;;;;OAWG;IACH,WAAW,CAAC,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEhD;;;;;;;;;;;;;OAaG;IACH,eAAe,CAAC,CACd,IAAI,EAAE,YAAY,EAClB,IAAI,EAAE,MAAM,EACZ,MAAM,CAAC,EAAE,MAAM,GACd,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;CAC3B,CAAC"}

package/dist/docs/assets/hierarchy.js

@@ -1 +1 @@
-window.hierarchyData = "eJyNkj1vwyAQhv/LzRca/AlsUScvVaV2i6KK2qSxTEwFV2WI/N8r221FJ7wwwPO+zyHdHbxzFEAdpTgheHO2pqXejQHUHaSYz1FfDShoXp2zgDD0YweKZwLhy1tQ0FodggkP5JxlC8UudJ3R5QUUUOh2c2y3XiC0l9523oygjnzPsRAZljzDSpZYFyXWskSRVygzjjKXpwmB73k0y6ZRNkwyIRQii4tvfaCQqg5vtHBsxdOSkseSQ5MW6J4dmnRxJcuo+FFb+67bYcMH2l+U/YXStrqIbc1I5sPrdVuSwj6iWRzdoP33ySdDN+eHtHFcQfYTSHtEXkWeZ+soLfm0jtiMputlFq/wCzlv0v1hxtgCbzDkMt5lHbZsAs0YW+CUYZq+AQY2XOs="
+window.hierarchyData = "eJyNkk1PxCAQhv/LnGex9GNLuW089WJM9GY2BrvoNmWLgTF72PS/G1o1eIITCTzzPgPMDZy15EG+8EIcEZx+N3qg0c4e5A14IcIyq4sGCf2ztQYQpnE+geSlQPhyBiQMRnmv/R1Za9hKsTNdArqegATyp10o220bCMN5NCen52DmHOuuwaZssC0EtqJEUdUo2ga7fYmdqI4LAuc86iWrlYxOFoS6a+Lg6+jJp6L9K60c2/C0pCljyaFPC9TIDn06uP33RffKmDc1TBkXGH5R9leUYRNlPBAz6Q+ntnFJCseIZnFpWiuqOtI+aLpaN6WN8wayn4IMTxv/0qOxlJZ8GkssoOn4bh+/3hNZp9P5PmBshTMMoopnWfmcSaCAsRVOGZblG4H2XUc="

package/dist/docs/assets/navigation.js

@@ -1 +1 @@
-window.navigationData = "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"
+window.navigationData = "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"