@portel/photon-core 1.0.1 → 1.1.0

package/dist/generator.d.ts

@@ -0,0 +1,205 @@
+/**
+ * Generator-based Tool Execution
+ *
+ * Enables photon tools to use generator functions with `yield` for:
+ * - User prompts (text, password, confirm, select)
+ * - Progress updates
+ * - Streaming responses
+ * - Multi-step wizards
+ *
+ * The runtime handles yields appropriately based on the protocol:
+ * - REST: Extract yields as optional parameters
+ * - WebSocket/MCP: Interactive prompts
+ * - CLI: readline prompts
+ * - Fallback: Native OS dialogs
+ *
+ * @example
+ * ```typescript
+ * async *connect(params: { ip: string }) {
+ *   await this.startConnection(params.ip);
+ *
+ *   const code: string = yield {
+ *     prompt: 'Enter the 6-digit code:',
+ *     type: 'text'
+ *   };
+ *
+ *   await this.sendCode(code);
+ *   return { success: true };
+ * }
+ * ```
+ */
+/**
+ * Text input prompt
+ */
+export interface PromptYield {
+    prompt: string;
+    type?: 'text' | 'password';
+    default?: string;
+    /** Unique identifier for this prompt (auto-generated if not provided) */
+    id?: string;
+    /** Validation pattern */
+    pattern?: string;
+    /** Whether this prompt is required */
+    required?: boolean;
+}
+/**
+ * Confirmation dialog
+ */
+export interface ConfirmYield {
+    confirm: string;
+    /** Mark as dangerous action (UI can show warning styling) */
+    dangerous?: boolean;
+    id?: string;
+}
+/**
+ * Selection from options
+ */
+export interface SelectYield {
+    select: string;
+    options: Array<string | {
+        value: string;
+        label: string;
+    }>;
+    /** Allow multiple selections */
+    multi?: boolean;
+    id?: string;
+}
+/**
+ * Progress update (for long-running operations)
+ */
+export interface ProgressYield {
+    progress: number;
+    status?: string;
+    /** Additional data to stream to client */
+    data?: any;
+}
+/**
+ * Stream data to client
+ */
+export interface StreamYield {
+    stream: any;
+    /** Whether this is the final chunk */
+    final?: boolean;
+}
+/**
+ * Log/debug message
+ */
+export interface LogYield {
+    log: string;
+    level?: 'debug' | 'info' | 'warn' | 'error';
+}
+/**
+ * All possible yield types
+ */
+export type PhotonYield = PromptYield | ConfirmYield | SelectYield | ProgressYield | StreamYield | LogYield;
+/**
+ * Check if a yield requires user input
+ */
+export declare function isInputYield(y: PhotonYield): y is PromptYield | ConfirmYield | SelectYield;
+/**
+ * Check if a yield is a progress update
+ */
+export declare function isProgressYield(y: PhotonYield): y is ProgressYield;
+/**
+ * Check if a yield is streaming data
+ */
+export declare function isStreamYield(y: PhotonYield): y is StreamYield;
+/**
+ * Check if a yield is a log message
+ */
+export declare function isLogYield(y: PhotonYield): y is LogYield;
+/**
+ * Function that provides input for a yield
+ * Runtimes implement this based on their protocol
+ */
+export type InputProvider = (yielded: PhotonYield) => Promise<any>;
+/**
+ * Handler for non-input yields (progress, stream, log)
+ */
+export type OutputHandler = (yielded: PhotonYield) => void | Promise<void>;
+/**
+ * Configuration for generator execution
+ */
+export interface GeneratorExecutorConfig {
+    /** Provides input for prompt/confirm/select yields */
+    inputProvider: InputProvider;
+    /** Handles progress/stream/log yields */
+    outputHandler?: OutputHandler;
+    /** Pre-provided inputs (for REST APIs) */
+    preProvidedInputs?: Record<string, any>;
+    /** Timeout for waiting for input (ms) */
+    inputTimeout?: number;
+}
+/**
+ * Execute a generator-based tool
+ *
+ * @param generator - The async generator to execute
+ * @param config - Configuration for handling yields
+ * @returns The final return value of the generator
+ *
+ * @example
+ * ```typescript
+ * const result = await executeGenerator(tool.connect({ ip: '192.168.1.1' }), {
+ *   inputProvider: async (y) => {
+ *     if ('prompt' in y) return await readline(y.prompt);
+ *     if ('confirm' in y) return await confirm(y.confirm);
+ *   },
+ *   outputHandler: (y) => {
+ *     if ('progress' in y) console.log(`Progress: ${y.progress}%`);
+ *   }
+ * });
+ * ```
+ */
+export declare function executeGenerator<T>(generator: AsyncGenerator<PhotonYield, T, any>, config: GeneratorExecutorConfig): Promise<T>;
+/**
+ * Check if a function is an async generator function
+ */
+export declare function isAsyncGeneratorFunction(fn: any): fn is (...args: any[]) => AsyncGenerator;
+/**
+ * Check if a value is an async generator (already invoked)
+ */
+export declare function isAsyncGenerator(obj: any): obj is AsyncGenerator;
+/**
+ * Information about a yield point extracted from a generator
+ */
+export interface ExtractedYield {
+    id: string;
+    type: 'prompt' | 'confirm' | 'select';
+    prompt?: string;
+    options?: Array<string | {
+        value: string;
+        label: string;
+    }>;
+    default?: string;
+    required?: boolean;
+    pattern?: string;
+    dangerous?: boolean;
+    multi?: boolean;
+}
+/**
+ * Extract yield information by running generator with mock provider
+ * This is used for REST API schema generation
+ *
+ * Note: This only extracts yields that are reachable with default/empty inputs
+ * Complex conditional yields may not be extracted
+ */
+export declare function extractYields(generatorFn: (...args: any[]) => AsyncGenerator<PhotonYield, any, any>, mockParams?: any): Promise<ExtractedYield[]>;
+/**
+ * Create an input provider from pre-provided values
+ * Throws if a required value is missing
+ */
+export declare function createPrefilledProvider(inputs: Record<string, any>): InputProvider;
+/**
+ * Error thrown when input is needed but not available
+ * Runtimes can catch this to return appropriate responses
+ */
+export declare class NeedsInputError extends Error {
+    readonly yielded: PhotonYield;
+    constructor(yielded: PhotonYield);
+}
+/**
+ * Wrap a regular async function to behave like a generator
+ * Useful for uniform handling in runtimes
+ */
+export declare function wrapAsGenerator<T>(asyncFn: () => Promise<T>): AsyncGenerator<never, T, unknown>;
+//# sourceMappingURL=generator.d.ts.map

