ai-functions 0.3.0 → 2.0.1

package/dist/generate.js

@@ -0,0 +1,174 @@
+/**
+ * AI Generation functions with automatic model resolution and routing
+ *
+ * Wraps AI SDK generateObject and generateText with smart model routing:
+ * - Simple aliases: 'opus', 'sonnet', 'gpt-4o'
+ * - Full IDs: 'anthropic/claude-sonnet-4.5'
+ * - Auto-routes to native SDKs for openai/anthropic/google
+ *
+ * @packageDocumentation
+ */
+import { generateObject as sdkGenerateObject, generateText as sdkGenerateText, streamObject as sdkStreamObject, streamText as sdkStreamText } from 'ai';
+import { schema as convertSchema } from './schema.js';
+/**
+ * Resolve model string to LanguageModel instance
+ * Uses ai-providers for model routing with Cloudflare AI Gateway support
+ */
+async function resolveModel(modelArg) {
+    // Already a LanguageModel instance
+    if (typeof modelArg !== 'string') {
+        return modelArg;
+    }
+    // Use ai-providers for model resolution
+    const { model } = await import('ai-providers');
+    return model(modelArg);
+}
+/**
+ * Check if value is a Zod schema
+ */
+function isZodSchema(value) {
+    return value !== null &&
+        typeof value === 'object' &&
+        '_def' in value &&
+        'parse' in value;
+}
+/**
+ * Convert schema to Zod if needed
+ */
+function resolveSchema(schemaArg) {
+    if (isZodSchema(schemaArg)) {
+        return schemaArg;
+    }
+    return convertSchema(schemaArg);
+}
+/**
+ * Generate a typed object from a prompt using AI
+ *
+ * Automatically resolves model aliases and routes to the best provider.
+ * Supports both Zod schemas and simplified schema syntax.
+ *
+ * @example
+ * ```ts
+ * import { generateObject } from 'ai-functions'
+ *
+ * // Simplified schema syntax
+ * const { object } = await generateObject({
+ *   model: 'sonnet',
+ *   schema: {
+ *     recipe: {
+ *       name: 'What is the recipe name?',
+ *       type: 'food | drink | dessert',
+ *       ingredients: ['List all ingredients'],
+ *       steps: ['List all cooking steps'],
+ *     },
+ *   },
+ *   prompt: 'Generate a lasagna recipe.',
+ * })
+ *
+ * // Zod schema also works
+ * import { z } from 'zod'
+ * const { object } = await generateObject({
+ *   model: 'sonnet',
+ *   schema: z.object({
+ *     name: z.string(),
+ *     ingredients: z.array(z.string()),
+ *   }),
+ *   prompt: 'Generate a lasagna recipe.',
+ * })
+ * ```
+ */
+export async function generateObject(options) {
+    const model = await resolveModel(options.model);
+    const schema = resolveSchema(options.schema);
+    // Use 'as any' to handle AI SDK v4 API variance
+    return sdkGenerateObject({
+        ...options,
+        model,
+        schema,
+        output: 'object'
+    });
+}
+/**
+ * Generate text from a prompt using AI
+ *
+ * Automatically resolves model aliases and routes to the best provider.
+ *
+ * @example
+ * ```ts
+ * import { generateText } from 'ai-functions'
+ *
+ * const { text } = await generateText({
+ *   model: 'opus',  // → anthropic/claude-opus-4.5
+ *   prompt: 'Write a haiku about programming.',
+ * })
+ *
+ * // With tools
+ * const { text, toolResults } = await generateText({
+ *   model: 'gpt-4o',  // → openai/gpt-4o
+ *   prompt: 'What is the weather in San Francisco?',
+ *   tools: { ... },
+ *   maxSteps: 5,
+ * })
+ * ```
+ */
+export async function generateText(options) {
+    const model = await resolveModel(options.model);
+    return sdkGenerateText({
+        ...options,
+        model
+    });
+}
+/**
+ * Stream a typed object from a prompt using AI
+ *
+ * @example
+ * ```ts
+ * import { streamObject } from 'ai-functions'
+ *
+ * const { partialObjectStream } = streamObject({
+ *   model: 'sonnet',
+ *   schema: { story: 'Write a creative story' },
+ *   prompt: 'Write a short story.',
+ * })
+ *
+ * for await (const partial of partialObjectStream) {
+ *   console.log(partial.story)
+ * }
+ * ```
+ */
+export async function streamObject(options) {
+    const model = await resolveModel(options.model);
+    const schema = resolveSchema(options.schema);
+    // Use 'as any' to handle AI SDK API variance
+    return sdkStreamObject({
+        ...options,
+        model,
+        schema,
+        output: 'object'
+    });
+}
+/**
+ * Stream text from a prompt using AI
+ *
+ * @example
+ * ```ts
+ * import { streamText } from 'ai-functions'
+ *
+ * const { textStream } = streamText({
+ *   model: 'gemini',  // → google/gemini-2.5-flash
+ *   prompt: 'Explain quantum computing.',
+ * })
+ *
+ * for await (const chunk of textStream) {
+ *   process.stdout.write(chunk)
+ * }
+ * ```
+ */
+export async function streamText(options) {
+    const model = await resolveModel(options.model);
+    return sdkStreamText({
+        ...options,
+        model
+    });
+}
+//# sourceMappingURL=generate.js.map

