@plotday/twister 0.20.0

package/dist/tools/network.d.ts

@@ -0,0 +1,188 @@
+import { ITool } from "..";
+import { type AuthProvider, type Authorization } from "./integrations";
+/**
+ * Represents an incoming webhook request.
+ *
+ * This object is passed to webhook callback functions and contains all
+ * the information about the HTTP request that triggered the webhook.
+ *
+ * @example
+ * ```typescript
+ * async onWebhookReceived(request: WebhookRequest, context: any) {
+ *   console.log(`${request.method} request received`);
+ *   console.log("Headers:", request.headers);
+ *   console.log("Query params:", request.params);
+ *   console.log("Body:", request.body);
+ *   console.log("Context:", context);
+ * }
+ * ```
+ */
+export type WebhookRequest = {
+    /** HTTP method of the request (GET, POST, etc.) */
+    method: string;
+    /** HTTP headers from the request */
+    headers: Record<string, string>;
+    /** Query string parameters from the request URL */
+    params: Record<string, string>;
+    /** Request body (parsed as JSON if applicable) */
+    body: any;
+};
+/**
+ * Built-in tool for requesting HTTP access permissions and managing webhooks.
+ *
+ * The Network tool serves two purposes:
+ * 1. Declares which URLs a twist or tool is allowed to access via HTTP/HTTPS
+ * 2. Provides webhook creation and management for receiving HTTP callbacks
+ *
+ * **IMPORTANT**: Must be requested in the Twist or Tool Init method to declare
+ * HTTP access permissions. Without requesting this tool with the appropriate URLs,
+ * all outbound HTTP requests (fetch, etc.) will be blocked.
+ *
+ * **Permission Patterns:**
+ * - `*` - Allow access to all URLs
+ * - `https://*.example.com` - Allow access to all subdomains
+ * - `https://api.example.com/*` - Allow access to all paths on the domain
+ * - `https://api.example.com/v1/*` - Allow access to specific path prefix
+ *
+ * **Webhook Characteristics:**
+ * - Persistent across worker restarts
+ * - Automatic callback routing to parent tool/twist
+ * - Support for all HTTP methods
+ * - Context preservation for callback execution
+ *
+ * @example
+ * ```typescript
+ * class MyTwist extends Twist<MyTwist> {
+ *   build(build: ToolBuilder) {
+ *     return {
+ *       // Request HTTP access to specific APIs
+ *       network: build(Network, {
+ *         urls: [
+ *           'https://api.github.com/*',
+ *           'https://api.openai.com/*'
+ *         ]
+ *       })
+ *     };
+ *   }
+ * }
+ * ```
+ *
+ * @example
+ * ```typescript
+ * class CalendarTool extends Tool<CalendarTool> {
+ *   build(build: ToolBuilder) {
+ *     return {
+ *       network: build(Network, {
+ *         urls: ['https://www.googleapis.com/calendar/*']
+ *       })
+ *     };
+ *   }
+ *
+ *   async setupCalendarWebhook(calendarId: string) {
+ *     // Create webhook URL that will call onCalendarEvent
+ *     const webhookUrl = await this.tools.network.createWebhook({
+ *       callback: this.onCalendarEvent,
+ *       extraArgs: [calendarId, "google"]
+ *     });
+ *
+ *     // Register webhook with Google Calendar API
+ *     await this.registerWithGoogleCalendar(calendarId, webhookUrl);
+ *
+ *     return webhookUrl;
+ *   }
+ *
+ *   async onCalendarEvent(request: WebhookRequest, calendarId: string, provider: string) {
+ *     console.log("Calendar event received:", {
+ *       method: request.method,
+ *       calendarId,
+ *       provider,
+ *       body: request.body
+ *     });
+ *
+ *     // Process the calendar event change
+ *     await this.processCalendarChange(request.body);
+ *   }
+ *
+ *   async cleanup(webhookUrl: string) {
+ *     await this.tools.network.deleteWebhook(webhookUrl);
+ *   }
+ * }
+ * ```
+ */
+export declare abstract class Network extends ITool {
+    static readonly Options: {
+        /**
+         * All network access is blocked except the specified URLs.
+         * Wildcards (*) are supported for domains and paths.
+         */
+        urls: string[];
+    };
+    /**
+     * Creates a new webhook endpoint.
+     *
+     * Generates a unique HTTP endpoint that will invoke the callback function
+     * when requests are received. The callback receives the WebhookRequest plus any extraArgs.
+     *
+     * **Provider-Specific Behavior:**
+     * - **Slack**: Uses provider-specific routing via team_id. Requires `authorization` parameter.
+     * - **Gmail** (Google with Gmail scopes): Returns a Google Pub/Sub topic name instead of a webhook URL.
+     *   The topic name (e.g., "projects/plot-prod/topics/gmail-webhook-abc123") should be passed
+     *   to the Gmail API's `users.watch` endpoint. Requires `authorization` parameter with Gmail scopes.
+     * - **Default**: Returns a standard webhook URL for all other cases.
+     *
+     * @param options - Webhook creation options
+     * @param options.callback - Function receiving (request, ...extraArgs)
+     * @param options.extraArgs - Additional arguments to pass to the callback (type-checked)
+     * @param options.provider - Optional provider for provider-specific webhook routing
+     * @param options.authorization - Optional authorization for provider-specific webhooks (required for Slack and Gmail)
+     * @returns Promise resolving to the webhook URL, or for Gmail, a Pub/Sub topic name
+     *
+     * @example
+     * ```typescript
+     * // Gmail webhook - returns Pub/Sub topic name
+     * const topicName = await this.tools.network.createWebhook({
+     *   callback: this.onGmailNotification,
+     *   provider: AuthProvider.Google,
+     *   authorization: gmailAuth,
+     *   extraArgs: ["inbox"]
+     * });
+     * // topicName: "projects/plot-prod/topics/gmail-webhook-abc123"
+     *
+     * // Pass topic name to Gmail API
+     * await gmailApi.users.watch({
+     *   userId: 'me',
+     *   requestBody: {
+     *     topicName: topicName,  // Use the returned topic name
+     *     labelIds: ['INBOX']
+     *   }
+     * });
+     * ```
+     */
+    abstract createWebhook<TCallback extends (request: WebhookRequest, ...args: any[]) => any>(options: {
+        callback: TCallback;
+        extraArgs?: TCallback extends (req: any, ...rest: infer R) => any ? R : [];
+        provider?: AuthProvider;
+        authorization?: Authorization;
+    }): Promise<string>;
+    /**
+     * Deletes an existing webhook endpoint.
+     *
+     * Removes the webhook endpoint and stops processing requests.
+     * Works with all webhook types (standard, Slack, and Gmail).
+     *
+     * **For Gmail webhooks:** Also deletes the associated Google Pub/Sub topic and subscription.
+     *
+     * **For Slack webhooks:** Removes the callback registration for the specific team.
+     *
+     * **For standard webhooks:** Removes the webhook endpoint. Any subsequent requests
+     * to the deleted webhook will return 404.
+     *
+     * @param url - The webhook identifier returned from `createWebhook()`.
+     *              This can be a URL (standard webhooks), a Pub/Sub topic name (Gmail),
+     *              or an opaque identifier (Slack). Always pass the exact value returned
+     *              from `createWebhook()`.
+     * @returns Promise that resolves when the webhook is deleted
+     */
+    abstract deleteWebhook(url: string): Promise<void>;
+}
+//# sourceMappingURL=network.d.ts.map

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

