@plotday/twister 0.22.0 → 0.27.0

package/cli/templates/AGENTS.template.md

@@ -17,16 +17,43 @@ Plot Twists are TypeScript classes that extend the `Twist` base class. Twists in
 - **Store intermediate state**: Use the Store tool to persist state between batches
 - **Examples**: Syncing large datasets, processing many API calls, or performing batch operations
 
-## twist Structure Pattern
+## Understanding Activities and Notes
+
+**CRITICAL CONCEPT**: An **Activity** represents something done or to be done (a task, event, or conversation), while **Notes** represent the updates and details on that activity.
+
+**Think of an Activity as a thread** on a messaging platform, and **Notes as the messages in that thread**.
+
+### Key Guidelines
+
+1. **Always create Activities with an initial Note** - The title is just a summary; detailed content goes in Notes
+2. **Add Notes to existing Activities for updates** - Don't create a new Activity for each related message
+3. **Track external items using generated UUIDs** - Store mappings between external IDs and Plot UUIDs for deduplication
+4. **Most Activities should be `ActivityType.Note`** - Use `Action` only for tasks with `doneAt`, use `Event` only for items with `start`/`end`
+
+### Decision Tree
+
+```
+New event/task/conversation?
+  ├─ Yes → Generate UUID with Uuid.Generate()
+  │         Create new Activity with that UUID
+  │         Store mapping: external_id → activity_uuid
+  │
+  └─ No (update/reply/comment) → Look up mapping by external_id
+      ├─ Found → Add Note to existing Activity using stored UUID
+      └─ Not found → Create new Activity with UUID + store mapping
+```
+
+## Twist Structure Pattern
 
 ```typescript
 import {
   type Activity,
-  twist,
   type Priority,
   type ToolBuilder,
+  twist,
 } from "@plotday/twister";
 import { Plot } from "@plotday/twister/tools/plot";
+import { Uuid } from "@plotday/twister/utils/uuid";
 
 export default class MyTwist extends Twist<MyTwist> {
   build(build: ToolBuilder) {
@@ -118,9 +145,14 @@ async activate(_priority: Pick<Priority, "id">) {
   );
 
   await this.tools.plot.createActivity({
-    type: ActivityType.Action,
+    type: ActivityType.Note,
     title: "Connect your account",
-    links: [authLink],
+    notes: [
+      {
+        content: "Click the link below to connect your account and start syncing.",
+        links: [authLink],
+      },
+    ],
   });
 }
 ```
