@portel/photon-core 1.4.0 → 2.1.0

package/dist/io.d.ts

@@ -0,0 +1,395 @@
+/**
+ * IO Helper API
+ *
+ * Clean, ergonomic API for yielding emit and ask messages in Photon generators.
+ *
+ * @example
+ * ```typescript
+ * import { io } from '@portel/photon-core';
+ *
+ * async *myTool() {
+ *   yield io.emit.status('Starting...');
+ *   yield io.emit.progress(0.5, 'Halfway there');
+ *
+ *   const name = yield io.ask.text('What is your name?');
+ *   const confirmed = yield io.ask.confirm('Continue?');
+ *
+ *   return { name, confirmed };
+ * }
+ * ```
+ *
+ * @module io
+ */
+import type { EmitStatus, EmitProgress, EmitStream, EmitLog, EmitToast, EmitThinking, EmitArtifact, EmitUI, AskText, AskPassword, AskConfirm, AskSelect, AskNumber, AskFile, AskDate, AskForm, AskUrl, FormSchema } from './generator.js';
+/**
+ * Emit a status message
+ *
+ * @example
+ * yield io.emit.status('Connecting...');
+ * yield io.emit.status('Done!', 'success');
+ */
+declare function status(message: string, type?: EmitStatus['type']): EmitStatus;
+/**
+ * Emit a progress update
+ *
+ * @example
+ * yield io.emit.progress(0.5); // 50%
+ * yield io.emit.progress(0.75, 'Almost done');
+ */
+declare function progress(value: number, message?: string, meta?: Record<string, any>): EmitProgress;
+/**
+ * Emit a stream chunk
+ *
+ * @example
+ * for await (const chunk of stream) {
+ *   yield io.emit.stream(chunk);
+ * }
+ * yield io.emit.stream('', true); // final
+ */
+declare function stream(data: any, final?: boolean, contentType?: string): EmitStream;
+/**
+ * Emit a log message (for debugging)
+ *
+ * @example
+ * yield io.emit.log('Processing item', 'debug', { id: 123 });
+ */
+declare function log(message: string, level?: EmitLog['level'], data?: Record<string, any>): EmitLog;
+/**
+ * Emit a toast notification
+ *
+ * @example
+ * yield io.emit.toast('Saved!', 'success');
+ * yield io.emit.toast('Error!', 'error', 5000);
+ */
+declare function toast(message: string, type?: EmitToast['type'], duration?: number): EmitToast;
+/**
+ * Emit thinking indicator
+ *
+ * @example
+ * yield io.emit.thinking(true);
+ * // ... heavy computation
+ * yield io.emit.thinking(false);
+ */
+declare function thinking(active: boolean): EmitThinking;
+/**
+ * Emit an artifact (image, code, document)
+ *
+ * @example
+ * yield io.emit.artifact('image', { url: 'https://...', title: 'Chart' });
+ * yield io.emit.artifact('code', { content: 'const x = 1;', language: 'typescript' });
+ */
+declare function artifact(type: EmitArtifact['type'], options: Omit<EmitArtifact, 'emit' | 'type'>): EmitArtifact;
+/**
+ * Emit a UI component
+ *
+ * @example
+ * yield io.emit.ui('preferences', { currentTheme: 'dark' });
+ * yield io.emit.ui(null, { inline: '<div>Hello</div>' });
+ */
+declare function ui(id: string | null, options?: Omit<EmitUI, 'emit' | 'id'>): EmitUI;
+/** Options for text input */
+interface TextOptions {
+    id?: string;
+    default?: string;
+    placeholder?: string;
+    pattern?: string;
+    minLength?: number;
+    maxLength?: number;
+    required?: boolean;
+}
+/**
+ * Ask for text input
+ *
+ * @example
+ * const name = yield io.ask.text('What is your name?');
+ * const email = yield io.ask.text('Email:', { pattern: '.*@.*' });
+ */
+declare function text(message: string, options?: TextOptions): AskText;
+/**
+ * Ask for password input (masked)
+ *
+ * @example
+ * const apiKey = yield io.ask.password('Enter API key:');
+ */
+declare function password(message: string, options?: Pick<TextOptions, 'id' | 'required'>): AskPassword;
+/** Options for confirm input */
+interface ConfirmOptions {
+    id?: string;
+    default?: boolean;
+    dangerous?: boolean;
+    required?: boolean;
+}
+/**
+ * Ask for confirmation (yes/no)
+ *
+ * @example
+ * const ok = yield io.ask.confirm('Delete this file?');
+ * const dangerous = yield io.ask.confirm('Proceed?', { dangerous: true });
+ */
+declare function confirm(message: string, options?: ConfirmOptions): AskConfirm;
+/** Options for select input */
+interface SelectOptions {
+    id?: string;
+    default?: string | string[];
+    multi?: boolean;
+    required?: boolean;
+    /** Layout style for rendering options */
+    layout?: 'list' | 'grid' | 'cards';
+    /** Number of columns for grid/cards layout */
+    columns?: number;
+    /** Filter buttons to show (e.g., ['All', 'Vegetarian', 'Vegan']) */
+    filters?: string[];
+    /** Which option field to filter on (default: 'category') */
+    filterField?: string;
+    /** Show search box for filtering options */
+    searchable?: boolean;
+    /** Placeholder text for search box */
+    searchPlaceholder?: string;
+}
+/**
+ * Rich select option for e-commerce, catalogs, and other common use cases.
+ *
+ * Supports simple strings for basic options, or rich objects for
+ * product cards, catalog items, and other visual selections.
+ *
+ * @example Simple string options
+ * ['Red', 'Green', 'Blue']
+ *
+ * @example Rich product options
+ * [
+ *   {
+ *     value: 'prod-123',
+ *     label: 'Wireless Headphones',
+ *     description: 'Premium sound quality',
+ *     image: 'https://example.com/headphones.jpg',
+ *     price: 99.99,
+ *     badge: 'Sale',
+ *   }
+ * ]
+ */
+type SelectOption = string | {
+    /** Unique identifier returned when selected */
+    value: string;
+    /** Display label (product name, item title) */
+    label: string;
+    /** Secondary text (short description) */
+    description?: string;
+    /** Image URL (product photo, thumbnail) */
+    image?: string;
+    /** Price in currency units (rendered with locale formatting) */
+    price?: number;
+    /** Original price for showing discounts */
+    originalPrice?: number;
+    /** Currency code (default: USD) */
+    currency?: string;
+    /** Badge text (Sale, New, Low Stock, etc.) */
+    badge?: string;
+    /** Badge color/type for styling */
+    badgeType?: 'default' | 'success' | 'warning' | 'error' | 'info';
+    /** Quantity (for cart items) */
+    quantity?: number;
+    /** Enable +/- quantity controls */
+    adjustable?: boolean;
+    /** Minimum quantity (0 = can remove, default: 1) */
+    minQuantity?: number;
+    /** Maximum quantity allowed */
+    maxQuantity?: number;
+    /** Category for filtering (e.g., 'vegetarian', 'spicy') */
+    category?: string | string[];
+    /** Whether the option is disabled/unavailable */
+    disabled?: boolean;
+    /** Reason for being disabled (Out of stock, etc.) */
+    disabledReason?: string;
+    /** Pre-selected state for multi-select */
+    selected?: boolean;
+    /** Additional metadata (not rendered, returned with selection) */
+    meta?: Record<string, any>;
+};
+/**
+ * Ask for selection from options
+ *
+ * Supports simple string arrays for basic choices, or rich option objects
+ * for product catalogs, shopping carts, and other visual selections.
+ *
+ * @example Basic selection
+ * const env = yield io.ask.select('Choose environment:', ['dev', 'staging', 'prod']);
+ *
+ * @example Multi-select features
+ * const features = yield io.ask.select('Enable features:', ['auth', 'logs'], { multi: true });
+ *
+ * @example Product selection (e-commerce)
+ * const items = yield io.ask.select('Select items to purchase:', [
+ *   {
+ *     value: 'prod-1',
+ *     label: 'Wireless Mouse',
+ *     description: 'Ergonomic design',
+ *     image: 'https://example.com/mouse.jpg',
+ *     price: 29.99,
+ *     badge: 'Bestseller'
+ *   },
+ *   {
+ *     value: 'prod-2',
+ *     label: 'Mechanical Keyboard',
+ *     description: 'Cherry MX switches',
+ *     image: 'https://example.com/keyboard.jpg',
+ *     price: 149.99,
+ *     originalPrice: 199.99,
+ *     badge: 'Sale'
+ *   }
+ * ], { multi: true, layout: 'cards', columns: 2 });
+ *
+ * @example Shopping cart review
+ * const confirmed = yield io.ask.select('Review your cart:', cartItems.map(item => ({
+ *   value: item.id,
+ *   label: item.name,
+ *   image: item.thumbnail,
+ *   price: item.price,
+ *   quantity: item.qty,
+ *   selected: true  // Pre-selected
+ * })), { multi: true, layout: 'list' });
+ */
+declare function select(message: string, options: SelectOption[], config?: SelectOptions): AskSelect;
+/** Options for number input */
+interface NumberOptions {
+    id?: string;
+    default?: number;
+    min?: number;
+    max?: number;
+    step?: number;
+    required?: boolean;
+}
+/**
+ * Ask for number input
+ *
+ * @example
+ * const qty = yield io.ask.number('Quantity:', { min: 1, max: 100 });
+ */
+declare function number(message: string, options?: NumberOptions): AskNumber;
+/** Options for file input */
+interface FileOptions {
+    id?: string;
+    accept?: string;
+    multiple?: boolean;
+    required?: boolean;
+}
+/**
+ * Ask for file selection
+ *
+ * @example
+ * const file = yield io.ask.file('Select a document:', { accept: '.pdf,.doc' });
+ */
+declare function file(message: string, options?: FileOptions): AskFile;
+/** Options for date input */
+interface DateOptions {
+    id?: string;
+    default?: string;
+    min?: string;
+    max?: string;
+    includeTime?: boolean;
+    required?: boolean;
+}
+/**
+ * Ask for date selection
+ *
+ * @example
+ * const date = yield io.ask.date('Select delivery date:');
+ * const datetime = yield io.ask.date('When?', { includeTime: true });
+ */
+declare function date(message: string, options?: DateOptions): AskDate;
+/** Options for form input */
+interface FormOptions {
+    id?: string;
+    required?: boolean;
+}
+/**
+ * Ask for form input (structured data)
+ *
+ * @example
+ * const contact = yield io.ask.form('Enter contact details:', {
+ *   type: 'object',
+ *   properties: {
+ *     name: { type: 'string', title: 'Full Name' },
+ *     email: { type: 'string', format: 'email', title: 'Email' }
+ *   },
+ *   required: ['name', 'email']
+ * });
+ */
+declare function form(message: string, schema: FormSchema, options?: FormOptions): AskForm;
+/** Options for url input */
+interface UrlOptions {
+    id?: string;
+    elicitationId?: string;
+    required?: boolean;
+}
+/**
+ * Ask via URL (OAuth, external auth)
+ *
+ * @example
+ * const auth = yield io.ask.url('Authenticate with GitHub:', 'https://github.com/login/...');
+ */
+declare function url(message: string, urlValue: string, options?: UrlOptions): AskUrl;
+/**
+ * IO helper namespace for emit and ask yields
+ *
+ * @example
+ * ```typescript
+ * import { io } from '@portel/photon-core';
+ *
+ * async *myTool() {
+ *   yield io.emit.status('Starting...');
+ *   const name = yield io.ask.text('Name?');
+ * }
+ * ```
+ */
+export declare const io: {
+    /**
+     * Emit helpers - fire and forget output
+     */
+    readonly emit: {
+        readonly status: typeof status;
+        readonly progress: typeof progress;
+        readonly stream: typeof stream;
+        readonly log: typeof log;
+        readonly toast: typeof toast;
+        readonly thinking: typeof thinking;
+        readonly artifact: typeof artifact;
+        readonly ui: typeof ui;
+    };
+    /**
+     * Ask helpers - blocking input from user
+     */
+    readonly ask: {
+        readonly text: typeof text;
+        readonly password: typeof password;
+        readonly confirm: typeof confirm;
+        readonly select: typeof select;
+        readonly number: typeof number;
+        readonly file: typeof file;
+        readonly date: typeof date;
+        readonly form: typeof form;
+        readonly url: typeof url;
+    };
+};
+export declare const emit: {
+    readonly status: typeof status;
+    readonly progress: typeof progress;
+    readonly stream: typeof stream;
+    readonly log: typeof log;
+    readonly toast: typeof toast;
+    readonly thinking: typeof thinking;
+    readonly artifact: typeof artifact;
+    readonly ui: typeof ui;
+};
+export declare const ask: {
+    readonly text: typeof text;
+    readonly password: typeof password;
+    readonly confirm: typeof confirm;
+    readonly select: typeof select;
+    readonly number: typeof number;
+    readonly file: typeof file;
+    readonly date: typeof date;
+    readonly form: typeof form;
+    readonly url: typeof url;
+};
+export {};
+//# sourceMappingURL=io.d.ts.map

