@plotday/twister 0.20.0

package/dist/twist.d.ts

@@ -0,0 +1,204 @@
+import { type Priority } from "./plot";
+import { type ITool } from "./tool";
+import type { Callback } from "./tools/callbacks";
+import type { InferTools, ToolBuilder, ToolShed } from "./utils/types";
+/**
+ * Base class for all twists.
+ *
+ * Twists are activated in a Plot priority and have access to that priority and all
+ * its descendants.
+ *
+ * Override build() to declare tool dependencies and lifecycle methods to handle events.
+ *
+ * @example
+ * ```typescript
+ * class FlatteringTwist extends Twist<FlatteringTwist> {
+ *   build(build: ToolBuilder) {
+ *     return {
+ *       plot: build(Plot),
+ *     };
+ *   }
+ *
+ *   async activate(priority: Pick<Priority, "id">) {
+ *     // Initialize twist for the given priority
+ *     await this.tools.plot.createActivity({
+ *       type: ActivityType.Note,
+ *       note: "Hello, good looking!",
+ *     });
+ *   }
+ * }
+ * ```
+ */
+export declare abstract class Twist<TSelf> {
+    protected id: string;
+    private toolShed;
+    constructor(id: string, toolShed: ToolShed);
+    /**
+     * Gets the initialized tools for this twist.
+     * @throws Error if called before initialization is complete
+     */
+    protected get tools(): InferTools<TSelf>;
+    /**
+     * Declares tool dependencies for this twist.
+     * Return an object mapping tool names to build() promises.
+     *
+     * @param build - The build function to use for declaring dependencies
+     * @returns Object mapping tool names to tool promises
+     *
+     * @example
+     * ```typescript
+     * build(build: ToolBuilder) {
+     *   return {
+     *     plot: build(Plot),
+     *     calendar: build(GoogleCalendar, { apiKey: "..." }),
+     *   };
+     * }
+     * ```
+     */
+    abstract build(build: ToolBuilder): Record<string, Promise<ITool>>;
+    /**
+     * Creates a persistent callback to a method on this twist.
+     *
+     * ExtraArgs are strongly typed to match the method's signature after the first argument.
+     *
+     * @param fn - The method to callback
+     * @param extraArgs - Additional arguments to pass (type-checked, must be serializable)
+     * @returns Promise resolving to a persistent callback token
+     *
+     * @example
+     * ```typescript
+     * const callback = await this.callback(this.onWebhook, "calendar", 123);
+     * ```
+     */
+    protected callback(fn: Function, ...extraArgs: any[]): Promise<Callback>;
+    /**
+     * Deletes a specific callback by its token.
+     *
+     * @param token - The callback token to delete
+     * @returns Promise that resolves when the callback is deleted
+     */
+    protected deleteCallback(token: Callback): Promise<void>;
+    /**
+     * Deletes all callbacks for this twist.
+     *
+     * @returns Promise that resolves when all callbacks are deleted
+     */
+    protected deleteAllCallbacks(): Promise<void>;
+    /**
+     * Executes a callback by its token.
+     *
+     * @param token - The callback token to execute
+     * @param args - Optional arguments to pass to the callback
+     * @returns Promise resolving to the callback result
+     */
+    protected run(token: Callback, ...args: []): Promise<any>;
+    /**
+     * Retrieves a value from persistent storage by key.
+     *
+     * @template T - The expected type of the stored value
+     * @param key - The storage key to retrieve
+     * @returns Promise resolving to the stored value or null
+     */
+    protected get<T>(key: string): Promise<T | null>;
+    /**
+     * Stores a value in persistent storage.
+     *
+     * **Important**: Values must be JSON-serializable. Functions, Symbols, and undefined values
+     * cannot be stored directly.
+     *
+     * **For function references**: Use callbacks instead of storing functions directly.
+     *
+     * @example
+     * ```typescript
+     * // ❌ WRONG: Cannot store functions directly
+     * await this.set("handler", this.myHandler);
+     *
+     * // ✅ CORRECT: Create a callback token first
+     * const token = await this.callback(this.myHandler, "arg1", "arg2");
+     * await this.set("handler_token", token);
+     *
+     * // Later, execute the callback
+     * const token = await this.get<string>("handler_token");
+     * await this.run(token, args);
+     * ```
+     *
+     * @template T - The type of value being stored
+     * @param key - The storage key to use
+     * @param value - The value to store (must be JSON-serializable)
+     * @returns Promise that resolves when the value is stored
+     */
+    protected set<T>(key: string, value: T): Promise<void>;
+    /**
+     * Removes a specific key from persistent storage.
+     *
+     * @param key - The storage key to remove
+     * @returns Promise that resolves when the key is removed
+     */
+    protected clear(key: string): Promise<void>;
+    /**
+     * Removes all keys from this twist's storage.
+     *
+     * @returns Promise that resolves when all keys are removed
+     */
+    protected clearAll(): Promise<void>;
+    /**
+     * Queues a callback to execute in a separate worker context.
+     *
+     * @param callback - The callback token created with `this.callback()`
+     * @param options - Optional configuration for the execution
+     * @param options.runAt - If provided, schedules execution at this time; otherwise runs immediately
+     * @returns Promise resolving to a cancellation token (only for scheduled executions)
+     */
+    protected runTask(callback: Callback, options?: {
+        runAt?: Date;
+    }): Promise<string | void>;
+    /**
+     * Cancels a previously scheduled execution.
+     *
+     * @param token - The cancellation token returned by runTask() with runAt option
+     * @returns Promise that resolves when the cancellation is processed
+     */
+    protected cancelTask(token: string): Promise<void>;
+    /**
+     * Cancels all scheduled executions for this twist.
+     *
+     * @returns Promise that resolves when all cancellations are processed
+     */
+    protected cancelAllTasks(): Promise<void>;
+    /**
+     * Called when the twist is activated for a specific priority.
+     *
+     * This method should contain initialization logic such as setting up
+     * initial activities, configuring webhooks, or establishing external connections.
+     *
+     * @param priority - The priority context containing the priority ID
+     * @returns Promise that resolves when activation is complete
+     */
+    activate(priority: Pick<Priority, "id">): Promise<void>;
+    /**
+     * Called when a new version of the twist is deployed to an existing priority.
+     *
+     * This method should contain migration logic for updating old data structures
+     * or setting up new resources that weren't needed by the previous version.
+     * It is called with the new version for each active priorityTwist.
+     *
+     * @returns Promise that resolves when upgrade is complete
+     */
+    upgrade(): Promise<void>;
+    /**
+     * Called when the twist is removed from a priority.
+     *
+     * This method should contain cleanup logic such as removing webhooks,
+     * cleaning up external resources, or performing final data operations.
+     *
+     * @returns Promise that resolves when deactivation is complete
+     */
+    deactivate(): Promise<void>;
+    /**
+     * Waits for tool initialization to complete.
+     * Called automatically by the entrypoint before lifecycle methods.
+     * @internal
+     */
+    waitForReady(): Promise<void>;
+}
+//# sourceMappingURL=twist.d.ts.map

