ai-functions 2.1.1 → 2.3.0

package/dist/context.js

@@ -1,8 +1,8 @@
 /**
  * Execution Context for AI Functions
  *
- * Provides configuration without polluting function signatures.
- * Settings flow from environment → global context → local context.
+ * Standalone context module with batch processing and budget tracking features.
+ * Settings flow from environment -> global context -> local context.
  *
  * @example
  * ```ts
@@ -61,18 +61,6 @@ export function resetContext() {
 let asyncLocalStorage = null;
 // Lazy initialization of AsyncLocalStorage
 let asyncLocalStorageInitialized = false;
-async function initAsyncLocalStorage() {
-    if (asyncLocalStorageInitialized)
-        return;
-    asyncLocalStorageInitialized = true;
-    try {
-        const { AsyncLocalStorage } = await import('async_hooks');
-        asyncLocalStorage = new AsyncLocalStorage();
-    }
-    catch {
-        // Not in Node.js environment, use global context only
-    }
-}
 // Initialize synchronously if possible (for Node.js environments)
 if (typeof process !== 'undefined' && process.versions?.node) {
     import('async_hooks')
@@ -84,15 +72,71 @@ if (typeof process !== 'undefined' && process.versions?.node) {
         asyncLocalStorageInitialized = true;
     });
 }
+// ============================================================================
+// Environment Defaults
+// ============================================================================
+function getEnvContext() {
+    if (typeof process === 'undefined')
+        return {};
+    const context = {};
+    // Model defaults
+    if (process.env['AI_MODEL']) {
+        context.model = process.env['AI_MODEL'];
+    }
+    // Provider defaults
+    if (process.env['AI_PROVIDER']) {
+        context.provider = process.env['AI_PROVIDER'];
+    }
+    else if (process.env['ANTHROPIC_API_KEY'] && !process.env['OPENAI_API_KEY']) {
+        context.provider = 'anthropic';
+    }
+    else if (process.env['OPENAI_API_KEY']) {
+        context.provider = 'openai';
+    }
+    else if (process.env['CLOUDFLARE_API_TOKEN']) {
+        context.provider = 'cloudflare';
+    }
+    else if (process.env['AWS_ACCESS_KEY_ID']) {
+        context.provider = 'bedrock';
+    }
+    return context;
+}
+function getEnvBatchContext() {
+    if (typeof process === 'undefined')
+        return {};
+    const context = {};
+    // Batch mode
+    if (process.env['AI_BATCH_MODE']) {
+        context.batchMode = process.env['AI_BATCH_MODE'];
+    }
+    // Flex threshold (when to start using flex processing)
+    if (process.env['AI_FLEX_THRESHOLD']) {
+        context.flexThreshold = parseInt(process.env['AI_FLEX_THRESHOLD'], 10);
+    }
+    // Batch threshold (when to switch from flex to full batch)
+    if (process.env['AI_BATCH_THRESHOLD']) {
+        context.batchThreshold = parseInt(process.env['AI_BATCH_THRESHOLD'], 10);
+    }
+    // Webhook URL
+    if (process.env['AI_BATCH_WEBHOOK_URL']) {
+        context.webhookUrl = process.env['AI_BATCH_WEBHOOK_URL'];
+    }
+    return context;
+}
+// ============================================================================
+// Context Functions
+// ============================================================================
 /**
  * Get the current execution context
- * Merges: environment defaults → global context → local context
+ * Merges: environment defaults -> global context -> local context
  */
 export function getContext() {
     const envContext = getEnvContext();
+    const envBatchContext = getEnvBatchContext();
     const localContext = asyncLocalStorage?.getStore();
     return {
         ...envContext,
+        ...envBatchContext,
         ...globalContext,
         ...localContext,
     };
@@ -124,51 +168,6 @@ export function withContext(context, fn) {
     }
 }
 // ============================================================================
