@plotday/twister 0.20.0

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

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

package/dist/tools/ai.js

@@ -0,0 +1,104 @@
+import { ITool } from "..";
+/**
+ * Built-in tool for prompting Large Language Models (LLMs).
+ *
+ * The AI tool provides twists and tools with access to LLM capabilities
+ * for natural language processing, text generation, data extraction,
+ * and intelligent decision making within their workflows.
+ *
+ * **Features:**
+ * - Access to multiple AI providers (OpenAI, Anthropic, Google, Workers AI)
+ * - Multi-turn conversation support with `messages`
+ * - Tool calling with automatic execution
+ * - Structured output with Typebox schemas via `outputSchema`
+ * - Unified API across all models via Vercel AI SDK
+ * - Automatic response parsing and validation with full type inference
+ *
+ * @example
+ * ```typescript
+ * import { Type } from "typebox";
+ *
+ * class SmartEmailTool extends Tool {
+ *   private ai: AI;
+ *
+ *   constructor(id: string, tools: ToolBuilder) {
+ *     super();
+ *     this.ai = tools.get(AI);
+ *   }
+ *
+ *   async categorizeEmail(emailContent: string) {
+ *     // Define the output schema using Typebox
+ *     const schema = Type.Object({
+ *       category: Type.Union([
+ *         Type.Literal("work"),
+ *         Type.Literal("personal"),
+ *         Type.Literal("spam"),
+ *         Type.Literal("promotional")
+ *       ]),
+ *       confidence: Type.Number({ minimum: 0, maximum: 1 }),
+ *       reasoning: Type.Optional(Type.String())
+ *     });
+ *
+ *     const response = await this.ai.prompt({
+ *       model: { speed: "fast", cost: "medium" },
+ *       system: "Classify emails into categories: work, personal, spam, or promotional.",
+ *       prompt: `Categorize this email: ${emailContent}`,
+ *       outputSchema: schema
+ *     });
+ *
+ *     return response.output;
+ *   }
+ *
+ *   async generateResponse(emailContent: string) {
+ *     const response = await this.ai.prompt({
+ *       model: { speed: "fast", cost: "medium" },
+ *       system: "Generate professional email responses that are helpful and concise.",
+ *       prompt: `Write a response to: ${emailContent}`
+ *     });
+ *
+ *     return response.text;
+ *   }
+ * }
+ * ```
+ */
+export class AI extends ITool {
+}
+/**
+ * Supported AI models available through Cloudflare AI Gateway and Workers AI.
+ *
+ * Models are organized by provider:
+ * - **OpenAI**: Latest GPT models via AI Gateway
+ * - **Anthropic**: Claude models via AI Gateway (prefix with "anthropic/")
+ * - **Google**: Gemini models via AI Gateway (prefix with "google-ai-studio/")
+ * - **Workers AI**: Models running on Cloudflare's network (free/low cost)
+ */
+export var AIModel;
+(function (AIModel) {
+    // OpenAI models - Latest GPT and reasoning models
+    AIModel["GPT_5"] = "openai/gpt-5";
+    AIModel["GPT_5_PRO"] = "openai/gpt-5-pro";
+    AIModel["GPT_5_MINI"] = "openai/gpt-5-mini";
+    AIModel["GPT_5_NANO"] = "openai/gpt-5-nano";
+    AIModel["GPT_4O"] = "openai/gpt-4o";
+    AIModel["GPT_4O_MINI"] = "openai/gpt-4o-mini";
+    AIModel["O3"] = "openai/o3";
+    AIModel["O3_MINI"] = "openai/o3-mini";
+    // Anthropic models - Claude 4.x and 3.7 series
+    AIModel["CLAUDE_SONNET_45"] = "anthropic/claude-sonnet-4-5";
+    AIModel["CLAUDE_HAIKU_45"] = "anthropic/claude-haiku-4-5";
+    AIModel["CLAUDE_OPUS_41"] = "anthropic/claude-opus-4-1";
+    AIModel["CLAUDE_37_SONNET"] = "anthropic/claude-3-7-sonnet-latest";
+    // Google models - Gemini 2.x series
+    AIModel["GEMINI_25_PRO"] = "google/gemini-2.5-pro";
+    AIModel["GEMINI_25_FLASH"] = "google/gemini-2.5-flash";
+    AIModel["GEMINI_25_FLASH_LITE"] = "google/gemini-2.5-flash-lite";
+    AIModel["GEMINI_20_FLASH"] = "google/gemini-2.0-flash";
+    AIModel["GEMINI_20_FLASH_LITE"] = "google/gemini-2.0-flash-lite";
+    // Cloudflare Workers AI models - Free/low-cost models running on Cloudflare's network
+    AIModel["LLAMA_4_SCOUT_17B"] = "meta/llama-4-scout-17b-16e-instruct";
+    AIModel["LLAMA_33_70B"] = "meta/llama-3.3-70b-instruct-fp8-fast";
+    AIModel["LLAMA_31_8B"] = "meta/llama-3.1-8b-instruct-fp8";
+    AIModel["LLAMA_32_1B"] = "meta/llama-3.2-1b-instruct";
+    AIModel["DEEPSEEK_R1_32B"] = "deepseek-ai/deepseek-r1-distill-qwen-32b";
+})(AIModel || (AIModel = {}));
+//# sourceMappingURL=ai.js.map

