@agentick/ai-sdk 0.0.1

package/dist/compiler.d.ts

@@ -0,0 +1,302 @@
+/**
+ * ============================================================================
+ * AI SDK Compiler Adapter
+ * ============================================================================
+ *
+ * This adapter provides progressive adoption for AI SDK users who want to use
+ * our JSX compilation without fully committing to our Engine.
+ *
+ * Direction of adaptation: Engine → ai-sdk
+ * (For ai-sdk → Engine direction, use adapter.ts directly)
+ *
+ * ============================================================================
+ * PROGRESSIVE ADOPTION LEVELS
+ * ============================================================================
+ *
+ * Level 1: compile() only
+ * Returns library-native input. User calls generateText themselves.
+ *
+ * @example
+ * ```typescript
+ * import { compile } from '@tentickle/ai-sdk';
+ * import { generateText } from 'ai';
+ * import { openai } from '@ai-sdk/openai';
+ *
+ * const compiled = await compile(<MyAgent />);
+ *
+ * const result = await generateText({
+ *   model: compiled.model ?? openai('gpt-4o'),
+ *   messages: compiled.messages,
+ *   tools: compiled.tools,
+ *   system: compiled.system,
+ * });
+ * ```
+ *
+ * Level 2: run() with executor
+ * User controls model execution, we handle the tick loop.
+ *
+ * @example
+ * ```typescript
+ * import { createCompiler } from '@tentickle/ai-sdk';
+ * import { generateText } from 'ai';
+ * import { openai } from '@ai-sdk/openai';
+ *
+ * const compiler = createCompiler();
+ *
+ * const result = await compiler.run(<MyAgent />, async (input) => {
+ *   return await generateText({
+ *     model: openai('gpt-4o'),
+ *     ...input,
+ *   });
+ * });
+ * ```
+ *
+ * Level 3: run() / stream() - managed execution
+ * We handle everything. Model comes from <Model> component or config.
+ *
+ * @example
+ * ```typescript
+ * import { createCompiler } from '@tentickle/ai-sdk';
+ * import { openai } from '@ai-sdk/openai';
+ *
+ * const compiler = createCompiler({ model: openai('gpt-4o') });
+ *
+ * const result = await compiler.run(<MyAgent />);
+ *
+ * // Or streaming:
+ * for await (const chunk of compiler.stream(<MyAgent />)) {
+ *   process.stdout.write(chunk.textDelta ?? '');
+ * }
+ * ```
+ *
+ * Level 4: generateText() / streamText() - mirror library API
+ * Same API as ai-sdk, but with JSX as the first argument.
+ *
+ * @example
+ * ```typescript
+ * import { generateText, streamText } from '@tentickle/ai-sdk';
+ * import { openai } from '@ai-sdk/openai';
+ *
+ * // createCompiler run internally
+ *
+ * // Exact same return type as ai-sdk's generateText
+ * const result = await generateText(<MyAgent />, {
+ *   temperature: 0.8,
+ * });
+ *
+ * // Exact same return type as ai-sdk's streamText
+ * const { fullStream, text } = streamText(<MyAgent />);
+ * for await (const chunk of fullStream) {
+ *   // Native ai-sdk chunks
+ * }
+ * ```
+ *
+ * ============================================================================
+ * COMPONENT PORTABILITY
+ * ============================================================================
+ *
+ * All adapter packages export the same component names:
+ * - Model: Configure the model declaratively
+ * - Tool: Define tools in JSX
+ * - Message, System, User, Assistant: Message components
+ *
+ * Switch adapters without changing agent code.
+ *
+ * ============================================================================
+ */
+import { type RuntimeConfig, type JSX } from "@tentickle/core";
+import type { LanguageModel, ModelMessage as AiSdkMessage, ToolSet, TextStreamPart } from "ai";
+import { generateText as aiSdkGenerateText, streamText as aiSdkStreamText } from "ai";
+/**
+ * Library-native compiled output.
+ * This is what compile() returns - ready to pass to generateText/streamText.
+ */
+export interface CompiledInput {
+    /** Messages in ai-sdk CoreMessage format */
+    messages: AiSdkMessage[];
+    /** Tools in ai-sdk ToolSet format (definitions only, no execute) */
+    tools?: ToolSet;
+    /** System prompt (extracted from system messages) */
+    system?: string;
+    /** Model extracted from <Model> component (if present) */
+    model?: LanguageModel;
+    /** Current tick number (for multi-tick execution) */
+    tick: number;
+}
+/**
+ * Executor function signature.
+ * User provides this to control model execution.
+ */
+export type Executor = (input: CompiledInput) => Promise<Awaited<ReturnType<typeof aiSdkGenerateText>>>;
+/**
+ * Stream executor function signature.
+ */
+export type StreamExecutor = (input: CompiledInput) => ReturnType<typeof aiSdkStreamText>;
+/**
+ * Configuration for the compiler.
+ */
+export interface CompilerConfig {
+    /** Default model (used when no <Model> component and no executor provided) */
+    model?: LanguageModel;
+    /** Default temperature */
+    temperature?: number;
+    /** Default max tokens */
+    maxTokens?: number;
+    /** Maximum ticks per execution (default: 10) */
+    maxTicks?: number;
+    /** Additional service config */
+    serviceConfig?: Partial<Omit<RuntimeConfig, "modelGetter" | "processMethods">>;
+}
+/**
+ * Options for generateText/streamText methods.
+ * Matches ai-sdk's options interface.
+ */
+export type GenerateOptions = Partial<Omit<Parameters<typeof aiSdkGenerateText>[0], "messages" | "prompt">>;
+/**
+ * Events emitted during streaming.
+ */
+export type CompilerStreamEvent = {
+    type: "tick_start";
+    tick: number;
+} | {
+    type: "compiled";
+    tick: number;
+    input: CompiledInput;
+} | {
+    type: "chunk";
+    tick: number;
+    chunk: TextStreamPart<ToolSet>;
+} | {
+    type: "tick_end";
+    tick: number;
+} | {
+    type: "complete";
+    result: any;
+};
+/**
+ * Compile JSX to library-native input.
+ *
+ * This is the simplest entry point. You get back messages, tools, and system
+ * in ai-sdk format, ready to pass to generateText/streamText.
+ *
+ * @example
+ * ```typescript
+ * import { compile } from '@tentickle/ai-sdk';
+ * import { generateText } from 'ai';
+ * import { openai } from '@ai-sdk/openai';
+ *
+ * const { messages, tools, system, model } = await compile(<MyAgent />);
+ *
+ * const result = await generateText({
+ *   model: model ?? openai('gpt-4o'),
+ *   messages,
+ *   tools,
+ *   system,
+ * });
+ * ```
+ */
+export declare function compile(jsx: JSX.Element, initialMessages?: AiSdkMessage[]): Promise<CompiledInput>;
+/**
+ * AI SDK Compiler.
+ *
+ * Provides progressive adoption from simple compilation to full execution management.
+ *
+ * @example Level 2: User-controlled execution
+ * ```typescript
+ * const compiler = createCompiler();
+ *
+ * const result = await compiler.run(<MyAgent />, async (input) => {
+ *   return await generateText({ model: openai('gpt-4o'), ...input });
+ * });
+ * ```
+ *
+ * @example Level 3: Managed execution
+ * ```typescript
+ * const compiler = createCompiler({ model: openai('gpt-4o') });
+ * const result = await compiler.run(<MyAgent />);
+ * ```
+ *
+ * @example Level 4: Library-mirroring API
+ * ```typescript
+ * const compiler = createCompiler({ model: openai('gpt-4o') });
+ * const result = await compiler.generateText(<MyAgent />, { temperature: 0.8 });
+ * ```
+ */
+export declare class AiSdkCompiler {
+    private service;
+    private defaultModel?;
+    private defaultOptions;
+    private maxTicks;
+    private executions;
+    private currentExecutor?;
+    constructor(config?: CompilerConfig);
+    private createProcessMethods;
+    private engineInputToMessages;
+    /**
+     * Execute a JSX program.
+     *
+     * If executor is provided (Level 2), user controls model execution.
+     * If not provided (Level 3), we manage execution using configured model.
+     *
+     * @param jsx Root JSX element
+     * @param executorOrMessages Optional executor function OR initial messages
+     * @param maybeExecutor Optional executor (if second arg was messages)
+     */
+    run(jsx: JSX.Element, executorOrMessages?: Executor | AiSdkMessage[], maybeExecutor?: Executor): Promise<Awaited<ReturnType<typeof aiSdkGenerateText>>>;
+    private runInternal;
+    private createManagedExecutor;
+    /**
+     * Execute a JSX program with streaming.
+     *
+     * @param jsx Root JSX element
+     * @param executorOrMessages Optional executor function OR initial messages
+     * @param maybeExecutor Optional executor (if second arg was messages)
+     */
+    stream(jsx: JSX.Element, executorOrMessages?: StreamExecutor | AiSdkMessage[], maybeExecutor?: StreamExecutor): AsyncGenerator<CompilerStreamEvent>;
+    private streamInternal;
+    private createManagedStreamExecutor;
+    destroy(): Promise<void>;
+}
+/**
+ * Generate text using JSX.
+ *
+ * Mirrors ai-sdk's generateText API exactly.
+ * Returns the same type for seamless integration.
+ *
+ * @param jsx Root JSX element
+ * @param options Additional options (merged with defaults and JSX config)
+ */
+export declare function generateText(jsx: JSX.Element, options?: GenerateOptions): Promise<Awaited<ReturnType<typeof aiSdkGenerateText>>>;
+/**
+ * Stream text using JSX.
+ *
+ * Mirrors ai-sdk's streamText API exactly.
+ * Returns the same type for seamless integration.
+ *
+ * @param jsx Root JSX element
+ * @param options Additional options (merged with defaults and JSX config)
+ */
+export declare function streamText(jsx: JSX.Element, options?: GenerateOptions): ReturnType<typeof aiSdkStreamText>;
+/**
+ * Create an AI SDK compiler.
+ *
+ * @example Without model (requires executor or <Model> component)
+ * ```typescript
+ * const compiler = createCompiler();
+ *
+ * // Use with executor
+ * const result = await compiler.run(<MyAgent />, async (input) => {
+ *   return await generateText({ model: openai('gpt-4o'), ...input });
+ * });
+ * ```
+ *
+ * @example With model (managed execution)
+ * ```typescript
+ * const compiler = createCompiler({ model: openai('gpt-4o') });
+ *
+ * const result = await compiler.run(<MyAgent />);
+ * ```
+ */
+export declare function createCompiler(config?: CompilerConfig): AiSdkCompiler;
+export { createCompiler as createAiSdkCompiler };
+//# sourceMappingURL=compiler.d.ts.map

package/dist/compiler.d.ts.map

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