@plotday/twister 0.36.0 → 0.38.0

package/dist/tools/plot.d.ts

@@ -1,13 +1,14 @@
-import { type Activity, type ActivityOccurrence, type ActivityUpdate, type Actor, type ActorId, ITool, type NewActivity, type NewActivityWithNotes, type NewContact, type NewNote, type NewPriority, type Note, type NoteUpdate, type Priority, type PriorityUpdate, type Tag, Uuid } from "..";
-export declare enum ActivityAccess {
+import { type Thread, type ThreadUpdate, type Actor, type ActorId, ITool, type Link, type NewThread, type NewThreadWithNotes, type NewContact, type NewNote, type NewPriority, type Note, type NoteUpdate, type Priority, type PriorityUpdate, Uuid } from "..";
+import { type Schedule, type NewSchedule } from "../schedule";
+export declare enum ThreadAccess {
     /**
-     * Create new Note on an Activity where the twist was mentioned.
-     * Add/remove tags on Activity or Note where the twist was mentioned.
+     * Create new Note on a Thread where the twist was mentioned.
+     * Add/remove tags on Thread or Note where the twist was mentioned.
      */
     Respond = 0,
     /**
-     * Create new Activity.
-     * Create new Note in an Activity the twist created.
+     * Create new Thread.
+     * Create new Note in a Thread the twist created.
      * All Respond permissions.
      */
     Create = 1
@@ -32,8 +33,8 @@ export declare enum ContactAccess {
     Write = 1
 }
 /**
- * Intent handler for activity mentions.
- * Defines how the twist should respond when mentioned in an activity.
+ * Intent handler for thread mentions.
+ * Defines how the twist should respond when mentioned in a thread.
  */
 export type NoteIntentHandler = {
     /** Human-readable description of what this intent handles */
@@ -43,10 +44,59 @@ export type NoteIntentHandler = {
     /** The function to call when this intent is matched */
     handler: (note: Note) => Promise<void>;
 };
+/**
+ * Filter for querying links from connected source channels.
+ */
+export type LinkFilter = {
+    /** Only return links from these channel IDs. */
+    channelIds?: string[];
+    /** Only return links created/updated after this date. */
+    since?: Date;
+    /** Only return links of this type. */
+    type?: string;
+    /** Maximum number of links to return. */
+    limit?: number;
+};
+type SearchResultBase = {
+    thread: {
+        id: string;
+        title: string | null;
+    };
+    priority: {
+        id: string;
+        title: string | null;
+    };
+    similarity: number;
+};
+export type NoteSearchResult = SearchResultBase & {
+    type: 'note';
+    id: string;
+    content: string | null;
+};
+export type LinkSearchResult = SearchResultBase & {
+    type: 'link';
+    id: string;
+    title: string | null;
+    sourceUrl: string | null;
+    content: string | null;
+};
+export type SearchResult = NoteSearchResult | LinkSearchResult;
+/** Default number of search results returned */
+export declare const SEARCH_DEFAULT_LIMIT = 10;
+/** Maximum number of search results allowed */
+export declare const SEARCH_MAX_LIMIT = 30;
+export type SearchOptions = {
+    /** Max results to return (default: 10, max: 30) */
+    limit?: number;
+    /** Minimum similarity score 0-1 (default: 0.3) */
+    threshold?: number;
+    /** Scope search to this priority + descendants (default: twist's installed priority). Must be within the twist's allowed scope. */
+    priorityId?: string;
+};
 /**
  * Built-in tool for interacting with the core Plot data layer.
  *
- * The Plot tool provides twists with the ability to create and manage activities,
+ * The Plot tool provides twists with the ability to create and manage threads,
  * priorities, and contacts within the Plot system. This is the primary interface
  * for twists to persist data and interact with the Plot database.
  *
@@ -61,13 +111,12 @@ export type NoteIntentHandler = {
  *   }
  *
  *   async activate(priority) {
- *     // Create a welcome activity
- *     await this.plot.createActivity({
- *       type: ActivityType.Note,
+ *     // Create a welcome thread
+ *     await this.plot.createThread({
  *       title: "Welcome to Plot!",
- *       links: [{
+ *       actions: [{
  *         title: "Get Started",
- *         type: ActivityLinkType.external,
+ *         type: ActionType.external,
  *         url: "https://plot.day/docs"
  *       }]
  *     });
@@ -87,8 +136,8 @@ export declare abstract class Plot extends ITool {
      * build(build: ToolBuilder) {
      *   return {
      *     plot: build(Plot, {
-     *       activity: {
-     *         access: ActivityAccess.Create
+     *       thread: {
+     *         access: ThreadAccess.Create
      *       }
      *     })
      *   };
@@ -98,9 +147,8 @@ export declare abstract class Plot extends ITool {
      * build(build: ToolBuilder) {
      *   return {
      *     plot: build(Plot, {
-     *       activity: {
-     *         access: ActivityAccess.Create,
-     *         updated: this.onActivityUpdated
+     *       thread: {
+     *         access: ThreadAccess.Create,
      *       },
      *       note: {
      *         intents: [{
@@ -108,8 +156,8 @@ export declare abstract class Plot extends ITool {
      *           examples: ["Schedule a meeting tomorrow"],
      *           handler: this.onSchedulingIntent
      *         }],
-     *         created: this.onNoteCreated
      *       },
+     *       link: true,
      *       priority: {
      *         access: PriorityAccess.Full
      *       },
@@ -122,27 +170,12 @@ export declare abstract class Plot extends ITool {
      * ```
      */
     static readonly Options: {
-        activity?: {
+        thread?: {
             /**
              * Capability to create Notes and modify tags.
              * Must be explicitly set to grant permissions.
              */
-            access?: ActivityAccess;
-            /**
-             * Called when an activity created by this twist is updated.
-             * This is often used to implement two-way sync with an external system.
-             *
-             * @param activity - The updated activity
-             * @param changes - Changes to the activity and the previous version
-             */
-            updated?: (activity: Activity, changes: {
-                tagsAdded: Record<Tag, ActorId[]>;
-                tagsRemoved: Record<Tag, ActorId[]>;
-                /**
-                 * If present, this update is for a specific occurrence of a recurring activity.
-                 */
-                occurrence?: ActivityOccurrence;
-            }) => Promise<void>;
+            access?: ThreadAccess;
         };
         note?: {
             /**
@@ -165,120 +198,98 @@ export declare abstract class Plot extends ITool {
              * ```
              */
             intents?: NoteIntentHandler[];
-            /**
-             * Called when a note is created on an activity created by this twist.
-             * This is often used to implement two-way sync with an external system,
-             * such as syncing notes as comments back to the source system.
-             *
-             * Notes created by the twist itself are automatically filtered out to prevent loops.
-             * The parent activity is available via note.activity.
-             *
-             * @param note - The newly created note
-             */
-            created?: (note: Note) => Promise<void>;
         };
+        /** Enable link processing from connected source channels. */
+        link?: true;
         priority?: {
             access?: PriorityAccess;
         };
         contact?: {
             access?: ContactAccess;
         };
+        /** Enable semantic search across notes and links in the twist's priority scope. */
+        search?: true;
     };
     /**
-     * Creates a new activity in the Plot system.
+     * Creates a new thread in the Plot system.
      *
-     * The activity will be automatically assigned an ID and author information
-     * based on the current execution context. All other fields from NewActivity
-     * will be preserved in the created activity.
+     * The thread will be automatically assigned an ID and author information
+     * based on the current execution context. All other fields from NewThread
+     * will be preserved in the created thread.
      *
-     * @param activity - The activity data to create
-     * @returns Promise resolving to the created activity's ID
+     * @param thread - The thread data to create
+     * @returns Promise resolving to the created thread's ID
      */
-    abstract createActivity(activity: NewActivity | NewActivityWithNotes): Promise<Uuid>;
+    abstract createThread(thread: NewThread | NewThreadWithNotes): Promise<Uuid>;
     /**
-     * Creates multiple activities in a single batch operation.
+     * Creates multiple threads in a single batch operation.
      *
-     * This method efficiently creates multiple activities at once, which is
-     * more performant than calling createActivity() multiple times individually.
-     * All activities are created with the same author and access control rules.
+     * This method efficiently creates multiple threads at once, which is
+     * more performant than calling createThread() multiple times individually.
+     * All threads are created with the same author and access control rules.
      *
-     * @param activities - Array of activity data to create
-     * @returns Promise resolving to array of created activity IDs
+     * @param threads - Array of thread data to create
+     * @returns Promise resolving to array of created thread IDs
      */
-    abstract createActivities(activities: (NewActivity | NewActivityWithNotes)[]): Promise<Uuid[]>;
+    abstract createThreads(threads: (NewThread | NewThreadWithNotes)[]): Promise<Uuid[]>;
     /**
-     * Updates an existing activity in the Plot system.
+     * Updates an existing thread in the Plot system.
      *
-     * **Important**: This method only updates existing activities. It will throw an error
-     * if the activity does not exist. Use `createActivity()` to create or update (upsert)
-     * activities.
+     * **Important**: This method only updates existing threads. It will throw an error
+     * if the thread does not exist. Use `createThread()` to create or update (upsert)
+     * threads.
      *
      * Only the fields provided in the update object will be modified - all other fields
      * remain unchanged. This enables partial updates without needing to fetch and resend
-     * the entire activity object.
+     * the entire thread object.
      *
      * For tags, provide a Record<number, boolean> where true adds a tag and false removes it.
      * Tags not included in the update remain unchanged.
      *
-     * When updating the parent, the activity's path will be automatically recalculated to
+     * When updating the parent, the thread's path will be automatically recalculated to
      * maintain the correct hierarchical structure.
      *
-     * When updating scheduling fields (start, end, recurrence*), the database will
-     * automatically recalculate duration and range values to maintain consistency.
+     * Scheduling is handled separately via `createSchedule()` / `updateSchedule()`.
      *
-     * @param activity - The activity update containing the ID or source and fields to change
+     * @param thread - The thread update containing the ID or source and fields to change
      * @returns Promise that resolves when the update is complete
-     * @throws Error if the activity does not exist
+     * @throws Error if the thread does not exist
      *
      * @example
      * ```typescript
      * // Mark a task as complete
-     * await this.plot.updateActivity({
+     * await this.plot.updateThread({
      *   id: "task-123",
      *   done: new Date()
      * });
      *
-     * // Reschedule an event
-     * await this.plot.updateActivity({
-     *   id: "event-456",
-     *   start: new Date("2024-03-15T10:00:00Z"),
-     *   end: new Date("2024-03-15T11:00:00Z")
-     * });
-     *
      * // Add and remove tags
-     * await this.plot.updateActivity({
-     *   id: "activity-789",
+     * await this.plot.updateThread({
+     *   id: "thread-789",
      *   tags: {
      *     1: true,  // Add tag with ID 1
      *     2: false  // Remove tag with ID 2
      *   }
      * });
-     *
-     * // Update a recurring event exception
-     * await this.plot.updateActivity({
-     *   id: "exception-123",
-     *   occurrence: new Date("2024-03-20T09:00:00Z"),
-     *   title: "Rescheduled meeting"
-     * });
      * ```
      */
-    abstract updateActivity(activity: ActivityUpdate): Promise<void>;
+    abstract updateThread(thread: ThreadUpdate): Promise<void>;
     /**
-     * Retrieves all notes within an activity.
+     * Retrieves all notes within a thread.
      *
-     * Notes are detailed entries within an activity, ordered by creation time.
-     * Each note can contain markdown content, links, and other detailed information
-     * related to the parent activity.
+     * Notes are detailed entries within a thread, ordered by creation time.
+     * Each note can contain markdown content, actions, and other detailed information
+     * related to the parent thread.
      *
-     * @param activity - The activity whose notes to retrieve
-     * @returns Promise resolving to array of notes in the activity
+     * @param thread - The thread whose notes to retrieve
+     * @returns Promise resolving to array of notes in the thread
      */
-    abstract getNotes(activity: Activity): Promise<Note[]>;
+    abstract getNotes(thread: Thread): Promise<Note[]>;
     /**
-     * Creates a new note in an activity.
+     * Creates a new note in a thread.
      *
-     * Notes provide detailed content within an activity, supporting markdown,
-     * links, and other rich content. The note will be automatically assigned
+     * Notes provide detailed content within a thread, supporting markdown,
+     * actions, and other rich content. The note will be automatically assigned
      * an ID and author information based on the current execution context.
      *
      * @param note - The note data to create
@@ -288,17 +299,17 @@ export declare abstract class Plot extends ITool {
      * ```typescript
      * // Create a note with content
      * await this.plot.createNote({
-     *   activity: { id: "activity-123" },
+     *   thread: { id: "thread-123" },
      *   note: "Discussion notes from the meeting...",
      *   contentType: "markdown"
      * });
      *
-     * // Create a note with links
+     * // Create a note with actions
      * await this.plot.createNote({
-     *   activity: { id: "activity-456" },
+     *   thread: { id: "thread-456" },
      *   note: "Meeting recording available",
-     *   links: [{
-     *     type: ActivityLinkType.external,
+     *   actions: [{
+     *     type: ActionType.external,
      *     title: "View Recording",
      *     url: "https://example.com/recording"
      *   }]
@@ -321,11 +332,11 @@ export declare abstract class Plot extends ITool {
      * // Create multiple notes in one batch
      * await this.plot.createNotes([
      *   {
-     *     activity: { id: "activity-123" },
+     *     thread: { id: "thread-123" },
      *     note: "First message in thread"
      *   },
      *   {
-     *     activity: { id: "activity-123" },
+     *     thread: { id: "thread-123" },
      *     note: "Second message in thread"
      *   }
      * ]);
@@ -365,25 +376,25 @@ export declare abstract class Plot extends ITool {
      */
     abstract updateNote(note: NoteUpdate): Promise<void>;
     /**
-     * Retrieves an activity by ID or source.
+     * Retrieves a thread by ID or source.
      *
-     * This method enables lookup of activities either by their unique ID or by their
-     * source identifier (canonical URL from an external system). Archived activities
+     * This method enables lookup of threads either by their unique ID or by their
+     * source identifier (canonical URL from an external system). Archived threads
      * are included in the results.
      *
-     * @param activity - Activity lookup by ID or source
-     * @returns Promise resolving to the matching activity or null if not found
+     * @param thread - Thread lookup by ID or source
+     * @returns Promise resolving to the matching thread or null if not found
      */
-    abstract getActivity(activity: {
+    abstract getThread(thread: {
         id: Uuid;
     } | {
         source: string;
-    }): Promise<Activity | null>;
+    }): Promise<Thread | null>;
     /**
      * Retrieves a note by ID or key.
      *
      * This method enables lookup of notes either by their unique ID or by their
-     * key (unique identifier within the activity). Archived notes are included
+     * key (unique identifier within the thread). Archived notes are included
      * in the results.
      *
      * @param note - Note lookup by ID or key
@@ -397,7 +408,7 @@ export declare abstract class Plot extends ITool {
     /**
      * Creates a new priority in the Plot system.
      *
-     * Priorities serve as organizational containers for activities and twists.
+     * Priorities serve as organizational containers for threads and twists.
      * The created priority will be automatically assigned a unique ID.
      *
      * @param priority - The priority data to create
@@ -432,7 +443,7 @@ export declare abstract class Plot extends ITool {
     /**
      * Adds contacts to the Plot system.
      *
-     * Contacts are used for associating people with activities, such as
+     * Contacts are used for associating people with threads, such as
      * event attendees or task assignees. Duplicate contacts (by email)
      * will be merged or updated as appropriate.
      * This method requires ContactAccess.Write permission.
@@ -451,5 +462,59 @@ export declare abstract class Plot extends ITool {
      * @returns Promise resolving to array of actors
      */
     abstract getActors(ids: ActorId[]): Promise<Actor[]>;
+    /**
+     * Creates a new schedule for a thread.
+     *
+     * Schedules define when a thread occurs in time. A thread can have
+     * multiple schedules (shared and per-user).
+     *
+     * @param schedule - The schedule data to create
+     * @returns Promise resolving to the created schedule
+     *
+     * @example
+     * ```typescript
+     * // Schedule a timed event
+     * const threadId = await this.plot.createThread({
+     *   title: "Team standup"
+     * });
+     * await this.plot.createSchedule({
+     *   threadId,
+     *   start: new Date("2025-01-15T10:00:00Z"),
+     *   end: new Date("2025-01-15T10:30:00Z"),
+     *   recurrenceRule: "FREQ=DAILY;BYDAY=MO,TU,WE,TH,FR"
+     * });
+     * ```
+     */
+    abstract createSchedule(schedule: NewSchedule): Promise<Schedule>;
+    /**
+     * Retrieves all schedules for a thread.
+     *
+     * @param threadId - The thread whose schedules to retrieve
+     * @returns Promise resolving to array of schedules for the thread
+     */
+    abstract getSchedules(threadId: Uuid): Promise<Schedule[]>;
+    /**
+     * Retrieves links from connected source channels.
+     *
+     * Requires `link: true` in Plot options.
+     *
+     * @param filter - Optional filter criteria for links
+     * @returns Promise resolving to array of links with their notes
+     */
+    abstract getLinks(filter?: LinkFilter): Promise<Array<{
+        link: Link;
+        notes: Note[];
+    }>>;
+    /**
+     * Searches notes and links using semantic similarity.
+     *
+     * Requires `search: true` in Plot options.
+     *
+     * @param query - The search query text
+     * @param options - Optional search configuration
+     * @returns Promise resolving to array of search results ordered by similarity
+     */
+    abstract search(query: string, options?: SearchOptions): Promise<SearchResult[]>;
 }
+export {};
 //# sourceMappingURL=plot.d.ts.map

package/dist/tools/plot.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"plot.d.ts","sourceRoot":"","sources":["../../src/tools/plot.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,QAAQ,EACb,KAAK,kBAAkB,EACvB,KAAK,cAAc,EACnB,KAAK,KAAK,EACV,KAAK,OAAO,EACZ,KAAK,EACL,KAAK,WAAW,EAChB,KAAK,oBAAoB,EACzB,KAAK,UAAU,EACf,KAAK,OAAO,EACZ,KAAK,WAAW,EAChB,KAAK,IAAI,EACT,KAAK,UAAU,EACf,KAAK,QAAQ,EACb,KAAK,cAAc,EACnB,KAAK,GAAG,EACR,IAAI,EACL,MAAM,IAAI,CAAC;AAEZ,oBAAY,cAAc;IACxB;;;OAGG;IACH,OAAO,IAAA;IACP;;;;OAIG;IACH,MAAM,IAAA;CACP;AAED,oBAAY,cAAc;IACxB;;;OAGG;IACH,MAAM,IAAA;IACN;;;;OAIG;IACH,IAAI,IAAA;CACL;AAED,oBAAY,aAAa;IACvB,iFAAiF;IACjF,IAAI,IAAA;IACJ,kCAAkC;IAClC,KAAK,IAAA;CACN;AAED;;;GAGG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC9B,6DAA6D;IAC7D,WAAW,EAAE,MAAM,CAAC;IACpB,uEAAuE;IACvE,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,uDAAuD;IACvD,OAAO,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACxC,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,8BAAsB,IAAK,SAAQ,KAAK;IACtC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA4CG;IACH,MAAM,CAAC,QAAQ,CAAC,OAAO,EAAE;QACvB,QAAQ,CAAC,EAAE;YACT;;;eAGG;YACH,MAAM,CAAC,EAAE,cAAc,CAAC;YACxB;;;;;;eAMG;YACH,OAAO,CAAC,EAAE,CACR,QAAQ,EAAE,QAAQ,EAClB,OAAO,EAAE;gBACP,SAAS,EAAE,MAAM,CAAC,GAAG,EAAE,OAAO,EAAE,CAAC,CAAC;gBAClC,WAAW,EAAE,MAAM,CAAC,GAAG,EAAE,OAAO,EAAE,CAAC,CAAC;gBACpC;;mBAEG;gBACH,UAAU,CAAC,EAAE,kBAAkB,CAAC;aACjC,KACE,OAAO,CAAC,IAAI,CAAC,CAAC;SACpB,CAAC;QACF,IAAI,CAAC,EAAE;YACL;;;;;;;;;;;;;;;;;;eAkBG;YACH,OAAO,CAAC,EAAE,iBAAiB,EAAE,CAAC;YAC9B;;;;;;;;;eASG;YACH,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;SACzC,CAAC;QACF,QAAQ,CAAC,EAAE;YACT,MAAM,CAAC,EAAE,cAAc,CAAC;SACzB,CAAC;QACF,OAAO,CAAC,EAAE;YACR,MAAM,CAAC,EAAE,aAAa,CAAC;SACxB,CAAC;KACH,CAAC;IAEF;;;;;;;;;OASG;IAEH,QAAQ,CAAC,cAAc,CACrB,QAAQ,EAAE,WAAW,GAAG,oBAAoB,GAC3C,OAAO,CAAC,IAAI,CAAC;IAEhB;;;;;;;;;OASG;IAEH,QAAQ,CAAC,gBAAgB,CACvB,UAAU,EAAE,CAAC,WAAW,GAAG,oBAAoB,CAAC,EAAE,GACjD,OAAO,CAAC,IAAI,EAAE,CAAC;IAElB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAuDG;IAEH,QAAQ,CAAC,cAAc,CAAC,QAAQ,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAEhE;;;;;;;;;OASG;IAEH,QAAQ,CAAC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;IAEtD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA8BG;IAEH,QAAQ,CAAC,UAAU,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAEjD;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IAEH,QAAQ,CAAC,WAAW,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;IAEvD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA8BG;IAEH,QAAQ,CAAC,UAAU,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAEpD;;;;;;;;;OASG;IAEH,QAAQ,CAAC,WAAW,CAClB,QAAQ,EAAE;QAAE,EAAE,EAAE,IAAI,CAAA;KAAE,GAAG;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,GAC1C,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC;IAE3B;;;;;;;;;OASG;IAEH,QAAQ,CAAC,OAAO,CAAC,IAAI,EAAE;QAAE,EAAE,EAAE,IAAI,CAAA;KAAE,GAAG;QAAE,GAAG,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC;IAE5E;;;;;;;;OAQG;IAEH,QAAQ,CAAC,cAAc,CAAC,QAAQ,EAAE,WAAW,GAAG,OAAO,CAAC,QAAQ,GAAG;QAAE,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC;IAExF;;;;;;;OAOG;IAEH,QAAQ,CAAC,WAAW,CAClB,QAAQ,EAAE;QAAE,EAAE,EAAE,IAAI,CAAA;KAAE,GAAG;QAAE,GAAG,EAAE,MAAM,CAAA;KAAE,GACvC,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC;IAE3B;;;;;;;;OAQG;IAEH,QAAQ,CAAC,cAAc,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAE9D;;;;;;;;;;OAUG;IAEH,QAAQ,CAAC,WAAW,CAAC,QAAQ,EAAE,KAAK,CAAC,UAAU,CAAC,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;IAEnE;;;;;;;;OAQG;IAEH,QAAQ,CAAC,SAAS,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;CACrD"}
+{"version":3,"file":"plot.d.ts","sourceRoot":"","sources":["../../src/tools/plot.ts"],"names":[],"mappings":"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"}

package/dist/tools/plot.js

@@ -1,18 +1,18 @@
 import { ITool, } from "..";
-export var ActivityAccess;
-(function (ActivityAccess) {
+export var ThreadAccess;
+(function (ThreadAccess) {
     /**
-     * Create new Note on an Activity where the twist was mentioned.
-     * Add/remove tags on Activity or Note where the twist was mentioned.
+     * Create new Note on a Thread where the twist was mentioned.
+     * Add/remove tags on Thread or Note where the twist was mentioned.
      */
-    ActivityAccess[ActivityAccess["Respond"] = 0] = "Respond";
+    ThreadAccess[ThreadAccess["Respond"] = 0] = "Respond";
     /**
-     * Create new Activity.
-     * Create new Note in an Activity the twist created.
+     * Create new Thread.
+     * Create new Note in a Thread the twist created.
      * All Respond permissions.
      */
-    ActivityAccess[ActivityAccess["Create"] = 1] = "Create";
-})(ActivityAccess || (ActivityAccess = {}));
+    ThreadAccess[ThreadAccess["Create"] = 1] = "Create";
+})(ThreadAccess || (ThreadAccess = {}));
 export var PriorityAccess;
 (function (PriorityAccess) {
     /**
@@ -34,10 +34,14 @@ export var ContactAccess;
     /** Create and update contacts. */
     ContactAccess[ContactAccess["Write"] = 1] = "Write";
 })(ContactAccess || (ContactAccess = {}));
+/** Default number of search results returned */
+export const SEARCH_DEFAULT_LIMIT = 10;
+/** Maximum number of search results allowed */
+export const SEARCH_MAX_LIMIT = 30;
 /**
  * Built-in tool for interacting with the core Plot data layer.
  *
- * The Plot tool provides twists with the ability to create and manage activities,
+ * The Plot tool provides twists with the ability to create and manage threads,
  * priorities, and contacts within the Plot system. This is the primary interface
  * for twists to persist data and interact with the Plot database.
  *
@@ -52,13 +56,12 @@ export var ContactAccess;
  *   }
  *
  *   async activate(priority) {
- *     // Create a welcome activity
- *     await this.plot.createActivity({
- *       type: ActivityType.Note,
+ *     // Create a welcome thread
+ *     await this.plot.createThread({
  *       title: "Welcome to Plot!",
- *       links: [{
+ *       actions: [{
  *         title: "Get Started",
- *         type: ActivityLinkType.external,
+ *         type: ActionType.external,
  *         url: "https://plot.day/docs"
  *       }]
  *     });
@@ -78,8 +81,8 @@ export class Plot extends ITool {
      * build(build: ToolBuilder) {
      *   return {
      *     plot: build(Plot, {
-     *       activity: {
-     *         access: ActivityAccess.Create
+     *       thread: {
+     *         access: ThreadAccess.Create
      *       }
      *     })
      *   };
@@ -89,9 +92,8 @@ export class Plot extends ITool {
      * build(build: ToolBuilder) {
      *   return {
      *     plot: build(Plot, {
-     *       activity: {
-     *         access: ActivityAccess.Create,
-     *         updated: this.onActivityUpdated
+     *       thread: {
+     *         access: ThreadAccess.Create,
      *       },
      *       note: {
      *         intents: [{
@@ -99,8 +101,8 @@ export class Plot extends ITool {
      *           examples: ["Schedule a meeting tomorrow"],
      *           handler: this.onSchedulingIntent
      *         }],
-     *         created: this.onNoteCreated
      *       },
+     *       link: true,
      *       priority: {
      *         access: PriorityAccess.Full
      *       },

package/dist/tools/plot.js.map

@@ -1 +1 @@
-{"version":3,"file":"plot.js","sourceRoot":"","sources":["../../src/tools/plot.ts"],"names":[],"mappings":"AAAA,OAAO,EAML,KAAK,GAYN,MAAM,IAAI,CAAC;AAEZ,MAAM,CAAN,IAAY,cAYX;AAZD,WAAY,cAAc;IACxB;;;OAGG;IACH,yDAAO,CAAA;IACP;;;;OAIG;IACH,uDAAM,CAAA;AACR,CAAC,EAZW,cAAc,KAAd,cAAc,QAYzB;AAED,MAAM,CAAN,IAAY,cAYX;AAZD,WAAY,cAAc;IACxB;;;OAGG;IACH,uDAAM,CAAA;IACN;;;;OAIG;IACH,mDAAI,CAAA;AACN,CAAC,EAZW,cAAc,KAAd,cAAc,QAYzB;AAED,MAAM,CAAN,IAAY,aAKX;AALD,WAAY,aAAa;IACvB,iFAAiF;IACjF,iDAAI,CAAA;IACJ,kCAAkC;IAClC,mDAAK,CAAA;AACP,CAAC,EALW,aAAa,KAAb,aAAa,QAKxB;AAeD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,MAAM,OAAgB,IAAK,SAAQ,KAAK;IACtC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA4CG;IACH,MAAM,CAAU,OAAO,CAiErB;CAkSH"}
+{"version":3,"file":"plot.js","sourceRoot":"","sources":["../../src/tools/plot.ts"],"names":[],"mappings":"AAAA,OAAO,EAKL,KAAK,GAYN,MAAM,IAAI,CAAC;AAMZ,MAAM,CAAN,IAAY,YAYX;AAZD,WAAY,YAAY;IACtB;;;OAGG;IACH,qDAAO,CAAA;IACP;;;;OAIG;IACH,mDAAM,CAAA;AACR,CAAC,EAZW,YAAY,KAAZ,YAAY,QAYvB;AAED,MAAM,CAAN,IAAY,cAYX;AAZD,WAAY,cAAc;IACxB;;;OAGG;IACH,uDAAM,CAAA;IACN;;;;OAIG;IACH,mDAAI,CAAA;AACN,CAAC,EAZW,cAAc,KAAd,cAAc,QAYzB;AAED,MAAM,CAAN,IAAY,aAKX;AALD,WAAY,aAAa;IACvB,iFAAiF;IACjF,iDAAI,CAAA;IACJ,kCAAkC;IAClC,mDAAK,CAAA;AACP,CAAC,EALW,aAAa,KAAb,aAAa,QAKxB;AAmDD,gDAAgD;AAChD,MAAM,CAAC,MAAM,oBAAoB,GAAG,EAAE,CAAC;AACvC,+CAA+C;AAC/C,MAAM,CAAC,MAAM,gBAAgB,GAAG,EAAE,CAAC;AAWnC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,MAAM,OAAgB,IAAK,SAAQ,KAAK;IACtC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA2CG;IACH,MAAM,CAAU,OAAO,CAwCrB;CA6UH"}

package/dist/tools/twists.d.ts

@@ -41,7 +41,7 @@ export type Log = {
  *     "https://googleapis.com/*": ["use"]
  *   },
  *   "plot": {
- *     "activity:mentioned": ["read", "write", "update"],
+ *     "thread:mentioned": ["read", "write", "update"],
  *     "priority": ["read", "write", "update"]
  *   }
  * }