package/dist/io.d.ts.map

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

package/dist/io.js

@@ -0,0 +1,304 @@
+/**
+ * IO Helper API
+ *
+ * Clean, ergonomic API for yielding emit and ask messages in Photon generators.
+ *
+ * @example
+ * ```typescript
+ * import { io } from '@portel/photon-core';
+ *
+ * async *myTool() {
+ *   yield io.emit.status('Starting...');
+ *   yield io.emit.progress(0.5, 'Halfway there');
+ *
+ *   const name = yield io.ask.text('What is your name?');
+ *   const confirmed = yield io.ask.confirm('Continue?');
+ *
+ *   return { name, confirmed };
+ * }
+ * ```
+ *
+ * @module io
+ */
+// ══════════════════════════════════════════════════════════════════════════════
+// EMIT HELPERS - Output to user (fire and forget)
+// ══════════════════════════════════════════════════════════════════════════════
+/**
+ * Emit a status message
+ *
+ * @example
+ * yield io.emit.status('Connecting...');
+ * yield io.emit.status('Done!', 'success');
+ */
+function status(message, type) {
+    return { emit: 'status', message, ...(type && { type }) };
+}
+/**
+ * Emit a progress update
+ *
+ * @example
+ * yield io.emit.progress(0.5); // 50%
+ * yield io.emit.progress(0.75, 'Almost done');
+ */
+function progress(value, message, meta) {
+    return {
+        emit: 'progress',
+        value,
+        ...(message && { message }),
+        ...(meta && { meta }),
+    };
+}
+/**
+ * Emit a stream chunk
+ *
+ * @example
+ * for await (const chunk of stream) {
+ *   yield io.emit.stream(chunk);
+ * }
+ * yield io.emit.stream('', true); // final
+ */
+function stream(data, final, contentType) {
+    return {
+        emit: 'stream',
+        data,
+        ...(final && { final }),
+        ...(contentType && { contentType }),
+    };
+}
+/**
+ * Emit a log message (for debugging)
+ *
+ * @example
+ * yield io.emit.log('Processing item', 'debug', { id: 123 });
+ */
+function log(message, level, data) {
+    return {
+        emit: 'log',
+        message,
+        ...(level && { level }),
+        ...(data && { data }),
+    };
+}
+/**
+ * Emit a toast notification
+ *
+ * @example
+ * yield io.emit.toast('Saved!', 'success');
+ * yield io.emit.toast('Error!', 'error', 5000);
+ */
+function toast(message, type, duration) {
+    return {
+        emit: 'toast',
+        message,
+        ...(type && { type }),
+        ...(duration !== undefined && { duration }),
+    };
+}
+/**
+ * Emit thinking indicator
+ *
+ * @example
+ * yield io.emit.thinking(true);
+ * // ... heavy computation
+ * yield io.emit.thinking(false);
+ */
+function thinking(active) {
+    return { emit: 'thinking', active };
+}
+/**
+ * Emit an artifact (image, code, document)
+ *
+ * @example
+ * yield io.emit.artifact('image', { url: 'https://...', title: 'Chart' });
+ * yield io.emit.artifact('code', { content: 'const x = 1;', language: 'typescript' });
+ */
+function artifact(type, options) {
+    return { emit: 'artifact', type, ...options };
+}
+/**
+ * Emit a UI component
+ *
+ * @example
+ * yield io.emit.ui('preferences', { currentTheme: 'dark' });
+ * yield io.emit.ui(null, { inline: '<div>Hello</div>' });
+ */
+function ui(id, options) {
+    return { emit: 'ui', ...(id && { id }), ...options };
+}
+/**
+ * Ask for text input
+ *
+ * @example
+ * const name = yield io.ask.text('What is your name?');
+ * const email = yield io.ask.text('Email:', { pattern: '.*@.*' });
+ */
+function text(message, options) {
+    return { ask: 'text', message, ...options };
+}
+/**
+ * Ask for password input (masked)
+ *
+ * @example
+ * const apiKey = yield io.ask.password('Enter API key:');
+ */
+function password(message, options) {
+    return { ask: 'password', message, ...options };
+}
+/**
+ * Ask for confirmation (yes/no)
+ *
+ * @example
+ * const ok = yield io.ask.confirm('Delete this file?');
+ * const dangerous = yield io.ask.confirm('Proceed?', { dangerous: true });
+ */
+function confirm(message, options) {
+    return { ask: 'confirm', message, ...options };
+}
+/**
+ * Ask for selection from options
+ *
+ * Supports simple string arrays for basic choices, or rich option objects
+ * for product catalogs, shopping carts, and other visual selections.
+ *
+ * @example Basic selection
+ * const env = yield io.ask.select('Choose environment:', ['dev', 'staging', 'prod']);
+ *
+ * @example Multi-select features
+ * const features = yield io.ask.select('Enable features:', ['auth', 'logs'], { multi: true });
+ *
+ * @example Product selection (e-commerce)
+ * const items = yield io.ask.select('Select items to purchase:', [
+ *   {
+ *     value: 'prod-1',
+ *     label: 'Wireless Mouse',
+ *     description: 'Ergonomic design',
+ *     image: 'https://example.com/mouse.jpg',
+ *     price: 29.99,
+ *     badge: 'Bestseller'
+ *   },
+ *   {
+ *     value: 'prod-2',
+ *     label: 'Mechanical Keyboard',
+ *     description: 'Cherry MX switches',
+ *     image: 'https://example.com/keyboard.jpg',
+ *     price: 149.99,
+ *     originalPrice: 199.99,
+ *     badge: 'Sale'
+ *   }
+ * ], { multi: true, layout: 'cards', columns: 2 });
+ *
+ * @example Shopping cart review
+ * const confirmed = yield io.ask.select('Review your cart:', cartItems.map(item => ({
+ *   value: item.id,
+ *   label: item.name,
+ *   image: item.thumbnail,
+ *   price: item.price,
+ *   quantity: item.qty,
+ *   selected: true  // Pre-selected
+ * })), { multi: true, layout: 'list' });
+ */
+function select(message, options, config) {
+    return { ask: 'select', message, options, ...config };
+}
+/**
+ * Ask for number input
+ *
+ * @example
+ * const qty = yield io.ask.number('Quantity:', { min: 1, max: 100 });
+ */
+function number(message, options) {
+    return { ask: 'number', message, ...options };
+}
+/**
+ * Ask for file selection
+ *
+ * @example
+ * const file = yield io.ask.file('Select a document:', { accept: '.pdf,.doc' });
+ */
+function file(message, options) {
+    return { ask: 'file', message, ...options };
+}
+/**
+ * Ask for date selection
+ *
+ * @example
+ * const date = yield io.ask.date('Select delivery date:');
+ * const datetime = yield io.ask.date('When?', { includeTime: true });
+ */
+function date(message, options) {
+    return { ask: 'date', message, ...options };
+}
+/**
+ * Ask for form input (structured data)
+ *
+ * @example
+ * const contact = yield io.ask.form('Enter contact details:', {
+ *   type: 'object',
+ *   properties: {
+ *     name: { type: 'string', title: 'Full Name' },
+ *     email: { type: 'string', format: 'email', title: 'Email' }
+ *   },
+ *   required: ['name', 'email']
+ * });
+ */
+function form(message, schema, options) {
+    return { ask: 'form', message, schema, ...options };
+}
+/**
+ * Ask via URL (OAuth, external auth)
+ *
+ * @example
+ * const auth = yield io.ask.url('Authenticate with GitHub:', 'https://github.com/login/...');
+ */
+function url(message, urlValue, options) {
+    return { ask: 'url', message, url: urlValue, ...options };
+}
+// ══════════════════════════════════════════════════════════════════════════════
+// EXPORTED API
+// ══════════════════════════════════════════════════════════════════════════════
+/**
+ * IO helper namespace for emit and ask yields
+ *
+ * @example
+ * ```typescript
+ * import { io } from '@portel/photon-core';
+ *
+ * async *myTool() {
+ *   yield io.emit.status('Starting...');
+ *   const name = yield io.ask.text('Name?');
+ * }
+ * ```
+ */
+export const io = {
+    /**
+     * Emit helpers - fire and forget output
+     */
+    emit: {
+        status,
+        progress,
+        stream,
+        log,
+        toast,
+        thinking,
+        artifact,
+        ui,
+    },
+    /**
+     * Ask helpers - blocking input from user
+     */
+    ask: {
+        text,
+        password,
+        confirm,
+        select,
+        number,
+        file,
+        date,
+        form,
+        url,
+    },
+};
+// Also export individual functions for direct import
+export const emit = io.emit;
+export const ask = io.ask;
+//# sourceMappingURL=io.js.map