package/dist/twist.d.ts.map

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

package/dist/twist.js

@@ -0,0 +1,216 @@
+/**
+ * Base class for all twists.
+ *
+ * Twists are activated in a Plot priority and have access to that priority and all
+ * its descendants.
+ *
+ * Override build() to declare tool dependencies and lifecycle methods to handle events.
+ *
+ * @example
+ * ```typescript
+ * class FlatteringTwist extends Twist<FlatteringTwist> {
+ *   build(build: ToolBuilder) {
+ *     return {
+ *       plot: build(Plot),
+ *     };
+ *   }
+ *
+ *   async activate(priority: Pick<Priority, "id">) {
+ *     // Initialize twist for the given priority
+ *     await this.tools.plot.createActivity({
+ *       type: ActivityType.Note,
+ *       note: "Hello, good looking!",
+ *     });
+ *   }
+ * }
+ * ```
+ */
+export class Twist {
+    id;
+    toolShed;
+    constructor(id, toolShed) {
+        this.id = id;
+        this.toolShed = toolShed;
+    }
+    /**
+     * Gets the initialized tools for this twist.
+     * @throws Error if called before initialization is complete
+     */
+    get tools() {
+        return this.toolShed.getTools();
+    }
+    /**
+     * Creates a persistent callback to a method on this twist.
+     *
+     * ExtraArgs are strongly typed to match the method's signature after the first argument.
+     *
+     * @param fn - The method to callback
+     * @param extraArgs - Additional arguments to pass (type-checked, must be serializable)
+     * @returns Promise resolving to a persistent callback token
+     *
+     * @example
+     * ```typescript
+     * const callback = await this.callback(this.onWebhook, "calendar", 123);
+     * ```
+     */
+    async callback(fn, ...extraArgs) {
+        return this.tools.callbacks.create(fn, ...extraArgs);
+    }
+    /**
+     * Deletes a specific callback by its token.
+     *
+     * @param token - The callback token to delete
+     * @returns Promise that resolves when the callback is deleted
+     */
+    async deleteCallback(token) {
+        return this.tools.callbacks.delete(token);
+    }
+    /**
+     * Deletes all callbacks for this twist.
+     *
+     * @returns Promise that resolves when all callbacks are deleted
+     */
+    async deleteAllCallbacks() {
+        return this.tools.callbacks.deleteAll();
+    }
+    /**
+     * Executes a callback by its token.
+     *
+     * @param token - The callback token to execute
+     * @param args - Optional arguments to pass to the callback
+     * @returns Promise resolving to the callback result
+     */
+    async run(token, ...args) {
+        return this.tools.callbacks.run(token, ...args);
+    }
+    /**
+     * Retrieves a value from persistent storage by key.
+     *
+     * @template T - The expected type of the stored value
+     * @param key - The storage key to retrieve
+     * @returns Promise resolving to the stored value or null
+     */
+    async get(key) {
+        return this.tools.store.get(key);
+    }
+    /**
+     * Stores a value in persistent storage.
+     *
+     * **Important**: Values must be JSON-serializable. Functions, Symbols, and undefined values
+     * cannot be stored directly.
+     *
+     * **For function references**: Use callbacks instead of storing functions directly.
+     *
+     * @example
+     * ```typescript
+     * // ❌ WRONG: Cannot store functions directly
+     * await this.set("handler", this.myHandler);
+     *
+     * // ✅ CORRECT: Create a callback token first
+     * const token = await this.callback(this.myHandler, "arg1", "arg2");
+     * await this.set("handler_token", token);
+     *
+     * // Later, execute the callback
+     * const token = await this.get<string>("handler_token");
+     * await this.run(token, args);
+     * ```
+     *
+     * @template T - The type of value being stored
+     * @param key - The storage key to use
+     * @param value - The value to store (must be JSON-serializable)
+     * @returns Promise that resolves when the value is stored
+     */
+    async set(key, value) {
+        return this.tools.store.set(key, value);
+    }
+    /**
+     * Removes a specific key from persistent storage.
+     *
+     * @param key - The storage key to remove
+     * @returns Promise that resolves when the key is removed
+     */
+    async clear(key) {
+        return this.tools.store.clear(key);
+    }
+    /**
+     * Removes all keys from this twist's storage.
+     *
+     * @returns Promise that resolves when all keys are removed
+     */
+    async clearAll() {
+        return this.tools.store.clearAll();
+    }
+    /**
+     * Queues a callback to execute in a separate worker context.
+     *
+     * @param callback - The callback token created with `this.callback()`
+     * @param options - Optional configuration for the execution
+     * @param options.runAt - If provided, schedules execution at this time; otherwise runs immediately
+     * @returns Promise resolving to a cancellation token (only for scheduled executions)
+     */
+    async runTask(callback, options) {
+        return this.tools.tasks.runTask(callback, options);
+    }
+    /**
+     * Cancels a previously scheduled execution.
+     *
+     * @param token - The cancellation token returned by runTask() with runAt option
+     * @returns Promise that resolves when the cancellation is processed
+     */
+    async cancelTask(token) {
+        return this.tools.tasks.cancelTask(token);
+    }
+    /**
+     * Cancels all scheduled executions for this twist.
+     *
+     * @returns Promise that resolves when all cancellations are processed
+     */
+    async cancelAllTasks() {
+        return this.tools.tasks.cancelAllTasks();
+    }
+    /**
+     * Called when the twist is activated for a specific priority.
+     *
+     * This method should contain initialization logic such as setting up
+     * initial activities, configuring webhooks, or establishing external connections.
+     *
+     * @param priority - The priority context containing the priority ID
+     * @returns Promise that resolves when activation is complete
+     */
+    // eslint-disable-next-line @typescript-eslint/no-unused-vars
+    activate(priority) {
+        return Promise.resolve();
+    }
+    /**
+     * Called when a new version of the twist is deployed to an existing priority.
+     *
+     * This method should contain migration logic for updating old data structures
+     * or setting up new resources that weren't needed by the previous version.
+     * It is called with the new version for each active priorityTwist.
+     *
+     * @returns Promise that resolves when upgrade is complete
+     */
+    upgrade() {
+        return Promise.resolve();
+    }
+    /**
+     * Called when the twist is removed from a priority.
+     *
+     * This method should contain cleanup logic such as removing webhooks,
+     * cleaning up external resources, or performing final data operations.
+     *
+     * @returns Promise that resolves when deactivation is complete
+     */
+    deactivate() {
+        return Promise.resolve();
+    }
+    /**
+     * Waits for tool initialization to complete.
+     * Called automatically by the entrypoint before lifecycle methods.
+     * @internal
+     */
+    async waitForReady() {
+        await this.toolShed.waitForReady();
+    }
+}
+//# sourceMappingURL=twist.js.map