-// Environment Defaults
-// ============================================================================
-function getEnvContext() {
-    if (typeof process === 'undefined')
-        return {};
-    const context = {};
-    // Model defaults
-    if (process.env.AI_MODEL) {
-        context.model = process.env.AI_MODEL;
-    }
-    // Provider defaults
-    if (process.env.AI_PROVIDER) {
-        context.provider = process.env.AI_PROVIDER;
-    }
-    else if (process.env.ANTHROPIC_API_KEY && !process.env.OPENAI_API_KEY) {
-        context.provider = 'anthropic';
-    }
-    else if (process.env.OPENAI_API_KEY) {
-        context.provider = 'openai';
-    }
-    else if (process.env.CLOUDFLARE_API_TOKEN) {
-        context.provider = 'cloudflare';
-    }
-    else if (process.env.AWS_ACCESS_KEY_ID) {
-        context.provider = 'bedrock';
-    }
-    // Batch mode
-    if (process.env.AI_BATCH_MODE) {
-        context.batchMode = process.env.AI_BATCH_MODE;
-    }
-    // Flex threshold (when to start using flex processing)
-    if (process.env.AI_FLEX_THRESHOLD) {
-        context.flexThreshold = parseInt(process.env.AI_FLEX_THRESHOLD, 10);
-    }
-    // Batch threshold (when to switch from flex to full batch)
-    if (process.env.AI_BATCH_THRESHOLD) {
-        context.batchThreshold = parseInt(process.env.AI_BATCH_THRESHOLD, 10);
-    }
-    // Webhook URL
-    if (process.env.AI_BATCH_WEBHOOK_URL) {
-        context.webhookUrl = process.env.AI_BATCH_WEBHOOK_URL;
-    }
-    return context;
-}
-// ============================================================================
 // Context Helpers
 // ============================================================================
 /**
@@ -179,12 +178,15 @@ export function getModel() {
     return ctx.model || 'sonnet';
 }
 /**
- * Get the effective provider from context
+ * Get the effective provider from context (typed as BatchProvider)
  */
 export function getProvider() {
     const ctx = getContext();
-    return ctx.provider || 'openai';
+    return (ctx.provider || 'openai');
 }
+// ============================================================================
+// Batch-Specific Context Helpers
+// ============================================================================
 /**
  * Get the effective batch mode from context
  */

package/dist/context.js.map

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

package/dist/digital-objects-registry.d.ts

