@plotday/twister 0.20.0

package/bin/templates/README.template.md

@@ -0,0 +1,189 @@
+# {{displayName}} twist
+
+A Plot twist that [describe what your twist does].
+
+## Quick Start
+
+```bash
+# Install dependencies
+{{packageManager}} install
+
+# Lint your code
+{{packageManager}} lint
+
+# Deploy to Plot
+{{packageManager}} deploy
+```
+
+## Development
+
+### Project Structure
+
+```
+.
+├── src/
+│   └── index.ts      # Main twist implementation
+├── package.json      # twist metadata and dependencies
+├── tsconfig.json     # TypeScript configuration
+└── README.md         # This file
+```
+
+### twist Lifecycle
+
+Your twist implements two key lifecycle methods:
+
+#### `activate(priority: Pick<Priority, "id">)`
+
+Called when the twist is enabled for a priority. This is where you typically:
+- Request authentication from external services
+- Create initial setup activities
+- Initialize twist state
+
+#### `activity(activity: Activity)`
+
+Called when an activity is routed to this twist. Use this to:
+- Process incoming activities
+- Create new activities based on external events
+- Update existing activities
+
+### Using Tools
+
+Twists access functionality through tools. Declare tools in the `build` method:
+
+```typescript
+build(build: ToolBuilder) {
+  return {
+    plot: build(Plot),
+  };
+}
+// Store, Tasks, and Callbacks methods are available directly via this
+```
+
+#### Built-in Tools
+
+- **Plot**: Create, update, and delete activities
+- **Store**: Persist data across twist invocations
+- **Integrations**: Request OAuth authentication from external services
+- **Tasks**: Queue background tasks and batch operations
+- **Callbacks**: Create persistent function references for webhooks
+- **Network**: HTTP access permissions and webhook management
+
+#### External Tools
+
+Add external tool dependencies to `package.json`:
+
+```json
+{
+  "dependencies": {
+    "@plotday/twister": "workspace:^",
+    "@plotday/tool-google-calendar": "workspace:^"
+  }
+}
+```
+
+Then use them in your twist:
+
+```typescript
+import GoogleCalendarTool from "@plotday/tool-google-calendar";
+
+build(build: ToolBuilder) {
+  return {
+    googleCalendar: build(GoogleCalendarTool),
+  };
+}
+```
+
+### Activity Types
+
+Plot supports three activity types:
+
+- **ActivityType.Note**: Information without actionable requirements
+- **ActivityType.Task**: Actionable items that can be completed
+- **ActivityType.Event**: Scheduled occurrences with start/end times
+
+### State Management
+
+Use Store methods (available directly on twist and Tool classes) to persist data across twist invocations:
+
+```typescript
+// Save state
+await this.set("sync_token", token);
+
+// Load state
+const token = await this.get<string>("sync_token");
+```
+
+**Important**: twist instances are ephemeral. Always use Store methods for data that needs to persist.
+
+### Runtime Limitations
+
+**Important**: All twist and tool functions are executed in a sandboxed, ephemeral environment with limited resources:
+
+- **Memory is temporary**: Anything stored in memory (e.g. as a variable in the twist/tool object) is lost after the function completes. Use the Store tool instead. Only use memory for temporary caching.
+- **Limited CPU time**: Each execution has limited CPU time (typically 10 seconds) and memory (128MB)
+- **Use the Tasks tool**: Queue separate chunks of work with `this.run(callback)`
+- **Break long operations**: Split large operations into smaller batches that can be processed independently
+- **Store intermediate state**: Use the Store tool to persist state between batches
+- **Examples**: Syncing large datasets, processing many API calls, or performing batch operations
+
+#### Pattern for Long-Running Operations
+
+```typescript
+async startSync(calendarId: string): Promise<void> {
+  // Initialize state in Store (persists between executions)
+  await this.set(`sync_state_${calendarId}`, {
+    nextPageToken: null,
+    batchNumber: 1,
+  });
+
+  // Queue first batch using run method
+  const callback = await this.callback("syncBatch", { calendarId });
+  await this.run(callback);
+}
+
+async syncBatch(args: any, context: { calendarId: string }): Promise<void> {
+  // Load state from Store
+  const state = await this.get(`sync_state_${calendarId}`);
+
+  // Process one batch
+  const result = await processBatch(state.nextPageToken);
+
+  if (result.hasMore) {
+    // Update state and queue next batch
+    await this.set(`sync_state_${context.calendarId}`, {
+      nextPageToken: result.nextPageToken,
+      batchNumber: state.batchNumber + 1,
+    });
+
+    const nextCallback = await this.callback("syncBatch", context);
+    await this.run(nextCallback);
+  } else {
+    // Cleanup when done
+    await this.clear(`sync_state_${context.calendarId}`);
+  }
+}
+```
+
+## Testing
+
+Test your twist locally before deploying:
+
+```bash
+# Run linter
+{{packageManager}} lint
+
+# Deploy to your Plot account
+{{packageManager}} deploy
+```
+
+## Resources
+
+- [Plot twist Builder Documentation](https://github.com/plotday/plot)
+- [twist Examples](https://github.com/plotday/plot/tree/main/libs/twist/examples)
+- [Tool Documentation](https://github.com/plotday/plot/tree/main/libs/twist/tools)
+
+## Support
+
+For help or questions:
+- Open an issue on GitHub
+- Contact support@plot.day

package/bin/utils/bundle.js

@@ -0,0 +1,106 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.bundleTwist = bundleTwist;
+const esbuild = __importStar(require("esbuild"));
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+/**
+ * Bundles a Plot twist using esbuild.
+ *
+ * This function is shared between the build and deploy commands to ensure
+ * consistent bundling behavior.
+ *
+ * @param twistPath - Absolute path to the twist directory
+ * @param options - Optional bundling configuration
+ * @returns Promise resolving to the bundled code and any warnings
+ * @throws Error if bundling fails
+ */
+async function bundleTwist(twistPath, options = {}) {
+    const { minify = false, sourcemap = true } = options;
+    // Validate twist path exists
+    if (!fs.existsSync(twistPath)) {
+        throw new Error(`Twist directory not found: ${twistPath}`);
+    }
+    // Check for entry point
+    const entryPoint = path.join(twistPath, "src", "index.ts");
+    if (!fs.existsSync(entryPoint)) {
+        throw new Error("src/index.ts not found. Your twist needs an entry point at src/index.ts");
+    }
+    // Create build directory
+    const buildDir = path.join(twistPath, "build");
+    if (fs.existsSync(buildDir)) {
+        fs.rmSync(buildDir, { recursive: true });
+    }
+    fs.mkdirSync(buildDir, { recursive: true });
+    // Bundle with esbuild
+    const result = await esbuild.build({
+        entryPoints: [entryPoint],
+        bundle: true,
+        format: "esm",
+        platform: "browser",
+        target: "esnext",
+        outfile: path.join(buildDir, "index.js"),
+        sourcemap,
+        minify,
+        logLevel: "silent",
+    });
+    // Check for errors
+    if (result.errors.length > 0) {
+        const errorMessages = result.errors
+            .map((err) => `${err.location?.file}:${err.location?.line} - ${err.text}`)
+            .join("\n");
+        throw new Error(`Build failed with errors:\n${errorMessages}`);
+    }
+    // Collect warnings
+    const warnings = result.warnings.map((warn) => `${warn.location?.file}:${warn.location?.line} - ${warn.text}`);
+    // Read the bundled code
+    const bundlePath = path.join(buildDir, "index.js");
+    const code = fs.readFileSync(bundlePath, "utf-8");
+    // Read the sourcemap if it exists
+    let sourcemapContent;
+    if (sourcemap) {
+        const sourcemapPath = path.join(buildDir, "index.js.map");
+        if (fs.existsSync(sourcemapPath)) {
+            sourcemapContent = fs.readFileSync(sourcemapPath, "utf-8");
+        }
+    }
+    return {
+        code,
+        sourcemap: sourcemapContent,
+        warnings,
+    };
+}
+//# sourceMappingURL=bundle.js.map

package/bin/utils/bundle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bundle.js","sourceRoot":"","sources":["../../cli/utils/bundle.ts"],"names":[],"mappings":"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"}

package/bin/utils/output.js

@@ -0,0 +1,133 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.colors = void 0;
+exports.success = success;
+exports.error = error;
+exports.info = info;
+exports.warning = warning;
+exports.section = section;
+exports.progress = progress;
+exports.listItem = listItem;
+exports.keyValue = keyValue;
+exports.nextSteps = nextSteps;
+exports.header = header;
+exports.plain = plain;
+exports.blank = blank;
+exports.cliHeader = cliHeader;
+const chalk_1 = __importDefault(require("chalk"));
+// Plot brand colors
+exports.colors = {
+    // Brand green from logo
+    brand: (text) => chalk_1.default.hex("#2B9F7A")(text),
+    // Semantic colors
+    success: (text) => chalk_1.default.hex("#2B9F7A")(text),
+    error: (text) => chalk_1.default.red(text),
+    warning: (text) => chalk_1.default.yellow(text),
+    info: (text) => chalk_1.default.cyan(text),
+    // Style helpers
+    dim: (text) => chalk_1.default.dim(text),
+    bold: (text) => chalk_1.default.bold(text),
+    underline: (text) => chalk_1.default.underline(text),
+};
+/**
+ * Print a success message with checkmark
+ */
+function success(message, details) {
+    console.log(exports.colors.success("✓") + " " + message);
+    if (details) {
+        details.forEach((detail) => console.log("  " + exports.colors.dim(detail)));
+    }
+}
+/**
+ * Print an error message with X mark
+ */
+function error(message, details) {
+    console.log(exports.colors.error("✗") + " " + message);
+    if (details) {
+        console.log("  " + exports.colors.dim(details));
+    }
+}
+/**
+ * Print an info message
+ */
+function info(message, details) {
+    console.log(exports.colors.info("ℹ") + " " + message);
+    if (details) {
+        details.forEach((detail) => console.log("  " + exports.colors.dim(detail)));
+    }
+}
+/**
+ * Print a warning message
+ */
+function warning(message, details) {
+    console.log(exports.colors.warning("⚠") + " " + message);
+    if (details) {
+        details.forEach((detail) => console.log("  " + exports.colors.dim(detail)));
+    }
+}
+/**
+ * Print a section header
+ */
+function section(title) {
+    console.log("\n" + exports.colors.bold(title));
+}
+/**
+ * Print a progress message
+ */
+function progress(message) {
+    console.log(exports.colors.brand("●") + " " + message);
+}
+/**
+ * Print a list item
+ */
+function listItem(item) {
+    console.log("  " + exports.colors.dim("•") + " " + item);
+}
+/**
+ * Print a key-value pair
+ */
+function keyValue(key, value) {
+    console.log("  " + exports.colors.dim(key + ":") + " " + value);
+}
+/**
+ * Print next steps section
+ */
+function nextSteps(steps) {
+    section("Next steps");
+    steps.forEach((step) => {
+        console.log("  " + exports.colors.brand("›") + " " + step);
+    });
+}
+/**
+ * Print a subtle branded header
+ */
+function header(text) {
+    console.log("\n" + exports.colors.brand("━".repeat(50)));
+    console.log(exports.colors.bold("  " + text));
+    console.log(exports.colors.brand("━".repeat(50)) + "\n");
+}
+/**
+ * Print a simple message without formatting
+ */
+function plain(message) {
+    console.log(message);
+}
+/**
+ * Print a blank line
+ */
+function blank() {
+    console.log();
+}
+/**
+ * Print the CLI header with version
+ */
+function cliHeader(version) {
+    const title = "🌪️ Plot";
+    const subtitle = `Twister v${version}`;
+    const underline = exports.colors.brand("─".repeat(title.length + subtitle.length + 1));
+    console.log(`\n${title} ${exports.colors.dim(subtitle)}\n${underline}`);
+}
+//# sourceMappingURL=output.js.map

package/bin/utils/output.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"output.js","sourceRoot":"","sources":["../../cli/utils/output.ts"],"names":[],"mappings":"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"}

package/bin/utils/packageManager.js

@@ -0,0 +1,65 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.detectPackageManager = detectPackageManager;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+/**
+ * Detects the package manager being used
+ * Checks for npm_config_user_twist and lock files
+ */
+function detectPackageManager() {
+    // Check npm_config_user_twist first (set by npm, yarn, pnpm)
+    const userTwist = process.env.npm_config_user_twist;
+    if (userTwist) {
+        if (userTwist.includes("yarn"))
+            return "yarn";
+        if (userTwist.includes("pnpm"))
+            return "pnpm";
+        if (userTwist.includes("npm"))
+            return "npm";
+    }
+    // Check for lock files in current directory
+    const cwd = process.cwd();
+    if (fs.existsSync(path.join(cwd, "pnpm-lock.yaml")))
+        return "pnpm";
+    if (fs.existsSync(path.join(cwd, "yarn.lock")))
+        return "yarn";
+    if (fs.existsSync(path.join(cwd, "package-lock.json")))
+        return "npm";
+    // Default to npm
+    return "npm";
+}
+//# sourceMappingURL=packageManager.js.map

package/bin/utils/packageManager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"packageManager.js","sourceRoot":"","sources":["../../cli/utils/packageManager.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAOA,oDAiBC;AAxBD,uCAAyB;AACzB,2CAA6B;AAE7B;;;GAGG;AACH,SAAgB,oBAAoB;IAClC,6DAA6D;IAC7D,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,qBAAqB,CAAC;IACpD,IAAI,SAAS,EAAE,CAAC;QACd,IAAI,SAAS,CAAC,QAAQ,CAAC,MAAM,CAAC;YAAE,OAAO,MAAM,CAAC;QAC9C,IAAI,SAAS,CAAC,QAAQ,CAAC,MAAM,CAAC;YAAE,OAAO,MAAM,CAAC;QAC9C,IAAI,SAAS,CAAC,QAAQ,CAAC,KAAK,CAAC;YAAE,OAAO,KAAK,CAAC;IAC9C,CAAC;IAED,4CAA4C;IAC5C,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IAC1B,IAAI,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,gBAAgB,CAAC,CAAC;QAAE,OAAO,MAAM,CAAC;IACnE,IAAI,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC;QAAE,OAAO,MAAM,CAAC;IAC9D,IAAI,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,mBAAmB,CAAC,CAAC;QAAE,OAAO,KAAK,CAAC;IAErE,iBAAiB;IACjB,OAAO,KAAK,CAAC;AACf,CAAC"}

package/bin/utils/sse.js

@@ -0,0 +1,100 @@
+"use strict";
+/**
+ * Server-Sent Events (SSE) client utilities
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handleSSEStream = handleSSEStream;
+/**
+ * Parse and handle SSE response stream
+ */
+async function handleSSEStream(response, handlers) {
+    if (!response.body) {
+        throw new Error("Response has no body");
+    }
+    const reader = response.body.getReader();
+    const decoder = new TextDecoder();
+    let buffer = "";
+    let result = null;
+    try {
+        while (true) {
+            const { done, value } = await reader.read();
+            if (done) {
+                break;
+            }
+            // Decode chunk and add to buffer
+            buffer += decoder.decode(value, { stream: true });
+            // Process complete messages in buffer
+            const lines = buffer.split("\n");
+            // Keep incomplete message in buffer
+            buffer = lines.pop() || "";
+            let currentEvent = {};
+            for (const line of lines) {
+                // Empty line marks end of event
+                if (line.trim() === "") {
+                    if (currentEvent.event && currentEvent.data !== undefined) {
+                        // Parse data if it's JSON
+                        let parsedData = currentEvent.data;
+                        try {
+                            parsedData = JSON.parse(currentEvent.data);
+                        }
+                        catch {
+                            // Not JSON, use as-is
+                        }
+                        // Handle event based on type
+                        switch (currentEvent.event) {
+                            case "progress":
+                                handlers.onProgress?.(parsedData.message);
+                                break;
+                            case "result":
+                                result = parsedData;
+                                handlers.onResult?.(parsedData);
+                                break;
+                            case "error":
+                                handlers.onError?.(parsedData.error);
+                                throw new Error(parsedData.error);
+                            default:
+                                // Handle custom events via onEvent handler
+                                if (handlers.onEvent) {
+                                    handlers.onEvent(currentEvent.event, parsedData);
+                                }
+                        }
+                    }
+                    // Reset for next event
+                    currentEvent = {};
+                    continue;
+                }
+                // Skip comment lines (lines starting with ":")
+                if (line.startsWith(":")) {
+                    continue;
+                }
+                // Parse SSE field
+                const colonIndex = line.indexOf(":");
+                if (colonIndex === -1) {
+                    continue;
+                }
+                const field = line.slice(0, colonIndex);
+                let value = line.slice(colonIndex + 1);
+                // Trim leading space from value (SSE spec)
+                if (value.startsWith(" ")) {
+                    value = value.slice(1);
+                }
+                switch (field) {
+                    case "event":
+                        currentEvent.event = value;
+                        break;
+                    case "data":
+                        currentEvent.data = value;
+                        break;
+                    case "id":
+                        currentEvent.id = value;
+                        break;
+                }
+            }
+        }
+        return result;
+    }
+    finally {
+        reader.releaseLock();
+    }
+}
+//# sourceMappingURL=sse.js.map

package/bin/utils/sse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sse.js","sourceRoot":"","sources":["../../cli/utils/sse.ts"],"names":[],"mappings":"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"}