package/dist/generator.d.ts.map

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

package/dist/generator.js

@@ -0,0 +1,248 @@
+/**
+ * Generator-based Tool Execution
+ *
+ * Enables photon tools to use generator functions with `yield` for:
+ * - User prompts (text, password, confirm, select)
+ * - Progress updates
+ * - Streaming responses
+ * - Multi-step wizards
+ *
+ * The runtime handles yields appropriately based on the protocol:
+ * - REST: Extract yields as optional parameters
+ * - WebSocket/MCP: Interactive prompts
+ * - CLI: readline prompts
+ * - Fallback: Native OS dialogs
+ *
+ * @example
+ * ```typescript
+ * async *connect(params: { ip: string }) {
+ *   await this.startConnection(params.ip);
+ *
+ *   const code: string = yield {
+ *     prompt: 'Enter the 6-digit code:',
+ *     type: 'text'
+ *   };
+ *
+ *   await this.sendCode(code);
+ *   return { success: true };
+ * }
+ * ```
+ */
+/**
+ * Check if a yield requires user input
+ */
+export function isInputYield(y) {
+    return 'prompt' in y || 'confirm' in y || 'select' in y;
+}
+/**
+ * Check if a yield is a progress update
+ */
+export function isProgressYield(y) {
+    return 'progress' in y;
+}
+/**
+ * Check if a yield is streaming data
+ */
+export function isStreamYield(y) {
+    return 'stream' in y;
+}
+/**
+ * Check if a yield is a log message
+ */
+export function isLogYield(y) {
+    return 'log' in y;
+}
+// ============================================================================
+// Generator Executor - Runs generator tools
+// ============================================================================
+/**
+ * Execute a generator-based tool
+ *
+ * @param generator - The async generator to execute
+ * @param config - Configuration for handling yields
+ * @returns The final return value of the generator
+ *
+ * @example
+ * ```typescript
+ * const result = await executeGenerator(tool.connect({ ip: '192.168.1.1' }), {
+ *   inputProvider: async (y) => {
+ *     if ('prompt' in y) return await readline(y.prompt);
+ *     if ('confirm' in y) return await confirm(y.confirm);
+ *   },
+ *   outputHandler: (y) => {
+ *     if ('progress' in y) console.log(`Progress: ${y.progress}%`);
+ *   }
+ * });
+ * ```
+ */
+export async function executeGenerator(generator, config) {
+    const { inputProvider, outputHandler, preProvidedInputs } = config;
+    let promptIndex = 0;
+    let result = await generator.next();
+    while (!result.done) {
+        const yielded = result.value;
+        // Handle input yields (prompt, confirm, select)
+        if (isInputYield(yielded)) {
+            // Generate ID if not provided
+            const yieldId = yielded.id || `prompt_${promptIndex++}`;
+            // Check for pre-provided input (REST API style)
+            if (preProvidedInputs && yieldId in preProvidedInputs) {
+                result = await generator.next(preProvidedInputs[yieldId]);
+                continue;
+            }
+            // Get input from provider
+            const input = await inputProvider(yielded);
+            result = await generator.next(input);
+        }
+        // Handle output yields (progress, stream, log)
+        else {
+            if (outputHandler) {
+                await outputHandler(yielded);
+            }
+            // Continue without providing a value
+            result = await generator.next();
+        }
+    }
+    return result.value;
+}
+// ============================================================================
+// Generator Detection - Check if a function is a generator
+// ============================================================================
+/**
+ * Check if a function is an async generator function
+ */
+export function isAsyncGeneratorFunction(fn) {
+    if (!fn)
+        return false;
+    const constructor = fn.constructor;
+    if (!constructor)
+        return false;
+    if (constructor.name === 'AsyncGeneratorFunction')
+        return true;
+    // Check prototype chain
+    const prototype = Object.getPrototypeOf(fn);
+    return prototype && prototype.constructor &&
+        prototype.constructor.name === 'AsyncGeneratorFunction';
+}
+/**
+ * Check if a value is an async generator (already invoked)
+ */
+export function isAsyncGenerator(obj) {
+    return obj &&
+        typeof obj.next === 'function' &&
+        typeof obj.return === 'function' &&
+        typeof obj.throw === 'function' &&
+        typeof obj[Symbol.asyncIterator] === 'function';
+}
+/**
+ * Extract yield information by running generator with mock provider
+ * This is used for REST API schema generation
+ *
+ * Note: This only extracts yields that are reachable with default/empty inputs
+ * Complex conditional yields may not be extracted
+ */
+export async function extractYields(generatorFn, mockParams = {}) {
+    const yields = [];
+    let promptIndex = 0;
+    try {
+        const generator = generatorFn(mockParams);
+        let result = await generator.next();
+        while (!result.done) {
+            const yielded = result.value;
+            if (isInputYield(yielded)) {
+                const id = yielded.id || `prompt_${promptIndex++}`;
+                if ('prompt' in yielded) {
+                    yields.push({
+                        id,
+                        type: yielded.type === 'password' ? 'prompt' : 'prompt',
+                        prompt: yielded.prompt,
+                        default: yielded.default,
+                        required: yielded.required,
+                        pattern: yielded.pattern,
+                    });
+                    // Provide mock value to continue
+                    result = await generator.next(yielded.default || '');
+                }
+                else if ('confirm' in yielded) {
+                    yields.push({
+                        id,
+                        type: 'confirm',
+                        prompt: yielded.confirm,
+                        dangerous: yielded.dangerous,
+                    });
+                    result = await generator.next(true);
+                }
+                else if ('select' in yielded) {
+                    yields.push({
+                        id,
+                        type: 'select',
+                        prompt: yielded.select,
+                        options: yielded.options,
+                        multi: yielded.multi,
+                    });
+                    const firstOption = yielded.options[0];
+                    const mockValue = typeof firstOption === 'string' ? firstOption : firstOption.value;
+                    result = await generator.next(yielded.multi ? [mockValue] : mockValue);
+                }
+            }
+            else {
+                // Skip non-input yields
+                result = await generator.next();
+            }
+        }
+    }
+    catch (error) {
+        // Generator may throw if it needs real resources
+        // Return what we've extracted so far
+        console.warn('[generator] Yield extraction incomplete:', error);
+    }
+    return yields;
+}
+// ============================================================================
+// Default Input Providers - Built-in implementations for common scenarios
+// ============================================================================
+/**
+ * Create an input provider from pre-provided values
+ * Throws if a required value is missing
+ */
+export function createPrefilledProvider(inputs) {
+    return async (yielded) => {
+        if (!isInputYield(yielded))
+            return undefined;
+        const id = yielded.id || 'default';
+        if (id in inputs) {
+            return inputs[id];
+        }
+        // Check for default value
+        if ('prompt' in yielded && yielded.default !== undefined) {
+            return yielded.default;
+        }
+        throw new NeedsInputError(yielded);
+    };
+}
+/**
+ * Error thrown when input is needed but not available
+ * Runtimes can catch this to return appropriate responses
+ */
+export class NeedsInputError extends Error {
+    yielded;
+    constructor(yielded) {
+        const message = 'prompt' in yielded ? yielded.prompt :
+            'confirm' in yielded ? yielded.confirm :
+                'select' in yielded ? yielded.select : 'Input required';
+        super(`Input required: ${message}`);
+        this.name = 'NeedsInputError';
+        this.yielded = yielded;
+    }
+}
+// ============================================================================
+// Utility: Wrap regular async function to match generator interface
+// ============================================================================
+/**
+ * Wrap a regular async function to behave like a generator
+ * Useful for uniform handling in runtimes
+ */
+export async function* wrapAsGenerator(asyncFn) {
+    return await asyncFn();
+}
+//# sourceMappingURL=generator.js.map