package/dist/tools/ai.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai.js","sourceRoot":"","sources":["../../src/tools/ai.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,EAAE,MAAM,IAAI,CAAC;AAE3B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6DG;AACH,MAAM,OAAgB,EAAG,SAAQ,KAAK;CAgFrC;AA0DD;;;;;;;;GAQG;AACH,MAAM,CAAN,IAAY,OA8BX;AA9BD,WAAY,OAAO;IACjB,kDAAkD;IAClD,iCAAsB,CAAA;IACtB,yCAA8B,CAAA;IAC9B,2CAAgC,CAAA;IAChC,2CAAgC,CAAA;IAChC,mCAAwB,CAAA;IACxB,6CAAkC,CAAA;IAClC,2BAAgB,CAAA;IAChB,qCAA0B,CAAA;IAE1B,+CAA+C;IAC/C,2DAAgD,CAAA;IAChD,yDAA8C,CAAA;IAC9C,uDAA4C,CAAA;IAC5C,kEAAuD,CAAA;IAEvD,oCAAoC;IACpC,kDAAuC,CAAA;IACvC,sDAA2C,CAAA;IAC3C,gEAAqD,CAAA;IACrD,sDAA2C,CAAA;IAC3C,gEAAqD,CAAA;IAErD,sFAAsF;IACtF,oEAAyD,CAAA;IACzD,gEAAqD,CAAA;IACrD,yDAA8C,CAAA;IAC9C,qDAA0C,CAAA;IAC1C,uEAA4D,CAAA;AAC9D,CAAC,EA9BW,OAAO,KAAP,OAAO,QA8BlB"}

package/dist/tools/callbacks.d.ts