@@ -0,0 +1,229 @@
+/**
+ * DigitalObjectsFunctionRegistry - Persistent function registry using digital-objects
+ *
+ * This implementation stores function definitions as Things and function calls as Actions,
+ * providing full persistence and audit trail capabilities.
+ *
+ * Nouns:
+ * - CodeFunction: Functions that generate executable code
+ * - GenerativeFunction: Functions that use AI to generate content
+ * - AgenticFunction: Functions that run in a loop with tools
+ * - HumanFunction: Functions that require human input/approval
+ *
+ * Verbs:
+ * - define: Function definition action
+ * - call: Function invocation action
+ * - complete: Successful completion action
+ * - fail: Failed execution action
+ *
+ * @packageDocumentation
+ */
+import type { DigitalObjectsProvider, Thing, Action } from 'digital-objects';
+import type { FunctionRegistry, DefinedFunction } from './types.js';
+/**
+ * Noun names for function types
+ */
+export declare const FUNCTION_NOUNS: {
+    readonly CODE: "CodeFunction";
+    readonly GENERATIVE: "GenerativeFunction";
+    readonly AGENTIC: "AgenticFunction";
+    readonly HUMAN: "HumanFunction";
+};
+/**
+ * Verb names for function actions
+ */
+export declare const FUNCTION_VERBS: {
+    readonly DEFINE: "define";
+    readonly CALL: "call";
+    readonly COMPLETE: "complete";
+    readonly FAIL: "fail";
+};
+/**
+ * Stored function definition shape
+ */
+export interface StoredFunctionDefinition {
+    name: string;
+    type: 'code' | 'generative' | 'agentic' | 'human';
+    description?: string;
+    args: unknown;
+    returnType?: unknown;
+    /** Inline deterministic code body for a `code` function (handlers are not persistable). */
+    code?: string;
+    language?: string;
+    instructions?: string;
+    /** @deprecated Legacy code-authoring fields; retained only for back-compat reads. */
+    includeTests?: boolean;
+    /** @deprecated Legacy code-authoring fields; retained only for back-compat reads. */
+    includeExamples?: boolean;
+    output?: string;
+    system?: string;
+    promptTemplate?: string;
+    model?: string;
+    temperature?: number;
+    tools?: unknown[];
+    maxIterations?: number;
+    stream?: boolean;
+    channel?: string;
+    timeout?: number;
+    assignee?: string;
+}
+/**
+ * Function call data stored in actions
+ */
+export interface FunctionCallData {
+    args: unknown;
+    result?: unknown;
+    error?: string;
+    duration?: number;
+}
+/**
+ * Options for creating a DigitalObjectsFunctionRegistry
+ */
+export interface DigitalObjectsRegistryOptions {
+    /** The digital-objects provider to use for storage */
+    provider: DigitalObjectsProvider;
+    /** Whether to auto-initialize nouns and verbs (default: true) */
+    autoInitialize?: boolean;
+}
+/**
+ * DigitalObjectsFunctionRegistry - Persistent function registry using digital-objects
+ *
+ * This class implements the FunctionRegistry interface using digital-objects for storage.
+ * Function definitions are stored as Things, and function calls are tracked as Actions.
+ *
+ * @example
+ * ```ts
+ * import { createMemoryProvider } from 'digital-objects'
+ * import { createDigitalObjectsRegistry, defineFunction } from 'ai-functions'
+ *
+ * const provider = createMemoryProvider()
+ * const registry = await createDigitalObjectsRegistry({ provider })
+ *
+ * // Define a function
+ * const summarize = defineFunction({
+ *   type: 'generative',
+ *   name: 'summarize',
+ *   args: { text: 'Text to summarize' },
+ *   output: 'string',
+ * })
+ *
+ * // Store it in the registry
+ * registry.set('summarize', summarize)
+ *
+ * // Later, retrieve it
+ * const fn = registry.get('summarize')
+ * if (fn) {
+ *   const result = await fn.call({ text: 'Long article...' })
+ * }
+ * ```
+ */
+export declare class DigitalObjectsFunctionRegistry implements FunctionRegistry {
+    private provider;
+    private initialized;
+    private autoInitialize;
+    private initPromise;
+    private functionCache;
+    constructor(options: DigitalObjectsRegistryOptions);
+    /**
+     * Initialize the registry by defining all necessary nouns and verbs
+     */
+    initialize(): Promise<void>;
+    private _initialize;
+    /**
+     * Ensure the registry is initialized before operations
+     */
+    private ensureInitialized;
+    /**
+     * Get a function by name
+     */
+    get(name: string): DefinedFunction | undefined;
+    /**
+     * Get a function by name (async version for loading from storage)
+     */
+    getAsync(name: string): Promise<DefinedFunction | undefined>;
+    /**
+     * Store a function definition
+     */
+    set(name: string, fn: DefinedFunction): void;
+    /**
+     * Store a function definition (async version)
+     */
+    setAsync(name: string, fn: DefinedFunction): Promise<Thing<StoredFunctionDefinition>>;
+    /**
+     * Check if a function exists
+     */
+    has(name: string): boolean;
+    /**
+     * Check if a function exists (async version that also checks storage)
+     */
+    hasAsync(name: string): Promise<boolean>;
+    /**
+     * List all function names
+     */
+    list(): string[];
+    /**
+     * List all function names (async version that includes storage)
+     */
+    listAsync(): Promise<string[]>;
+    /**
+     * Delete a function
+     */
+    delete(name: string): boolean;
+    /**
+     * Delete a function (async version)
+     */
+    deleteAsync(name: string): Promise<boolean>;
+    /**
+     * Clear all functions
+     */
+    clear(): void;
+    /**
+     * Clear all functions (async version)
+     */
+    clearAsync(): Promise<void>;
+    /**
+     * Record a function call as an Action
+     */
+    trackCall(functionName: string, args: unknown): Promise<Action<FunctionCallData>>;
+    /**
+     * Record a successful function completion
+     */
+    trackCompletion(callActionId: string, result: unknown, duration?: number): Promise<Action<FunctionCallData>>;
+    /**
+     * Record a function failure
+     */
+    trackFailure(callActionId: string, error: string, duration?: number): Promise<Action<FunctionCallData>>;
+    /**
+     * Get call history for a function
+     */
+    getCallHistory(functionName: string): Promise<Action<FunctionCallData>[]>;
+    /**
+     * Get all recent function calls
+     */
+    getRecentCalls(limit?: number): Promise<Action<FunctionCallData>[]>;
+    /**
+     * Get the underlying provider for advanced operations
+     */
+    getProvider(): DigitalObjectsProvider;
+}
+/**
+ * Create a DigitalObjectsFunctionRegistry
+ *
+ * @param options - Configuration options including the provider
+ * @returns An initialized DigitalObjectsFunctionRegistry
+ *
+ * @example
+ * ```ts
+ * import { createMemoryProvider } from 'digital-objects'
+ * import { createDigitalObjectsRegistry } from 'ai-functions'
+ *
+ * const provider = createMemoryProvider()
+ * const registry = await createDigitalObjectsRegistry({ provider })
+ *
+ * // Use the registry
+ * registry.set('myFunc', definedFunction)
+ * const fn = registry.get('myFunc')
+ * ```
+ */
+export declare function createDigitalObjectsRegistry(options: DigitalObjectsRegistryOptions): Promise<DigitalObjectsFunctionRegistry>;
+//# sourceMappingURL=digital-objects-registry.d.ts.map

package/dist/digital-objects-registry.d.ts.map

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