package/dist/generator.js.map

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

package/dist/index.d.ts

@@ -38,4 +38,6 @@ export { SchemaExtractor } from './schema-extractor.js';
 export { formatOutput, detectFormat, renderPrimitive, renderList, renderTable, renderTree, renderNone, formatKey, formatValue, formatToMimeType, printSuccess, printError, printInfo, printWarning, printHeader, STATUS, } from './cli-formatter.js';
 export { resolvePath, listFiles, ensureDir, resolvePhotonPath, listPhotonFiles, ensurePhotonDir, DEFAULT_PHOTON_DIR, type ResolverOptions, } from './path-resolver.js';
 export * from './types.js';
+export { isInputYield, isProgressYield, isStreamYield, isLogYield, isAsyncGeneratorFunction, isAsyncGenerator, executeGenerator, extractYields, createPrefilledProvider, NeedsInputError, wrapAsGenerator, type PhotonYield, type PromptYield, type ConfirmYield, type SelectYield, type ProgressYield, type StreamYield, type LogYield, type InputProvider, type OutputHandler, type GeneratorExecutorConfig, type ExtractedYield, } from './generator.js';
+export { prompt, confirm, elicit, elicitReadline, elicitNativeDialog, setPromptHandler, getPromptHandler, setElicitHandler, getElicitHandler, type ElicitOptions, type ElicitResult, type ElicitHandler, type PromptHandler, } from './elicit.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAGH,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAGtC,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAG5D,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAGxD,OAAO,EACL,YAAY,EACZ,YAAY,EACZ,eAAe,EACf,UAAU,EACV,WAAW,EACX,UAAU,EACV,UAAU,EACV,SAAS,EACT,WAAW,EACX,gBAAgB,EAChB,YAAY,EACZ,UAAU,EACV,SAAS,EACT,YAAY,EACZ,WAAW,EACX,MAAM,GACP,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EACL,WAAW,EACX,SAAS,EACT,SAAS,EACT,iBAAiB,EACjB,eAAe,EACf,eAAe,EACf,kBAAkB,EAClB,KAAK,eAAe,GACrB,MAAM,oBAAoB,CAAC;AAG5B,cAAc,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAGH,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAGtC,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAG5D,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAGxD,OAAO,EACL,YAAY,EACZ,YAAY,EACZ,eAAe,EACf,UAAU,EACV,WAAW,EACX,UAAU,EACV,UAAU,EACV,SAAS,EACT,WAAW,EACX,gBAAgB,EAChB,YAAY,EACZ,UAAU,EACV,SAAS,EACT,YAAY,EACZ,WAAW,EACX,MAAM,GACP,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EACL,WAAW,EACX,SAAS,EACT,SAAS,EACT,iBAAiB,EACjB,eAAe,EACf,eAAe,EACf,kBAAkB,EAClB,KAAK,eAAe,GACrB,MAAM,oBAAoB,CAAC;AAG5B,cAAc,YAAY,CAAC;AAG3B,OAAO,EAEL,YAAY,EACZ,eAAe,EACf,aAAa,EACb,UAAU,EAEV,wBAAwB,EACxB,gBAAgB,EAEhB,gBAAgB,EAEhB,aAAa,EAEb,uBAAuB,EACvB,eAAe,EAEf,eAAe,EAEf,KAAK,WAAW,EAChB,KAAK,WAAW,EAChB,KAAK,YAAY,EACjB,KAAK,WAAW,EAChB,KAAK,aAAa,EAClB,KAAK,WAAW,EAChB,KAAK,QAAQ,EACb,KAAK,aAAa,EAClB,KAAK,aAAa,EAClB,KAAK,uBAAuB,EAC5B,KAAK,cAAc,GACpB,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EAEL,MAAM,EACN,OAAO,EAEP,MAAM,EACN,cAAc,EACd,kBAAkB,EAElB,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,EAEhB,KAAK,aAAa,EAClB,KAAK,YAAY,EACjB,KAAK,aAAa,EAClB,KAAK,aAAa,GACnB,MAAM,aAAa,CAAC"}