@@ -0,0 +1,96 @@
+import { ITool } from "..";
+import type { CallbackMethods, NoFunctions, NonFunction } from "../utils/types";
+export type { CallbackMethods, NoFunctions, NonFunction };
+/**
+ * Represents a callback token for persistent function references.
+ *
+ * Callbacks enable tools and twists to create persistent references to functions
+ * that can survive worker restarts and be invoked across different execution contexts.
+ *
+ * This is a branded string type to prevent mixing callback tokens with regular strings.
+ *
+ * @example
+ * ```typescript
+ * const callback = await this.callback(this.onCalendarSelected, "primary", "google");
+ * ```
+ */
+export type Callback = string & {
+    readonly __brand: "Callback";
+};
+/**
+ * Built-in tool for creating and managing persistent callback references.
+ *
+ * The Callbacks tool enables twists and tools to create callback links that persist
+ * across worker invocations and restarts. This is essential for webhook handlers,
+ * scheduled operations, and user interaction flows that need to survive runtime
+ * boundaries.
+ *
+ * **Note:** Callback methods are also available directly on Twist and Tool classes
+ * via `this.callback()`, `this.deleteCallback()`, `this.deleteAllCallbacks()`, and
+ * `this.run()`. This is the recommended approach for most use cases.
+ *
+ * **When to use callbacks:**
+ * - Webhook handlers that need persistent function references
+ * - Scheduled operations that run after worker timeouts
+ * - User interaction links (ActivityLinkType.callback)
+ * - Cross-tool communication that survives restarts
+ *
+ * **Type Safety:**
+ * Callbacks are fully type-safe - extraArgs are type-checked against the function signature.
+ *
+ * @example
+ * ```typescript
+ * class MyTool extends Tool {
+ *   async setupWebhook() {
+ *     // Using built-in callback method (recommended)
+ *     const callback = await this.callback(this.handleWebhook, "calendar");
+ *     return `https://api.plot.day/webhook/${callback}`;
+ *   }
+ *
+ *   async handleWebhook(data: any, webhookType: string) {
+ *     console.log("Webhook received:", data, webhookType);
+ *   }
+ * }
+ * ```
+ */
+export declare abstract class Callbacks extends ITool {
+    /**
+     * Creates a persistent callback to a method on the current class.
+     *
+     * @param fn - The function to callback
+     * @param extraArgs - Additional arguments to pass to the function (must be serializable)
+     * @returns Promise resolving to a persistent callback token
+     */
+    abstract create(fn: Function, ...extraArgs: any[]): Promise<Callback>;
+    /**
+     * Creates a persistent callback to a function from the parent twist/tool.
+     * Use this when the callback function is passed in from outside this class.
+     *
+     * @param fn - The function to callback
+     * @param extraArgs - Additional arguments to pass to the function (must be serializable, validated at runtime)
+     * @returns Promise resolving to a persistent callback token
+     */
+    abstract createFromParent(fn: Function, ...extraArgs: any[]): Promise<Callback>;
+    /**
+     * Deletes a specific callback by its token.
+     *
+     * @param callback - The callback token to delete
+     * @returns Promise that resolves when the callback is deleted
+     */
+    abstract delete(callback: Callback): Promise<void>;
+    /**
+     * Deletes all callbacks for the tool's parent.
+     *
+     * @returns Promise that resolves when all callbacks are deleted
+     */
+    abstract deleteAll(): Promise<void>;
+    /**
+     * Executes a callback by its token.
+     *
+     * @param callback - The callback token returned by create()
+     * @param args - Optional arguments to pass to the callback function
+     * @returns Promise resolving to the callback result
+     */
+    abstract run<T = unknown>(callback: Callback, ...args: any[]): Promise<T>;
+}
+//# sourceMappingURL=callbacks.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"callbacks.d.ts","sourceRoot":"","sources":["../../src/tools/callbacks.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,IAAI,CAAC;AAC3B,OAAO,KAAK,EAAE,eAAe,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAGhF,YAAY,EAAE,eAAe,EAAE,WAAW,EAAE,WAAW,EAAE,CAAC;AAE1D;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG;IAAE,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAA;CAAE,CAAC;AAEjE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,8BAAsB,SAAU,SAAQ,KAAK;IAC3C;;;;;;OAMG;IAEH,QAAQ,CAAC,MAAM,CACb,EAAE,EAAE,QAAQ,EACZ,GAAG,SAAS,EAAE,GAAG,EAAE,GAClB,OAAO,CAAC,QAAQ,CAAC;IAEpB;;;;;;;OAOG;IAEH,QAAQ,CAAC,gBAAgB,CACvB,EAAE,EAAE,QAAQ,EACZ,GAAG,SAAS,EAAE,GAAG,EAAE,GAClB,OAAO,CAAC,QAAQ,CAAC;IAEpB;;;;;OAKG;IAEH,QAAQ,CAAC,MAAM,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAElD;;;;OAIG;IACH,QAAQ,CAAC,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAEnC;;;;;;OAMG;IAEH,QAAQ,CAAC,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,OAAO,CAAC,CAAC,CAAC;CAC1E"}

