@plotday/twister 0.57.0 → 0.59.0

package/dist/docs/media/AGENTS.md

@@ -22,8 +22,12 @@ connectors/<name>/
 {
   "name": "@plotday/connector-<name>",
   "private": true,
+  "plotTwistId": "<uuid>",
   "displayName": "Human Name",
   "description": "One-line purpose statement",
+  "logoUrl": "https://api.iconify.design/logos/<name>-icon.svg",
+  "publisher": "Plot",
+  "publisherUrl": "https://plot.day",
   "author": "Plot <team@plot.day> (https://plot.day)",
   "license": "MIT",
   "version": "0.1.0",
@@ -37,8 +41,7 @@ connectors/<name>/
       "default": "./dist/index.js"
     }
   },
-  "files": ["dist", "README.md", "LICENSE"],
-  "scripts": { "build": "tsc", "clean": "rm -rf dist" },
+  "scripts": { "build": "tsc", "clean": "rm -rf dist", "lint": "plot lint", "deploy": "plot deploy" },
   "dependencies": { "@plotday/twister": "workspace:^" },
   "devDependencies": { "typescript": "^5.9.3" },
   "repository": { "type": "git", "url": "https://github.com/plotday/plot.git", "directory": "connectors/<name>" },
@@ -48,6 +51,7 @@ connectors/<name>/
 ```
 
 - `"@plotday/connector"` export condition resolves to TS source during workspace dev.
+- `plotTwistId` is the connector's stable twist UUID — `plot create --connector` generates one; `plot deploy` reads it along with `displayName`, `description`, `logoUrl`/`logoUrlDark`, and `publisher`.
 - Add third-party SDKs to `dependencies` (e.g. `"@linear/sdk": "^72.0.0"`).
 - Add `@plotday/connector-google-contacts` as `"workspace:^"` if you sync contacts (Google connectors only).
 
@@ -68,47 +72,47 @@ Use `connectors/linear/` as the canonical reference. Minimum shape:
 
 ```typescript
 import {
-  ActivityType, LinkType, Connector,
-  type NewActivityWithNotes, type SyncToolOptions, type ConnectorBuilder,
+  Connector,
+  type NewLinkWithNotes, type ToolBuilder,
 } from "@plotday/twister";
-import { type Callback, Callbacks } from "@plotday/twister/tools/callbacks";
 import {
   AuthProvider, Integrations,
   type AuthToken, type Authorization, type Channel,
+  type StatusIcon, type SyncContext,
 } from "@plotday/twister/tools/integrations";
 import { Network, type WebhookRequest } from "@plotday/twister/tools/network";