package/dist/generate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate.js","sourceRoot":"","sources":["../src/generate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EACL,cAAc,IAAI,iBAAiB,EACnC,YAAY,IAAI,eAAe,EAC/B,YAAY,IAAI,eAAe,EAC/B,UAAU,IAAI,aAAa,EAM5B,MAAM,IAAI,CAAA;AACX,OAAO,EAAE,MAAM,IAAI,aAAa,EAAqB,MAAM,aAAa,CAAA;AA+CxE;;;GAGG;AACH,KAAK,UAAU,YAAY,CAAC,QAAkB;IAC5C,mCAAmC;IACnC,IAAI,OAAO,QAAQ,KAAK,QAAQ,EAAE,CAAC;QACjC,OAAO,QAAQ,CAAA;IACjB,CAAC;IAED,wCAAwC;IACxC,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,MAAM,CAAC,cAAc,CAAC,CAAA;IAC9C,OAAO,KAAK,CAAC,QAAQ,CAAC,CAAA;AACxB,CAAC;AAED;;GAEG;AACH,SAAS,WAAW,CAAC,KAAc;IACjC,OAAO,KAAK,KAAK,IAAI;QACnB,OAAO,KAAK,KAAK,QAAQ;QACzB,MAAM,IAAI,KAAK;QACf,OAAO,IAAI,KAAK,CAAA;AACpB,CAAC;AAED;;GAEG;AACH,SAAS,aAAa,CAAC,SAAoB;IACzC,IAAI,WAAW,CAAC,SAAS,CAAC,EAAE,CAAC;QAC3B,OAAO,SAAS,CAAA;IAClB,CAAC;IACD,OAAO,aAAa,CAAC,SAAyB,CAAC,CAAA;AACjD,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,OAAiC;IAEjC,MAAM,KAAK,GAAG,MAAM,YAAY,CAAC,OAAO,CAAC,KAAK,CAAC,CAAA;IAC/C,MAAM,MAAM,GAAG,aAAa,CAAC,OAAO,CAAC,MAAmB,CAAC,CAAA;IACzD,gDAAgD;IAChD,OAAO,iBAAiB,CAAC;QACvB,GAAG,OAAO;QACV,KAAK;QACL,MAAM;QACN,MAAM,EAAE,QAAQ;KACV,CAAqC,CAAA;AAC/C,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,OAA4B;IAE5B,MAAM,KAAK,GAAG,MAAM,YAAY,CAAC,OAAO,CAAC,KAAK,CAAC,CAAA;IAC/C,OAAO,eAAe,CAAC;QACrB,GAAG,OAAO;QACV,KAAK;KACmC,CAAC,CAAA;AAC7C,CAAC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,OAAiC;IAEjC,MAAM,KAAK,GAAG,MAAM,YAAY,CAAC,OAAO,CAAC,KAAK,CAAC,CAAA;IAC/C,MAAM,MAAM,GAAG,aAAa,CAAC,OAAO,CAAC,MAAmB,CAAC,CAAA;IACzD,6CAA6C;IAC7C,OAAO,eAAe,CAAC;QACrB,GAAG,OAAO;QACV,KAAK;QACL,MAAM;QACN,MAAM,EAAE,QAAQ;KACV,CAA+C,CAAA;AACzD,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,OAA4B;IAE5B,MAAM,KAAK,GAAG,MAAM,YAAY,CAAC,OAAO,CAAC,KAAK,CAAC,CAAA;IAC/C,OAAO,aAAa,CAAC;QACnB,GAAG,OAAO;QACV,KAAK;KACiC,CAAC,CAAA;AAC3C,CAAC"}

package/dist/index.d.ts