package/dist/tools/callbacks.js

@@ -0,0 +1,40 @@
+import { ITool } from "..";
+/**
+ * Built-in tool for creating and managing persistent callback references.
+ *
+ * The Callbacks tool enables twists and tools to create callback links that persist
+ * across worker invocations and restarts. This is essential for webhook handlers,
+ * scheduled operations, and user interaction flows that need to survive runtime
+ * boundaries.
+ *
+ * **Note:** Callback methods are also available directly on Twist and Tool classes
+ * via `this.callback()`, `this.deleteCallback()`, `this.deleteAllCallbacks()`, and
+ * `this.run()`. This is the recommended approach for most use cases.
+ *
+ * **When to use callbacks:**
+ * - Webhook handlers that need persistent function references
+ * - Scheduled operations that run after worker timeouts
+ * - User interaction links (ActivityLinkType.callback)
+ * - Cross-tool communication that survives restarts
+ *
+ * **Type Safety:**
+ * Callbacks are fully type-safe - extraArgs are type-checked against the function signature.
+ *
+ * @example
+ * ```typescript
+ * class MyTool extends Tool {
+ *   async setupWebhook() {
+ *     // Using built-in callback method (recommended)
+ *     const callback = await this.callback(this.handleWebhook, "calendar");
+ *     return `https://api.plot.day/webhook/${callback}`;
+ *   }
+ *
+ *   async handleWebhook(data: any, webhookType: string) {
+ *     console.log("Webhook received:", data, webhookType);
+ *   }
+ * }
+ * ```
+ */
+export class Callbacks extends ITool {
+}
+//# sourceMappingURL=callbacks.js.map

package/dist/tools/callbacks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"callbacks.js","sourceRoot":"","sources":["../../src/tools/callbacks.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,IAAI,CAAC;AAqB3B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,MAAM,OAAgB,SAAU,SAAQ,KAAK;CAqD5C"}

package/dist/tools/index.d.ts

@@ -0,0 +1,9 @@
+export * from "./twists";
+export * from "./ai";
+export * from "./callbacks";
+export * from "./integrations";
+export * from "./network";
+export * from "./plot";
+export * from "./store";
+export * from "./tasks";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,MAAM,CAAC;AACrB,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,WAAW,CAAC;AAC1B,cAAc,QAAQ,CAAC;AACvB,cAAc,SAAS,CAAC;AACxB,cAAc,SAAS,CAAC"}

package/dist/tools/index.js

@@ -0,0 +1,9 @@
+export * from "./twists";
+export * from "./ai";
+export * from "./callbacks";
+export * from "./integrations";
+export * from "./network";
+export * from "./plot";
+export * from "./store";
+export * from "./tasks";
+//# sourceMappingURL=index.js.map

package/dist/tools/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,MAAM,CAAC;AACrB,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,WAAW,CAAC;AAC1B,cAAc,QAAQ,CAAC;AACvB,cAAc,SAAS,CAAC;AACxB,cAAc,SAAS,CAAC"}

package/dist/tools/integrations.d.ts