package/dist/twist.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"twist.js","sourceRoot":"","sources":["../src/twist.ts"],"names":[],"mappings":"AAKA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAM,OAAgB,KAAK;IACH;IAAoB;IAA1C,YAAsB,EAAU,EAAU,QAAkB;QAAtC,OAAE,GAAF,EAAE,CAAQ;QAAU,aAAQ,GAAR,QAAQ,CAAU;IAAG,CAAC;IAEhE;;;OAGG;IACH,IAAc,KAAK;QACjB,OAAO,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAqB,CAAC;IACrD,CAAC;IAqBD;;;;;;;;;;;;;OAaG;IACO,KAAK,CAAC,QAAQ,CACtB,EAAY,EACZ,GAAG,SAAgB;QAEnB,OAAO,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC,EAAS,EAAE,GAAG,SAAS,CAAC,CAAC;IAC9D,CAAC;IAED;;;;;OAKG;IACO,KAAK,CAAC,cAAc,CAAC,KAAe;QAC5C,OAAO,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAC5C,CAAC;IAED;;;;OAIG;IACO,KAAK,CAAC,kBAAkB;QAChC,OAAO,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,SAAS,EAAE,CAAC;IAC1C,CAAC;IAED;;;;;;OAMG;IACO,KAAK,CAAC,GAAG,CAAC,KAAe,EAAE,GAAG,IAAQ;QAC9C,OAAO,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,IAAI,CAAC,CAAC;IAClD,CAAC;IAED;;;;;;OAMG;IACO,KAAK,CAAC,GAAG,CAAI,GAAW;QAChC,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACnC,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;OA0BG;IACO,KAAK,CAAC,GAAG,CAAI,GAAW,EAAE,KAAQ;QAC1C,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IAC1C,CAAC;IAED;;;;;OAKG;IACO,KAAK,CAAC,KAAK,CAAC,GAAW;QAC/B,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACrC,CAAC;IAED;;;;OAIG;IACO,KAAK,CAAC,QAAQ;QACtB,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC;IACrC,CAAC;IAED;;;;;;;OAOG;IACO,KAAK,CAAC,OAAO,CACrB,QAAkB,EAClB,OAA0B;QAE1B,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IACrD,CAAC;IAED;;;;;OAKG;IACO,KAAK,CAAC,UAAU,CAAC,KAAa;QACtC,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;IAC5C,CAAC;IAED;;;;OAIG;IACO,KAAK,CAAC,cAAc;QAC5B,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,cAAc,EAAE,CAAC;IAC3C,CAAC;IAED;;;;;;;;OAQG;IACH,6DAA6D;IAC7D,QAAQ,CAAC,QAA8B;QACrC,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;IAC3B,CAAC;IAED;;;;;;;;OAQG;IACH,OAAO;QACL,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;IAC3B,CAAC;IAED;;;;;;;OAOG;IACH,UAAU;QACR,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;IAC3B,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,YAAY;QAChB,MAAM,IAAI,CAAC,QAAQ,CAAC,YAAY,EAAE,CAAC;IACrC,CAAC;CACF"}