@@ -1,5 +1,30 @@
-import { AI, ListFunction } from './types';
-export declare const ai: AI;
-export declare const list: ListFunction;
-export * from './types';
+/**
+ * ai-functions - Core AI primitives for building intelligent applications
+ *
+ * This is the foundational package that all other primitives depend on.
+ * It provides:
+ * - RPC primitives via rpc.do
+ * - AI function types and interfaces
+ * - Core AI() and ai() constructors
+ * - Embedding utilities from AI SDK
+ * - Cloudflare Workers AI provider (default for embeddings)
+ * - Tagged template literal support for all functions
+ * - Async iterator support for list/extract
+ *
+ * @packageDocumentation
+ */
+export * from 'rpc.do';
+export * from './types.js';
+export * from './ai.js';
+export * from './embeddings.js';
+export { generateObject, generateText, streamObject, streamText } from './generate.js';
+export { schema, type SimpleSchema } from './schema.js';
+export * from './providers/index.js';
+export { parseTemplate, createTemplateFunction, createChainablePromise, createStreamableList, withBatch, type FunctionOptions, type TemplateFunction, type BatchableFunction, type StreamableList, type ChainablePromise, } from './template.js';
+export { AIPromise, isAIPromise, getRawPromise, createTextPromise, createObjectPromise, createListPromise, createListsPromise, createBooleanPromise, createExtractPromise, createAITemplateFunction, parseTemplateWithDependencies, AI_PROMISE_SYMBOL, RAW_PROMISE_SYMBOL, type AIPromiseOptions, } from './ai-promise.js';
+export { generate, type GenerateType, type GenerateOptions, ai as aiPrompt, // Renamed to avoid conflict with AIProxy from ai.ts
+write, code, list, lists, extract, summarize, is, diagram, slides, image, video, do, research, read, browse, decide, ask, approve, review, type HumanOptions, type HumanResult, } from './primitives.js';
+export { BatchQueue, createBatch, withBatch as withBatchQueue, registerBatchAdapter, getBatchAdapter, isBatchMode, deferToBatch, BATCH_MODE_SYMBOL, type BatchMode as BatchQueueMode, type BatchProvider, type BatchStatus, type BatchItem, type BatchJob, type BatchResult, type BatchSubmitResult, type BatchAdapter, type BatchQueueOptions, type DeferredOptions, } from './batch-queue.js';
+export { BatchMapPromise, createBatchMap, isBatchMapPromise, BATCH_MAP_SYMBOL, type CapturedOperation, type BatchMapOptions, } from './batch-map.js';
+export { configure, getContext, withContext, getGlobalContext, resetContext, getModel, getProvider, getBatchMode, getBatchThreshold, shouldUseBatchAPI, type ExecutionContext, type BatchMode, } from './context.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":"AAEA,OAAO,EAAE,EAAE,EAAE,YAAY,EAA2D,MAAM,SAAS,CAAA;AA0DnG,eAAO,MAAM,EAAE,EAA4D,EAAE,CAAA;AAG7E,eAAO,MAAM,IAAI,EAA4C,YAAY,CAAA;AAGzE,cAAc,SAAS,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAGH,cAAc,QAAQ,CAAA;AAGtB,cAAc,YAAY,CAAA;AAC1B,cAAc,SAAS,CAAA;AAGvB,cAAc,iBAAiB,CAAA;AAG/B,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,eAAe,CAAA;AAGtF,OAAO,EAAE,MAAM,EAAE,KAAK,YAAY,EAAE,MAAM,aAAa,CAAA;AAGvD,cAAc,sBAAsB,CAAA;AAGpC,OAAO,EACL,aAAa,EACb,sBAAsB,EACtB,sBAAsB,EACtB,oBAAoB,EACpB,SAAS,EACT,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACtB,KAAK,cAAc,EACnB,KAAK,gBAAgB,GACtB,MAAM,eAAe,CAAA;AAGtB,OAAO,EACL,SAAS,EACT,WAAW,EACX,aAAa,EACb,iBAAiB,EACjB,mBAAmB,EACnB,iBAAiB,EACjB,kBAAkB,EAClB,oBAAoB,EACpB,oBAAoB,EACpB,wBAAwB,EACxB,6BAA6B,EAC7B,iBAAiB,EACjB,kBAAkB,EAClB,KAAK,gBAAgB,GACtB,MAAM,iBAAiB,CAAA;AAGxB,OAAO,EAEL,QAAQ,EACR,KAAK,YAAY,EACjB,KAAK,eAAe,EAGpB,EAAE,IAAI,QAAQ,EAAE,oDAAoD;AACpE,KAAK,EACL,IAAI,EACJ,IAAI,EACJ,KAAK,EACL,OAAO,EACP,SAAS,EACT,EAAE,EACF,OAAO,EACP,MAAM,EACN,KAAK,EACL,KAAK,EAGL,EAAE,EACF,QAAQ,EAGR,IAAI,EACJ,MAAM,EAGN,MAAM,EAGN,GAAG,EACH,OAAO,EACP,MAAM,EACN,KAAK,YAAY,EACjB,KAAK,WAAW,GACjB,MAAM,iBAAiB,CAAA;AAGxB,OAAO,EACL,UAAU,EACV,WAAW,EACX,SAAS,IAAI,cAAc,EAC3B,oBAAoB,EACpB,eAAe,EACf,WAAW,EACX,YAAY,EACZ,iBAAiB,EACjB,KAAK,SAAS,IAAI,cAAc,EAChC,KAAK,aAAa,EAClB,KAAK,WAAW,EAChB,KAAK,SAAS,EACd,KAAK,QAAQ,EACb,KAAK,WAAW,EAChB,KAAK,iBAAiB,EACtB,KAAK,YAAY,EACjB,KAAK,iBAAiB,EACtB,KAAK,eAAe,GACrB,MAAM,kBAAkB,CAAA;AAGzB,OAAO,EACL,eAAe,EACf,cAAc,EACd,iBAAiB,EACjB,gBAAgB,EAChB,KAAK,iBAAiB,EACtB,KAAK,eAAe,GACrB,MAAM,gBAAgB,CAAA;AAGvB,OAAO,EACL,SAAS,EACT,UAAU,EACV,WAAW,EACX,gBAAgB,EAChB,YAAY,EACZ,QAAQ,EACR,WAAW,EACX,YAAY,EACZ,iBAAiB,EACjB,iBAAiB,EACjB,KAAK,gBAAgB,EACrB,KAAK,SAAS,GACf,MAAM,cAAc,CAAA"}