@@ -0,0 +1,142 @@
+import { type ActivityLink, ITool } from "..";
+import { type NoFunctions } from "./callbacks";
+/**
+ * Built-in tool for managing OAuth authentication flows.
+ *
+ * The Integrations tool provides a unified interface for requesting user authorization
+ * from external service providers like Google and Microsoft. It handles the
+ * OAuth flow creation, token management, and callback integration.
+ *
+ * @example
+ * ```typescript
+ * class CalendarTool extends Tool {
+ *   private auth: Integrations;
+ *
+ *   constructor(id: string, tools: ToolBuilder) {
+ *     super();
+ *     this.integrations = tools.get(Integrations);
+ *   }
+ *
+ *   async requestAuth() {
+ *     return await this.integrations.request({
+ *       provider: AuthProvider.Google,
+ *       level: AuthLevel.User,
+ *       scopes: ["https://www.googleapis.com/auth/calendar.readonly"]
+ *     }, {
+ *       functionName: "onAuthComplete",
+ *       context: { provider: "google" }
+ *     });
+ *   }
+ *
+ *   async onAuthComplete(authResult: Authorization, context: any) {
+ *     const authToken = await this.integrations.get(authResult);
+ *   }
+ * }
+ * ```
+ */
+export declare abstract class Integrations extends ITool {
+    /**
+     * Initiates an OAuth authentication flow.
+     *
+     * Creates an authentication link that users can click to authorize access
+     * to the specified provider with the requested scopes. When authorization
+     * completes, the callback will be invoked with the Authorization and any extraArgs.
+     *
+     * @param auth - Authentication configuration
+     * @param auth.provider - The OAuth provider to authenticate with
+     * @param auth.level - The authorization level (priority-scoped or user-scoped)
+     * @param auth.scopes - Array of OAuth scopes to request
+     * @param callback - Function receiving (authorization, ...extraArgs)
+     * @param extraArgs - Additional arguments to pass to the callback (type-checked, must be serializable)
+     * @returns Promise resolving to an ActivityLink for the auth flow
+     */
+    abstract request<TCallback extends (auth: Authorization, ...args: any[]) => any>(auth: {
+        provider: AuthProvider;
+        level: AuthLevel;
+        scopes: string[];
+    }, callback: TCallback, ...extraArgs: TCallback extends (auth: any, ...rest: infer R) => any ? NoFunctions<R> : []): Promise<ActivityLink>;
+    /**
+     * Retrieves an access token (refreshing it first if necessary).
+     *
+     * Returns null if the authorization is no longer valid or has been revoked.
+     *
+     * @param authorization - The authorization from the request callback
+     * @returns Promise resolving to the access token or null if no longer available
+     */
+    abstract get(authorization: Authorization): Promise<AuthToken | null>;
+}
+/**
+ * Enumeration of supported OAuth providers.
+ *
+ * Each provider has different OAuth endpoints, scopes, and token formats.
+ * The Integrations tool handles the provider-specific implementation details.
+ */
+export declare enum AuthProvider {
+    /** Google OAuth provider for Google Workspace services */
+    Google = "google",
+    /** Microsoft OAuth provider for Microsoft 365 services */
+    Microsoft = "microsoft",
+    /** Notion OAuth provider for Notion workspaces */
+    Notion = "notion",
+    /** Slack OAuth provider for Slack workspaces */
+    Slack = "slack",
+    /** Atlassian OAuth provider for Jira and Confluence */
+    Atlassian = "atlassian",
+    /** Linear OAuth provider for Linear workspaces */
+    Linear = "linear",
+    /** Monday.com OAuth provider */
+    Monday = "monday",
+    /** GitHub OAuth provider for GitHub repositories and organizations */
+    GitHub = "github",
+    /** Asana OAuth provider for Asana workspaces */
+    Asana = "asana",
+    /** HubSpot OAuth provider for HubSpot CRM */
+    HubSpot = "hubspot"
+}
+/**
+ * Enumeration of authorization levels for OAuth flows.
+ *
+ * Different levels determine the scope and storage of authentication tokens.
+ */
+export declare enum AuthLevel {
+    /** Priority-scoped authorization shared across twists in a priority */
+    Priority = "priority",
+    /** User-scoped authorization specific to individual users */
+    User = "user"
+}
+/**
+ * Represents authorization criteria for token lookup.
+ *
+ * Used to specify which authentication token to retrieve from storage
+ * based on provider, scopes, and authorization ID.
+ */
+export type Authorization = {
+    /** Unique identifier for this authorization */
+    id: string;
+    /** The OAuth provider this authorization is for */
+    provider: AuthProvider;
+    /** Array of OAuth scopes this authorization covers */
+    scopes: string[];
+};
+/**
+ * Represents a stored OAuth authentication token.
+ *
+ * Contains the actual access token and the scopes it was granted,
+ * which may be a subset of the originally requested scopes.
+ */
+export type AuthToken = {
+    /** The OAuth access token */
+    token: string;
+    /** Array of granted OAuth scopes */
+    scopes: string[];
+    /**
+     * Provider-specific metadata as key-value pairs.
+     *
+     * For Slack (AuthProvider.Slack):
+     * - authed_user_id: The authenticated user's Slack ID
+     * - bot_user_id: The bot user's Slack ID
+     * - team_name: The Slack workspace/team name
+     */
+    provider?: Record<string, string>;
+};
+//# sourceMappingURL=integrations.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"integrations.d.ts","sourceRoot":"","sources":["../../src/tools/integrations.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,YAAY,EAAE,KAAK,EAAE,MAAM,IAAI,CAAC;AAC9C,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,8BAAsB,YAAa,SAAQ,KAAK;IAC9C;;;;;;;;;;;;;;OAcG;IAEH,QAAQ,CAAC,OAAO,CACd,SAAS,SAAS,CAAC,IAAI,EAAE,aAAa,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,EAE9D,IAAI,EAAE;QACJ,QAAQ,EAAE,YAAY,CAAC;QACvB,KAAK,EAAE,SAAS,CAAC;QACjB,MAAM,EAAE,MAAM,EAAE,CAAC;KAClB,EACD,QAAQ,EAAE,SAAS,EACnB,GAAG,SAAS,EAAE,SAAS,SAAS,CAAC,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI,EAAE,MAAM,CAAC,KAAK,GAAG,GAChE,WAAW,CAAC,CAAC,CAAC,GACd,EAAE,GACL,OAAO,CAAC,YAAY,CAAC;IAExB;;;;;;;OAOG;IAEH,QAAQ,CAAC,GAAG,CAAC,aAAa,EAAE,aAAa,GAAG,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC;CACtE;AAED;;;;;GAKG;AACH,oBAAY,YAAY;IACtB,0DAA0D;IAC1D,MAAM,WAAW;IACjB,0DAA0D;IAC1D,SAAS,cAAc;IACvB,kDAAkD;IAClD,MAAM,WAAW;IACjB,gDAAgD;IAChD,KAAK,UAAU;IACf,uDAAuD;IACvD,SAAS,cAAc;IACvB,kDAAkD;IAClD,MAAM,WAAW;IACjB,gCAAgC;IAChC,MAAM,WAAW;IACjB,sEAAsE;IACtE,MAAM,WAAW;IACjB,gDAAgD;IAChD,KAAK,UAAU;IACf,6CAA6C;IAC7C,OAAO,YAAY;CACpB;AAED;;;;GAIG;AACH,oBAAY,SAAS;IACnB,uEAAuE;IACvE,QAAQ,aAAa;IACrB,6DAA6D;IAC7D,IAAI,SAAS;CACd;AAED;;;;;GAKG;AACH,MAAM,MAAM,aAAa,GAAG;IAC1B,+CAA+C;IAC/C,EAAE,EAAE,MAAM,CAAC;IACX,mDAAmD;IACnD,QAAQ,EAAE,YAAY,CAAC;IACvB,sDAAsD;IACtD,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB,CAAC;AAEF;;;;;GAKG;AACH,MAAM,MAAM,SAAS,GAAG;IACtB,6BAA6B;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,oCAAoC;IACpC,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB;;;;;;;OAOG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACnC,CAAC"}

