ai-props 2.1.3 → 2.4.0

package/dist/worker.d.ts

@@ -0,0 +1,270 @@
+/**
+ * Worker Export - WorkerEntrypoint for RPC access to AI Props
+ *
+ * Exposes AI props generation methods via Cloudflare RPC.
+ * Provides schema-based prop generation, caching, validation,
+ * and cascade execution patterns.
+ *
+ * ## Features
+ *
+ * - **RPC Service**: WorkerEntrypoint for service binding access
+ * - **Cascade Execution**: Code -> Generative -> Agentic -> Human escalation
+ * - **Durable Cascades**: Cloudflare Workflows integration for durability
+ * - **AI Gateway**: Configuration helpers for Cloudflare AI Gateway
+ *
+ * @example
+ * ```typescript
+ * // wrangler.jsonc
+ * {
+ *   "services": [
+ *     { "binding": "AI_PROPS", "service": "ai-props" }
+ *   ]
+ * }
+ *
+ * // worker.ts - consuming service
+ * export default {
+ *   async fetch(request: Request, env: Env) {
+ *     const service = env.AI_PROPS.connect()
+ *     const result = await service.generate({
+ *       schema: { title: 'Page title', description: 'Page description' },
+ *       context: { topic: 'AI' }
+ *     })
+ *     return Response.json(result.props)
+ *   }
+ * }
+ * ```
+ *
+ * ## Cascade Pattern
+ *
+ * @example
+ * ```typescript
+ * import {
+ *   DurableCascadeExecutor,
+ *   createDurableCascadeStep,
+ *   createAIGatewayConfig
+ * } from 'ai-props/worker'
+ *
+ * // Create a durable cascade for content generation
+ * const contentCascade = createDurableCascadeStep({
+ *   name: 'generate-content',
+ *   code: async (input) => {
+ *     if (input.template) return { content: input.template }
+ *     throw new Error('No template available')
+ *   },
+ *   generative: async (input, ctx) => {
+ *     const result = await ctx.ai.run('@cf/meta/llama-3-8b-instruct', {
+ *       messages: [{ role: 'user', content: `Generate content about: ${input.topic}` }]
+ *     })
+ *     return { content: result.response }
+ *   }
+ * })
+ *
+ * // In a Cloudflare Workflow
+ * const result = await contentCascade.run(step, { topic: 'AI' })
+ * console.log(result.tier) // 'code' or 'generative'
+ * ```
+ *
+ * @packageDocumentation
+ */
+import { WorkerEntrypoint, RpcTarget } from 'cloudflare:workers';
+import type { PropSchema, GeneratePropsOptions, GeneratePropsResult, AIPropsConfig, PropsCacheEntry, ValidationResult } from './types.js';
+/**
+ * Environment bindings for the worker
+ */
+export interface Env {
+    AI?: unknown;
+}
+/**
+ * PropsServiceCore - RpcTarget wrapper for AI props functionality
+ *
+ * Exposes all required methods as RPC-callable methods.
+ * This is the core service class that can be instantiated directly.
+ */
+export declare class PropsServiceCore extends RpcTarget {
+    private cache;
+    constructor();
+    /**
+     * Generate props using AI
+     *
+     * @example
+     * ```ts
+     * const result = await service.generate({
+     *   schema: {
+     *     title: 'A compelling page title',
+     *     description: 'A brief description',
+     *   },
+     *   context: { topic: 'AI-powered applications' },
+     * })
+     * ```
+     */
+    generate<T = Record<string, unknown>>(options: GeneratePropsOptions): Promise<GeneratePropsResult<T>>;
+    /**
+     * Generate props synchronously from cache
+     *
+     * @throws {Error} If props are not in cache
+     */
+    getSync<T = Record<string, unknown>>(schema: PropSchema, context?: Record<string, unknown>): T;
+    /**
+     * Pre-generate props for warming the cache
+     */
+    prefetch(requests: GeneratePropsOptions[]): Promise<void>;
+    /**
+     * Generate multiple prop sets in parallel
+     */
+    generateMany<T = Record<string, unknown>>(requests: GeneratePropsOptions[]): Promise<GeneratePropsResult<T>[]>;
+    /**
+     * Merge partial props with generated props
+     *
+     * Generates only the missing props, keeping provided ones.
+     */
+    mergeWithGenerated<T extends Record<string, unknown>>(schema: PropSchema, partialProps: Partial<T>, options?: Omit<GeneratePropsOptions, 'schema' | 'context'>): Promise<T>;
+    /**
+     * Configure global AI props settings
+     */
+    configure(config: Partial<AIPropsConfig>): void;
+    /**
+     * Get current configuration
+     */
+    getConfig(): AIPropsConfig;
+    /**
+     * Reset configuration to defaults
+     */
+    resetConfig(): void;
+    /**
+     * Get cached props by key
+     */
+    getCached<T>(key: string): PropsCacheEntry<T> | undefined;
+    /**
+     * Set props in cache
+     */
+    setCached<T>(key: string, props: T): void;
+    /**
+     * Delete cached entry by key
+     */
+    deleteCached(key: string): boolean;
+    /**
+     * Clear all cached props
+     */
+    clearCache(): void;
+    /**
+     * Get cache size
+     */
+    getCacheSize(): number;
+    /**
+     * Create a cache key from schema and context
+     */
+    createCacheKey(schema: PropSchema, context?: Record<string, unknown>): string;
+    /**
+     * Configure cache TTL
+     */
+    configureCache(ttl: number): void;
+    /**
+     * Validate props against a schema
+     */
+    validate(props: Record<string, unknown>, schema: PropSchema): ValidationResult;
+    /**
+     * Check if all required props are present
+     */
+    hasRequired(props: Record<string, unknown>, required: string[]): boolean;
+    /**
+     * Get list of missing props according to schema
+     */
+    getMissing(props: Record<string, unknown>, schema: PropSchema): string[];
+    /**
+     * Check if props are complete according to schema
+     */
+    isComplete(props: Record<string, unknown>, schema: PropSchema): boolean;
+    /**
+     * Sanitize props by removing unknown keys
+     */
+    sanitize<T extends Record<string, unknown>>(props: T, schema: PropSchema): Partial<T>;
+    /**
+     * Merge props with default values
+     */
+    mergeDefaults<T extends Record<string, unknown>>(props: Partial<T>, defaults: Partial<T>, schema: PropSchema): Partial<T>;
+}
+/**
+ * PropsService - WorkerEntrypoint for RPC access
+ *
+ * Provides `connect()` method that returns an RpcTarget service
+ * with all AI props methods. Also handles HTTP endpoints for
+ * direct JSON-RPC access.
+ *
+ * @example
+ * ```typescript
+ * // In consuming worker
+ * const service = env.AI_PROPS.connect()
+ * const result = await service.generate({
+ *   schema: { title: 'Page title' }
+ * })
+ * ```
+ */
+export declare class PropsService extends WorkerEntrypoint<Env> {
+    private serviceCore;
+    /**
+     * Get or create the service core instance
+     */
+    private getServiceCore;
+    /**
+     * Get a connected service instance for RPC calls
+     *
+     * Note: Named 'getService' instead of 'connect' because 'connect'
+     * is a reserved method name in Cloudflare Workers RPC (used for sockets).
+     *
+     * @returns PropsServiceCore instance for RPC calls
+     */
+    getService(): PropsServiceCore;
+    /**
+     * Alias for getService() - provides the connect() interface
+     * Note: This may conflict with the Fetcher's connect() for sockets
+     * when accessed via service bindings. Use getService() instead.
+     *
+     * @deprecated Use getService() instead
+     * @returns PropsServiceCore instance for RPC calls
+     */
+    connect(): PropsServiceCore;
+    /**
+     * HTTP request handler for JSON-RPC and service info endpoints
+     *
+     * Routes:
+     * - GET / - Returns service info
+     * - POST /rpc - JSON-RPC endpoint for calling service methods
+     */
+    fetch(request: Request): Promise<Response>;
+}
+/**
+ * Default export for Cloudflare Workers
+ */
+export default PropsService;
+/**
+ * Export aliases
+ */
+export { PropsService as PropsWorker };
+export { CascadeExecutor, createCascadeStep, type CascadeConfig, type CascadeResult, type CascadeContext, type TierContext, type TierHandler, type TierResult, type CapabilityTier, type FiveWHEvent, type TierRetryConfig, type SkipCondition, type CascadeMetrics, type CascadeStep, TIER_ORDER, DEFAULT_TIER_TIMEOUTS, CascadeTimeoutError, TierSkippedError, AllTiersFailedError, createCascadeContext, recordStep, } from './cascade.js';
+export { DurableCascadeExecutor, createDurableCascadeStep, createAIGatewayConfig, type DurableCascadeConfig, type DurableCascadeTierContext, type DurableStepConfig, type DurableRetryConfig, type WorkflowStep, type AiBinding, type HumanReviewRequest, type AIGatewayConfig, type CodeTierHandler, type AiTierHandler, type HumanTierHandler, } from './durable-cascade.js';
+/**
+ * Event System exports for Queue-based event handling
+ *
+ * @example
+ * ```typescript
+ * import { EventBridge, createQueueHandler } from 'ai-props/worker'
+ *
+ * const bridge = new EventBridge(env.MY_QUEUE)
+ * bridge.on('user.created', async (data) => {
+ *   console.log('User created:', data.id)
+ * })
+ *
+ * export default {
+ *   async fetch(request, env) {
+ *     await bridge.emit('user.created', { id: '123' })
+ *     return new Response('OK')
+ *   },
+ *   async queue(batch, env) {
+ *     const handler = createQueueHandler(bridge)
+ *     await handler.queue(batch, env)
+ *   }
+ * }
+ * ```
+ */
+export { EventBridge, createQueueHandler, createEventBridge, type QueuedEvent, type EventBridgeConfig, type EventHandler, type EmitOptions, type Queue, type QueueMessage, type MessageBatch, type TypedEventBridge, } from './event-bridge.js';
+//# sourceMappingURL=worker.d.ts.map