package/dist/index.js

@@ -1,53 +1,54 @@
-import { createAIFunction, createTemplateFunction } from './factory';
-import { createListFunction } from './factory/list';
-import { z } from 'zod';
-// Create the main template function with async iteration support
-const templateFn = createTemplateFunction();
-// Create the list function with async iteration support
-const listFn = createListFunction();
-// Create the categorizeProduct function with proper schema
-const categorizeProduct = createAIFunction(z.object({
-    productType: z.enum(['App', 'API', 'Marketplace', 'Platform', 'Packaged Service', 'Professional Service', 'Website']),
-    customer: z.string().describe('ideal customer profile in 3-5 words'),
-    solution: z.string().describe('describe the offer in 4-10 words'),
-    description: z.string().describe('website meta description'),
-}));
-// Create the main AI object with template literal and async iteration support
-function isTemplateStringsArray(value) {
-    return Array.isArray(value) && 'raw' in value;
-}
-function createWrappedTemplateFunction(baseFn) {
-    const wrappedFn = function (stringsOrOptions, ...values) {
-        if (!isTemplateStringsArray(stringsOrOptions)) {
-            return baseFn(values.shift(), ...values, stringsOrOptions);
-        }
-        return baseFn(stringsOrOptions, ...values);
-    };
-    // Make wrappedFn async iterable by delegating to baseFn
-    Object.defineProperty(wrappedFn, Symbol.asyncIterator, {
-        value: function () {
-            return baseFn[Symbol.asyncIterator]();
-        },
-        writable: true,
-        configurable: true,
-    });
-    // Add withOptions method
-    Object.defineProperty(wrappedFn, 'withOptions', {
-        value: (opts) => baseFn.withOptions(opts),
-        writable: true,
-        configurable: true,
-    });
-    // Add queue property
-    Object.defineProperty(wrappedFn, 'queue', {
-        get: () => baseFn.queue,
-        configurable: true,
-    });
-    return wrappedFn;
-}
-const aiFn = createWrappedTemplateFunction(templateFn);
-export const ai = Object.assign(aiFn, { categorizeProduct });
-// Create the list function with template literal and async iteration support
-export const list = createWrappedTemplateFunction(listFn);
-// Export types for consumers
-export * from './types';
+/**
+ * ai-functions - Core AI primitives for building intelligent applications
+ *
+ * This is the foundational package that all other primitives depend on.
+ * It provides:
+ * - RPC primitives via rpc.do
+ * - AI function types and interfaces
+ * - Core AI() and ai() constructors
+ * - Embedding utilities from AI SDK
+ * - Cloudflare Workers AI provider (default for embeddings)
+ * - Tagged template literal support for all functions
+ * - Async iterator support for list/extract
+ *
+ * @packageDocumentation
+ */
+// Re-export RPC primitives from rpc.do
+export * from 'rpc.do';
+// Export AI function types and interfaces
+export * from './types.js';
+export * from './ai.js';
+// Export embedding utilities
+export * from './embeddings.js';
+// Export generation functions with smart model routing
+export { generateObject, generateText, streamObject, streamText } from './generate.js';
+// Export simplified schema helper
+export { schema } from './schema.js';
+// Export providers
+export * from './providers/index.js';
+// Export template utilities
+export { parseTemplate, createTemplateFunction, createChainablePromise, createStreamableList, withBatch, } from './template.js';
+// Export AIPromise utilities for promise pipelining
+export { AIPromise, isAIPromise, getRawPromise, createTextPromise, createObjectPromise, createListPromise, createListsPromise, createBooleanPromise, createExtractPromise, createAITemplateFunction, parseTemplateWithDependencies, AI_PROMISE_SYMBOL, RAW_PROMISE_SYMBOL, } from './ai-promise.js';
+// Export AI primitives
+export { 
+// Core generate primitive
+generate, 
+// Generative functions
+ai as aiPrompt, // Renamed to avoid conflict with AIProxy from ai.ts
+write, code, list, lists, extract, summarize, is, diagram, slides, image, video, 
+// Agentic functions
+do, research, 
+// Web functions
+read, browse, 
+// Decision functions
+decide, 
+// Human-in-the-loop functions
+ask, approve, review, } from './primitives.js';
+// Export batch processing
+export { BatchQueue, createBatch, withBatch as withBatchQueue, registerBatchAdapter, getBatchAdapter, isBatchMode, deferToBatch, BATCH_MODE_SYMBOL, } from './batch-queue.js';
+// Export batch map for automatic batching
+export { BatchMapPromise, createBatchMap, isBatchMapPromise, BATCH_MAP_SYMBOL, } from './batch-map.js';
+// Export execution context
+export { configure, getContext, withContext, getGlobalContext, resetContext, getModel, getProvider, getBatchMode, getBatchThreshold, shouldUseBatchAPI, } from './context.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,OAAO,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,MAAM,WAAW,CAAA;AACpE,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAA;AAEnD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,iEAAiE;AACjE,MAAM,UAAU,GAAG,sBAAsB,EAAE,CAAA;AAE3C,wDAAwD;AACxD,MAAM,MAAM,GAAG,kBAAkB,EAAE,CAAA;AAEnC,2DAA2D;AAC3D,MAAM,iBAAiB,GAAG,gBAAgB,CACxC,CAAC,CAAC,MAAM,CAAC;IACP,WAAW,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,SAAS,CAAC,CAAC;IACrH,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,qCAAqC,CAAC;IACpE,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,kCAAkC,CAAC;IACjE,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,0BAA0B,CAAC;CAC7D,CAAC,CACH,CAAA;AAED,8EAA8E;AAC9E,SAAS,sBAAsB,CAAC,KAAc;IAC5C,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,KAAK,CAAA;AAC/C,CAAC;AAED,SAAS,6BAA6B,CAAC,MAA4B;IACjE,MAAM,SAAS,GAAG,UAAU,gBAA2D,EAAE,GAAG,MAAiB;QAC3G,IAAI,CAAC,sBAAsB,CAAC,gBAAgB,CAAC,EAAE,CAAC;YAC9C,OAAO,MAAM,CAAC,MAAM,CAAC,KAAK,EAA0B,EAAE,GAAG,MAAM,EAAE,gBAAgB,CAAC,CAAA;QACpF,CAAC;QACD,OAAO,MAAM,CAAC,gBAAgB,EAAE,GAAG,MAAM,CAAC,CAAA;IAC5C,CAAC,CAAA;IAED,wDAAwD;IACxD,MAAM,CAAC,cAAc,CAAC,SAAS,EAAE,MAAM,CAAC,aAAa,EAAE;QACrD,KAAK,EAAE;YACL,OAAO,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,EAAE,CAAA;QACvC,CAAC;QACD,QAAQ,EAAE,IAAI;QACd,YAAY,EAAE,IAAI;KACnB,CAAC,CAAA;IAEF,yBAAyB;IACzB,MAAM,CAAC,cAAc,CAAC,SAAS,EAAE,aAAa,EAAE;QAC9C,KAAK,EAAE,CAAC,IAAwB,EAAE,EAAE,CAAC,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC;QAC7D,QAAQ,EAAE,IAAI;QACd,YAAY,EAAE,IAAI;KACnB,CAAC,CAAA;IAEF,qBAAqB;IACrB,MAAM,CAAC,cAAc,CAAC,SAAS,EAAE,OAAO,EAAE;QACxC,GAAG,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,KAAK;QACvB,YAAY,EAAE,IAAI;KACnB,CAAC,CAAA;IAEF,OAAO,SAAiC,CAAA;AAC1C,CAAC;AAED,MAAM,IAAI,GAAG,6BAA6B,CAAC,UAAU,CAAC,CAAA;AACtD,MAAM,CAAC,MAAM,EAAE,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,iBAAiB,EAAE,CAAkB,CAAA;AAE7E,6EAA6E;AAC7E,MAAM,CAAC,MAAM,IAAI,GAAG,6BAA6B,CAAC,MAAM,CAAiB,CAAA;AAEzE,6BAA6B;AAC7B,cAAc,SAAS,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,uCAAuC;AACvC,cAAc,QAAQ,CAAA;AAEtB,0CAA0C;AAC1C,cAAc,YAAY,CAAA;AAC1B,cAAc,SAAS,CAAA;AAEvB,6BAA6B;AAC7B,cAAc,iBAAiB,CAAA;AAE/B,uDAAuD;AACvD,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,eAAe,CAAA;AAEtF,kCAAkC;AAClC,OAAO,EAAE,MAAM,EAAqB,MAAM,aAAa,CAAA;AAEvD,mBAAmB;AACnB,cAAc,sBAAsB,CAAA;AAEpC,4BAA4B;AAC5B,OAAO,EACL,aAAa,EACb,sBAAsB,EACtB,sBAAsB,EACtB,oBAAoB,EACpB,SAAS,GAMV,MAAM,eAAe,CAAA;AAEtB,oDAAoD;AACpD,OAAO,EACL,SAAS,EACT,WAAW,EACX,aAAa,EACb,iBAAiB,EACjB,mBAAmB,EACnB,iBAAiB,EACjB,kBAAkB,EAClB,oBAAoB,EACpB,oBAAoB,EACpB,wBAAwB,EACxB,6BAA6B,EAC7B,iBAAiB,EACjB,kBAAkB,GAEnB,MAAM,iBAAiB,CAAA;AAExB,uBAAuB;AACvB,OAAO;AACL,0BAA0B;AAC1B,QAAQ;AAIR,uBAAuB;AACvB,EAAE,IAAI,QAAQ,EAAE,oDAAoD;AACpE,KAAK,EACL,IAAI,EACJ,IAAI,EACJ,KAAK,EACL,OAAO,EACP,SAAS,EACT,EAAE,EACF,OAAO,EACP,MAAM,EACN,KAAK,EACL,KAAK;AAEL,oBAAoB;AACpB,EAAE,EACF,QAAQ;AAER,gBAAgB;AAChB,IAAI,EACJ,MAAM;AAEN,qBAAqB;AACrB,MAAM;AAEN,8BAA8B;AAC9B,GAAG,EACH,OAAO,EACP,MAAM,GAGP,MAAM,iBAAiB,CAAA;AAExB,0BAA0B;AAC1B,OAAO,EACL,UAAU,EACV,WAAW,EACX,SAAS,IAAI,cAAc,EAC3B,oBAAoB,EACpB,eAAe,EACf,WAAW,EACX,YAAY,EACZ,iBAAiB,GAWlB,MAAM,kBAAkB,CAAA;AAEzB,0CAA0C;AAC1C,OAAO,EACL,eAAe,EACf,cAAc,EACd,iBAAiB,EACjB,gBAAgB,GAGjB,MAAM,gBAAgB,CAAA;AAEvB,2BAA2B;AAC3B,OAAO,EACL,SAAS,EACT,UAAU,EACV,WAAW,EACX,gBAAgB,EAChB,YAAY,EACZ,QAAQ,EACR,WAAW,EACX,YAAY,EACZ,iBAAiB,EACjB,iBAAiB,GAGlB,MAAM,cAAc,CAAA"}