@@ -0,0 +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;CACX,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"}

package/dist/tools/network.js

@@ -0,0 +1,87 @@
+import { ITool } from "..";
+/**
+ * Built-in tool for requesting HTTP access permissions and managing webhooks.
+ *
+ * The Network tool serves two purposes:
+ * 1. Declares which URLs a twist or tool is allowed to access via HTTP/HTTPS
+ * 2. Provides webhook creation and management for receiving HTTP callbacks
+ *
+ * **IMPORTANT**: Must be requested in the Twist or Tool Init method to declare
+ * HTTP access permissions. Without requesting this tool with the appropriate URLs,
+ * all outbound HTTP requests (fetch, etc.) will be blocked.
+ *
+ * **Permission Patterns:**
+ * - `*` - Allow access to all URLs
+ * - `https://*.example.com` - Allow access to all subdomains
+ * - `https://api.example.com/*` - Allow access to all paths on the domain
+ * - `https://api.example.com/v1/*` - Allow access to specific path prefix
+ *
+ * **Webhook Characteristics:**
+ * - Persistent across worker restarts
+ * - Automatic callback routing to parent tool/twist
+ * - Support for all HTTP methods
+ * - Context preservation for callback execution
+ *
+ * @example
+ * ```typescript
+ * class MyTwist extends Twist<MyTwist> {
+ *   build(build: ToolBuilder) {
+ *     return {
+ *       // Request HTTP access to specific APIs
+ *       network: build(Network, {
+ *         urls: [
+ *           'https://api.github.com/*',
+ *           'https://api.openai.com/*'
+ *         ]
+ *       })
+ *     };
+ *   }
+ * }
+ * ```
+ *
+ * @example
+ * ```typescript
+ * class CalendarTool extends Tool<CalendarTool> {
+ *   build(build: ToolBuilder) {
+ *     return {
+ *       network: build(Network, {
+ *         urls: ['https://www.googleapis.com/calendar/*']
+ *       })
+ *     };
+ *   }
+ *
+ *   async setupCalendarWebhook(calendarId: string) {
+ *     // Create webhook URL that will call onCalendarEvent
+ *     const webhookUrl = await this.tools.network.createWebhook({
+ *       callback: this.onCalendarEvent,
+ *       extraArgs: [calendarId, "google"]
+ *     });
+ *
+ *     // Register webhook with Google Calendar API
+ *     await this.registerWithGoogleCalendar(calendarId, webhookUrl);
+ *
+ *     return webhookUrl;
+ *   }
+ *
+ *   async onCalendarEvent(request: WebhookRequest, calendarId: string, provider: string) {
+ *     console.log("Calendar event received:", {
+ *       method: request.method,
+ *       calendarId,
+ *       provider,
+ *       body: request.body
+ *     });
+ *
+ *     // Process the calendar event change
+ *     await this.processCalendarChange(request.body);
+ *   }
+ *
+ *   async cleanup(webhookUrl: string) {
+ *     await this.tools.network.deleteWebhook(webhookUrl);
+ *   }
+ * }
+ * ```
+ */
+export class Network extends ITool {
+    static Options;
+}
+//# sourceMappingURL=network.js.map