@@ -129,8 +161,13 @@ async activate(_priority: Pick<Priority, "id">) {
 
 ```typescript
 const activity = await this.tools.plot.createActivity({
-  type: ActivityType.Action,
+  type: ActivityType.Note,
   title: "Setup",
+  notes: [
+    {
+      content: "Your twist is being set up. Configuration steps will appear here.",
+    },
+  ],
 });
 
 await this.set("setup_activity_id", activity.id);
@@ -180,11 +217,16 @@ const callbackLink: ActivityLink = {
   token: token,
 };
 
-// Add to activity
+// Add to activity note
 await this.tools.plot.createActivity({
-  type: ActivityType.Action,
+  type: ActivityType.Note,
   title: "Task with links",
-  links: [urlLink, callbackLink],
+  notes: [
+    {
+      content: "Click the links below to take action.",
+      links: [urlLink, callbackLink],
+    },
+  ],
 });
 ```
 
@@ -202,9 +244,14 @@ async activate(_priority: Pick<Priority, "id">) {
 
   // Create activity with auth link
   const activity = await this.tools.plot.createActivity({
-    type: ActivityType.Action,
+    type: ActivityType.Note,
     title: "Connect Google account",
-    links: [authLink],
+    notes: [
+      {
+        content: "Click below to connect your Google account and start syncing.",
+        links: [authLink],
+      },
+    ],
   });
 
   // Store for later use
@@ -222,7 +269,7 @@ async onAuthComplete(authResult: { authToken: string }, provider: string) {
 
 ## Sync Pattern
 
-Pattern for syncing external data with callbacks:
+Pattern for syncing external data - demonstrates adding Notes to existing Activities:
 
 ```typescript
 async startSync(calendarId: string): Promise<void> {
@@ -236,9 +283,42 @@ async startSync(calendarId: string): Promise<void> {
   );
 }
 
-async handleEvent(activity: Activity, calendarId: string): Promise<void> {
-  // Process incoming event from external service
-  await this.tools.plot.createActivity(activity);
+async handleEvent(
+  incomingActivity: NewActivityWithNotes,
+  calendarId: string
+): Promise<void> {
+  // Extract external event ID from meta (adapt based on your tool's data)
+  const externalId = incomingActivity.meta?.eventId;
+
+  if (!externalId) {
+    console.error("Event missing external ID");
+    return;
+  }
+
+  // Check if we've already synced this event
+  const mappingKey = `event_mapping:${calendarId}:${externalId}`;
+  const existingActivityId = await this.get<Uuid>(mappingKey);
+
+  if (existingActivityId) {
+    // Event already exists - add update as a Note (add message to thread)
+    if (incomingActivity.notes?.[0]?.content) {
+      await this.tools.plot.createNote({
+        activity: { id: existingActivityId },
+        content: incomingActivity.notes[0].content,
+      });
+    }
+    return;
+  }
+
+  // New event - generate UUID and store mapping
+  const activityId = Uuid.Generate();
+  await this.set(mappingKey, activityId);
+
+  // Create new Activity with initial Note (new thread with first message)
+  await this.tools.plot.createActivity({
+    ...incomingActivity,
+    id: activityId,
+  });
 }
 
 async stopSync(calendarId: string): Promise<void> {
@@ -278,7 +358,12 @@ private async createCalendarSelectionActivity(
   await this.tools.plot.createActivity({
     type: ActivityType.Note,
     title: "Which calendars would you like to connect?",
-    links,
+    notes: [
+      {
+        content: "Select the calendars you want to sync:",
+        links,
+      },
+    ],
   });
 }
 
@@ -334,9 +419,24 @@ async syncBatch(args: any, resourceId: string): Promise<void> {
   // Process one batch (keep under time limit)
   const result = await this.fetchBatch(state.nextPageToken);
 
-  // Process results
+  // Process results (create activities with Notes)
   for (const item of result.items) {
-    await this.tools.plot.createActivity(item);
+    // Check if already synced
+    const mappingKey = `item_mapping:${resourceId}:${item.id}`;
+    const existingId = await this.get<Uuid>(mappingKey);
+
+    if (!existingId) {
+      // New item - generate UUID and store mapping
+      const activityId = Uuid.Generate();
+      await this.set(mappingKey, activityId);
+
+      await this.tools.plot.createActivity({
+        id: activityId,
+        type: ActivityType.Note,
+        title: item.title,
+        notes: [{ id: Uuid.Generate(), content: item.description }],
+      });
+    }
   }
 
   if (result.nextPageToken) {
@@ -357,7 +457,12 @@ async syncBatch(args: any, resourceId: string): Promise<void> {
     // Optionally notify user of completion
     await this.tools.plot.createActivity({
       type: ActivityType.Note,
-      note: `Sync complete: ${state.itemsProcessed + result.items.length} items processed`,
+      title: "Sync complete",
+      notes: [
+        {
+          content: `Successfully processed ${state.itemsProcessed + result.items.length} items.`,
+        },
+      ],
     });
   }
 }
@@ -375,7 +480,12 @@ try {
 
   await this.tools.plot.createActivity({
     type: ActivityType.Note,
-    note: `Failed to complete operation: ${error.message}`,
+    title: "Operation failed",
+    notes: [
+      {
+        content: `Failed to complete operation: ${error.message}`,
+      },
+    ],
   });
 }
 ```
@@ -384,7 +494,10 @@ try {
 
 - **Don't use instance variables for state** - Anything stored in memory is lost after function execution. Always use the Store tool for data that needs to persist.
 - **Processing self-created activities** - Other users may change an Activity created by the twist, resulting in an \`activity\` call. Be sure to check the \`changes === null\` and/or \`activity.author.id !== this.id\` to avoid re-processing.
-- Most activity should be `type = ActivityType.Note` with a `title` and `note`, and no `start` or `end`. This represents a typical message. `start` and `end` should only be used for a note if it should be displayed for a specific date or time, such as a birthday.
+- **Always create Activities with Notes** - See "Understanding Activities and Notes" section above for the thread/message pattern and decision tree.
+- **Use correct Activity types** - Most should be `ActivityType.Note`. Only use `Action` for tasks with `doneAt`, and `Event` for items with `start`/`end`.
+- **Track external items with UUID mappings** - Generate UUIDs with `Uuid.Generate()` and store mappings (`external_id → uuid`) for deduplication. Never rely on the `source` field.
+- **Add Notes to existing Activities** - Look up stored UUID mappings before creating new Activities. Think thread replies, not new threads.
 - Tools are declared in the `build` method and accessed via `this.tools.toolName` in twist methods.
 - **Don't forget runtime limits** - Each execution has ~10 seconds. Break long operations into batches with the Tasks tool. Process enough items per batch to be efficient, but few enough to stay under time limits.
 - **Always use Callbacks tool for persistent references** - Direct function references don't survive worker restarts.

package/dist/common/calendar.d.ts

@@ -1,4 +1,4 @@
-import type { ActivityLink, NewActivityWithNotes } from "../index";
+import type { ActivityLink, SyncUpdate } from "../index";
 /**
  * Represents successful calendar authorization.
  *
@@ -85,9 +85,25 @@ export interface SyncOptions {
  *     }
  *   }
  *
- *   async onCalendarEvent(activity: NewActivityWithNotes) {
+ *   async onCalendarEvent(
+ *     syncUpdate: SyncUpdate,
+ *     syncMeta: { initialSync: boolean }
+ *   ) {
  *     // Step 4: Process synced events
- *     await this.plot.createActivity(activity);
+ *     if ('activityId' in syncUpdate) {
+ *       // Update existing activity
+ *       if (syncUpdate.update) {
+ *         await this.plot.updateActivity(syncUpdate.update);
+ *       }
+ *       if (syncUpdate.notes) {
+ *         for (const note of syncUpdate.notes) {
+ *           await this.plot.createNote(note);
+ *         }
+ *       }
+ *     } else {
+ *       // Create new activity
+ *       await this.plot.createActivity(syncUpdate);
+ *     }
  *   }
  * }
  * ```
@@ -120,14 +136,21 @@ export interface CalendarTool {
      * event import and ongoing change notifications. The callback function
      * will be invoked for each synced event.
      *
+     * Tools implementing this should:
+     * - Generate UUIDs for new activities and notes using Uuid.Generate()
+     * - Track activity IDs locally to detect updates vs new items
+     * - Send NewActivityWithNotes for new events
+     * - Send update object with activityId for changed events
+     * - Set activity.unread = false for initial sync, true for incremental updates
+     *
      * @param authToken - Authorization token for calendar access
      * @param calendarId - ID of the calendar to sync
-     * @param callback - Function receiving (activity, ...extraArgs) for each synced event
+     * @param callback - Function receiving (syncUpdate, ...extraArgs) for each synced event
      * @param extraArgs - Additional arguments to pass to the callback (type-checked)
      * @returns Promise that resolves when sync setup is complete
      * @throws When auth token is invalid or calendar doesn't exist
      */
-    startSync<TCallback extends (activity: NewActivityWithNotes, ...args: any[]) => any>(authToken: string, calendarId: string, callback: TCallback, ...extraArgs: TCallback extends (activity: any, ...rest: infer R) => any ? R : []): Promise<void>;
+    startSync<TCallback extends (syncUpdate: SyncUpdate, ...args: any[]) => any>(authToken: string, calendarId: string, callback: TCallback, ...extraArgs: TCallback extends (syncUpdate: any, ...rest: infer R) => any ? R : []): Promise<void>;
     /**
      * Stops synchronizing events from a specific calendar.
      *

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,MAAM,UAAU,CAAC;AAEnE;;;;;;GAMG;AACH,MAAM,MAAM,YAAY,GAAG;IACzB,2CAA2C;IAC3C,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,WAAW,QAAQ;IACvB,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;AAED;;;;;GAKG;AACH,MAAM,WAAW,WAAW;IAC1B,oDAAoD;IACpD,OAAO,CAAC,EAAE,IAAI,CAAC;IACf,gDAAgD;IAChD,OAAO,CAAC,EAAE,IAAI,CAAC;CAChB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoDG;AACH,MAAM,WAAW,YAAY;IAC3B;;;;;;OAMG;IACH,WAAW,CAAC,SAAS,SAAS,CAAC,IAAI,EAAE,YAAY,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,EACvE,QAAQ,EAAE,SAAS,EACnB,GAAG,SAAS,EAAE,SAAS,SAAS,CAAC,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI,EAAE,MAAM,CAAC,KAAK,GAAG,GAChE,CAAC,GACD,EAAE,GACL,OAAO,CAAC,YAAY,CAAC,CAAC;IAEzB;;;;;;;;;;OAUG;IACH,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;IAErD;;;;;;;;;;;;;OAaG;IACH,SAAS,CACP,SAAS,SAAS,CAAC,QAAQ,EAAE,oBAAoB,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,EAEzE,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,SAAS,EACnB,GAAG,SAAS,EAAE,SAAS,SAAS,CAAC,QAAQ,EAAE,GAAG,EAAE,GAAG,IAAI,EAAE,MAAM,CAAC,KAAK,GAAG,GACpE,CAAC,GACD,EAAE,GACL,OAAO,CAAC,IAAI,CAAC,CAAC;IAEjB;;;;;;;;;;OAUG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAChE"}
+{"version":3,"file":"calendar.d.ts","sourceRoot":"","sources":["../../src/common/calendar.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAwB,UAAU,EAAE,MAAM,UAAU,CAAC;AAE/E;;;;;;GAMG;AACH,MAAM,MAAM,YAAY,GAAG;IACzB,2CAA2C;IAC3C,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,WAAW,QAAQ;IACvB,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;AAED;;;;;GAKG;AACH,MAAM,WAAW,WAAW;IAC1B,oDAAoD;IACpD,OAAO,CAAC,EAAE,IAAI,CAAC;IACf,gDAAgD;IAChD,OAAO,CAAC,EAAE,IAAI,CAAC;CAChB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoEG;AACH,MAAM,WAAW,YAAY;IAC3B;;;;;;OAMG;IACH,WAAW,CAAC,SAAS,SAAS,CAAC,IAAI,EAAE,YAAY,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,EACvE,QAAQ,EAAE,SAAS,EACnB,GAAG,SAAS,EAAE,SAAS,SAAS,CAAC,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI,EAAE,MAAM,CAAC,KAAK,GAAG,GAChE,CAAC,GACD,EAAE,GACL,OAAO,CAAC,YAAY,CAAC,CAAC;IAEzB;;;;;;;;;;OAUG;IACH,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;IAErD;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,SAAS,CACP,SAAS,SAAS,CAChB,UAAU,EAAE,UAAU,EACtB,GAAG,IAAI,EAAE,GAAG,EAAE,KACX,GAAG,EAER,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,SAAS,EACnB,GAAG,SAAS,EAAE,SAAS,SAAS,CAC9B,UAAU,EAAE,GAAG,EACf,GAAG,IAAI,EAAE,MAAM,CAAC,KACb,GAAG,GACJ,CAAC,GACD,EAAE,GACL,OAAO,CAAC,IAAI,CAAC,CAAC;IAEjB;;;;;;;;;;OAUG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAChE"}

package/dist/common/messaging.d.ts

@@ -1,4 +1,4 @@
-import type { ActivityLink, NewActivityWithNotes } from "../index";
+import type { ActivityLink, SyncUpdate } from "../index";
 /**
  * Represents a successful messaging service authorization.
  *
@@ -61,18 +61,24 @@ export interface MessagingTool {
     /**
      * Begins synchronizing messages from a specific channel.
      *
-     * Email threads and chat conversations are converted to ActivityWithNotes objects.
-     * Each object contains an Activity (with subject/title) and Notes array (one per message).
-     * The Activity.id can be used as a stable conversation identifier.
+     * Email threads and chat conversations are converted to SyncUpdate objects,
+     * which can be either new items or updates to existing items.
+     *
+     * Tools implementing this should:
+     * - Generate UUIDs for new activities and notes using Uuid.Generate()
+     * - Track activity IDs locally to detect updates vs new threads
+     * - Send NewActivityWithNotes for new threads
+     * - Send update object with activityId and new notes for new messages in existing threads
+     * - Set activity.unread = false for initial sync, true for incremental updates
      *
      * @param authToken - Authorization token for access
      * @param channelId - ID of the channel (e.g., channel, inbox) to sync
-     * @param callback - Function receiving (thread, ...extraArgs) for each synced conversation
+     * @param callback - Function receiving (syncUpdate, ...extraArgs) for each synced conversation
      * @param options - Optional configuration for limiting the sync scope (e.g., time range)
      * @param extraArgs - Additional arguments to pass to the callback (type-checked)
      * @returns Promise that resolves when sync setup is complete
      */
-    startSync<TCallback extends (thread: NewActivityWithNotes, ...args: any[]) => any>(authToken: string, channelId: string, callback: TCallback, options?: MessageSyncOptions, ...extraArgs: TCallback extends (thread: any, ...rest: infer R) => any ? R : []): Promise<void>;
+    startSync<TCallback extends (syncUpdate: SyncUpdate, ...args: any[]) => any>(authToken: string, channelId: string, callback: TCallback, options?: MessageSyncOptions, ...extraArgs: TCallback extends (syncUpdate: any, ...rest: infer R) => any ? R : []): Promise<void>;
     /**
      * Stops synchronizing messages from a specific channel.
      *

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,MAAM,UAAU,CAAC;AAEnE;;;;;;GAMG;AACH,MAAM,MAAM,aAAa,GAAG;IAC1B,4CAA4C;IAC5C,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF;;;;;GAKG;AACH,MAAM,WAAW,cAAc;IAC7B,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;AAED;;;;;GAKG;AACH,MAAM,WAAW,kBAAkB;IACjC,oDAAoD;IACpD,OAAO,CAAC,EAAE,IAAI,CAAC;CAChB;AAED;;;;;GAKG;AACH,MAAM,WAAW,aAAa;IAC5B;;;;;;OAMG;IACH,WAAW,CAAC,SAAS,SAAS,CAAC,IAAI,EAAE,aAAa,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,EACxE,QAAQ,EAAE,SAAS,EACnB,GAAG,SAAS,EAAE,SAAS,SAAS,CAAC,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI,EAAE,MAAM,CAAC,KAAK,GAAG,GAChE,CAAC,GACD,EAAE,GACL,OAAO,CAAC,YAAY,CAAC,CAAC;IAEzB;;;;;OAKG;IACH,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC;IAE1D;;;;;;;;;;;;;OAaG;IACH,SAAS,CACP,SAAS,SAAS,CAAC,MAAM,EAAE,oBAAoB,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,EAEvE,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,SAAS,EACnB,OAAO,CAAC,EAAE,kBAAkB,EAC5B,GAAG,SAAS,EAAE,SAAS,SAAS,CAAC,MAAM,EAAE,GAAG,EAAE,GAAG,IAAI,EAAE,MAAM,CAAC,KAAK,GAAG,GAClE,CAAC,GACD,EAAE,GACL,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"}
+{"version":3,"file":"messaging.d.ts","sourceRoot":"","sources":["../../src/common/messaging.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAwB,UAAU,EAAE,MAAM,UAAU,CAAC;AAE/E;;;;;;GAMG;AACH,MAAM,MAAM,aAAa,GAAG;IAC1B,4CAA4C;IAC5C,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF;;;;;GAKG;AACH,MAAM,WAAW,cAAc;IAC7B,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;AAED;;;;;GAKG;AACH,MAAM,WAAW,kBAAkB;IACjC,oDAAoD;IACpD,OAAO,CAAC,EAAE,IAAI,CAAC;CAChB;AAED;;;;;GAKG;AACH,MAAM,WAAW,aAAa;IAC5B;;;;;;OAMG;IACH,WAAW,CAAC,SAAS,SAAS,CAAC,IAAI,EAAE,aAAa,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,EACxE,QAAQ,EAAE,SAAS,EACnB,GAAG,SAAS,EAAE,SAAS,SAAS,CAAC,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI,EAAE,MAAM,CAAC,KAAK,GAAG,GAChE,CAAC,GACD,EAAE,GACL,OAAO,CAAC,YAAY,CAAC,CAAC;IAEzB;;;;;OAKG;IACH,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC;IAE1D;;;;;;;;;;;;;;;;;;;OAmBG;IACH,SAAS,CACP,SAAS,SAAS,CAAC,UAAU,EAAE,UAAU,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,EAEjE,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,SAAS,EACnB,OAAO,CAAC,EAAE,kBAAkB,EAC5B,GAAG,SAAS,EAAE,SAAS,SAAS,CAAC,UAAU,EAAE,GAAG,EAAE,GAAG,IAAI,EAAE,MAAM,CAAC,KAAK,GAAG,GACtE,CAAC,GACD,EAAE,GACL,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"}

package/dist/common/projects.d.ts

@@ -0,0 +1,121 @@
+import type { ActivityLink, ActivityUpdate, SyncUpdate } 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;
+};
+/**
+ * Represents a project from an external project management service.
+ *
+ * Contains metadata about a specific project/board/workspace that can be synced
+ * with Plot.
+ */
+export interface Project {
+    /** Unique identifier for the project within the provider */
+    id: string;
+    /** Human-readable name of the project (e.g., "Q1 Roadmap", "Engineering") */
+    name: string;
+    /** Optional description or additional details about the project */
+    description: string | null;
+    /** Optional project key/abbreviation (e.g., "PROJ" in Jira, "ENG" in Linear) */
+    key: string | null;
+}
+/**
+ * Configuration options for project synchronization.
+ *
+ * Controls the time range and other parameters for project sync operations.
+ * Used to limit sync scope and optimize performance.
+ */
+export interface ProjectSyncOptions {
+    /** Earliest date to sync issues from (inclusive) */
+    timeMin?: Date;
+}
+/**
+ * Base interface for project management integration tools.
+ *
+ * All synced issues/tasks are converted to ActivityWithNotes objects.
+ * Each issue becomes an Activity with Notes for the description and comments.
+ */
+export interface 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<TCallback extends (auth: ProjectAuth, ...args: any[]) => any>(callback: TCallback, ...extraArgs: TCallback extends (auth: any, ...rest: infer R) => any ? R : []): Promise<ActivityLink>;
+    /**
+     * Retrieves the list of projects accessible to the user.
+     *
+     * @param authToken - Authorization token from successful auth flow
+     * @returns Promise resolving to array of available projects
+     */
+    getProjects(authToken: string): Promise<Project[]>;
+    /**
+     * Begins synchronizing issues from a specific project.
+     *
+     * Issues and tasks are converted to SyncUpdate objects, which can be either
+     * new items or updates to existing items.
+     *
+     * Tools implementing this should:
+     * - Generate UUIDs for new activities and notes using Uuid.Generate()
+     * - Track activity IDs locally to detect updates vs new items
+     * - Send NewActivityWithNotes for new issues
+     * - Send update object with activityId for changed issues or new comments
+     * - Track description note ID and hash to detect description changes
+     * - Set activity.unread = false for initial sync, true for incremental updates
+     *
+     * @param authToken - Authorization token for access
+     * @param projectId - ID of the project to sync
+     * @param callback - Function receiving (syncUpdate, ...extraArgs) for each synced issue
+     * @param options - Optional configuration for limiting the sync scope (e.g., time range)
+     * @param extraArgs - Additional arguments to pass to the callback (type-checked)
+     * @returns Promise that resolves when sync setup is complete
+     */
+    startSync<TCallback extends (syncUpdate: SyncUpdate, ...args: any[]) => any>(authToken: string, projectId: string, callback: TCallback, options?: ProjectSyncOptions, ...extraArgs: TCallback extends (syncUpdate: any, ...rest: infer R) => any ? R : []): 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>;
+    /**
+     * 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.
+     *
+     * The update object contains only the fields that changed, plus id and source.
+     * Uses the combination of start and doneAt to determine workflow state:
+     * - doneAt set → Completed/Done state
+     * - doneAt null + start set → In Progress/Active state
+     * - doneAt null + start null → Backlog/Todo state
+     *
+     * @param authToken - Authorization token for access
+     * @param update - ActivityUpdate with changed fields (includes id and source)
+     * @returns Promise that resolves when the update is synced
+     */
+    updateIssue?(authToken: string, update: ActivityUpdate): 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.
+     *
+     * @param authToken - Authorization token for access
+     * @param issueId - ID or key of the issue/task to comment on
+     * @param body - The comment text content
+     * @returns Promise that resolves when the comment is added
+     */
+    addIssueComment?(authToken: string, issueId: string, body: string): Promise<void>;
+}
+//# sourceMappingURL=projects.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"projects.d.ts","sourceRoot":"","sources":["../../src/common/projects.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,YAAY,EACZ,cAAc,EAEd,UAAU,EACX,MAAM,UAAU,CAAC;AAElB;;;;;;GAMG;AACH,MAAM,MAAM,WAAW,GAAG;IACxB,qDAAqD;IACrD,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF;;;;;GAKG;AACH,MAAM,WAAW,OAAO;IACtB,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;AAED;;;;;GAKG;AACH,MAAM,WAAW,kBAAkB;IACjC,oDAAoD;IACpD,OAAO,CAAC,EAAE,IAAI,CAAC;CAChB;AAED;;;;;GAKG;AACH,MAAM,WAAW,WAAW;IAC1B;;;;;;OAMG;IACH,WAAW,CAAC,SAAS,SAAS,CAAC,IAAI,EAAE,WAAW,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,EACtE,QAAQ,EAAE,SAAS,EACnB,GAAG,SAAS,EAAE,SAAS,SAAS,CAAC,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI,EAAE,MAAM,CAAC,KAAK,GAAG,GAChE,CAAC,GACD,EAAE,GACL,OAAO,CAAC,YAAY,CAAC,CAAC;IAEzB;;;;;OAKG;IACH,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;IAEnD;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,SAAS,CACP,SAAS,SAAS,CAChB,UAAU,EAAE,UAAU,EACtB,GAAG,IAAI,EAAE,GAAG,EAAE,KACX,GAAG,EAER,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,SAAS,EACnB,OAAO,CAAC,EAAE,kBAAkB,EAC5B,GAAG,SAAS,EAAE,SAAS,SAAS,CAC9B,UAAU,EAAE,GAAG,EACf,GAAG,IAAI,EAAE,MAAM,CAAC,KACb,GAAG,GACJ,CAAC,GACD,EAAE,GACL,OAAO,CAAC,IAAI,CAAC,CAAC;IAEjB;;;;;;OAMG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE9D;;;;;;;;;;;;;;;OAeG;IACH,WAAW,CAAC,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEvE;;;;;;;;;;OAUG;IACH,eAAe,CAAC,CACd,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,IAAI,CAAC,CAAC;CAClB"}

package/dist/common/projects.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=projects.js.map

package/dist/common/projects.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"projects.js","sourceRoot":"","sources":["../../src/common/projects.ts"],"names":[],"mappings":""}

package/dist/docs/assets/hierarchy.js

@@ -1 +1 @@
-window.hierarchyData = "eJyNkrFOwzAQht/l5quR6zhOs1VMWRASbKhCJjE0ihsj+1CHKu+OnAAyk714iL///87R3cA7RwHaF8VPCN68W9PT6OYA7Q0Uj+esLwZa6J6ds4AwjfMALd83CF/eQgu91SGYcEfOWbZS7EyXiK430AKFYRdju+0DQn8e7eDNHL0Vin2FQlYohUIpD1jzCmvZoOINKlGfFgRVJZMUDVIwx4Ig9v+Kr2OgkKsOr7RybMMLJDKVHLu8QI/s2OWLpVBJ8b229k33U8ED+l+U/YUKbPKQrsNM5sPrbVeywjGhWRrNa2ue/r0HQ1fnp7xx3kD2EyjwyCbxPFpHecmndcQimq9XPK1/IudNvj9EjK1wgUHU6S7rULIJFDG2wjnDsnwDA8lccw=="
+window.hierarchyData = "eJyNkrFOwzAQht/l5qtRSJyzslWdsiAk2FCFTGpoFDdG9qEOVd4dOQFkJnvxYH/3f3fy3cA7xwG6F6qOCN68WzPw6OYA3Q2oiuesLwY66J+ds4AwjfMJuupeIXx5Cx0MVodgwh07Z8VKiTNfIrq+QAccTrtYttsuEIbzaE/ezNHbYN0orEmhbCuUirBtamwVIUlCInlcEKhJOilqpKCPBaFuVBp8HQOHXHR45ZUTG14goVSy7/MCPYp9nw+WbfpBB23tmx6mggGGX1T8FRXYFKXrMLP58HrblaxwTGiRlua1bVMn2gfDV+envHHeQPFTUOD5N96jdZyXfFrHIqL5eJJp/BM7b/L5IWJihQsMJNNd1qFkEzhiYoVzhmX5BnM3XJs="

package/dist/docs/assets/highlight.css

@@ -25,10 +25,10 @@
     --dark-hl-11: #9CDCFE;
     --light-hl-12: #EE0000;
     --dark-hl-12: #D7BA7D;
-    --light-hl-13: #098658;
-    --dark-hl-13: #B5CEA8;
-    --light-hl-14: #000000FF;
-    --dark-hl-14: #D4D4D4;
+    --light-hl-13: #000000FF;
+    --dark-hl-13: #D4D4D4;
+    --light-hl-14: #098658;
+    --dark-hl-14: #B5CEA8;
     --light-hl-15: #000000;
     --dark-hl-15: #C8C8C8;
     --light-code-background: #FFFFFF;

package/dist/docs/assets/navigation.js

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