package/dist/index.js

@@ -44,4 +44,26 @@ export { formatOutput, detectFormat, renderPrimitive, renderList, renderTable, r
 export { resolvePath, listFiles, ensureDir, resolvePhotonPath, listPhotonFiles, ensurePhotonDir, DEFAULT_PHOTON_DIR, } from './path-resolver.js';
 // Types
 export * from './types.js';
+// Generator-based tools - yield for prompts, progress, streaming
+export { 
+// Yield type checking
+isInputYield, isProgressYield, isStreamYield, isLogYield, 
+// Generator detection
+isAsyncGeneratorFunction, isAsyncGenerator, 
+// Executor
+executeGenerator, 
+// Yield extraction (for REST schema generation)
+extractYields, 
+// Built-in providers
+createPrefilledProvider, NeedsInputError, 
+// Utility
+wrapAsGenerator, } from './generator.js';
+// Elicit - Cross-platform user input (legacy, prefer generators)
+export { 
+// Simple functions (no imports needed in photon files)
+prompt, confirm, 
+// Full elicit with options
+elicit, elicitReadline, elicitNativeDialog, 
+// Handler management (for runtimes)
+setPromptHandler, getPromptHandler, setElicitHandler, getElicitHandler, } from './elicit.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAEH,uCAAuC;AACvC,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAEtC,wBAAwB;AACxB,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAE5D,oBAAoB;AACpB,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAExD,iBAAiB;AACjB,OAAO,EACL,YAAY,EACZ,YAAY,EACZ,eAAe,EACf,UAAU,EACV,WAAW,EACX,UAAU,EACV,UAAU,EACV,SAAS,EACT,WAAW,EACX,gBAAgB,EAChB,YAAY,EACZ,UAAU,EACV,SAAS,EACT,YAAY,EACZ,WAAW,EACX,MAAM,GACP,MAAM,oBAAoB,CAAC;AAE5B,kBAAkB;AAClB,OAAO,EACL,WAAW,EACX,SAAS,EACT,SAAS,EACT,iBAAiB,EACjB,eAAe,EACf,eAAe,EACf,kBAAkB,GAEnB,MAAM,oBAAoB,CAAC;AAE5B,QAAQ;AACR,cAAc,YAAY,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAEH,uCAAuC;AACvC,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAEtC,wBAAwB;AACxB,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAE5D,oBAAoB;AACpB,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAExD,iBAAiB;AACjB,OAAO,EACL,YAAY,EACZ,YAAY,EACZ,eAAe,EACf,UAAU,EACV,WAAW,EACX,UAAU,EACV,UAAU,EACV,SAAS,EACT,WAAW,EACX,gBAAgB,EAChB,YAAY,EACZ,UAAU,EACV,SAAS,EACT,YAAY,EACZ,WAAW,EACX,MAAM,GACP,MAAM,oBAAoB,CAAC;AAE5B,kBAAkB;AAClB,OAAO,EACL,WAAW,EACX,SAAS,EACT,SAAS,EACT,iBAAiB,EACjB,eAAe,EACf,eAAe,EACf,kBAAkB,GAEnB,MAAM,oBAAoB,CAAC;AAE5B,QAAQ;AACR,cAAc,YAAY,CAAC;AAE3B,iEAAiE;AACjE,OAAO;AACL,sBAAsB;AACtB,YAAY,EACZ,eAAe,EACf,aAAa,EACb,UAAU;AACV,sBAAsB;AACtB,wBAAwB,EACxB,gBAAgB;AAChB,WAAW;AACX,gBAAgB;AAChB,gDAAgD;AAChD,aAAa;AACb,qBAAqB;AACrB,uBAAuB,EACvB,eAAe;AACf,UAAU;AACV,eAAe,GAahB,MAAM,gBAAgB,CAAC;AAExB,iEAAiE;AACjE,OAAO;AACL,uDAAuD;AACvD,MAAM,EACN,OAAO;AACP,2BAA2B;AAC3B,MAAM,EACN,cAAc,EACd,kBAAkB;AAClB,oCAAoC;AACpC,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,GAMjB,MAAM,aAAa,CAAC"}

package/dist/schema-extractor.d.ts

@@ -108,5 +108,11 @@ export declare class SchemaExtractor {
      * Example: @mimeType text/markdown
      */
     private extractMimeType;
+    /**
+     * Extract yield information from JSDoc for generator methods
+     * Supports @yields tags with id, type, and description
+     * Example: @yields {pairing_code} text Enter the 6-digit code shown on TV
+     */
+    private extractYieldsFromJSDoc;
 }
 //# sourceMappingURL=schema-extractor.d.ts.map

package/dist/schema-extractor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"schema-extractor.d.ts","sourceRoot":"","sources":["../src/schema-extractor.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,YAAY,EAAE,UAAU,EAAgB,MAAM,YAAY,CAAC;AAEvG,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,eAAe,EAAE,CAAC;IACzB,SAAS,EAAE,YAAY,EAAE,CAAC;IAC1B,OAAO,EAAE,UAAU,EAAE,CAAC;CACvB;AAED;;GAEG;AACH,qBAAa,eAAe;IAC1B;;OAEG;IACG,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IAUnE;;OAEG;IACH,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,iBAAiB;IAyHvD;;OAEG;IACH,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,eAAe,EAAE;IAIpD;;OAEG;IACH,OAAO,CAAC,eAAe;IAqBvB;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAS7B;;;OAGG;IACH,OAAO,CAAC,mBAAmB;IAiC3B;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAyGxB;;;;;OAKG;IACH,OAAO,CAAC,oBAAoB;IA0F5B;;OAEG;IACH,wBAAwB,CAAC,MAAM,EAAE,MAAM,GAAG,gBAAgB,EAAE;IAmD5D;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAuB3B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAqB1B;;;OAGG;IACH,OAAO,CAAC,gBAAgB;IA4BxB;;;;OAIG;IACH,OAAO,CAAC,uBAAuB;IA2G/B;;;;;OAKG;IACH,OAAO,CAAC,gBAAgB;IA0FxB;;OAEG;IACH,OAAO,CAAC,cAAc;IAItB;;OAEG;IACH,OAAO,CAAC,YAAY;IAIpB;;;OAGG;IACH,OAAO,CAAC,gBAAgB;IAKxB;;;;;OAKG;IACH,OAAO,CAAC,aAAa;IAsBrB;;;OAGG;IACH,OAAO,CAAC,eAAe;CAIxB"}
+{"version":3,"file":"schema-extractor.d.ts","sourceRoot":"","sources":["../src/schema-extractor.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,YAAY,EAAE,UAAU,EAA2B,MAAM,YAAY,CAAC;AAElH,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,eAAe,EAAE,CAAC;IACzB,SAAS,EAAE,YAAY,EAAE,CAAC;IAC1B,OAAO,EAAE,UAAU,EAAE,CAAC;CACvB;AAED;;GAEG;AACH,qBAAa,eAAe;IAC1B;;OAEG;IACG,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IAUnE;;OAEG;IACH,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,iBAAiB;IAgIvD;;OAEG;IACH,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,eAAe,EAAE;IAIpD;;OAEG;IACH,OAAO,CAAC,eAAe;IAqBvB;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAS7B;;;OAGG;IACH,OAAO,CAAC,mBAAmB;IAiC3B;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAyGxB;;;;;OAKG;IACH,OAAO,CAAC,oBAAoB;IA0F5B;;OAEG;IACH,wBAAwB,CAAC,MAAM,EAAE,MAAM,GAAG,gBAAgB,EAAE;IAmD5D;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAuB3B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAqB1B;;;OAGG;IACH,OAAO,CAAC,gBAAgB;IA4BxB;;;;OAIG;IACH,OAAO,CAAC,uBAAuB;IA2G/B;;;;;OAKG;IACH,OAAO,CAAC,gBAAgB;IA0FxB;;OAEG;IACH,OAAO,CAAC,cAAc;IAItB;;OAEG;IACH,OAAO,CAAC,YAAY;IAIpB;;;OAGG;IACH,OAAO,CAAC,gBAAgB;IAKxB;;;;;OAKG;IACH,OAAO,CAAC,aAAa;IAsBrB;;;OAGG;IACH,OAAO,CAAC,eAAe;IAKvB;;;;OAIG;IACH,OAAO,CAAC,sBAAsB;CAiB/B"}

package/dist/schema-extractor.js

@@ -45,6 +45,8 @@ export class SchemaExtractor {
             const processMethod = (member) => {
                 const methodName = member.name.getText(sourceFile);
                 const jsdoc = this.getJSDocComment(member, sourceFile);
+                // Check if this is an async generator method (has asterisk token)
+                const isGenerator = member.asteriskToken !== undefined;
                 // Extract parameter type information
                 const paramsType = this.getFirstParameterType(member, sourceFile);
                 if (!paramsType) {
@@ -100,11 +102,14 @@ export class SchemaExtractor {
                 // Otherwise, it's a regular tool
                 else {
                     const outputFormat = this.extractFormat(jsdoc);
+                    const yields = isGenerator ? this.extractYieldsFromJSDoc(jsdoc) : undefined;
                     tools.push({
                         name: methodName,
                         description,
                         inputSchema,
                         ...(outputFormat ? { outputFormat } : {}),
+                        ...(isGenerator ? { isGenerator: true } : {}),
+                        ...(yields && yields.length > 0 ? { yields } : {}),
                     });
                 }
             };
@@ -113,7 +118,7 @@ export class SchemaExtractor {
                 // Look for class declarations
                 if (ts.isClassDeclaration(node)) {
                     node.members.forEach((member) => {
-                        // Look for async methods
+                        // Look for async methods (including async generators with *)
                         if (ts.isMethodDeclaration(member) &&
                             member.modifiers?.some(m => m.kind === ts.SyntaxKind.AsyncKeyword)) {
                             processMethod(member);
@@ -736,5 +741,25 @@ export class SchemaExtractor {
         const match = jsdocContent.match(/@mimeType\s+([\w\/\-+.]+)/i);
         return match ? match[1].trim() : undefined;
     }
+    /**
+     * Extract yield information from JSDoc for generator methods
+     * Supports @yields tags with id, type, and description
+     * Example: @yields {pairing_code} text Enter the 6-digit code shown on TV
+     */
+    extractYieldsFromJSDoc(jsdocContent) {
+        const yields = [];
+        // Match @yields {id} type description
+        const yieldRegex = /@yields?\s+\{(\w+)\}\s+(prompt|confirm|select)\s+(.+)/gi;
+        let match;
+        while ((match = yieldRegex.exec(jsdocContent)) !== null) {
+            const [, id, type, description] = match;
+            yields.push({
+                id,
+                type: type.toLowerCase(),
+                prompt: description.trim(),
+            });
+        }
+        return yields;
+    }
 }
 //# sourceMappingURL=schema-extractor.js.map