package/dist/tools/integrations.js

@@ -0,0 +1,79 @@
+import { ITool } from "..";
+/**
+ * Built-in tool for managing OAuth authentication flows.
+ *
+ * The Integrations tool provides a unified interface for requesting user authorization
+ * from external service providers like Google and Microsoft. It handles the
+ * OAuth flow creation, token management, and callback integration.
+ *
+ * @example
+ * ```typescript
+ * class CalendarTool extends Tool {
+ *   private auth: Integrations;
+ *
+ *   constructor(id: string, tools: ToolBuilder) {
+ *     super();
+ *     this.integrations = tools.get(Integrations);
+ *   }
+ *
+ *   async requestAuth() {
+ *     return await this.integrations.request({
+ *       provider: AuthProvider.Google,
+ *       level: AuthLevel.User,
+ *       scopes: ["https://www.googleapis.com/auth/calendar.readonly"]
+ *     }, {
+ *       functionName: "onAuthComplete",
+ *       context: { provider: "google" }
+ *     });
+ *   }
+ *
+ *   async onAuthComplete(authResult: Authorization, context: any) {
+ *     const authToken = await this.integrations.get(authResult);
+ *   }
+ * }
+ * ```
+ */
+export class Integrations extends ITool {
+}
+/**
+ * Enumeration of supported OAuth providers.
+ *
+ * Each provider has different OAuth endpoints, scopes, and token formats.
+ * The Integrations tool handles the provider-specific implementation details.
+ */
+export var AuthProvider;
+(function (AuthProvider) {
+    /** Google OAuth provider for Google Workspace services */
+    AuthProvider["Google"] = "google";
+    /** Microsoft OAuth provider for Microsoft 365 services */
+    AuthProvider["Microsoft"] = "microsoft";
+    /** Notion OAuth provider for Notion workspaces */
+    AuthProvider["Notion"] = "notion";
+    /** Slack OAuth provider for Slack workspaces */
+    AuthProvider["Slack"] = "slack";
+    /** Atlassian OAuth provider for Jira and Confluence */
+    AuthProvider["Atlassian"] = "atlassian";
+    /** Linear OAuth provider for Linear workspaces */
+    AuthProvider["Linear"] = "linear";
+    /** Monday.com OAuth provider */
+    AuthProvider["Monday"] = "monday";
+    /** GitHub OAuth provider for GitHub repositories and organizations */
+    AuthProvider["GitHub"] = "github";
+    /** Asana OAuth provider for Asana workspaces */
+    AuthProvider["Asana"] = "asana";
+    /** HubSpot OAuth provider for HubSpot CRM */
+    AuthProvider["HubSpot"] = "hubspot";
+})(AuthProvider || (AuthProvider = {}));
+/**
+ * Enumeration of authorization levels for OAuth flows.
+ *
+ * Different levels determine the scope and storage of authentication tokens.
+ */
+export var AuthLevel;
+(function (AuthLevel) {
+    /** Priority-scoped authorization shared across twists in a priority */
+    AuthLevel["Priority"] = "priority";
+    /** User-scoped authorization specific to individual users */
+    AuthLevel["User"] = "user";
+})(AuthLevel || (AuthLevel = {}));
+//# sourceMappingURL=integrations.js.map

