Add Activity.threadRoot

Author: KrisBraun

.changeset/quick-streets-trade.md

@@ -0,0 +1,5 @@
+---
+"@plotday/agent": patch
+---
+
+Added: Activity.threadRoot

builder/src/plot.ts

@@ -269,6 +269,8 @@ export type Activity = {
   doneAt: Date | null;
   /** Reference to a parent activity for creating hierarchical relationships */
   parent: Activity | null;
+  /** For nested activities in a thread, references the top-level activity of that thread */
+  threadRoot?: Activity;
   /** Array of interactive links attached to the activity */
   links: Array<ActivityLink> | null;
   /** The priority context this activity belongs to */
@@ -319,7 +321,7 @@ export type Activity = {
  */
 export type NewActivity = Pick<Activity, "type"> &
   Partial<
-    Omit<Activity, "id" | "author" | "type" | "parent" | "priority"> & {
+    Omit<Activity, "id" | "author" | "type" | "parent" | "priority" | "threadRoot"> & {
       parent?: Pick<Activity, "id"> | null;
       priority?: Pick<Priority, "id">;
     }

builder/src/tools/plot.ts

@@ -27,13 +27,14 @@ export enum ActivityAccess {
 
 export enum PriorityAccess {
   /**
-   * Create new priority.
+   * Create a new Priority within the agent's Priority.
    * Update Priority created by the agent.
    */
   Create,
   /**
-   * Update and archive Priority created by others.
-   * All Create permissions.
+   * Read all Priority within the agent's Priority.
+   * Create a new Priority within the agent's Priority.
+   * Update and archive any Priority within the agent's Priority.
    */
   Full,
 }