package/dist/tools/network.js.map

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

package/dist/tools/plot.d.ts

@@ -0,0 +1,252 @@
+import { type Activity, type ActivityMeta, type ActivityUpdate, type Actor, type ActorId, ITool, type NewActivity, type NewContact, type NewPriority, type Priority, type Tag } from "..";
+export declare enum ActivityAccess {
+    /**
+     * Create new Activity on a thread where the twist was mentioned.
+     * Add/remove tags on Activity where the twist was mentioned.
+     */
+    Respond = 0,
+    /**
+     * Create new, top-level Activity.
+     * Create new Activity in a thread the twist created.
+     * All Respond permissions.
+     */
+    Create = 1
+}
+export declare enum PriorityAccess {
+    /**
+     * Create a new Priority within the twist's Priority.
+     * Update Priority created by the twist.
+     */
+    Create = 0,
+    /**
+     * Read all Priority within the twist's Priority.
+     * Create a new Priority within the twist's Priority.
+     * Update and archive any Priority within the twist's Priority.
+     */
+    Full = 1
+}
+export declare enum ContactAccess {
+    /** Read existing contacts. */
+    Read = 0,
+    /** Create and update contacts. */
+    Write = 1
+}
+/**
+ * Intent handler for activity mentions.
+ * Defines how the twist should respond when mentioned in an activity.
+ */
+export type ActivityIntentHandler = {
+    /** Human-readable description of what this intent handles */
+    description: string;
+    /** Example phrases or activity content that would match this intent */
+    examples: string[];
+    /** The function to call when this intent is matched */
+    handler: (activity: Activity) => Promise<void>;
+};
+/**
+ * Built-in tool for interacting with the core Plot data layer.
+ *
+ * The Plot tool provides twists with the ability to create and manage activities,
+ * priorities, and contacts within the Plot system. This is the primary interface
+ * for twists to persist data and interact with the Plot database.
+ *
+ * @example
+ * ```typescript
+ * class MyTwist extends Twist {
+ *   private plot: Plot;
+ *
+ *   constructor(id: string, tools: ToolBuilder) {
+ *     super();
+ *     this.plot = tools.get(Plot);
+ *   }
+ *
+ *   async activate(priority) {
+ *     // Create a welcome activity
+ *     await this.plot.createActivity({
+ *       type: ActivityType.Note,
+ *       title: "Welcome to Plot!",
+ *       links: [{
+ *         title: "Get Started",
+ *         type: ActivityLinkType.external,
+ *         url: "https://plot.day/docs"
+ *       }]
+ *     });
+ *   }
+ * }
+ * ```
+ */
+export declare abstract class Plot extends ITool {
+    static readonly Options: {
+        /**
+         * Activity event callbacks.
+         */
+        activity?: {
+            access?: ActivityAccess;
+            /**
+             * Called when an activity is updated.
+             *
+             * @param activity - The updated activity
+             * @param changes - Optional changes object containing the previous version and tag modifications
+             */
+            updated?: (activity: Activity, changes?: {
+                previous: Activity;
+                tagsAdded: Record<Tag, ActorId[]>;
+                tagsRemoved: Record<Tag, ActorId[]>;
+            }) => Promise<void>;
+            /**
+             * Intent handlers for activity mentions.
+             * When an activity mentions this twist, the system will match the activity
+             * content against these intent descriptions and call the matching handler.
+             *
+             * @example
+             * ```typescript
+             * intents: [{
+             *   description: "Schedule or reschedule calendar events",
+             *   examples: ["Schedule a meeting tomorrow at 2pm", "Move my 3pm meeting to 4pm"],
+             *   handler: this.onSchedulingRequest
+             * }, {
+             *   description: "Find available meeting times",
+             *   examples: ["When am I free this week?", "Find time for a 1 hour meeting"],
+             *   handler: this.onAvailabilityRequest
+             * }]
+             * ```
+             */
+            intents?: ActivityIntentHandler[];
+        };
+        priority?: {
+            access?: PriorityAccess;
+        };
+        contact?: {
+            access?: ContactAccess;
+        };
+    };
+    /**
+     * Creates a new activity 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.
+     *
+     * @param activity - The activity data to create
+     * @returns Promise resolving to the complete created activity
+     */
+    abstract createActivity(activity: NewActivity): Promise<Activity>;
+    /**
+     * Creates multiple activities 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.
+     *
+     * @param activities - Array of activity data to create
+     * @returns Promise resolving to array of created activities
+     */
+    abstract createActivities(activities: NewActivity[]): Promise<Activity[]>;
+    /**
+     * Updates an existing activity in the Plot system.
+     *
+     * 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.
+     *
+     * 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
+     * maintain the correct hierarchical structure.
+     *
+     * When updating scheduling fields (start, end, recurrence*), the database will
+     * automatically recalculate duration and range values to maintain consistency.
+     *
+     * @param activity - The activity update containing the ID and fields to change
+     * @returns Promise that resolves when the update is complete
+     *
+     * @example
+     * ```typescript
+     * // Mark a task as complete
+     * await this.plot.updateActivity({
+     *   id: "task-123",
+     *   doneAt: 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",
+     *   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>;
+    /**
+     * Retrieves all activities in the same thread as the specified activity.
+     *
+     * A thread consists of related activities linked through parent-child
+     * relationships or other associative connections. This is useful for
+     * finding conversation histories or related task sequences.
+     *
+     * @param activity - The activity whose thread to retrieve
+     * @returns Promise resolving to array of activities in the thread
+     */
+    abstract getThread(activity: Activity): Promise<Activity[]>;
+    /**
+     * Finds an activity by its metadata.
+     *
+     * This method enables lookup of activities that were created from external
+     * systems, using the metadata to locate the corresponding Plot activity.
+     * Useful for preventing duplicate imports and maintaining sync state.
+     *
+     * @param meta - The activity metadata to search for
+     * @returns Promise resolving to the matching activity or null if not found
+     */
+    abstract getActivityByMeta(meta: ActivityMeta): Promise<Activity | null>;
+    /**
+     * Creates a new priority in the Plot system.
+     *
+     * Priorities serve as organizational containers for activities and twists.
+     * The created priority will be automatically assigned a unique ID.
+     *
+     * @param priority - The priority data to create
+     * @returns Promise resolving to the complete created priority
+     */
+    abstract createPriority(priority: NewPriority): Promise<Priority>;
+    /**
+     * Adds contacts to the Plot system.
+     *
+     * Contacts are used for associating people with activities, such as
+     * event attendees or task assignees. Duplicate contacts (by email)
+     * will be merged or updated as appropriate.
+     * This method requires ContactAccess.Write permission.
+     *
+     * @param contacts - Array of contact information to add
+     * @returns Promise resolving to array of created/updated actors
+     */
+    abstract addContacts(contacts: Array<NewContact>): Promise<Actor[]>;
+    /**
+     * Retrieves actors by their IDs.
+     *
+     * Actors represent users, contacts, or twists in the Plot system.
+     * This method requires ContactAccess.Read permission.
+     *
+     * @param ids - Array of actor IDs to retrieve
+     * @returns Promise resolving to array of actors
+     */
+    abstract getActors(ids: ActorId[]): Promise<Actor[]>;
+}
+//# sourceMappingURL=plot.d.ts.map

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

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