package/dist/tools/integrations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"integrations.js","sourceRoot":"","sources":["../../src/tools/integrations.ts"],"names":[],"mappings":"AAAA,OAAO,EAAqB,KAAK,EAAE,MAAM,IAAI,CAAC;AAG9C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,MAAM,OAAgB,YAAa,SAAQ,KAAK;CAyC/C;AAED;;;;;GAKG;AACH,MAAM,CAAN,IAAY,YAqBX;AArBD,WAAY,YAAY;IACtB,0DAA0D;IAC1D,iCAAiB,CAAA;IACjB,0DAA0D;IAC1D,uCAAuB,CAAA;IACvB,kDAAkD;IAClD,iCAAiB,CAAA;IACjB,gDAAgD;IAChD,+BAAe,CAAA;IACf,uDAAuD;IACvD,uCAAuB,CAAA;IACvB,kDAAkD;IAClD,iCAAiB,CAAA;IACjB,gCAAgC;IAChC,iCAAiB,CAAA;IACjB,sEAAsE;IACtE,iCAAiB,CAAA;IACjB,gDAAgD;IAChD,+BAAe,CAAA;IACf,6CAA6C;IAC7C,mCAAmB,CAAA;AACrB,CAAC,EArBW,YAAY,KAAZ,YAAY,QAqBvB;AAED;;;;GAIG;AACH,MAAM,CAAN,IAAY,SAKX;AALD,WAAY,SAAS;IACnB,uEAAuE;IACvE,kCAAqB,CAAA;IACrB,6DAA6D;IAC7D,0BAAa,CAAA;AACf,CAAC,EALW,SAAS,KAAT,SAAS,QAKpB"}