package/dist/utils/types.d.ts

@@ -0,0 +1,91 @@
+/**
+ * Internal type utilities for SDK implementation.
+ *
+ * This file contains advanced TypeScript type utilities used internally
+ * by the SDK to provide type-safe APIs. Most developers don't need to
+ * reference these types directly - they work behind the scenes to power
+ * the Twist and Tool APIs.
+ *
+ * @internal
+ */
+import type { Callbacks } from "../tools/callbacks";
+import type { Store } from "../tools/store";
+import type { Tasks } from "../tools/tasks";
+/**
+ * Unwraps Promise types to their resolved values.
+ * Converts { foo: Promise<string> } to { foo: string }
+ */
+export type PromiseValues<T> = {
+    [K in keyof T]: T[K] extends Promise<infer U> ? U : T[K];
+};
+/**
+ * Extracts the return type from an instance build method.
+ */
+export type ExtractBuildReturn<T> = T extends {
+    build: (...args: any[]) => infer R;
+} ? R : {};
+/**
+ * Built-in tools available to all twists and tools.
+ */
+export type BuiltInTools = {
+    callbacks: Callbacks;
+    store: Store;
+    tasks: Tasks;
+};
+/**
+ * Infers the complete set of tools available to an twist or tool,
+ * combining tools declared in build with built-in tools.
+ */
+export type InferTools<T> = PromiseValues<ExtractBuildReturn<T>> & BuiltInTools;
+/**
+ * Infers the options type from a constructor's second parameter.
+ */
+export type InferOptions<T> = T extends {
+    Options: infer O;
+} ? O : unknown;
+/**
+ * Function type for building tool dependencies.
+ * Used in build methods to request tool instances.
+ */
+export type ToolBuilder = <TC extends abstract new (...args: any) => any>(ToolClass: TC, options?: InferOptions<TC>) => Promise<InstanceType<TC>>;
+/**
+ * Interface for managing tool initialization and lifecycle.
+ * Implemented by the twist runtime to provide tools to twists and tools.
+ */
+export interface ToolShed {
+    /**
+     * Build function for requesting tool dependencies
+     */
+    build: ToolBuilder;
+    /**
+     * Whether tools are ready (all promises resolved)
+     */
+    readonly ready: boolean;
+    /**
+     * Wait for all tool promises to resolve
+     */
+    waitForReady(): Promise<void>;
+    /**
+     * Get resolved tools (throws if not ready)
+     */
+    getTools<T>(): T;
+}
+/**
+ * Represents any non-function type.
+ */
+export type NonFunction = Exclude<unknown, (...args: any[]) => any>;
+/**
+ * Filters out function properties from a type, keeping only data properties.
+ * For arrays, keeps the array structure while filtering functions from elements.
+ */
+export type NoFunctions<T> = T extends (...args: any[]) => any ? never : T extends object ? {
+    [K in keyof T]: T[K] extends (...args: any[]) => any ? never : T[K];
+} : T;
+/**
+ * Extracts method names from a type that are functions.
+ * Used to type-check callback method references.
+ */
+export type CallbackMethods<T> = {
+    [K in keyof T]: T[K] extends (...args: any[]) => any ? K : never;
+}[keyof T];
+//# sourceMappingURL=types.d.ts.map