package/dist/worker.d.ts.map

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

package/dist/worker.js

@@ -0,0 +1,405 @@
+/**
+ * Worker Export - WorkerEntrypoint for RPC access to AI Props
+ *
+ * Exposes AI props generation methods via Cloudflare RPC.
+ * Provides schema-based prop generation, caching, validation,
+ * and cascade execution patterns.
+ *
+ * ## Features
+ *
+ * - **RPC Service**: WorkerEntrypoint for service binding access
+ * - **Cascade Execution**: Code -> Generative -> Agentic -> Human escalation
+ * - **Durable Cascades**: Cloudflare Workflows integration for durability
+ * - **AI Gateway**: Configuration helpers for Cloudflare AI Gateway
+ *
+ * @example
+ * ```typescript
+ * // wrangler.jsonc
+ * {
+ *   "services": [
+ *     { "binding": "AI_PROPS", "service": "ai-props" }
+ *   ]
+ * }
+ *
+ * // worker.ts - consuming service
+ * export default {
+ *   async fetch(request: Request, env: Env) {
+ *     const service = env.AI_PROPS.connect()
+ *     const result = await service.generate({
+ *       schema: { title: 'Page title', description: 'Page description' },
+ *       context: { topic: 'AI' }
+ *     })
+ *     return Response.json(result.props)
+ *   }
+ * }
+ * ```
+ *
+ * ## Cascade Pattern
+ *
+ * @example
+ * ```typescript
+ * import {
+ *   DurableCascadeExecutor,
+ *   createDurableCascadeStep,
+ *   createAIGatewayConfig
+ * } from 'ai-props/worker'
+ *
+ * // Create a durable cascade for content generation
+ * const contentCascade = createDurableCascadeStep({
+ *   name: 'generate-content',
+ *   code: async (input) => {
+ *     if (input.template) return { content: input.template }
+ *     throw new Error('No template available')
+ *   },
+ *   generative: async (input, ctx) => {
+ *     const result = await ctx.ai.run('@cf/meta/llama-3-8b-instruct', {
+ *       messages: [{ role: 'user', content: `Generate content about: ${input.topic}` }]
+ *     })
+ *     return { content: result.response }
+ *   }
+ * })
+ *
+ * // In a Cloudflare Workflow
+ * const result = await contentCascade.run(step, { topic: 'AI' })
+ * console.log(result.tier) // 'code' or 'generative'
+ * ```
+ *
+ * @packageDocumentation
+ */
+import { WorkerEntrypoint, RpcTarget } from 'cloudflare:workers';
+import { generateProps, getPropsSync, prefetchProps, generatePropsMany, mergeWithGenerated, configureAIProps, getConfig, resetConfig, } from './generate.js';
+import { MemoryPropsCache, LRUPropsCache, createCacheKey, getDefaultCache, configureCache, clearCache, } from './cache.js';
+import { validateProps, hasRequiredProps, getMissingFromSchema, isComplete, sanitizeProps, mergeWithDefaults, } from './validate.js';
+/**
+ * PropsServiceCore - RpcTarget wrapper for AI props functionality
+ *
+ * Exposes all required methods as RPC-callable methods.
+ * This is the core service class that can be instantiated directly.
+ */
+export class PropsServiceCore extends RpcTarget {
+    cache;
+    constructor() {
+        super();
+        this.cache = getDefaultCache();
+    }
+    // ==================== Generation ====================
+    /**
+     * Generate props using AI
+     *
+     * @example
+     * ```ts
+     * const result = await service.generate({
+     *   schema: {
+     *     title: 'A compelling page title',
+     *     description: 'A brief description',
+     *   },
+     *   context: { topic: 'AI-powered applications' },
+     * })
+     * ```
+     */
+    async generate(options) {
+        return generateProps(options);
+    }
+    /**
+     * Generate props synchronously from cache
+     *
+     * @throws {Error} If props are not in cache
+     */
+    getSync(schema, context) {
+        return getPropsSync(schema, context);
+    }
+    /**
+     * Pre-generate props for warming the cache
+     */
+    async prefetch(requests) {
+        return prefetchProps(requests);
+    }
+    /**
+     * Generate multiple prop sets in parallel
+     */
+    async generateMany(requests) {
+        return generatePropsMany(requests);
+    }
+    /**
+     * Merge partial props with generated props
+     *
+     * Generates only the missing props, keeping provided ones.
+     */
+    async mergeWithGenerated(schema, partialProps, options) {
+        return mergeWithGenerated(schema, partialProps, options);
+    }
+    // ==================== Configuration ====================
+    /**
+     * Configure global AI props settings
+     */
+    configure(config) {
+        configureAIProps(config);
+    }
+    /**
+     * Get current configuration
+     */
+    getConfig() {
+        return getConfig();
+    }
+    /**
+     * Reset configuration to defaults
+     */
+    resetConfig() {
+        resetConfig();
+    }
+    // ==================== Cache Operations ====================
+    /**
+     * Get cached props by key
+     */
+    getCached(key) {
+        return this.cache.get(key);
+    }
+    /**
+     * Set props in cache
+     */
+    setCached(key, props) {
+        this.cache.set(key, props);
+    }
+    /**
+     * Delete cached entry by key
+     */
+    deleteCached(key) {
+        return this.cache.delete(key);
+    }
+    /**
+     * Clear all cached props
+     */
+    clearCache() {
+        clearCache();
+    }
+    /**
+     * Get cache size
+     */
+    getCacheSize() {
+        return this.cache.size;
+    }
+    /**
+     * Create a cache key from schema and context
+     */
+    createCacheKey(schema, context) {
+        return createCacheKey(schema, context);
+    }
+    /**
+     * Configure cache TTL
+     */
+    configureCache(ttl) {
+        configureCache(ttl);
+        this.cache = getDefaultCache();
+    }
+    // ==================== Validation ====================
+    /**
+     * Validate props against a schema
+     */
+    validate(props, schema) {
+        return validateProps(props, schema);
+    }
+    /**
+     * Check if all required props are present
+     */
+    hasRequired(props, required) {
+        return hasRequiredProps(props, required);
+    }
+    /**
+     * Get list of missing props according to schema
+     */
+    getMissing(props, schema) {
+        return getMissingFromSchema(props, schema);
+    }
+    /**
+     * Check if props are complete according to schema
+     */
+    isComplete(props, schema) {
+        return isComplete(props, schema);
+    }
+    /**
+     * Sanitize props by removing unknown keys
+     */
+    sanitize(props, schema) {
+        return sanitizeProps(props, schema);
+    }
+    /**
+     * Merge props with default values
+     */
+    mergeDefaults(props, defaults, schema) {
+        return mergeWithDefaults(props, defaults, schema);
+    }
+}
+/**
+ * PropsService - WorkerEntrypoint for RPC access
+ *
+ * Provides `connect()` method that returns an RpcTarget service
+ * with all AI props methods. Also handles HTTP endpoints for
+ * direct JSON-RPC access.
+ *
+ * @example
+ * ```typescript
+ * // In consuming worker
+ * const service = env.AI_PROPS.connect()
+ * const result = await service.generate({
+ *   schema: { title: 'Page title' }
+ * })
+ * ```
+ */
+export class PropsService extends WorkerEntrypoint {
+    serviceCore = null;
+    /**
+     * Get or create the service core instance
+     */
+    getServiceCore() {
+        if (!this.serviceCore) {
+            this.serviceCore = new PropsServiceCore();
+        }
+        return this.serviceCore;
+    }
+    /**
+     * Get a connected service instance for RPC calls
+     *
+     * Note: Named 'getService' instead of 'connect' because 'connect'
+     * is a reserved method name in Cloudflare Workers RPC (used for sockets).
+     *
+     * @returns PropsServiceCore instance for RPC calls
+     */
+    getService() {
+        return this.getServiceCore();
+    }
+    /**
+     * Alias for getService() - provides the connect() interface
+     * Note: This may conflict with the Fetcher's connect() for sockets
+     * when accessed via service bindings. Use getService() instead.
+     *
+     * @deprecated Use getService() instead
+     * @returns PropsServiceCore instance for RPC calls
+     */
+    connect() {
+        return this.getServiceCore();
+    }
+    /**
+     * HTTP request handler for JSON-RPC and service info endpoints
+     *
+     * Routes:
+     * - GET / - Returns service info
+     * - POST /rpc - JSON-RPC endpoint for calling service methods
+     */
+    async fetch(request) {
+        const url = new URL(request.url);
+        // GET / - Service info
+        if (request.method === 'GET' && url.pathname === '/') {
+            const service = this.getServiceCore();
+            return Response.json({
+                name: 'ai-props',
+                version: '1.0.0',
+                methods: [
+                    'generate',
+                    'getSync',
+                    'prefetch',
+                    'generateMany',
+                    'mergeWithGenerated',
+                    'configure',
+                    'getConfig',
+                    'resetConfig',
+                    'getCached',
+                    'setCached',
+                    'deleteCached',
+                    'clearCache',
+                    'getCacheSize',
+                    'createCacheKey',
+                    'configureCache',
+                    'validate',
+                    'hasRequired',
+                    'getMissing',
+                    'isComplete',
+                    'sanitize',
+                    'mergeDefaults',
+                ],
+                rpc: '/rpc',
+            });
+        }
+        // POST /rpc - JSON-RPC endpoint
+        if (url.pathname === '/rpc' && request.method === 'POST') {
+            try {
+                const body = (await request.json());
+                const { method, args = [] } = body;
+                if (!method || typeof method !== 'string') {
+                    return Response.json({ error: 'Missing or invalid method' }, { status: 400 });
+                }
+                const service = this.getServiceCore();
+                // Check if method exists on service
+                const methodFn = service[method];
+                if (typeof methodFn !== 'function') {
+                    return Response.json({ error: `Method "${method}" not found` }, { status: 404 });
+                }
+                // Call the method
+                const result = await methodFn.apply(service, args);
+                return Response.json({ result });
+            }
+            catch (error) {
+                const message = error instanceof Error ? error.message : 'Unknown error';
+                return Response.json({ error: message }, { status: 500 });
+            }
+        }
+        // 404 for other routes
+        return Response.json({ error: 'Not found' }, { status: 404 });
+    }
+}
+/**
+ * Default export for Cloudflare Workers
+ */
+export default PropsService;
+/**
+ * Export aliases
+ */
+export { PropsService as PropsWorker };
+// =============================================================================
+// Cascade Execution - Code -> Generative -> Agentic -> Human pattern
+// =============================================================================
+export { 
+// Base cascade (non-durable)
+CascadeExecutor, createCascadeStep, 
+// Constants
+TIER_ORDER, DEFAULT_TIER_TIMEOUTS, 
+// Errors
+CascadeTimeoutError, TierSkippedError, AllTiersFailedError, 
+// Helpers
+createCascadeContext, recordStep, } from './cascade.js';
+// =============================================================================
+// Durable Cascade - Cloudflare Workflows integration
+// =============================================================================
+export { 
+// Durable cascade executor
+DurableCascadeExecutor, createDurableCascadeStep, 
+// AI Gateway configuration
+createAIGatewayConfig, } from './durable-cascade.js';
+// =============================================================================
+// Event System - Queue-based event handling
+// =============================================================================
+/**
+ * Event System exports for Queue-based event handling
+ *
+ * @example
+ * ```typescript
+ * import { EventBridge, createQueueHandler } from 'ai-props/worker'
+ *
+ * const bridge = new EventBridge(env.MY_QUEUE)
+ * bridge.on('user.created', async (data) => {
+ *   console.log('User created:', data.id)
+ * })
+ *
+ * export default {
+ *   async fetch(request, env) {
+ *     await bridge.emit('user.created', { id: '123' })
+ *     return new Response('OK')
+ *   },
+ *   async queue(batch, env) {
+ *     const handler = createQueueHandler(bridge)
+ *     await handler.queue(batch, env)
+ *   }
+ * }
+ * ```
+ */
+export { EventBridge, createQueueHandler, createEventBridge, } from './event-bridge.js';
+//# sourceMappingURL=worker.js.map

package/dist/worker.js.map

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