-import { Tasks } from "@plotday/twister/tools/tasks";
 
 export class MyConnector extends Connector<MyConnector> {
-  static readonly PROVIDER = AuthProvider.Linear;
-  static readonly SCOPES = ["read", "write"];
-  static readonly Options: SyncToolOptions;
   static readonly handleReplies = true; // only for bidirectional connectors
-  declare readonly Options: SyncToolOptions;
 
-  build(build: ConnectorBuilder) {
+  readonly provider = AuthProvider.Linear;
+  readonly scopes = ["read", "write"]; // or a ScopeConfig: { required, optional }
+  readonly linkTypes = [{
+    type: "issue",
+    label: "Issue",
+    statuses: [
+      { status: "unstarted", label: "To Do", icon: "todo" as StatusIcon },
+      { status: "completed", label: "Done", done: true, icon: "done" as StatusIcon },
+    ],
+  }];
+
+  build(build: ToolBuilder) {
     return {
-      integrations: build(Integrations, {
-        providers: [{
-          provider: MyConnector.PROVIDER,
-          scopes: MyConnector.SCOPES,
-          getChannels: this.getChannels,
-          onChannelEnabled: this.onChannelEnabled,
-          onChannelDisabled: this.onChannelDisabled,
-        }],
-      }),
+      integrations: build(Integrations),
       network: build(Network, { urls: ["https://api.example.com/*"] }),
-      callbacks: build(Callbacks),
-      tasks: build(Tasks),
     };
   }
 
-  async getChannels(_auth: Authorization, token: AuthToken): Promise<Channel[]> { /* list resources */ }
+  async getChannels(_auth: Authorization | null, token: AuthToken | null): Promise<Channel[]> { /* list resources */ }
 
-  async onChannelEnabled(channel: Channel): Promise<void> {
-    // 1. Store parent callback tokens via tools.callbacks.createFromParent(this.options.onItem)
-    // 2. Queue webhook + initial sync as SEPARATE tasks via runTask() — never inline;
-    //    onChannelEnabled blocks the HTTP response until it returns.
+  async onChannelEnabled(channel: Channel, context?: SyncContext): Promise<void> {
+    // Runs inline in the HTTP request handler — only this.set()/this.get()/
+    // this.callback()/this.runTask() belong here. Queue webhook setup +
+    // initial sync as SEPARATE tasks via this.runTask(), never inline.
+    // Can be re-dispatched (auto-enable, recovery: context.recovering) —
+    // overwrite stored state unconditionally, don't skip-if-present.
+    // Call integrations.channelSyncCompleted(channel.id) once the initial
+    // backfill finishes (from the last syncBatch, not from here).
   }
 
   async onChannelDisabled(channel: Channel): Promise<void> {
@@ -119,18 +123,22 @@ export class MyConnector extends Connector<MyConnector> {
 export default MyConnector;
 ```
 
+The runtime reads `provider`, `scopes`, and `linkTypes` from the class and drives OAuth and channel management automatically. The built-in `callbacks`, `store`, and `tasks` tools are always available (`this.callback()`, `this.set()`/`this.get()`/`this.clear()`, `this.runTask()`) and need no `build()` entry.
+
 Required private helpers: `getClient(channelId)`, `setupWebhook(id)`, `startBatchSync(id)`, `syncBatch(id)`, `transformItem(item, id, initialSync)`, `onWebhook(req, id)`. See `linear/` for the full pattern.
 
 ## Integrations (auth + channels)
 
-Auth is handled in the Flutter edit modal — you declare providers in `build()`, the runtime drives OAuth.
+Auth is handled in the Flutter edit modal — you declare `provider` and `scopes` as class properties, the runtime drives OAuth.
 
 1. User clicks "Connect" → OAuth runs automatically.
 2. Runtime calls your `getChannels()` to list resources.
 3. User enables → `onChannelEnabled()`. User disables → `onChannelDisabled()`.
-4. Read tokens via `this.tools.integrations.get(PROVIDER, channelId)`.
+4. Read tokens via `this.tools.integrations.get(channelId)`.
+
+`AuthProvider` values: `Google`, `Microsoft`, `Notion`, `Slack`, `Atlassian`, `Linear`, `Monday`, `GitHub`, `Asana`, `HubSpot`, `Todoist`, `Airtable`.
 
-`AuthProvider` values: `Google`, `Microsoft`, `Notion`, `Slack`, `Atlassian`, `Linear`, `Monday`, `GitHub`, `Asana`, `HubSpot`.
+`scopes` may be a flat array (all required) or a `ScopeConfig` (`{ required, optional }`) whose optional scope groups render as connect-time toggles; detect declined groups via the granted `token.scopes` and degrade gracefully (see `slack/` and `google-calendar/`). Connectors without OAuth (API keys, CalDAV credentials) omit `provider` and collect credentials via the `Options` tool with `secure: true` fields (see `attio/`, `fellow/`, `apple-calendar/`).
 
 ### Per-user auth for write-backs
 
@@ -145,7 +153,7 @@ Plot but is not dispatched — there is no instance to deliver to.
 
 ### Cross-connector auth sharing (Google)
 
-Merge scopes with `Integrations.MergeScopes(MyGoogleConnector.SCOPES, GoogleContacts.SCOPES)` and add `googleContacts: build(GoogleContacts)` to your `build()` return.
+Set `readonly scopes = Integrations.MergeScopes(MyGoogleConnector.SCOPES, GoogleContacts.SCOPES)` and add `googleContacts: build(GoogleContacts)` to your `build()` return (see `gmail/`, `google-drive/`). Alternatively declare the contacts scopes as an optional `ScopeConfig` group so the user can decline them (see `google-calendar/`).
 
 ## Architecture
 
@@ -156,25 +164,32 @@ Connectors persist data directly via `integrations.saveLink()` (building `NewLin
 Functions are not serializable across worker boundaries. Convert to tokens, store primitives.
 
 ```typescript
+import { type Callback } from "@plotday/twister/tools/callbacks";
+
 // ❌ WRONG — passing a function as a callback arg
-await this.callback(this.syncBatch, callback, ...extraArgs);
-// Error: Cannot create callback args: Found function at path "value[0]"
-
-// ✅ CORRECT
-const token = await this.tools.callbacks.createFromParent(callback, ...extraArgs);
-await this.set(`callback_${resourceId}`, token);
-const batch = await this.callback(this.syncBatch, resourceId); // primitives only
-await this.tools.tasks.runTask(batch);
-
-// In syncBatch:
-const token = await this.get<Callback>(`callback_${resourceId}`);
-if (!token) throw new Error(`Callback not found for ${resourceId}`);
-await this.tools.callbacks.run(token, item);
+await this.callback(this.syncBatch, this.onItem);
+// Error: Found function at path "value[0]"
+
+// ✅ CORRECT — callback args are serializable primitives only
+const batch = await this.callback(this.syncBatch, resourceId);
+await this.runTask(batch);
+
+// To invoke something later (scheduled renewals, stored continuations),
+// persist the token, not the function:
+const token = await this.callback(this.renewWatch, resourceId);
+await this.set(`renewal_${resourceId}`, token);
+
+// Later:
+const stored = await this.get<Callback>(`renewal_${resourceId}`);
+if (!stored) throw new Error(`Callback not found for ${resourceId}`);
+await this.run(stored);
 ```
 
 Serializable: strings, numbers, booleans, `null`, plain objects, arrays, Dates (SuperJSON), callback tokens.  
 Not serializable: functions, `undefined` (use `null`), symbols, RPC stubs, circular refs.
 
+(`tools.callbacks.createFromParent()` exists for tokenizing a function handed in from a parent twist/tool — regular connectors don't need it.)
+
 ## Callback backward compatibility
 
 Deployed callbacks auto-upgrade to new connector versions. Signatures must stay compatible:
@@ -191,14 +206,12 @@ async syncBatch(batchNumber: number, resourceId: string, initialSync?: boolean)
 }
 ```
 
-For breaking changes, do migration in `preUpgrade()` (e.g. clear stale locks).
+For breaking changes, do migration in `upgrade()` (called once per active instance when a new version deploys — e.g. clear stale locks, see `gmail/`, `google-calendar/`).
 
 ## Storage key conventions
 
 | Key | Purpose |
 |---|---|
-| `item_callback_<id>` | Token for parent's `onItem` |
-| `disable_callback_<id>` | Token for parent's `onChannelDisabled` |
 | `sync_state_<id>` | Current batch pagination state |
 | `sync_enabled_<id>` | Boolean tracking enabled state |
 | `webhook_id_<id>` | External webhook registration id |
@@ -207,7 +220,7 @@ For breaking changes, do migration in `preUpgrade()` (e.g. clear stale locks).
 
 ## `source` — idempotency + cross-user dedup (CRITICAL)
 
-`activity.source` / `link.source` is the upsert key AND the cross-user dedup key: two instances emitting the same `source` converge on a single shared thread across users (that's how two users on the same Gmail message share one thread).
+`link.source` is the upsert key AND the cross-user dedup key: two instances emitting the same `source` converge on a single shared thread across users (that's how two users on the same Gmail message share one thread).
 
 **Your `source` must be globally unique for the external item, not merely unique within a user's account.** If two different users' connectors could emit the same string for different items, include a qualifier (workspace, tenant, mailbox, project).
 
@@ -233,6 +246,8 @@ Pick the format up front — retrofits require a backfill migration.
 
 **Mutable ids:** use the immutable id in `source`, store the mutable key in `meta` only (e.g. Jira issue id in `source`, issue key in `meta`).
 
+**Cross-connector bundling:** `link.sources` (plural) carries additional canonical aliases — any element shared with another link's `sources` bundles the two onto one thread. E.g. calendar connectors emit an `icaluid:<iCalUID>` alias so meeting-notes connectors (Fellow, Granola) can attach to the event's thread.
+
 ### Attestation-based visibility
 
 Populating `thread.contacts` with recipients does NOT automatically admit them. The runtime requires each user's own connector to sync the item before they get a `thread_priority` row. Users whose sync lands first go to `thread.pending_contacts` and are promoted on the next attester's sync. You just populate `contacts` with every recipient you see — the runtime's `upsert_thread` handles the rest.
@@ -266,12 +281,17 @@ Previews (`preview` fields) always use plain text — `snippet` or truncated tit
 
 ## Sync metadata injection
 
-Every synced activity must include provider and channel metadata — the twist's bulk operations (e.g. archiving on disable) rely on it:
+Every synced link must carry provider and channel metadata — bulk operations (e.g. `integrations.archiveLinks({ channelId })` on disable) rely on it:
 
 ```typescript
-activity.meta = { ...activity.meta, syncProvider: "myprovider", channelId: resourceId };
+link.channelId = resourceId; // first-class field on NewLink
+link.meta = { ...link.meta, syncProvider: "myprovider" };
 ```
 
+## Classifier facets (optional)
+
+Messaging-style connectors may set `link.facets` (`format` / `automation` / `reach` from `@plotday/twister/facets`) as internal classifier signal. Set a dimension only when a heuristic is confident; leave it `null`/omitted otherwise. See `gmail/src/gmail-facets.ts` and `slack/src/slack-facets.ts`.
+
 ## Initial vs incremental sync (REQUIRED)
 
 Missing this causes notification spam from bulk historical imports.
@@ -282,12 +302,12 @@ Missing this causes notification spam from bulk historical imports.
 | `archived` | `false` | *omit* |
 
 ```typescript
-const activity = {
+const link = {
   ...(initialSync ? { unread: false, archived: false } : {}),
 };
 ```
 
-The flag must flow from entry point through every batch to the activity-creation site.
+The flag must flow from entry point through every batch to the link-creation site.
 
 - **Pattern A — store in SyncState**: include `initialSync: boolean` in your state type; set `true` in `startBatchSync`, preserve across batches, webhooks pass `false`.
 - **Pattern B — pass as callback arg**: make it the last, optional param (for backward compat) and propagate: `async syncBatch(batch: number, mode: "full"|"incremental", channelId: string, initialSync?: boolean)`. Used by connectors like Gmail.
@@ -325,11 +345,12 @@ if (taskToken) await this.set(`watch_renewal_task_${resourceId}`, taskToken);
 ## Bidirectional sync
 
 ```typescript
-// Update issue/task from Plot
-async updateIssue(activity: Activity): Promise<void> {
-  const externalId = activity.meta?.externalId as string;
-  const client = await this.getClient(activity.meta?.resourceId as string);
-  await client.updateItem(externalId, { title: activity.title, done: /* ... */ });
+// Write back status/assignee changes the user makes in Plot on links this
+// connector created (dispatched by the runtime)
+async onLinkUpdated(link: Link): Promise<void> {
+  const externalId = link.meta?.externalId as string;
+  const client = await this.getClient(link.channelId ?? (link.meta?.resourceId as string));
+  await client.updateItem(externalId, { title: link.title, status: /* map link.status */ });
 }
 
 // Post a comment. Return a NoteWriteBackResult with externalContent so the
@@ -395,9 +416,9 @@ Opt a link type in by adding a `compose` block to its `LinkTypeConfig`:
   type: "issue",
   label: "Issue",
   statuses: [
-    { status: "backlog", label: "Backlog" },
-    { status: "unstarted", label: "To Do" },
-    { status: "completed", label: "Done", done: true },
+    { status: "backlog", label: "Backlog", icon: "backlog" as StatusIcon },
+    { status: "unstarted", label: "To Do", icon: "todo" as StatusIcon },
+    { status: "completed", label: "Done", done: true, icon: "done" as StatusIcon },
   ],
   compose: { status: "unstarted" },        // targets defaults to "channels"
 }
@@ -432,7 +453,7 @@ async onCreateLink(draft: CreateLinkDraft): Promise<NewLinkWithNotes | null> {
 }
 ```
 
-`CreateLinkDraft`: `channelId`, `type`, `status`, `title`, `noteContent`, `contacts: Actor[]`. See `twister/src/connector.ts`.
+`CreateLinkDraft`: `channelId`, `type`, `status` (`null` for status-less link types), `title`, `noteContent`, `contacts: Actor[]`, plus — for `compose.targets: "contacts"`/`"addresses"` — `recipients?: ResolvedRecipient[]` (contacts pre-resolved to platform account IDs with their thread `role`) and `inviteEmails?: string[]` (free-form typed addresses). See `twister/src/connector.ts`.
 
 Resolve category statuses (`"unstarted"`, etc.) to the provider's state id yourself — the draft's status is whatever the picker showed.
 
@@ -443,11 +464,16 @@ The returned link is written with `updated_by` set to the twist, so subsequent s
 Contacts are created implicitly when you save threads/links — no `addContacts()` call, no `ContactAccess.Write`.
 
 ```typescript
-const author: NewContact | undefined = creator?.email
-  ? { email: creator.email, name: creator.name, avatar: creator.avatarUrl ?? undefined }
+const author: NewContact | undefined = creator
+  ? {
+      ...(creator.email ? { email: creator.email } : {}),
+      name: creator.name ?? "",
+      avatar: creator.avatarUrl ?? undefined,
+      source: { accountId: creator.id }, // platform identity, resolves without email
+    }
   : undefined;
 
-const activity: NewActivityWithNotes = {
+const link: NewLinkWithNotes = {
   author,
   assignee: assigneeContact ?? null,
   notes: [{ author /* note-level author too */ }],
@@ -468,8 +494,8 @@ declare const Buffer: {
 ## Build & test
 
 ```bash
-cd public/connectors/<name> && pnpm build
-cd public/connectors/<name> && pnpm exec tsc --noEmit
+cd connectors/<name> && pnpm build
+cd connectors/<name> && pnpm exec tsc --noEmit
 pnpm install  # from repo root
 ```
 
@@ -477,19 +503,20 @@ Add to `pnpm-workspace.yaml` if not already covered by a glob.
 
 ## Checklist
 
-- [ ] Extend `Connector<YourConnector>`; declare `PROVIDER`, `SCOPES`, `Options` (static + `declare readonly`)
-- [ ] `build()` declares Integrations, Network, Callbacks, Tasks (plus GoogleContacts if applicable)
+- [ ] Extend `Connector<YourConnector>`; declare `readonly provider`, `readonly scopes`, `readonly linkTypes`
+- [ ] `build()` declares Integrations and Network (plus GoogleContacts/Files if applicable) — `callbacks`/`store`/`tasks` are built-in
 - [ ] Set `handleReplies = true` only if bidirectional
 - [ ] For bidirectional note sync: `onNoteCreated` / `onNoteUpdated` return `NoteWriteBackResult` with `externalContent` matching what sync-in will emit for this note — no `Promise<string | void>` in new connectors
 - [ ] For bidirectional note sync: implement `onNoteUpdated` if the external supports editing (document the gap if it doesn't)
 - [ ] `onChannelEnabled` uses `runTask()` (NOT `run()`) for webhook setup and initial sync — blocks HTTP response otherwise
-- [ ] Convert parent callbacks to tokens with `createFromParent()`; store via `this.set()`; retrieve with `this.get<Callback>()`
+- [ ] `onChannelEnabled` is idempotent (overwrites state) — it re-fires on auto-enable and recovery (`context.recovering`)
+- [ ] Call `integrations.channelSyncCompleted(channelId)` exactly once when the initial backfill finishes
 - [ ] Never pass functions, RPC stubs, or `undefined` to `this.callback()` — use `null`
-- [ ] Validate token exists before `callbacks.run()`
+- [ ] Validate stored callback tokens exist before `this.run()`
 - [ ] Localhost guard in webhook setup; verify webhook signatures
 - [ ] Canonical, globally-unique `source` using immutable ids; mutable keys in `meta` only
 - [ ] `note.key` for note-level upserts
-- [ ] Inject `syncProvider` + `channelId` into `activity.meta`
+- [ ] Set `link.channelId` and inject `syncProvider` into `link.meta`
 - [ ] `contentType: "html"` for HTML — never strip tags locally
 - [ ] `created` on notes = external timestamp, not sync time
 - [ ] `initialSync` propagated through every entry point and batch; set `unread: false, archived: false` on initial, omit on incremental
@@ -501,14 +528,14 @@ Add to `pnpm-workspace.yaml` if not already covered by a glob.
 ## Common pitfalls
 
 1. Passing functions/`undefined`/RPC stubs to `this.callback()` → use tokens + `null`.
-2. Forgetting sync metadata (`syncProvider`, `channelId`) → breaks bulk archive on disable.
+2. Forgetting sync metadata (`link.channelId`, `meta.syncProvider`) → breaks bulk archive on disable.
 3. Not propagating `initialSync` through the whole pipeline → notification spam.
 4. Mutable ids in `source` (e.g. Jira issue key) → use immutable id, store key in `meta`.
 5. `source` that's only unique within one user's account → breaks cross-user dedup; add workspace/tenant/mailbox qualifier.
 6. Not breaking long loops into batches → each execution has ~1000 request limit.
 7. Missing localhost guard → webhook registration fails silently.
 8. Calling `plot.createThread()` from a connector → use `integrations.saveLink()`.
-9. Breaking callback signatures → add optional params at end only; use `preUpgrade()` for breaking migrations.
+9. Breaking callback signatures → add optional params at end only; use `upgrade()` for breaking migrations.
 10. Not cleaning up on disable → orphan callbacks, webhooks, state.
 11. Two-way sync without metadata correlation → embed Plot id in external metadata to prevent race-condition duplicates (see SYNC_STRATEGIES.md §6).
 12. Stripping HTML locally → breaks encoding + loses links; use `contentType: "html"`.
@@ -533,4 +560,4 @@ Add to `pnpm-workspace.yaml` if not already covered by a glob.
 | `jira/` | ProjectConnector | Immutable vs mutable ids; comment metadata dedup |
 | `asana/` | ProjectConnector | HMAC webhook verification; section-based projects |
 | `outlook-calendar/` | CalendarConnector | Microsoft Graph; subscription management |
-| `google-contacts/` | Supporting | Contact sync; cross-connector `syncWithAuth()` |
+| `google-contacts/` | Supporting | Contact sync; shared Google auth consumed by other connectors via `MergeScopes` |

package/dist/docs/modules.html

@@ -1 +1 @@
-<!DOCTYPE html><html class="default" lang="en" data-base="./"><head><meta charset="utf-8"/><meta http-equiv="x-ua-compatible" content="IE=edge"/><title>Creating Plot Twists</title><link rel="icon" href="assets/favicon.svg" type="image/svg+xml"/><meta name="description" content="Documentation for Creating Plot Twists"/><meta name="viewport" content="width=device-width, initial-scale=1"/><link rel="stylesheet" href="assets/style.css"/><link rel="stylesheet" href="assets/highlight.css"/><script defer src="assets/main.js"></script><script async src="assets/icons.js" id="tsd-icons-script"></script><script async src="assets/search.js" id="tsd-search-script"></script><script async src="assets/navigation.js" id="tsd-nav-script"></script><script async src="assets/hierarchy.js" id="tsd-hierarchy-script"></script></head><body><script>document.documentElement.dataset.theme = localStorage.getItem("tsd-theme") || "os";document.body.style.display="none";setTimeout(() => window.app?app.showPage():document.body.style.removeProperty("display"),500)</script><header class="tsd-page-toolbar"><div class="tsd-toolbar-contents container"><a href="/" class="title">Creating Plot Twists</a><div id="tsd-toolbar-links"><a href="https://plot.day">Plot</a><a href="https://github.com/plotday/plot">GitHub</a><a href="https://www.npmjs.com/package/@plotday/twister">NPM</a></div><button id="tsd-search-trigger" class="tsd-widget" aria-label="Search"><svg width="16" height="16" viewBox="0 0 16 16" fill="none" aria-hidden="true"><use href="assets/icons.svg#icon-search"></use></svg></button><dialog id="tsd-search" aria-label="Search"><input role="combobox" id="tsd-search-input" aria-controls="tsd-search-results" aria-autocomplete="list" aria-expanded="true" autocapitalize="off" autocomplete="off" placeholder="Search the docs" maxLength="100"/><ul role="listbox" id="tsd-search-results"></ul><div id="tsd-search-status" aria-live="polite" aria-atomic="true"><div>Preparing search index...</div></div></dialog><a href="#" class="tsd-widget menu" id="tsd-toolbar-menu-trigger" data-toggle="menu" aria-label="Menu"><svg width="16" height="16" viewBox="0 0 16 16" fill="none" aria-hidden="true"><use href="assets/icons.svg#icon-menu"></use></svg></a></div></header><div class="container container-main"><div class="col-content"><div class="tsd-page-title"><ul class="tsd-breadcrumb" aria-label="Breadcrumb"></ul><h1>Creating Plot Twists</h1></div><details class="tsd-panel-group tsd-member-group tsd-accordion" open><summary class="tsd-accordion-summary" data-key="section-Guides"><svg width="20" height="20" viewBox="0 0 24 24" fill="none" aria-hidden="true"><use href="assets/icons.svg#icon-chevronDown"></use></svg><h2>Guides</h2></summary><dl class="tsd-member-summaries"><dt class="tsd-member-summary" id="getting-started-1"><span class="tsd-member-summary-name"><svg class="tsd-kind-icon" viewBox="0 0 24 24" aria-label="Document"><use href="assets/icons.svg#icon-8388608"></use></svg><a href="documents/Getting_Started.html">Getting Started</a><a href="#getting-started-1" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="assets/icons.svg#icon-anchor"></use></svg></a></span></dt><dd class="tsd-member-summary"></dd><dt class="tsd-member-summary" id="core-concepts"><span class="tsd-member-summary-name"><svg class="tsd-kind-icon" viewBox="0 0 24 24" aria-label="Document"><use href="assets/icons.svg#icon-8388608"></use></svg><a href="documents/Core_Concepts.html">Core Concepts</a><a href="#core-concepts" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="assets/icons.svg#icon-anchor"></use></svg></a></span></dt><dd class="tsd-member-summary"></dd><dt class="tsd-member-summary" id="built-in-tools"><span class="tsd-member-summary-name"><svg class="tsd-kind-icon" viewBox="0 0 24 24" aria-label="Document"><use href="assets/icons.svg#icon-8388608"></use></svg><a href="documents/Built-in_Tools.html">Built-in Tools</a><a href="#built-in-tools" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="assets/icons.svg#icon-anchor"></use></svg></a></span></dt><dd class="tsd-member-summary"></dd><dt class="tsd-member-summary" id="building-connectors"><span class="tsd-member-summary-name"><svg class="tsd-kind-icon" viewBox="0 0 24 24" aria-label="Document"><use href="assets/icons.svg#icon-8388608"></use></svg><a href="documents/Building_Connectors.html">Building Connectors</a><a href="#building-connectors" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="assets/icons.svg#icon-anchor"></use></svg></a></span></dt><dd class="tsd-member-summary"></dd><dt class="tsd-member-summary" id="cli-reference"><span class="tsd-member-summary-name"><svg class="tsd-kind-icon" viewBox="0 0 24 24" aria-label="Document"><use href="assets/icons.svg#icon-8388608"></use></svg><a href="documents/CLI_Reference.html">CLI Reference</a><a href="#cli-reference" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="assets/icons.svg#icon-anchor"></use></svg></a></span></dt><dd class="tsd-member-summary"></dd><dt class="tsd-member-summary" id="runtime-environment"><span class="tsd-member-summary-name"><svg class="tsd-kind-icon" viewBox="0 0 24 24" aria-label="Document"><use href="assets/icons.svg#icon-8388608"></use></svg><a href="documents/Runtime_Environment.html">Runtime Environment</a><a href="#runtime-environment" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="assets/icons.svg#icon-anchor"></use></svg></a></span></dt><dd class="tsd-member-summary"></dd></dl></details><details class="tsd-panel-group tsd-member-group tsd-accordion" open><summary class="tsd-accordion-summary" data-key="section-Modules"><svg width="20" height="20" viewBox="0 0 24 24" fill="none" aria-hidden="true"><use href="assets/icons.svg#icon-chevronDown"></use></svg><h2>Modules</h2></summary><dl class="tsd-member-summaries"><dt class="tsd-member-summary" id="index"><span class="tsd-member-summary-name"><svg class="tsd-kind-icon" viewBox="0 0 24 24" aria-label="Module"><use href="assets/icons.svg#icon-2"></use></svg><a href="modules/index.html">index</a><a href="#index" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="assets/icons.svg#icon-anchor"></use></svg></a></span></dt><dd class="tsd-member-summary"></dd><dt class="tsd-member-summary" id="plot"><span class="tsd-member-summary-name"><svg class="tsd-kind-icon" viewBox="0 0 24 24" aria-label="Module"><use href="assets/icons.svg#icon-2"></use></svg><a href="modules/plot.html">plot</a><a href="#plot" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="assets/icons.svg#icon-anchor"></use></svg></a></span></dt><dd class="tsd-member-summary"></dd><dt class="tsd-member-summary" id="tag"><span class="tsd-member-summary-name"><svg class="tsd-kind-icon" viewBox="0 0 24 24" aria-label="Module"><use href="assets/icons.svg#icon-2"></use></svg><a href="modules/tag.html">tag</a><a href="#tag" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="assets/icons.svg#icon-anchor"></use></svg></a></span></dt><dd class="tsd-member-summary"></dd><dt class="tsd-member-summary" id="tool"><span class="tsd-member-summary-name"><svg class="tsd-kind-icon" viewBox="0 0 24 24" aria-label="Module"><use href="assets/icons.svg#icon-2"></use></svg><a href="modules/tool.html">tool</a><a href="#tool" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="assets/icons.svg#icon-anchor"></use></svg></a></span></dt><dd class="tsd-member-summary"></dd><dt class="tsd-member-summary" id="toolsai"><span class="tsd-member-summary-name"><svg class="tsd-kind-icon" viewBox="0 0 24 24" aria-label="Module"><use href="assets/icons.svg#icon-2"></use></svg><a href="modules/tools_ai.html">tools/ai</a><a href="#toolsai" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="assets/icons.svg#icon-anchor"></use></svg></a></span></dt><dd class="tsd-member-summary"></dd><dt class="tsd-member-summary" id="toolscallbacks"><span class="tsd-member-summary-name"><svg class="tsd-kind-icon" viewBox="0 0 24 24" aria-label="Module"><use href="assets/icons.svg#icon-2"></use></svg><a href="modules/tools_callbacks.html">tools/callbacks</a><a href="#toolscallbacks" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="assets/icons.svg#icon-anchor"></use></svg></a></span></dt><dd class="tsd-member-summary"></dd><dt class="tsd-member-summary" id="toolsintegrations"><span class="tsd-member-summary-name"><svg class="tsd-kind-icon" viewBox="0 0 24 24" aria-label="Module"><use href="assets/icons.svg#icon-2"></use></svg><a href="modules/tools_integrations.html">tools/integrations</a><a href="#toolsintegrations" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="assets/icons.svg#icon-anchor"></use></svg></a></span></dt><dd class="tsd-member-summary"></dd><dt class="tsd-member-summary" id="toolsnetwork"><span class="tsd-member-summary-name"><svg class="tsd-kind-icon" viewBox="0 0 24 24" aria-label="Module"><use href="assets/icons.svg#icon-2"></use></svg><a href="modules/tools_network.html">tools/network</a><a href="#toolsnetwork" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="assets/icons.svg#icon-anchor"></use></svg></a></span></dt><dd class="tsd-member-summary"></dd><dt class="tsd-member-summary" id="toolsplot"><span class="tsd-member-summary-name"><svg class="tsd-kind-icon" viewBox="0 0 24 24" aria-label="Module"><use href="assets/icons.svg#icon-2"></use></svg><a href="modules/tools_plot.html">tools/plot</a><a href="#toolsplot" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="assets/icons.svg#icon-anchor"></use></svg></a></span></dt><dd class="tsd-member-summary"></dd><dt class="tsd-member-summary" id="toolsstore"><span class="tsd-member-summary-name"><svg class="tsd-kind-icon" viewBox="0 0 24 24" aria-label="Module"><use href="assets/icons.svg#icon-2"></use></svg><a href="modules/tools_store.html">tools/store</a><a href="#toolsstore" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="assets/icons.svg#icon-anchor"></use></svg></a></span></dt><dd class="tsd-member-summary"></dd><dt class="tsd-member-summary" id="toolstasks"><span class="tsd-member-summary-name"><svg class="tsd-kind-icon" viewBox="0 0 24 24" aria-label="Module"><use href="assets/icons.svg#icon-2"></use></svg><a href="modules/tools_tasks.html">tools/tasks</a><a href="#toolstasks" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="assets/icons.svg#icon-anchor"></use></svg></a></span></dt><dd class="tsd-member-summary"></dd><dt class="tsd-member-summary" id="toolstwists"><span class="tsd-member-summary-name"><svg class="tsd-kind-icon" viewBox="0 0 24 24" aria-label="Module"><use href="assets/icons.svg#icon-2"></use></svg><a href="modules/tools_twists.html">tools/twists</a><a href="#toolstwists" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="assets/icons.svg#icon-anchor"></use></svg></a></span></dt><dd class="tsd-member-summary"></dd><dt class="tsd-member-summary" id="twist"><span class="tsd-member-summary-name"><svg class="tsd-kind-icon" viewBox="0 0 24 24" aria-label="Module"><use href="assets/icons.svg#icon-2"></use></svg><a href="modules/twist.html">twist</a><a href="#twist" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="assets/icons.svg#icon-anchor"></use></svg></a></span></dt><dd class="tsd-member-summary"></dd><dt class="tsd-member-summary" id="utilshash"><span class="tsd-member-summary-name"><svg class="tsd-kind-icon" viewBox="0 0 24 24" aria-label="Module"><use href="assets/icons.svg#icon-2"></use></svg><a href="modules/utils_hash.html">utils/hash</a><a href="#utilshash" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="assets/icons.svg#icon-anchor"></use></svg></a></span></dt><dd class="tsd-member-summary"></dd><dt class="tsd-member-summary" id="utilstypes"><span class="tsd-member-summary-name"><svg class="tsd-kind-icon" viewBox="0 0 24 24" aria-label="Module"><use href="assets/icons.svg#icon-2"></use></svg><a href="modules/utils_types.html">utils/types</a><a href="#utilstypes" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="assets/icons.svg#icon-anchor"></use></svg></a></span></dt><dd class="tsd-member-summary"></dd></dl></details></div><div class="col-sidebar"><div class="page-menu"><div class="tsd-navigation settings"><details class="tsd-accordion"><summary class="tsd-accordion-summary"><svg width="20" height="20" viewBox="0 0 24 24" fill="none" aria-hidden="true"><use href="assets/icons.svg#icon-chevronDown"></use></svg><h3>Settings</h3></summary><div class="tsd-accordion-details"><div class="tsd-filter-visibility"><span class="settings-label">Member Visibility</span><ul id="tsd-filter-options"><li class="tsd-filter-item"><label class="tsd-filter-input"><input type="checkbox" id="tsd-filter-protected" name="protected"/><svg width="32" height="32" viewBox="0 0 32 32" aria-hidden="true"><rect class="tsd-checkbox-background" width="30" height="30" x="1" y="1" rx="6" fill="none"></rect><path class="tsd-checkbox-checkmark" d="M8.35422 16.8214L13.2143 21.75L24.6458 10.25" stroke="none" stroke-width="3.5" stroke-linejoin="round" fill="none"></path></svg><span>Protected</span></label></li><li class="tsd-filter-item"><label class="tsd-filter-input"><input type="checkbox" id="tsd-filter-inherited" name="inherited" checked/><svg width="32" height="32" viewBox="0 0 32 32" aria-hidden="true"><rect class="tsd-checkbox-background" width="30" height="30" x="1" y="1" rx="6" fill="none"></rect><path class="tsd-checkbox-checkmark" d="M8.35422 16.8214L13.2143 21.75L24.6458 10.25" stroke="none" stroke-width="3.5" stroke-linejoin="round" fill="none"></path></svg><span>Inherited</span></label></li></ul></div><div class="tsd-theme-toggle"><label class="settings-label" for="tsd-theme">Theme</label><select id="tsd-theme"><option value="os">OS</option><option value="light">Light</option><option value="dark">Dark</option></select></div></div></details></div><details open class="tsd-accordion tsd-page-navigation"><summary class="tsd-accordion-summary"><svg width="20" height="20" viewBox="0 0 24 24" fill="none" aria-hidden="true"><use href="assets/icons.svg#icon-chevronDown"></use></svg><h3>On This Page</h3></summary><div class="tsd-accordion-details"><details open class="tsd-accordion tsd-page-navigation-section"><summary class="tsd-accordion-summary" data-key="section-Guides"><svg width="20" height="20" viewBox="0 0 24 24" fill="none" aria-hidden="true"><use href="assets/icons.svg#icon-chevronDown"></use></svg>Guides</summary><div><a href="#getting-started-1"><svg class="tsd-kind-icon" viewBox="0 0 24 24" aria-label="Document"><use href="assets/icons.svg#icon-8388608"></use></svg><span>Getting <wbr/>Started</span></a><a href="#core-concepts"><svg class="tsd-kind-icon" viewBox="0 0 24 24" aria-label="Document"><use href="assets/icons.svg#icon-8388608"></use></svg><span>Core <wbr/>Concepts</span></a><a href="#built-in-tools"><svg class="tsd-kind-icon" viewBox="0 0 24 24" aria-label="Document"><use href="assets/icons.svg#icon-8388608"></use></svg><span>Built-<wbr/>in <wbr/>Tools</span></a><a href="#building-connectors"><svg class="tsd-kind-icon" viewBox="0 0 24 24" aria-label="Document"><use href="assets/icons.svg#icon-8388608"></use></svg><span>Building <wbr/>Connectors</span></a><a href="#cli-reference"><svg class="tsd-kind-icon" viewBox="0 0 24 24" aria-label="Document"><use href="assets/icons.svg#icon-8388608"></use></svg><span>CLI <wbr/>Reference</span></a><a href="#runtime-environment"><svg class="tsd-kind-icon" viewBox="0 0 24 24" aria-label="Document"><use href="assets/icons.svg#icon-8388608"></use></svg><span>Runtime <wbr/>Environment</span></a></div></details><details open class="tsd-accordion tsd-page-navigation-section"><summary class="tsd-accordion-summary" data-key="section-Modules"><svg width="20" height="20" viewBox="0 0 24 24" fill="none" aria-hidden="true"><use href="assets/icons.svg#icon-chevronDown"></use></svg>Modules</summary><div><a href="#index"><svg class="tsd-kind-icon" viewBox="0 0 24 24" aria-label="Module"><use href="assets/icons.svg#icon-2"></use></svg><span>index</span></a><a href="#plot"><svg class="tsd-kind-icon" viewBox="0 0 24 24" aria-label="Module"><use href="assets/icons.svg#icon-2"></use></svg><span>plot</span></a><a href="#tag"><svg class="tsd-kind-icon" viewBox="0 0 24 24" aria-label="Module"><use href="assets/icons.svg#icon-2"></use></svg><span>tag</span></a><a href="#tool"><svg class="tsd-kind-icon" viewBox="0 0 24 24" aria-label="Module"><use href="assets/icons.svg#icon-2"></use></svg><span>tool</span></a><a href="#toolsai"><svg class="tsd-kind-icon" viewBox="0 0 24 24" aria-label="Module"><use href="assets/icons.svg#icon-2"></use></svg><span>tools/ai</span></a><a href="#toolscallbacks"><svg class="tsd-kind-icon" viewBox="0 0 24 24" aria-label="Module"><use href="assets/icons.svg#icon-2"></use></svg><span>tools/callbacks</span></a><a href="#toolsintegrations"><svg class="tsd-kind-icon" viewBox="0 0 24 24" aria-label="Module"><use href="assets/icons.svg#icon-2"></use></svg><span>tools/integrations</span></a><a href="#toolsnetwork"><svg class="tsd-kind-icon" viewBox="0 0 24 24" aria-label="Module"><use href="assets/icons.svg#icon-2"></use></svg><span>tools/network</span></a><a href="#toolsplot"><svg class="tsd-kind-icon" viewBox="0 0 24 24" aria-label="Module"><use href="assets/icons.svg#icon-2"></use></svg><span>tools/plot</span></a><a href="#toolsstore"><svg class="tsd-kind-icon" viewBox="0 0 24 24" aria-label="Module"><use href="assets/icons.svg#icon-2"></use></svg><span>tools/store</span></a><a href="#toolstasks"><svg class="tsd-kind-icon" viewBox="0 0 24 24" aria-label="Module"><use href="assets/icons.svg#icon-2"></use></svg><span>tools/tasks</span></a><a href="#toolstwists"><svg class="tsd-kind-icon" viewBox="0 0 24 24" aria-label="Module"><use href="assets/icons.svg#icon-2"></use></svg><span>tools/twists</span></a><a href="#twist"><svg class="tsd-kind-icon" viewBox="0 0 24 24" aria-label="Module"><use href="assets/icons.svg#icon-2"></use></svg><span>twist</span></a><a href="#utilshash"><svg class="tsd-kind-icon" viewBox="0 0 24 24" aria-label="Module"><use href="assets/icons.svg#icon-2"></use></svg><span>utils/hash</span></a><a href="#utilstypes"><svg class="tsd-kind-icon" viewBox="0 0 24 24" aria-label="Module"><use href="assets/icons.svg#icon-2"></use></svg><span>utils/types</span></a></div></details></div></details></div><div class="site-menu"><nav id="tsd-sidebar-links" class="tsd-navigation"><a href="https://plot.day" class="tsd-nav-link">Plot</a><a href="https://github.com/plotday/plot" class="tsd-nav-link">GitHub</a><a href="https://www.npmjs.com/package/@plotday/twister" class="tsd-nav-link">NPM</a></nav><nav class="tsd-navigation"><a href="modules.html" class="current">Creating Plot Twists</a><ul class="tsd-small-nested-navigation" id="tsd-nav-container"><li>Loading...</li></ul></nav></div></div></div><footer><p class="tsd-generator">Generated using <a href="https://typedoc.org/" target="_blank">TypeDoc</a></p></footer><div class="overlay"></div></body></html>
+<!DOCTYPE html><html class="default" lang="en" data-base="./"><head><meta charset="utf-8"/><meta http-equiv="x-ua-compatible" content="IE=edge"/><title>Creating Plot Twists</title><link rel="icon" href="assets/favicon.svg" type="image/svg+xml"/><meta name="description" content="Documentation for Creating Plot Twists"/><meta name="viewport" content="width=device-width, initial-scale=1"/><link rel="stylesheet" href="assets/style.css"/><link rel="stylesheet" href="assets/highlight.css"/><script defer src="assets/main.js"></script><script async src="assets/icons.js" id="tsd-icons-script"></script><script async src="assets/search.js" id="tsd-search-script"></script><script async src="assets/navigation.js" id="tsd-nav-script"></script><script async src="assets/hierarchy.js" id="tsd-hierarchy-script"></script></head><body><script>document.documentElement.dataset.theme = localStorage.getItem("tsd-theme") || "os";document.body.style.display="none";setTimeout(() => window.app?app.showPage():document.body.style.removeProperty("display"),500)</script><header class="tsd-page-toolbar"><div class="tsd-toolbar-contents container"><a href="/" class="title">Creating Plot Twists</a><div id="tsd-toolbar-links"><a href="https://plot.day">Plot</a><a href="https://github.com/plotday/plot">GitHub</a><a href="https://www.npmjs.com/package/@plotday/twister">NPM</a></div><button id="tsd-search-trigger" class="tsd-widget" aria-label="Search"><svg width="16" height="16" viewBox="0 0 16 16" fill="none" aria-hidden="true"><use href="assets/icons.svg#icon-search"></use></svg></button><dialog id="tsd-search" aria-label="Search"><input role="combobox" id="tsd-search-input" aria-controls="tsd-search-results" aria-autocomplete="list" aria-expanded="true" autocapitalize="off" autocomplete="off" placeholder="Search the docs" maxLength="100"/><ul role="listbox" id="tsd-search-results"></ul><div id="tsd-search-status" aria-live="polite" aria-atomic="true"><div>Preparing search index...</div></div></dialog><a href="#" class="tsd-widget menu" id="tsd-toolbar-menu-trigger" data-toggle="menu" aria-label="Menu"><svg width="16" height="16" viewBox="0 0 16 16" fill="none" aria-hidden="true"><use href="assets/icons.svg#icon-menu"></use></svg></a></div></header><div class="container container-main"><div class="col-content"><div class="tsd-page-title"><ul class="tsd-breadcrumb" aria-label="Breadcrumb"></ul><h1>Creating Plot Twists</h1></div><details class="tsd-panel-group tsd-member-group tsd-accordion" open><summary class="tsd-accordion-summary" data-key="section-Documents"><svg width="20" height="20" viewBox="0 0 24 24" fill="none" aria-hidden="true"><use href="assets/icons.svg#icon-chevronDown"></use></svg><h2>Documents</h2></summary><dl class="tsd-member-summaries"><dt class="tsd-member-summary" id="sync_strategies"><span class="tsd-member-summary-name"><svg class="tsd-kind-icon" viewBox="0 0 24 24" aria-label="Document"><use href="assets/icons.svg#icon-8388608"></use></svg><a href="documents/SYNC_STRATEGIES.html">SYNC_STRATEGIES</a><a href="#sync_strategies" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="assets/icons.svg#icon-anchor"></use></svg></a></span></dt><dd class="tsd-member-summary"></dd><dt class="tsd-member-summary" id="multi_user_auth"><span class="tsd-member-summary-name"><svg class="tsd-kind-icon" viewBox="0 0 24 24" aria-label="Document"><use href="assets/icons.svg#icon-8388608"></use></svg><a href="documents/MULTI_USER_AUTH.html">MULTI_USER_AUTH</a><a href="#multi_user_auth" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="assets/icons.svg#icon-anchor"></use></svg></a></span></dt><dd class="tsd-member-summary"></dd></dl></details><details class="tsd-panel-group tsd-member-group tsd-accordion" open><summary class="tsd-accordion-summary" data-key="section-Guides"><svg width="20" height="20" viewBox="0 0 24 24" fill="none" aria-hidden="true"><use href="assets/icons.svg#icon-chevronDown"></use></svg><h2>Guides</h2></summary><dl class="tsd-member-summaries"><dt class="tsd-member-summary" id="getting-started-1"><span class="tsd-member-summary-name"><svg class="tsd-kind-icon" viewBox="0 0 24 24" aria-label="Document"><use href="assets/icons.svg#icon-8388608"></use></svg><a href="documents/Getting_Started.html">Getting Started</a><a href="#getting-started-1" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="assets/icons.svg#icon-anchor"></use></svg></a></span></dt><dd class="tsd-member-summary"></dd><dt class="tsd-member-summary" id="core-concepts"><span class="tsd-member-summary-name"><svg class="tsd-kind-icon" viewBox="0 0 24 24" aria-label="Document"><use href="assets/icons.svg#icon-8388608"></use></svg><a href="documents/Core_Concepts.html">Core Concepts</a><a href="#core-concepts" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="assets/icons.svg#icon-anchor"></use></svg></a></span></dt><dd class="tsd-member-summary"></dd><dt class="tsd-member-summary" id="built-in-tools"><span class="tsd-member-summary-name"><svg class="tsd-kind-icon" viewBox="0 0 24 24" aria-label="Document"><use href="assets/icons.svg#icon-8388608"></use></svg><a href="documents/Built-in_Tools.html">Built-in Tools</a><a href="#built-in-tools" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="assets/icons.svg#icon-anchor"></use></svg></a></span></dt><dd class="tsd-member-summary"></dd><dt class="tsd-member-summary" id="building-connectors"><span class="tsd-member-summary-name"><svg class="tsd-kind-icon" viewBox="0 0 24 24" aria-label="Document"><use href="assets/icons.svg#icon-8388608"></use></svg><a href="documents/Building_Connectors.html">Building Connectors</a><a href="#building-connectors" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="assets/icons.svg#icon-anchor"></use></svg></a></span></dt><dd class="tsd-member-summary"></dd><dt class="tsd-member-summary" id="cli-reference"><span class="tsd-member-summary-name"><svg class="tsd-kind-icon" viewBox="0 0 24 24" aria-label="Document"><use href="assets/icons.svg#icon-8388608"></use></svg><a href="documents/CLI_Reference.html">CLI Reference</a><a href="#cli-reference" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="assets/icons.svg#icon-anchor"></use></svg></a></span></dt><dd class="tsd-member-summary"></dd><dt class="tsd-member-summary" id="runtime-environment"><span class="tsd-member-summary-name"><svg class="tsd-kind-icon" viewBox="0 0 24 24" aria-label="Document"><use href="assets/icons.svg#icon-8388608"></use></svg><a href="documents/Runtime_Environment.html">Runtime Environment</a><a href="#runtime-environment" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="assets/icons.svg#icon-anchor"></use></svg></a></span></dt><dd class="tsd-member-summary"></dd></dl></details><details class="tsd-panel-group tsd-member-group tsd-accordion" open><summary class="tsd-accordion-summary" data-key="section-Modules"><svg width="20" height="20" viewBox="0 0 24 24" fill="none" aria-hidden="true"><use href="assets/icons.svg#icon-chevronDown"></use></svg><h2>Modules</h2></summary><dl class="tsd-member-summaries"><dt class="tsd-member-summary" id="index"><span class="tsd-member-summary-name"><svg class="tsd-kind-icon" viewBox="0 0 24 24" aria-label="Module"><use href="assets/icons.svg#icon-2"></use></svg><a href="modules/index.html">index</a><a href="#index" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="assets/icons.svg#icon-anchor"></use></svg></a></span></dt><dd class="tsd-member-summary"></dd><dt class="tsd-member-summary" id="plot"><span class="tsd-member-summary-name"><svg class="tsd-kind-icon" viewBox="0 0 24 24" aria-label="Module"><use href="assets/icons.svg#icon-2"></use></svg><a href="modules/plot.html">plot</a><a href="#plot" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="assets/icons.svg#icon-anchor"></use></svg></a></span></dt><dd class="tsd-member-summary"></dd><dt class="tsd-member-summary" id="tag"><span class="tsd-member-summary-name"><svg class="tsd-kind-icon" viewBox="0 0 24 24" aria-label="Module"><use href="assets/icons.svg#icon-2"></use></svg><a href="modules/tag.html">tag</a><a href="#tag" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="assets/icons.svg#icon-anchor"></use></svg></a></span></dt><dd class="tsd-member-summary"></dd><dt class="tsd-member-summary" id="tool"><span class="tsd-member-summary-name"><svg class="tsd-kind-icon" viewBox="0 0 24 24" aria-label="Module"><use href="assets/icons.svg#icon-2"></use></svg><a href="modules/tool.html">tool</a><a href="#tool" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="assets/icons.svg#icon-anchor"></use></svg></a></span></dt><dd class="tsd-member-summary"></dd><dt class="tsd-member-summary" id="toolsai"><span class="tsd-member-summary-name"><svg class="tsd-kind-icon" viewBox="0 0 24 24" aria-label="Module"><use href="assets/icons.svg#icon-2"></use></svg><a href="modules/tools_ai.html">tools/ai</a><a href="#toolsai" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="assets/icons.svg#icon-anchor"></use></svg></a></span></dt><dd class="tsd-member-summary"></dd><dt class="tsd-member-summary" id="toolscallbacks"><span class="tsd-member-summary-name"><svg class="tsd-kind-icon" viewBox="0 0 24 24" aria-label="Module"><use href="assets/icons.svg#icon-2"></use></svg><a href="modules/tools_callbacks.html">tools/callbacks</a><a href="#toolscallbacks" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="assets/icons.svg#icon-anchor"></use></svg></a></span></dt><dd class="tsd-member-summary"></dd><dt class="tsd-member-summary" id="toolsintegrations"><span class="tsd-member-summary-name"><svg class="tsd-kind-icon" viewBox="0 0 24 24" aria-label="Module"><use href="assets/icons.svg#icon-2"></use></svg><a href="modules/tools_integrations.html">tools/integrations</a><a href="#toolsintegrations" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="assets/icons.svg#icon-anchor"></use></svg></a></span></dt><dd class="tsd-member-summary"></dd><dt class="tsd-member-summary" id="toolsnetwork"><span class="tsd-member-summary-name"><svg class="tsd-kind-icon" viewBox="0 0 24 24" aria-label="Module"><use href="assets/icons.svg#icon-2"></use></svg><a href="modules/tools_network.html">tools/network</a><a href="#toolsnetwork" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="assets/icons.svg#icon-anchor"></use></svg></a></span></dt><dd class="tsd-member-summary"></dd><dt class="tsd-member-summary" id="toolsplot"><span class="tsd-member-summary-name"><svg class="tsd-kind-icon" viewBox="0 0 24 24" aria-label="Module"><use href="assets/icons.svg#icon-2"></use></svg><a href="modules/tools_plot.html">tools/plot</a><a href="#toolsplot" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="assets/icons.svg#icon-anchor"></use></svg></a></span></dt><dd class="tsd-member-summary"></dd><dt class="tsd-member-summary" id="toolsstore"><span class="tsd-member-summary-name"><svg class="tsd-kind-icon" viewBox="0 0 24 24" aria-label="Module"><use href="assets/icons.svg#icon-2"></use></svg><a href="modules/tools_store.html">tools/store</a><a href="#toolsstore" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="assets/icons.svg#icon-anchor"></use></svg></a></span></dt><dd class="tsd-member-summary"></dd><dt class="tsd-member-summary" id="toolstasks"><span class="tsd-member-summary-name"><svg class="tsd-kind-icon" viewBox="0 0 24 24" aria-label="Module"><use href="assets/icons.svg#icon-2"></use></svg><a href="modules/tools_tasks.html">tools/tasks</a><a href="#toolstasks" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="assets/icons.svg#icon-anchor"></use></svg></a></span></dt><dd class="tsd-member-summary"></dd><dt class="tsd-member-summary" id="toolstwists"><span class="tsd-member-summary-name"><svg class="tsd-kind-icon" viewBox="0 0 24 24" aria-label="Module"><use href="assets/icons.svg#icon-2"></use></svg><a href="modules/tools_twists.html">tools/twists</a><a href="#toolstwists" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="assets/icons.svg#icon-anchor"></use></svg></a></span></dt><dd class="tsd-member-summary"></dd><dt class="tsd-member-summary" id="twist"><span class="tsd-member-summary-name"><svg class="tsd-kind-icon" viewBox="0 0 24 24" aria-label="Module"><use href="assets/icons.svg#icon-2"></use></svg><a href="modules/twist.html">twist</a><a href="#twist" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="assets/icons.svg#icon-anchor"></use></svg></a></span></dt><dd class="tsd-member-summary"></dd><dt class="tsd-member-summary" id="utilshash"><span class="tsd-member-summary-name"><svg class="tsd-kind-icon" viewBox="0 0 24 24" aria-label="Module"><use href="assets/icons.svg#icon-2"></use></svg><a href="modules/utils_hash.html">utils/hash</a><a href="#utilshash" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="assets/icons.svg#icon-anchor"></use></svg></a></span></dt><dd class="tsd-member-summary"></dd><dt class="tsd-member-summary" id="utilstypes"><span class="tsd-member-summary-name"><svg class="tsd-kind-icon" viewBox="0 0 24 24" aria-label="Module"><use href="assets/icons.svg#icon-2"></use></svg><a href="modules/utils_types.html">utils/types</a><a href="#utilstypes" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="assets/icons.svg#icon-anchor"></use></svg></a></span></dt><dd class="tsd-member-summary"></dd></dl></details></div><div class="col-sidebar"><div class="page-menu"><div class="tsd-navigation settings"><details class="tsd-accordion"><summary class="tsd-accordion-summary"><svg width="20" height="20" viewBox="0 0 24 24" fill="none" aria-hidden="true"><use href="assets/icons.svg#icon-chevronDown"></use></svg><h3>Settings</h3></summary><div class="tsd-accordion-details"><div class="tsd-filter-visibility"><span class="settings-label">Member Visibility</span><ul id="tsd-filter-options"><li class="tsd-filter-item"><label class="tsd-filter-input"><input type="checkbox" id="tsd-filter-protected" name="protected"/><svg width="32" height="32" viewBox="0 0 32 32" aria-hidden="true"><rect class="tsd-checkbox-background" width="30" height="30" x="1" y="1" rx="6" fill="none"></rect><path class="tsd-checkbox-checkmark" d="M8.35422 16.8214L13.2143 21.75L24.6458 10.25" stroke="none" stroke-width="3.5" stroke-linejoin="round" fill="none"></path></svg><span>Protected</span></label></li><li class="tsd-filter-item"><label class="tsd-filter-input"><input type="checkbox" id="tsd-filter-inherited" name="inherited" checked/><svg width="32" height="32" viewBox="0 0 32 32" aria-hidden="true"><rect class="tsd-checkbox-background" width="30" height="30" x="1" y="1" rx="6" fill="none"></rect><path class="tsd-checkbox-checkmark" d="M8.35422 16.8214L13.2143 21.75L24.6458 10.25" stroke="none" stroke-width="3.5" stroke-linejoin="round" fill="none"></path></svg><span>Inherited</span></label></li></ul></div><div class="tsd-theme-toggle"><label class="settings-label" for="tsd-theme">Theme</label><select id="tsd-theme"><option value="os">OS</option><option value="light">Light</option><option value="dark">Dark</option></select></div></div></details></div><details open class="tsd-accordion tsd-page-navigation"><summary class="tsd-accordion-summary"><svg width="20" height="20" viewBox="0 0 24 24" fill="none" aria-hidden="true"><use href="assets/icons.svg#icon-chevronDown"></use></svg><h3>On This Page</h3></summary><div class="tsd-accordion-details"><details open class="tsd-accordion tsd-page-navigation-section"><summary class="tsd-accordion-summary" data-key="section-Documents"><svg width="20" height="20" viewBox="0 0 24 24" fill="none" aria-hidden="true"><use href="assets/icons.svg#icon-chevronDown"></use></svg>Documents</summary><div><a href="#sync_strategies"><svg class="tsd-kind-icon" viewBox="0 0 24 24" aria-label="Document"><use href="assets/icons.svg#icon-8388608"></use></svg><span>SYNC_<wbr/>STRATEGIES</span></a><a href="#multi_user_auth"><svg class="tsd-kind-icon" viewBox="0 0 24 24" aria-label="Document"><use href="assets/icons.svg#icon-8388608"></use></svg><span>MULTI_<wbr/>USER_<wbr/>AUTH</span></a></div></details><details open class="tsd-accordion tsd-page-navigation-section"><summary class="tsd-accordion-summary" data-key="section-Guides"><svg width="20" height="20" viewBox="0 0 24 24" fill="none" aria-hidden="true"><use href="assets/icons.svg#icon-chevronDown"></use></svg>Guides</summary><div><a href="#getting-started-1"><svg class="tsd-kind-icon" viewBox="0 0 24 24" aria-label="Document"><use href="assets/icons.svg#icon-8388608"></use></svg><span>Getting <wbr/>Started</span></a><a href="#core-concepts"><svg class="tsd-kind-icon" viewBox="0 0 24 24" aria-label="Document"><use href="assets/icons.svg#icon-8388608"></use></svg><span>Core <wbr/>Concepts</span></a><a href="#built-in-tools"><svg class="tsd-kind-icon" viewBox="0 0 24 24" aria-label="Document"><use href="assets/icons.svg#icon-8388608"></use></svg><span>Built-<wbr/>in <wbr/>Tools</span></a><a href="#building-connectors"><svg class="tsd-kind-icon" viewBox="0 0 24 24" aria-label="Document"><use href="assets/icons.svg#icon-8388608"></use></svg><span>Building <wbr/>Connectors</span></a><a href="#cli-reference"><svg class="tsd-kind-icon" viewBox="0 0 24 24" aria-label="Document"><use href="assets/icons.svg#icon-8388608"></use></svg><span>CLI <wbr/>Reference</span></a><a href="#runtime-environment"><svg class="tsd-kind-icon" viewBox="0 0 24 24" aria-label="Document"><use href="assets/icons.svg#icon-8388608"></use></svg><span>Runtime <wbr/>Environment</span></a></div></details><details open class="tsd-accordion tsd-page-navigation-section"><summary class="tsd-accordion-summary" data-key="section-Modules"><svg width="20" height="20" viewBox="0 0 24 24" fill="none" aria-hidden="true"><use href="assets/icons.svg#icon-chevronDown"></use></svg>Modules</summary><div><a href="#index"><svg class="tsd-kind-icon" viewBox="0 0 24 24" aria-label="Module"><use href="assets/icons.svg#icon-2"></use></svg><span>index</span></a><a href="#plot"><svg class="tsd-kind-icon" viewBox="0 0 24 24" aria-label="Module"><use href="assets/icons.svg#icon-2"></use></svg><span>plot</span></a><a href="#tag"><svg class="tsd-kind-icon" viewBox="0 0 24 24" aria-label="Module"><use href="assets/icons.svg#icon-2"></use></svg><span>tag</span></a><a href="#tool"><svg class="tsd-kind-icon" viewBox="0 0 24 24" aria-label="Module"><use href="assets/icons.svg#icon-2"></use></svg><span>tool</span></a><a href="#toolsai"><svg class="tsd-kind-icon" viewBox="0 0 24 24" aria-label="Module"><use href="assets/icons.svg#icon-2"></use></svg><span>tools/ai</span></a><a href="#toolscallbacks"><svg class="tsd-kind-icon" viewBox="0 0 24 24" aria-label="Module"><use href="assets/icons.svg#icon-2"></use></svg><span>tools/callbacks</span></a><a href="#toolsintegrations"><svg class="tsd-kind-icon" viewBox="0 0 24 24" aria-label="Module"><use href="assets/icons.svg#icon-2"></use></svg><span>tools/integrations</span></a><a href="#toolsnetwork"><svg class="tsd-kind-icon" viewBox="0 0 24 24" aria-label="Module"><use href="assets/icons.svg#icon-2"></use></svg><span>tools/network</span></a><a href="#toolsplot"><svg class="tsd-kind-icon" viewBox="0 0 24 24" aria-label="Module"><use href="assets/icons.svg#icon-2"></use></svg><span>tools/plot</span></a><a href="#toolsstore"><svg class="tsd-kind-icon" viewBox="0 0 24 24" aria-label="Module"><use href="assets/icons.svg#icon-2"></use></svg><span>tools/store</span></a><a href="#toolstasks"><svg class="tsd-kind-icon" viewBox="0 0 24 24" aria-label="Module"><use href="assets/icons.svg#icon-2"></use></svg><span>tools/tasks</span></a><a href="#toolstwists"><svg class="tsd-kind-icon" viewBox="0 0 24 24" aria-label="Module"><use href="assets/icons.svg#icon-2"></use></svg><span>tools/twists</span></a><a href="#twist"><svg class="tsd-kind-icon" viewBox="0 0 24 24" aria-label="Module"><use href="assets/icons.svg#icon-2"></use></svg><span>twist</span></a><a href="#utilshash"><svg class="tsd-kind-icon" viewBox="0 0 24 24" aria-label="Module"><use href="assets/icons.svg#icon-2"></use></svg><span>utils/hash</span></a><a href="#utilstypes"><svg class="tsd-kind-icon" viewBox="0 0 24 24" aria-label="Module"><use href="assets/icons.svg#icon-2"></use></svg><span>utils/types</span></a></div></details></div></details></div><div class="site-menu"><nav id="tsd-sidebar-links" class="tsd-navigation"><a href="https://plot.day" class="tsd-nav-link">Plot</a><a href="https://github.com/plotday/plot" class="tsd-nav-link">GitHub</a><a href="https://www.npmjs.com/package/@plotday/twister" class="tsd-nav-link">NPM</a></nav><nav class="tsd-navigation"><a href="modules.html" class="current">Creating Plot Twists</a><ul class="tsd-small-nested-navigation" id="tsd-nav-container"><li>Loading...</li></ul></nav></div></div></div><footer><p class="tsd-generator">Generated using <a href="https://typedoc.org/" target="_blank">TypeDoc</a></p></footer><div class="overlay"></div></body></html>