package/dist/tools/plot.js

@@ -0,0 +1,72 @@
+import { ITool, } from "..";
+export var ActivityAccess;
+(function (ActivityAccess) {
+    /**
+     * Create new Activity on a thread where the twist was mentioned.
+     * Add/remove tags on Activity where the twist was mentioned.
+     */
+    ActivityAccess[ActivityAccess["Respond"] = 0] = "Respond";
+    /**
+     * Create new, top-level Activity.
+     * Create new Activity in a thread the twist created.
+     * All Respond permissions.
+     */
+    ActivityAccess[ActivityAccess["Create"] = 1] = "Create";
+})(ActivityAccess || (ActivityAccess = {}));
+export var PriorityAccess;
+(function (PriorityAccess) {
+    /**
+     * Create a new Priority within the twist's Priority.
+     * Update Priority created by the twist.
+     */
+    PriorityAccess[PriorityAccess["Create"] = 0] = "Create";
+    /**
+     * Read all Priority within the twist's Priority.
+     * Create a new Priority within the twist's Priority.
+     * Update and archive any Priority within the twist's Priority.
+     */
+    PriorityAccess[PriorityAccess["Full"] = 1] = "Full";
+})(PriorityAccess || (PriorityAccess = {}));
+export var ContactAccess;
+(function (ContactAccess) {
+    /** Read existing contacts. */
+    ContactAccess[ContactAccess["Read"] = 0] = "Read";
+    /** Create and update contacts. */
+    ContactAccess[ContactAccess["Write"] = 1] = "Write";
+})(ContactAccess || (ContactAccess = {}));
+/**
+ * Built-in tool for interacting with the core Plot data layer.
+ *
+ * The Plot tool provides twists with the ability to create and manage activities,
+ * priorities, and contacts within the Plot system. This is the primary interface
+ * for twists to persist data and interact with the Plot database.
+ *
+ * @example
+ * ```typescript
+ * class MyTwist extends Twist {
+ *   private plot: Plot;
+ *
+ *   constructor(id: string, tools: ToolBuilder) {
+ *     super();
+ *     this.plot = tools.get(Plot);
+ *   }
+ *
+ *   async activate(priority) {
+ *     // Create a welcome activity
+ *     await this.plot.createActivity({
+ *       type: ActivityType.Note,
+ *       title: "Welcome to Plot!",
+ *       links: [{
+ *         title: "Get Started",
+ *         type: ActivityLinkType.external,
+ *         url: "https://plot.day/docs"
+ *       }]
+ *     });
+ *   }
+ * }
+ * ```
+ */
+export class Plot extends ITool {
+    static Options;
+}
+//# sourceMappingURL=plot.js.map

package/dist/tools/plot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plot.js","sourceRoot":"","sources":["../../src/tools/plot.ts"],"names":[],"mappings":"AAAA,OAAO,EAML,KAAK,GAMN,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,8BAA8B;IAC9B,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,CAgDrB;CAiJH"}