package/dist/utils/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/utils/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAC5C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAM5C;;;GAGG;AACH,MAAM,MAAM,aAAa,CAAC,CAAC,IAAI;KAC5B,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;CACzD,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,kBAAkB,CAAC,CAAC,IAAI,CAAC,SAAS;IAC5C,KAAK,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,MAAM,CAAC,CAAC;CACpC,GACG,CAAC,GACD,EAAE,CAAC;AAEP;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG;IACzB,SAAS,EAAE,SAAS,CAAC;IACrB,KAAK,EAAE,KAAK,CAAC;IACb,KAAK,EAAE,KAAK,CAAC;CACd,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,UAAU,CAAC,CAAC,IAAI,aAAa,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC,GAAG,YAAY,CAAC;AAEhF;;GAEG;AACH,MAAM,MAAM,YAAY,CAAC,CAAC,IAAI,CAAC,SAAS;IACtC,OAAO,EAAE,MAAM,CAAC,CAAC;CAClB,GACG,CAAC,GACD,OAAO,CAAC;AAEZ;;;GAGG;AACH,MAAM,MAAM,WAAW,GAAG,CAAC,EAAE,SAAS,QAAQ,MAAM,GAAG,IAAI,EAAE,GAAG,KAAK,GAAG,EACtE,SAAS,EAAE,EAAE,EACb,OAAO,CAAC,EAAE,YAAY,CAAC,EAAE,CAAC,KACvB,OAAO,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC,CAAC;AAE/B;;;GAGG;AACH,MAAM,WAAW,QAAQ;IACvB;;OAEG;IACH,KAAK,EAAE,WAAW,CAAC;IAEnB;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IAExB;;OAEG;IACH,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAE9B;;OAEG;IACH,QAAQ,CAAC,CAAC,KAAK,CAAC,CAAC;CAClB;AAMD;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,CAAC,CAAC;AAEpE;;;GAGG;AACH,MAAM,MAAM,WAAW,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,GAC1D,KAAK,GACL,CAAC,SAAS,MAAM,GAChB;KAAG,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,GAAG,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC;CAAE,GACvE,CAAC,CAAC;AAEN;;;GAGG;AACH,MAAM,MAAM,eAAe,CAAC,CAAC,IAAI;KAC9B,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,GAAG,CAAC,GAAG,KAAK;CACjE,CAAC,MAAM,CAAC,CAAC,CAAC"}

package/dist/utils/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/utils/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/utils/types.ts"],"names":[],"mappings":""}