@plotday/twister 0.28.0 → 0.30.0

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

@@ -1 +1 @@
-{"version":3,"file":"network.d.ts","sourceRoot":"","sources":["../../src/tools/network.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,IAAI,CAAC;AAC3B,OAAO,EAAE,KAAK,YAAY,EAAE,KAAK,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAEvE;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,MAAM,cAAc,GAAG;IAC3B,mDAAmD;IACnD,MAAM,EAAE,MAAM,CAAC;IACf,oCAAoC;IACpC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,mDAAmD;IACnD,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,kDAAkD;IAClD,IAAI,EAAE,GAAG,CAAC;IACV,oDAAoD;IACpD,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiFG;AACH,8BAAsB,OAAQ,SAAQ,KAAK;IACzC,MAAM,CAAC,QAAQ,CAAC,OAAO,EAAE;QACvB;;;WAGG;QACH,IAAI,EAAE,MAAM,EAAE,CAAC;KAChB,CAAC;IAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAwCG;IACH,QAAQ,CAAC,aAAa,CACpB,SAAS,SAAS,CAAC,OAAO,EAAE,cAAc,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,EAClE,OAAO,EAAE;QACT,QAAQ,EAAE,SAAS,CAAC;QACpB,SAAS,CAAC,EAAE,SAAS,SAAS,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,EAAE,MAAM,CAAC,KAAK,GAAG,GAAG,CAAC,GAAG,EAAE,CAAC;QAC3E,QAAQ,CAAC,EAAE,YAAY,CAAC;QACxB,aAAa,CAAC,EAAE,aAAa,CAAC;KAC/B,GAAG,OAAO,CAAC,MAAM,CAAC;IAEnB;;;;;;;;;;;;;;;;;;OAkBG;IACH,QAAQ,CAAC,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CACnD"}
+{"version":3,"file":"network.d.ts","sourceRoot":"","sources":["../../src/tools/network.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,IAAI,CAAC;AAC3B,OAAO,EAAE,KAAK,SAAS,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9D,OAAO,EAAE,KAAK,YAAY,EAAE,KAAK,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAEvE;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,MAAM,cAAc,GAAG;IAC3B,mDAAmD;IACnD,MAAM,EAAE,MAAM,CAAC;IACf,oCAAoC;IACpC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,mDAAmD;IACnD,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,kDAAkD;IAClD,IAAI,EAAE,SAAS,CAAC;IAChB,oDAAoD;IACpD,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmFG;AACH,8BAAsB,OAAQ,SAAQ,KAAK;IACzC,MAAM,CAAC,QAAQ,CAAC,OAAO,EAAE;QACvB;;;WAGG;QACH,IAAI,EAAE,MAAM,EAAE,CAAC;KAChB,CAAC;IAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA0CG;IACH,QAAQ,CAAC,aAAa,CACpB,KAAK,SAAS,YAAY,EAAE,EAC5B,SAAS,SAAS,CAAC,OAAO,EAAE,cAAc,EAAE,GAAG,IAAI,EAAE,KAAK,KAAK,GAAG,EAElE,OAAO,EAAE;QACP,QAAQ,CAAC,EAAE,YAAY,CAAC;QACxB,aAAa,CAAC,EAAE,aAAa,CAAC;KAC/B,EACD,QAAQ,EAAE,SAAS,EACnB,GAAG,SAAS,EAAE,KAAK,GAClB,OAAO,CAAC,MAAM,CAAC;IAElB;;;;;;;;;;;;;;;;;;OAkBG;IACH,QAAQ,CAAC,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CACnD"}

package/dist/tools/network.js

@@ -52,10 +52,12 @@ import { ITool } from "..";
  *
  *   async setupCalendarWebhook(calendarId: string) {
  *     // Create webhook URL that will call onCalendarEvent
- *     const webhookUrl = await this.tools.network.createWebhook({
- *       callback: this.onCalendarEvent,
- *       extraArgs: [calendarId, "google"]
- *     });
+ *     const webhookUrl = await this.tools.network.createWebhook(
+ *       {},
+ *       this.onCalendarEvent,
+ *       calendarId,
+ *       "google"
+ *     );
  *
  *     // Register webhook with Google Calendar API
  *     await this.registerWithGoogleCalendar(calendarId, webhookUrl);

package/dist/tools/network.js.map

@@ -1 +1 @@
-{"version":3,"file":"network.js","sourceRoot":"","sources":["../../src/tools/network.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,IAAI,CAAC;AAiC3B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiFG;AACH,MAAM,OAAgB,OAAQ,SAAQ,KAAK;IACzC,MAAM,CAAU,OAAO,CAMrB;CAwEH"}
+{"version":3,"file":"network.js","sourceRoot":"","sources":["../../src/tools/network.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,IAAI,CAAC;AAkC3B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmFG;AACH,MAAM,OAAgB,OAAQ,SAAQ,KAAK;IACzC,MAAM,CAAU,OAAO,CAMrB;CA6EH"}

package/dist/tools/plot.d.ts

@@ -1,4 +1,4 @@
-import { type Activity, type ActivityMeta, type ActivityUpdate, type Actor, type ActorId, ITool, type NewActivity, type NewActivityWithNotes, type NewContact, type NewNote, type NewPriority, type Note, type NoteUpdate, type Priority, type Tag } from "..";
+import { type Activity, 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 {
     /**
      * Create new Note on an Activity where the twist was mentioned.
@@ -76,10 +76,56 @@ export type NoteIntentHandler = {
  * ```
  */
 export declare abstract class Plot extends ITool {
+    /**
+     * Configuration options for the Plot tool.
+     *
+     * **Important**: All permissions must be explicitly requested. There are no default permissions.
+     *
+     * @example
+     * ```typescript
+     * // Minimal configuration with required permissions
+     * build(build: ToolBuilder) {
+     *   return {
+     *     plot: build(Plot, {
+     *       activity: {
+     *         access: ActivityAccess.Create
+     *       }
+     *     })
+     *   };
+     * }
+     *
+     * // Full configuration with callbacks
+     * build(build: ToolBuilder) {
+     *   return {
+     *     plot: build(Plot, {
+     *       activity: {
+     *         access: ActivityAccess.Create,
+     *         updated: this.onActivityUpdated
+     *       },
+     *       note: {
+     *         intents: [{
+     *           description: "Schedule meetings",
+     *           examples: ["Schedule a meeting tomorrow"],
+     *           handler: this.onSchedulingIntent
+     *         }],
+     *         created: this.onNoteCreated
+     *       },
+     *       priority: {
+     *         access: PriorityAccess.Full
+     *       },
+     *       contact: {
+     *         access: ContactAccess.Write
+     *       }
+     *     })
+     *   };
+     * }
+     * ```
+     */
     static readonly Options: {
         activity?: {
             /**
              * Capability to create Notes and modify tags.
+             * Must be explicitly set to grant permissions.
              */
             access?: ActivityAccess;
             /**
@@ -90,8 +136,6 @@ export declare abstract class Plot extends ITool {
              * @param changes - Changes to the activity and the previous version
              */
             updated?: (activity: Activity, changes: {
-                update: ActivityUpdate;
-                previous: Activity;
                 tagsAdded: Record<Tag, ActorId[]>;
                 tagsRemoved: Record<Tag, ActorId[]>;
             }) => Promise<void>;
@@ -308,35 +352,35 @@ export declare abstract class Plot extends ITool {
      */
     abstract updateNote(note: NoteUpdate): Promise<void>;
     /**
-     * Finds an activity by its meta.source.
-     *
-     * This method enables lookup of activities that were created from external
-     * systems, using the metadata to locate the corresponding Plot activity.
+     * Retrieves an activity by ID or source.
      *
-     * By default, archived activities are excluded from the search. Set includeArchived
-     * to true to include them in the results.
+     * This method enables lookup of activities either by their unique ID or by their
+     * source identifier (canonical URL from an external system). Archived activities
+     * are included in the results.
      *
-     * @param source - The meta.source value to search for
-     * @param includeArchived - Whether to include archived activities in search (default: false)
+     * @param activity - Activity lookup by ID or source
      * @returns Promise resolving to the matching activity or null if not found
      */
-    abstract getActivityBySource(source: string, includeArchived?: boolean): Promise<Activity | null>;
+    abstract getActivity(activity: {
+        id: Uuid;
+    } | {
+        source: string;
+    }): Promise<Activity | null>;
     /**
-     * Finds an activity by its metadata.
+     * Retrieves a note by ID or key.
      *
-     * This method enables lookup of activities that were created from external
-     * systems, using the metadata to locate the corresponding Plot activity.
-     * Uses JSON containment matching - the provided meta must be contained
-     * within the activity's meta field.
+     * This method enables lookup of notes either by their unique ID or by their
+     * key (unique identifier within the activity). Archived notes are included
+     * in the results.
      *
-     * By default, archived activities are excluded from the search. Set includeArchived
-     * to true to include them in the results.
-     *
-     * @param meta - The metadata to search for (uses JSON containment matching)
-     * @param includeArchived - Whether to include archived activities in search (default: false)
-     * @returns Promise resolving to the matching activity or null if not found
+     * @param note - Note lookup by ID or key
+     * @returns Promise resolving to the matching note or null if not found
      */
-    abstract getActivityByMeta(meta: ActivityMeta, includeArchived?: boolean): Promise<Activity | null>;
+    abstract getNote(note: {
+        id: Uuid;
+    } | {
+        key: string;
+    }): Promise<Note | null>;
     /**
      * Creates a new priority in the Plot system.
      *
@@ -347,6 +391,29 @@ export declare abstract class Plot extends ITool {
      * @returns Promise resolving to the complete created priority
      */
     abstract createPriority(priority: NewPriority): Promise<Priority>;
+    /**
+     * Retrieves a priority by ID or key.
+     *
+     * Archived priorities are included in the results.
+     *
+     * @param priority - Priority lookup by ID or key
+     * @returns Promise resolving to the matching priority or null if not found
+     */
+    abstract getPriority(priority: {
+        id: Uuid;
+    } | {
+        key: string;
+    }): Promise<Priority | null>;
+    /**
+     * Updates an existing priority in the Plot system.
+     *
+     * The priority is identified by either its ID or key.
+     * Only the fields specified in the update will be changed.
+     *
+     * @param update - Priority update containing ID/key and fields to change
+     * @returns Promise that resolves when the update is complete
+     */
+    abstract updatePriority(update: PriorityUpdate): Promise<void>;
     /**
      * Adds contacts to the Plot system.
      *

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

@@ -1 +1 @@
-{"version":3,"file":"plot.d.ts","sourceRoot":"","sources":["../../src/tools/plot.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"plot.d.ts","sourceRoot":"","sources":["../../src/tools/plot.ts"],"names":[],"mappings":"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"}

package/dist/tools/plot.js

@@ -67,6 +67,51 @@ export var ContactAccess;
  * ```
  */
 export class Plot extends ITool {
+    /**
+     * Configuration options for the Plot tool.
+     *
+     * **Important**: All permissions must be explicitly requested. There are no default permissions.
+     *
+     * @example
+     * ```typescript
+     * // Minimal configuration with required permissions
+     * build(build: ToolBuilder) {
+     *   return {
+     *     plot: build(Plot, {
+     *       activity: {
+     *         access: ActivityAccess.Create
+     *       }
+     *     })
+     *   };
+     * }
+     *
+     * // Full configuration with callbacks
+     * build(build: ToolBuilder) {
+     *   return {
+     *     plot: build(Plot, {
+     *       activity: {
+     *         access: ActivityAccess.Create,
+     *         updated: this.onActivityUpdated
+     *       },
+     *       note: {
+     *         intents: [{
+     *           description: "Schedule meetings",
+     *           examples: ["Schedule a meeting tomorrow"],
+     *           handler: this.onSchedulingIntent
+     *         }],
+     *         created: this.onNoteCreated
+     *       },
+     *       priority: {
+     *         access: PriorityAccess.Full
+     *       },
+     *       contact: {
+     *         access: ContactAccess.Write
+     *       }
+     *     })
+     *   };
+     * }
+     * ```
+     */
     static Options;
 }
 //# sourceMappingURL=plot.js.map

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,GAUN,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,MAAM,CAAU,OAAO,CA8DrB;CA4QH"}
+{"version":3,"file":"plot.js","sourceRoot":"","sources":["../../src/tools/plot.ts"],"names":[],"mappings":"AAAA,OAAO,EAKL,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,CA6DrB;CAyRH"}

package/dist/tools/store.d.ts

@@ -1,4 +1,4 @@
-import { ITool } from "..";
+import { ITool, type Serializable } from "..";
 /**
  * Built-in tool for persistent key-value storage.
  *
@@ -13,9 +13,20 @@ import { ITool } from "..";
  * **Storage Characteristics:**
  * - Persistent across worker restarts
  * - Isolated per twist/tool instance
- * - Supports any JSON-serializable data
+ * - Supports SuperJSON-serializable data (see below)
  * - Async operations for scalability
  *
+ * **Supported Data Types (via SuperJSON):**
+ * - Primitives: string, number, boolean, null, undefined
+ * - Complex types: Date, RegExp, Map, Set, Error, URL, BigInt
+ * - Collections: Arrays and objects (recursively)
+ *
+ * **NOT Supported (will throw validation errors):**
+ * - Functions (use callback tokens instead - see Callbacks tool)
+ * - Symbols
+ * - Circular references
+ * - Custom class instances
+ *
  * **Use Cases:**
  * - Storing authentication tokens
  * - Caching configuration data
@@ -50,39 +61,53 @@ export declare abstract class Store extends ITool {
      * Returns the stored value deserialized to the specified type,
      * or null if the key doesn't exist or the value is null.
      *
-     * @template T - The expected type of the stored value
+     * Values are automatically deserialized using SuperJSON, which
+     * properly restores Date objects, Maps, Sets, and other complex types.
+     *
+     * @template T - The expected type of the stored value (must be Serializable)
      * @param key - The storage key to retrieve
      * @returns Promise resolving to the stored value or null
      */
-    abstract get<T>(key: string): Promise<T | null>;
+    abstract get<T extends Serializable>(key: string): Promise<T | null>;
     /**
      * Stores a value in persistent storage.
      *
-     * The value will be JSON-serialized and stored persistently.
+     * The value will be serialized using SuperJSON and stored persistently.
      * Any existing value at the same key will be overwritten.
      *
-     * **Handling undefined values:**
-     * - Object keys with undefined values are automatically removed
-     * - Arrays with undefined elements will throw a validation error
-     * - Use null instead of undefined for array elements
+     * SuperJSON automatically handles Date objects, Maps, Sets, undefined values,
+     * and other complex types that standard JSON doesn't support.
      *
-     * @template T - The type of value being stored
+     * @template T - The type of value being stored (must be Serializable)
      * @param key - The storage key to use
-     * @param value - The value to store (must be JSON-serializable)
+     * @param value - The value to store (must be SuperJSON-serializable)
      * @returns Promise that resolves when the value is stored
      *
      * @example
      * ```typescript
-     * // Object keys with undefined are removed
-     * await this.set('data', { name: 'test', optional: undefined });
-     * // Stores: { name: 'test' }
+     * // Date objects are preserved
+     * await this.set('sync_state', {
+     *   lastSync: new Date(),
+     *   minDate: new Date(2024, 0, 1)
+     * });
+     *
+     * // undefined is now supported
+     * await this.set('data', { name: 'test', optional: undefined }); // ✅ Works
+     *
+     * // Arrays with undefined are supported
+     * await this.set('items', [1, undefined, 3]); // ✅ Works
+     * await this.set('items', [1, null, 3]); // ✅ Also works
+     *
+     * // Maps and Sets are supported
+     * await this.set('mapping', new Map([['key', 'value']])); // ✅ Works
+     * await this.set('tags', new Set(['tag1', 'tag2'])); // ✅ Works
      *
-     * // Arrays with undefined throw errors - use null instead
-     * await this.set('items', [1, null, 3]); // ✅ Works
-     * await this.set('items', [1, undefined, 3]); // ❌ Throws error
+     * // Functions are NOT supported - use callback tokens instead
+     * const token = await this.callback(this.myFunction);
+     * await this.set('callback_ref', token); // ✅ Use callback token
      * ```
      */
-    abstract set<T>(key: string, value: T): Promise<void>;
+    abstract set<T extends Serializable>(key: string, value: T): Promise<void>;
     /**
      * Removes a specific key from storage.
      *

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

@@ -1 +1 @@
-{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/tools/store.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,IAAI,CAAC;AAE3B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AACH,8BAAsB,KAAM,SAAQ,KAAK;IACvC;;;;;;;;;OASG;IAEH,QAAQ,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IAE/C;;;;;;;;;;;;;;;;;;;;;;;;;;OA0BG;IAEH,QAAQ,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAErD;;;;;;;;OAQG;IAEH,QAAQ,CAAC,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAE1C;;;;;;;OAOG;IACH,QAAQ,CAAC,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CACnC"}
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/tools/store.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,KAAK,YAAY,EAAE,MAAM,IAAI,CAAC;AAE9C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsDG;AACH,8BAAsB,KAAM,SAAQ,KAAK;IACvC;;;;;;;;;;;;OAYG;IAEH,QAAQ,CAAC,GAAG,CAAC,CAAC,SAAS,YAAY,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IAEpE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAqCG;IAEH,QAAQ,CAAC,GAAG,CAAC,CAAC,SAAS,YAAY,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAE1E;;;;;;;;OAQG;IAEH,QAAQ,CAAC,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAE1C;;;;;;;OAOG;IACH,QAAQ,CAAC,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CACnC"}

package/dist/tools/store.js

@@ -13,9 +13,20 @@ import { ITool } from "..";
  * **Storage Characteristics:**
  * - Persistent across worker restarts
  * - Isolated per twist/tool instance
- * - Supports any JSON-serializable data
+ * - Supports SuperJSON-serializable data (see below)
  * - Async operations for scalability
  *
+ * **Supported Data Types (via SuperJSON):**
+ * - Primitives: string, number, boolean, null, undefined
+ * - Complex types: Date, RegExp, Map, Set, Error, URL, BigInt
+ * - Collections: Arrays and objects (recursively)
+ *
+ * **NOT Supported (will throw validation errors):**
+ * - Functions (use callback tokens instead - see Callbacks tool)
+ * - Symbols
+ * - Circular references
+ * - Custom class instances
+ *
  * **Use Cases:**
  * - Storing authentication tokens
  * - Caching configuration data

package/dist/tools/store.js.map

@@ -1 +1 @@
-{"version":3,"file":"store.js","sourceRoot":"","sources":["../../src/tools/store.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,IAAI,CAAC;AAE3B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AACH,MAAM,OAAgB,KAAM,SAAQ,KAAK;CAiExC"}
+{"version":3,"file":"store.js","sourceRoot":"","sources":["../../src/tools/store.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAqB,MAAM,IAAI,CAAC;AAE9C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsDG;AACH,MAAM,OAAgB,KAAM,SAAQ,KAAK;CA+ExC"}

package/dist/tools/tasks.d.ts

@@ -3,12 +3,12 @@ import type { Callback } from "./callbacks";
 /**
  * Run background tasks and scheduled jobs.
  *
- * The Run tool enables twists and tools to queue callbacks. This is especially
- * iportant for long-running operations and batch processing, since twists
- * operate within runtime limits. Run callbacks also benefit from automatic
+ * The Tasks tool enables twists and tools to queue callbacks. This is especially
+ * important for long-running operations and batch processing, since twists
+ * operate within runtime limits. Task callbacks also benefit from automatic
  * retries on failure.
  *
- * **Note:** Run methods are also available directly on Twist and Tool classes
+ * **Note:** Tasks tool methods are also available directly on Twist and Tool classes
  * via `this.runTask()`, `this.cancelTask()`, and `this.cancelAllTasks()`.
  * This is the recommended approach for most use cases.
  *

package/dist/tools/tasks.js

@@ -2,12 +2,12 @@ import { ITool } from "..";
 /**
  * Run background tasks and scheduled jobs.
  *
- * The Run tool enables twists and tools to queue callbacks. This is especially
- * iportant for long-running operations and batch processing, since twists
- * operate within runtime limits. Run callbacks also benefit from automatic
+ * The Tasks tool enables twists and tools to queue callbacks. This is especially
+ * important for long-running operations and batch processing, since twists
+ * operate within runtime limits. Task callbacks also benefit from automatic
  * retries on failure.
  *
- * **Note:** Run methods are also available directly on Twist and Tool classes
+ * **Note:** Tasks tool methods are also available directly on Twist and Tool classes
  * via `this.runTask()`, `this.cancelTask()`, and `this.cancelAllTasks()`.
  * This is the recommended approach for most use cases.
  *

package/dist/twist.d.ts

@@ -1,6 +1,7 @@
-import { type Priority } from "./plot";
+import { ActivityLink, type Priority, Uuid } from "./plot";
 import { type ITool } from "./tool";
 import type { Callback } from "./tools/callbacks";
+import type { Serializable } from "./utils/serializable";
 import type { InferTools, ToolBuilder, ToolShed } from "./utils/types";
 /**
  * Base class for all twists.
@@ -30,9 +31,9 @@ import type { InferTools, ToolBuilder, ToolShed } from "./utils/types";
  * ```
  */
 export declare abstract class Twist<TSelf> {
-    protected id: string;
+    protected id: Uuid;
     private toolShed;
-    constructor(id: string, toolShed: ToolShed);
+    constructor(id: Uuid, toolShed: ToolShed);
     /**
      * Gets the initialized tools for this twist.
      * @throws Error if called before initialization is complete
@@ -59,7 +60,7 @@ export declare abstract class Twist<TSelf> {
     /**
      * Creates a persistent callback to a method on this twist.
      *
-     * ExtraArgs are strongly typed to match the method's signature after the first argument.
+     * ExtraArgs are strongly typed to match the method's signature. They must be serializable.
      *
      * @param fn - The method to callback
      * @param extraArgs - Additional arguments to pass (type-checked, must be serializable)
@@ -70,7 +71,25 @@ export declare abstract class Twist<TSelf> {
      * const callback = await this.callback(this.onWebhook, "calendar", 123);
      * ```
      */
-    protected callback(fn: Function, ...extraArgs: any[]): Promise<Callback>;
+    protected callback<TArgs extends Serializable[], Fn extends (...args: TArgs) => any>(fn: Fn, ...extraArgs: TArgs): Promise<Callback>;
+    /**
+     * Like callback(), but for an ActivityLink, which receives the link as the first argument.
+     *
+     * @param fn - The method to callback
+     * @param extraArgs - Additional arguments to pass after the link
+     * @returns Promise resolving to a persistent callback token
+     *
+     * @example
+     * ```typescript
+     * const callback = await this.linkCallback(this.doSomething, 123);
+     * const link: ActivityLink = {
+     *    type: ActivityLinkType.Callback,
+     *    title: "Do Something",
+     *    callback,
+     * };
+     * ```
+     */
+    protected linkCallback<TArgs extends Serializable[], Fn extends (link: ActivityLink, ...extraArgs: TArgs) => any>(fn: Fn, ...extraArgs: TArgs): Promise<Callback>;
     /**
      * Deletes a specific callback by its token.
      *
@@ -95,21 +114,35 @@ export declare abstract class Twist<TSelf> {
     /**
      * Retrieves a value from persistent storage by key.
      *
-     * @template T - The expected type of the stored value
+     * Values are automatically deserialized using SuperJSON, which
+     * properly restores Date objects, Maps, Sets, and other complex types.
+     *
+     * @template T - The expected type of the stored value (must be Serializable)
      * @param key - The storage key to retrieve
      * @returns Promise resolving to the stored value or null
      */
-    protected get<T>(key: string): Promise<T | null>;
+    protected get<T extends import("./index").Serializable>(key: string): Promise<T | null>;
     /**
      * Stores a value in persistent storage.
      *
-     * **Important**: Values must be JSON-serializable. Functions, Symbols, and undefined values
-     * cannot be stored directly.
+     * The value will be serialized using SuperJSON and stored persistently.
+     * SuperJSON automatically handles Date objects, Maps, Sets, undefined values,
+     * and other complex types that standard JSON doesn't support.
      *
+     * **Important**: Functions and Symbols cannot be stored.
      * **For function references**: Use callbacks instead of storing functions directly.
      *
      * @example
      * ```typescript
+     * // ✅ Date objects are preserved
+     * await this.set("sync_state", {
+     *   lastSync: new Date(),
+     *   minDate: new Date(2024, 0, 1)
+     * });
+     *
+     * // ✅ undefined is now supported
+     * await this.set("data", { name: "test", optional: undefined });
+     *
      * // ❌ WRONG: Cannot store functions directly
      * await this.set("handler", this.myHandler);
      *
@@ -122,12 +155,12 @@ export declare abstract class Twist<TSelf> {
      * await this.run(token, args);
      * ```
      *
-     * @template T - The type of value being stored
+     * @template T - The type of value being stored (must be Serializable)
      * @param key - The storage key to use
-     * @param value - The value to store (must be JSON-serializable)
+     * @param value - The value to store (must be SuperJSON-serializable)
      * @returns Promise that resolves when the value is stored
      */
-    protected set<T>(key: string, value: T): Promise<void>;
+    protected set<T extends import("./index").Serializable>(key: string, value: T): Promise<void>;
     /**
      * Removes a specific key from persistent storage.
      *

package/dist/twist.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"twist.d.ts","sourceRoot":"","sources":["../src/twist.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,QAAQ,EAAE,MAAM,QAAQ,CAAC;AACvC,OAAO,EAAE,KAAK,KAAK,EAAE,MAAM,QAAQ,CAAC;AACpC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEvE;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,8BAAsB,KAAK,CAAC,KAAK;IACnB,SAAS,CAAC,EAAE,EAAE,MAAM;IAAE,OAAO,CAAC,QAAQ;gBAA5B,EAAE,EAAE,MAAM,EAAU,QAAQ,EAAE,QAAQ;IAE5D;;;OAGG;IACH,SAAS,KAAK,KAAK,IAAI,UAAU,CAAC,KAAK,CAAC,CAEvC;IAED;;;;;;;;;;;;;;;;OAgBG;IACH,QAAQ,CAAC,KAAK,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;IAElE;;;;;;;;;;;;;OAaG;cACa,QAAQ,CACtB,EAAE,EAAE,QAAQ,EACZ,GAAG,SAAS,EAAE,GAAG,EAAE,GAClB,OAAO,CAAC,QAAQ,CAAC;IAIpB;;;;;OAKG;cACa,cAAc,CAAC,KAAK,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAI9D;;;;OAIG;cACa,kBAAkB,IAAI,OAAO,CAAC,IAAI,CAAC;IAInD;;;;;;OAMG;cACa,GAAG,CAAC,KAAK,EAAE,QAAQ,EAAE,GAAG,IAAI,EAAE,EAAE,GAAG,OAAO,CAAC,GAAG,CAAC;IAI/D;;;;;;OAMG;cACa,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IAItD;;;;;;;;;;;;;;;;;;;;;;;;;;OA0BG;cACa,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAI5D;;;;;OAKG;cACa,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIjD;;;;OAIG;cACa,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAIzC;;;;;;;OAOG;cACa,OAAO,CACrB,QAAQ,EAAE,QAAQ,EAClB,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,IAAI,CAAA;KAAE,GACzB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAIzB;;;;;OAKG;cACa,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIxD;;;;OAIG;cACa,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC;IAI/C;;;;;;;;OAQG;IAEH,QAAQ,CAAC,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAIvD;;;;;;;;OAQG;IACH,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAIxB;;;;;;;OAOG;IACH,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAI3B;;;;OAIG;IACG,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;CAGpC"}
+{"version":3,"file":"twist.d.ts","sourceRoot":"","sources":["../src/twist.ts"],"names":[],"mappings":"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"}

package/dist/twist.js

@@ -42,7 +42,7 @@ export class Twist {
     /**
      * Creates a persistent callback to a method on this twist.
      *
-     * ExtraArgs are strongly typed to match the method's signature after the first argument.
+     * ExtraArgs are strongly typed to match the method's signature. They must be serializable.
      *
      * @param fn - The method to callback
      * @param extraArgs - Additional arguments to pass (type-checked, must be serializable)
@@ -56,6 +56,26 @@ export class Twist {
     async callback(fn, ...extraArgs) {
         return this.tools.callbacks.create(fn, ...extraArgs);
     }
+    /**
+     * Like callback(), but for an ActivityLink, which receives the link as the first argument.
+     *
+     * @param fn - The method to callback
+     * @param extraArgs - Additional arguments to pass after the link
+     * @returns Promise resolving to a persistent callback token
+     *
+     * @example
+     * ```typescript
+     * const callback = await this.linkCallback(this.doSomething, 123);
+     * const link: ActivityLink = {
+     *    type: ActivityLinkType.Callback,
+     *    title: "Do Something",
+     *    callback,
+     * };
+     * ```
+     */
+    async linkCallback(fn, ...extraArgs) {
+        return this.tools.callbacks.create(fn, ...extraArgs);
+    }
     /**
      * Deletes a specific callback by its token.
      *
@@ -86,7 +106,10 @@ export class Twist {
     /**
      * Retrieves a value from persistent storage by key.
      *
-     * @template T - The expected type of the stored value
+     * Values are automatically deserialized using SuperJSON, which
+     * properly restores Date objects, Maps, Sets, and other complex types.
+     *
+     * @template T - The expected type of the stored value (must be Serializable)
      * @param key - The storage key to retrieve
      * @returns Promise resolving to the stored value or null
      */
@@ -96,13 +119,24 @@ export class Twist {
     /**
      * Stores a value in persistent storage.
      *
-     * **Important**: Values must be JSON-serializable. Functions, Symbols, and undefined values
-     * cannot be stored directly.
+     * The value will be serialized using SuperJSON and stored persistently.
+     * SuperJSON automatically handles Date objects, Maps, Sets, undefined values,
+     * and other complex types that standard JSON doesn't support.
      *
+     * **Important**: Functions and Symbols cannot be stored.
      * **For function references**: Use callbacks instead of storing functions directly.
      *
      * @example
      * ```typescript
+     * // ✅ Date objects are preserved
+     * await this.set("sync_state", {
+     *   lastSync: new Date(),
+     *   minDate: new Date(2024, 0, 1)
+     * });
+     *
+     * // ✅ undefined is now supported
+     * await this.set("data", { name: "test", optional: undefined });
+     *
      * // ❌ WRONG: Cannot store functions directly
      * await this.set("handler", this.myHandler);
      *
@@ -115,9 +149,9 @@ export class Twist {
      * await this.run(token, args);
      * ```
      *
-     * @template T - The type of value being stored
+     * @template T - The type of value being stored (must be Serializable)
      * @param key - The storage key to use
-     * @param value - The value to store (must be JSON-serializable)
+     * @param value - The value to store (must be SuperJSON-serializable)
      * @returns Promise that resolves when the value is stored
      */
     async set(key, value) {