package/dist/primitives.d.ts

@@ -0,0 +1,292 @@
+/**
+ * AI Function Primitives with Promise Pipelining
+ *
+ * All functions return AIPromise for:
+ * - Dynamic schema inference from destructuring
+ * - Promise pipelining without await
+ * - Magical .map() for batch processing
+ * - Dependency graph resolution
+ *
+ * @example
+ * ```ts
+ * // No await needed until the end!
+ * const { summary, keyPoints, conclusion } = ai`write about ${topic}`
+ * const isValid = is`${conclusion} is solid given ${keyPoints}`
+ * const improved = ai`improve ${conclusion} using ${keyPoints}`
+ *
+ * // Batch processing with map
+ * const ideas = list`startup ideas`
+ * const evaluated = await ideas.map(idea => ({
+ *   idea,
+ *   viable: is`${idea} is viable`,
+ *   market: ai`market size for ${idea}`,
+ * }))
+ *
+ * // Only await at the end
+ * if (await isValid) {
+ *   console.log(await improved)
+ * }
+ * ```
+ *
+ * @packageDocumentation
+ */
+import { AIPromise } from './ai-promise.js';
+import type { SimpleSchema } from './schema.js';
+import type { HumanChannel } from './types.js';
+export type GenerateType = 'text' | 'json' | 'code' | 'list' | 'lists' | 'markdown' | 'yaml' | 'diagram' | 'slides' | 'boolean' | 'summary' | 'extract';
+export interface GenerateOptions {
+    /** Model to use */
+    model?: string;
+    /** System prompt */
+    system?: string;
+    /** Temperature (0-2) */
+    temperature?: number;
+    /** Max tokens */
+    maxTokens?: number;
+    /** Schema for JSON output */
+    schema?: SimpleSchema;
+    /** Language for code generation */
+    language?: string;
+    /** Format for diagrams */
+    format?: 'mermaid' | 'svg' | 'ascii';
+    /** Number of slides for presentations */
+    slides?: number;
+}
+/**
+ * Core generate primitive - all other functions use this under the hood
+ */
+export declare function generate(type: GenerateType, prompt: string, options?: GenerateOptions): Promise<unknown>;
+/**
+ * General-purpose AI function with dynamic schema inference
+ *
+ * @example
+ * ```ts
+ * // Simple text generation
+ * const text = await ai`write a poem about ${topic}`
+ *
+ * // Dynamic schema from destructuring - no await needed!
+ * const { summary, keyPoints, conclusion } = ai`write about ${topic}`
+ * console.log(await summary)
+ *
+ * // Chain with other functions
+ * const isValid = is`${conclusion} is solid`
+ * const improved = ai`improve ${conclusion}`
+ * ```
+ */
+export declare const ai: ((strings: TemplateStringsArray, ...values: unknown[]) => AIPromise<unknown>) & ((prompt: string, options?: import("./template.js").FunctionOptions) => AIPromise<unknown>);
+/**
+ * Generate text content
+ *
+ * @example
+ * ```ts
+ * const post = await write`blog post about ${topic}`
+ * ```
+ */
+export declare const write: ((strings: TemplateStringsArray, ...values: unknown[]) => AIPromise<string>) & ((prompt: string, options?: import("./template.js").FunctionOptions) => AIPromise<string>);
+/**
+ * Generate code
+ *
+ * @example
+ * ```ts
+ * const code = await code`email validation function`
+ * ```
+ */
+export declare const code: ((strings: TemplateStringsArray, ...values: unknown[]) => AIPromise<string>) & ((prompt: string, options?: import("./template.js").FunctionOptions) => AIPromise<string>);
+/**
+ * Generate a list of items with .map() support
+ *
+ * @example
+ * ```ts
+ * // Simple list
+ * const ideas = await list`startup ideas`
+ *
+ * // With map - batch processes in ONE call!
+ * const evaluated = await list`startup ideas`.map(idea => ({
+ *   idea,
+ *   viable: is`${idea} is viable`,
+ *   market: ai`market size for ${idea}`,
+ * }))
+ *
+ * // Async iteration
+ * for await (const idea of list`startup ideas`) {
+ *   console.log(idea)
+ * }
+ * ```
+ */
+export declare const list: ((strings: TemplateStringsArray, ...values: unknown[]) => AIPromise<string[]>) & ((prompt: string, options?: import("./template.js").FunctionOptions) => AIPromise<string[]>);
+/**
+ * Generate multiple named lists with dynamic schema
+ *
+ * @example
+ * ```ts
+ * // Destructuring infers the schema!
+ * const { pros, cons } = await lists`pros and cons of ${topic}`
+ *
+ * // No await - pipeline with other functions
+ * const { benefits, risks, costs } = lists`analysis of ${project}`
+ * const summary = ai`summarize: benefits=${benefits}, risks=${risks}`
+ * console.log(await summary)
+ * ```
+ */
+export declare const lists: ((strings: TemplateStringsArray, ...values: unknown[]) => AIPromise<Record<string, string[]>>) & ((prompt: string, options?: import("./template.js").FunctionOptions) => AIPromise<Record<string, string[]>>);
+/**
+ * Extract structured data with dynamic schema
+ *
+ * @example
+ * ```ts
+ * // Dynamic schema from destructuring
+ * const { name, email, phone } = await extract`contact info from ${document}`
+ *
+ * // As array
+ * const emails = await extract`email addresses from ${text}`
+ * ```
+ */
+export declare const extract: ((strings: TemplateStringsArray, ...values: unknown[]) => AIPromise<unknown[]>) & ((prompt: string, options?: import("./template.js").FunctionOptions) => AIPromise<unknown[]>);
+/**
+ * Summarize text
+ *
+ * @example
+ * ```ts
+ * const summary = await summarize`${longArticle}`
+ * ```
+ */
+export declare const summarize: ((strings: TemplateStringsArray, ...values: unknown[]) => AIPromise<string>) & ((prompt: string, options?: import("./template.js").FunctionOptions) => AIPromise<string>);
+/**
+ * Check if something is true/false
+ *
+ * @example
+ * ```ts
+ * // Simple check
+ * const isColor = await is`${topic} a color`
+ *
+ * // Pipeline - no await needed!
+ * const { conclusion } = ai`write about ${topic}`
+ * const isValid = is`${conclusion} is well-argued`
+ * if (await isValid) { ... }
+ * ```
+ */
+export declare const is: ((strings: TemplateStringsArray, ...values: unknown[]) => AIPromise<boolean>) & ((prompt: string, options?: import("./template.js").FunctionOptions) => AIPromise<boolean>);
+/**
+ * Generate a diagram
+ *
+ * @example
+ * ```ts
+ * const diagram = await diagram`user authentication flow`
+ * ```
+ */
+export declare const diagram: ((strings: TemplateStringsArray, ...values: unknown[]) => AIPromise<string>) & ((prompt: string, options?: import("./template.js").FunctionOptions) => AIPromise<string>);
+/**
+ * Generate presentation slides
+ *
+ * @example
+ * ```ts
+ * const slides = await slides`quarterly review`
+ * ```
+ */
+export declare const slides: ((strings: TemplateStringsArray, ...values: unknown[]) => AIPromise<string>) & ((prompt: string, options?: import("./template.js").FunctionOptions) => AIPromise<string>);
+/**
+ * Generate an image
+ */
+export declare const image: ((strings: TemplateStringsArray, ...values: unknown[]) => AIPromise<Buffer<ArrayBufferLike>>) & ((prompt: string, options?: import("./template.js").FunctionOptions) => AIPromise<Buffer<ArrayBufferLike>>);
+/**
+ * Generate a video
+ */
+export declare const video: ((strings: TemplateStringsArray, ...values: unknown[]) => AIPromise<Buffer<ArrayBufferLike>>) & ((prompt: string, options?: import("./template.js").FunctionOptions) => AIPromise<Buffer<ArrayBufferLike>>);
+/**
+ * Execute a task
+ *
+ * @example
+ * ```ts
+ * const { summary, actions } = await do`send welcome email to ${user}`
+ * ```
+ */
+declare function doImpl(promptOrStrings: string | TemplateStringsArray, ...args: unknown[]): AIPromise<{
+    summary: string;
+    actions: string[];
+}>;
+export { doImpl as do };
+/**
+ * Conduct research on a topic
+ *
+ * @example
+ * ```ts
+ * const { summary, findings, sources } = await research`${competitor} vs our product`
+ * ```
+ */
+export declare const research: ((strings: TemplateStringsArray, ...values: unknown[]) => AIPromise<{
+    summary: string;
+    findings: string[];
+    sources: string[];
+}>) & ((prompt: string, options?: import("./template.js").FunctionOptions) => AIPromise<{
+    summary: string;
+    findings: string[];
+    sources: string[];
+}>);
+/**
+ * Read a URL and convert to markdown
+ */
+export declare const read: ((strings: TemplateStringsArray, ...values: unknown[]) => AIPromise<string>) & ((prompt: string, options?: import("./template.js").FunctionOptions) => AIPromise<string>);
+/**
+ * Browse a URL with browser automation
+ */
+export declare function browse(urlOrStrings: string | TemplateStringsArray, ...args: unknown[]): Promise<{
+    do: (action: string) => Promise<void>;
+    extract: (query: string) => Promise<unknown>;
+    screenshot: () => Promise<Buffer>;
+    close: () => Promise<void>;
+}>;
+/**
+ * LLM as judge - compare options and pick the best
+ *
+ * @example
+ * ```ts
+ * const winner = await decide`higher click-through rate`(headlineA, headlineB)
+ * ```
+ */
+export declare function decide(criteriaOrStrings: string | TemplateStringsArray, ...templateArgs: unknown[]): <T>(...options: T[]) => AIPromise<T>;
+export interface HumanOptions extends GenerateOptions {
+    channel?: HumanChannel;
+    assignee?: string;
+    timeout?: number;
+    webhook?: string;
+}
+export interface HumanResult<T = unknown> {
+    pending: boolean;
+    requestId: string;
+    response?: T;
+    respondedBy?: string;
+    respondedAt?: Date;
+    artifacts?: {
+        slackBlocks?: unknown[];
+        emailHtml?: string;
+        webComponent?: string;
+        smsText?: string;
+    };
+}
+/**
+ * Ask a human for input
+ */
+export declare const ask: ((strings: TemplateStringsArray, ...values: unknown[]) => AIPromise<HumanResult<string>>) & ((prompt: string, options?: import("./template.js").FunctionOptions) => AIPromise<HumanResult<string>>);
+/**
+ * Request human approval
+ */
+export declare const approve: ((strings: TemplateStringsArray, ...values: unknown[]) => AIPromise<HumanResult<{
+    approved: boolean;
+    notes?: string;
+}>>) & ((prompt: string, options?: import("./template.js").FunctionOptions) => AIPromise<HumanResult<{
+    approved: boolean;
+    notes?: string;
+}>>);
+/**
+ * Request human review
+ */
+export declare const review: ((strings: TemplateStringsArray, ...values: unknown[]) => AIPromise<HumanResult<{
+    rating?: number;
+    feedback: string;
+    approved?: boolean;
+}>>) & ((prompt: string, options?: import("./template.js").FunctionOptions) => AIPromise<HumanResult<{
+    rating?: number;
+    feedback: string;
+    approved?: boolean;
+}>>);
+//# sourceMappingURL=primitives.d.ts.map

package/dist/primitives.d.ts.map

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