@agentick/core 0.0.1

package/dist/model/adapter-helpers.js.map

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

package/dist/model/adapter.d.ts

@@ -0,0 +1,399 @@
+/**
+ * Adapter - The recommended way to create model adapters
+ *
+ * This provides a clean API for creating adapters while preserving
+ * all framework features (streaming, metadata, model-specific defaults, options merging).
+ *
+ * ## Why createAdapter?
+ *
+ * Creating adapters is one of the most common tasks when extending Agentick.
+ * This API minimizes boilerplate while maximizing flexibility:
+ *
+ * - **Minimal API**: Just implement prepareInput, mapChunk, execute, executeStream
+ * - **Automatic streaming**: StreamAccumulator handles all lifecycle events
+ * - **Options merging**: Built-in merging of providerOptions and libraryOptions
+ * - **Model defaults**: Full support for messageTransformation config
+ * - **Metadata extraction**: Hook for citations, annotations, grounding
+ *
+ * ## Quick Start
+ *
+ * ```typescript
+ * import { createAdapter, StopReason } from '@agentick/core/model';
+ *
+ * const model = createAdapter({
+ *   metadata: {
+ *     id: 'my-provider:my-model',
+ *     provider: 'my-provider',
+ *     capabilities: [{ stream: true, toolCalls: true }],
+ *   },
+ *
+ *   prepareInput: (input) => ({
+ *     model: 'my-model',
+ *     messages: toProviderMessages(input.messages),
+ *     tools: input.tools?.map(toProviderTool),
+ *   }),
+ *
+ *   mapChunk: (chunk) => {
+ *     if (chunk.type === 'text') return { type: 'text', delta: chunk.text };
+ *     if (chunk.type === 'tool') return { type: 'tool_call', id: chunk.id, name: chunk.name, input: chunk.args };
+ *     if (chunk.type === 'done') return { type: 'message_end', stopReason: StopReason.STOP };
+ *     return null;
+ *   },
+ *
+ *   execute: (input) => provider.generate(input),
+ *   executeStream: (input) => provider.stream(input),
+ * });
+ * ```
+ *
+ * @module agentick/model/adapter
+ */
+import React from "react";
+import type { COMInput } from "../com/types";
+import type { EngineResponse } from "../engine/engine-response";
+import type { EngineModel, ModelInput, ModelOutput, ModelMetadata } from "./model";
+import { type AdapterDelta, type ChunkMapping } from "./stream-accumulator";
+import type { ContentMetadata } from "@agentick/shared/streaming";
+import type { LibraryGenerationOptions, ProviderGenerationOptions } from "../types";
+export { StopReason } from "@agentick/shared";
+export type { AdapterDelta, ChunkMapping } from "./stream-accumulator";
+export { createChunkMapper } from "./stream-accumulator";
+import type { COM } from "../com/object-model";
+import type { ModelConfig as SharedModelConfig } from "@agentick/shared/models";
+/**
+ * Props for ModelClass when used as a JSX component.
+ * Extends SharedModelConfig with component-specific props.
+ */
+export interface ModelClassProps extends Partial<SharedModelConfig> {
+    /** Child components */
+    children?: React.ReactNode;
+    /** Provider-specific options */
+    providerOptions?: ProviderGenerationOptions;
+    /** Callback when mounted */
+    onMount?: (ctx: COM) => void | Promise<void>;
+    /** Callback when unmounted */
+    onUnmount?: (ctx: COM) => void | Promise<void>;
+}
+/**
+ * ModelClass - A model adapter that can be used both programmatically and as JSX.
+ *
+ * This is the return type of createAdapter. It behaves like:
+ * - An EngineModel for programmatic use (createApp, direct generate/stream calls)
+ * - A JSX component for declarative use in agent trees
+ *
+ * @example
+ * ```typescript
+ * const model = createAdapter({ ... });
+ *
+ * // Use as JSX component
+ * <model temperature={0.9}>
+ *   <MyAgent />
+ * </model>
+ *
+ * // Use with createApp
+ * const app = createApp(Agent, { model });
+ *
+ * // Direct execution
+ * const output = await model.generate(input);
+ * for await (const event of model.stream(input)) { ... }
+ * ```
+ */
+export interface ModelClass extends EngineModel<ModelInput, ModelOutput> {
+    /** Use as JSX component */
+    (props: ModelClassProps): React.ReactElement;
+}
+/**
+ * Merge provider options from multiple sources.
+ *
+ * Priority (later sources override earlier):
+ * 1. Model-level defaults (from adapter config)
+ * 2. Input providerOptions (from ModelInput)
+ * 3. Library-nested providerOptions (from libraryOptions[adapter].providerOptions)
+ *
+ * @example
+ * ```typescript
+ * const merged = mergeProviderOptions(
+ *   'openai',
+ *   { temperature: 0.5 },  // adapter defaults
+ *   input.providerOptions, // input options
+ *   input.libraryOptions,  // may contain nested providerOptions
+ * );
+ * ```
+ */
+export declare function mergeProviderOptions<T extends object = Record<string, unknown>>(providerKey: string, adapterDefaults?: Partial<T>, inputProviderOptions?: ProviderGenerationOptions, libraryOptions?: LibraryGenerationOptions): T;
+/**
+ * Merge library options from multiple sources.
+ *
+ * @example
+ * ```typescript
+ * const merged = mergeLibraryOptions(
+ *   'ai-sdk',
+ *   { maxSteps: 5 },       // adapter defaults
+ *   input.libraryOptions,  // input options
+ * );
+ * ```
+ */
+export declare function mergeLibraryOptions<T extends object = Record<string, unknown>>(libraryKey: string, adapterDefaults?: Partial<T>, inputLibraryOptions?: LibraryGenerationOptions): T;
+/**
+ * Extract all relevant options for a library adapter.
+ *
+ * Returns a structured object with:
+ * - `library`: Merged library-specific options
+ * - `provider`: Merged provider-specific options
+ * - `standard`: Standard ModelInput options (temperature, maxTokens, etc.)
+ *
+ * @example
+ * ```typescript
+ * const opts = extractAdapterOptions('ai-sdk', 'openai', input, {
+ *   libraryDefaults: { maxSteps: 5 },
+ *   providerDefaults: { temperature: 0.7 },
+ * });
+ *
+ * return {
+ *   model,
+ *   messages,
+ *   ...opts.library,    // AI SDK specific
+ *   providerOptions: {
+ *     openai: opts.provider,  // OpenAI specific
+ *   },
+ * };
+ * ```
+ */
+export declare function extractAdapterOptions<TLibrary extends object = Record<string, unknown>, TProvider extends object = Record<string, unknown>>(libraryKey: string, providerKey: string, input: ModelInput, defaults?: {
+    libraryDefaults?: Partial<TLibrary>;
+    providerDefaults?: Partial<TProvider>;
+}): {
+    library: TLibrary;
+    provider: TProvider;
+    standard: {
+        model?: string;
+        temperature?: number;
+        maxTokens?: number;
+        topP?: number;
+        frequencyPenalty?: number;
+        presencePenalty?: number;
+        stop?: string | string[];
+    };
+};
+/**
+ * Options for createAdapter.
+ *
+ * This is the minimal interface for creating an adapter. The framework handles:
+ * - Stream lifecycle (message_start, content_start/delta/end, message_end)
+ * - Content accumulation and ModelOutput construction
+ * - COMInput → ModelInput → ProviderInput transformations
+ * - ModelOutput → EngineResponse transformations
+ *
+ * You only need to implement the provider-specific parts.
+ *
+ * @example
+ * ```typescript
+ * const model = createAdapter({
+ *   metadata: { id: 'openai:gpt-4', provider: 'openai', capabilities: [{ stream: true, toolCalls: true }] },
+ *
+ *   prepareInput: (input) => ({
+ *     model: 'gpt-4',
+ *     messages: input.messages.map(toOpenAIMessage),
+ *     tools: input.tools?.map(toOpenAITool),
+ *   }),
+ *
+ *   mapChunk: (chunk) => {
+ *     if (chunk.choices?.[0]?.delta?.content) {
+ *       return { type: 'text', delta: chunk.choices[0].delta.content };
+ *     }
+ *     return null;
+ *   },
+ *
+ *   execute: async (input) => openai.chat.completions.create(input),
+ *   executeStream: (input) => openai.chat.completions.create({ ...input, stream: true }),
+ * });
+ * ```
+ */
+export interface AdapterOptions<TProviderInput, TProviderOutput, TChunk> {
+    /** Model metadata */
+    metadata: ModelMetadata;
+    /**
+     * Convert engine ModelInput to provider-specific input format.
+     * This is the only complex transformation you need to implement.
+     *
+     * Use the options helpers to merge providerOptions and libraryOptions:
+     * ```typescript
+     * prepareInput: (input) => {
+     *   const opts = extractAdapterOptions('ai-sdk', 'openai', input, {
+     *     providerDefaults: { temperature: 0.7 },
+     *   });
+     *   return { model, messages, ...opts.provider };
+     * }
+     * ```
+     */
+    prepareInput: (input: ModelInput) => TProviderInput | Promise<TProviderInput>;
+    /**
+     * Map a provider stream chunk to an AdapterDelta.
+     * Return null to skip/ignore the chunk.
+     *
+     * The framework handles stream lifecycle automatically:
+     * - First text/reasoning delta → emits content_start/reasoning_start
+     * - Subsequent deltas → emits content_delta/reasoning_delta
+     * - message_end → emits content_end/reasoning_end
+     *
+     * @example
+     * ```typescript
+     * mapChunk: (chunk) => {
+     *   if (chunk.type === 'text-delta') return { type: 'text', delta: chunk.text };
+     *   if (chunk.type === 'tool-call') return { type: 'tool_call', id: chunk.id, name: chunk.name, input: chunk.args };
+     *   if (chunk.type === 'finish') return { type: 'message_end', stopReason: StopReason.STOP };
+     *   return null;
+     * }
+     * ```
+     */
+    mapChunk: (chunk: TChunk) => AdapterDelta | null;
+    /**
+     * Execute non-streaming generation.
+     */
+    execute: (input: TProviderInput) => Promise<TProviderOutput>;
+    /**
+     * Execute streaming generation.
+     * Returns an async iterable of provider chunks.
+     */
+    executeStream?: (input: TProviderInput) => AsyncIterable<TChunk>;
+    /**
+     * Convert non-streaming provider output to ModelOutput.
+     * Optional - if not provided, streaming will be used and accumulated.
+     */
+    processOutput?: (output: TProviderOutput) => ModelOutput | Promise<ModelOutput>;
+    /**
+     * Reconstruct the raw provider response from accumulated streaming data.
+     * This creates a response object that mirrors what a non-streaming call would return.
+     *
+     * @example
+     * ```typescript
+     * reconstructRaw: (accumulated) => ({
+     *   id: accumulated.firstChunkId,
+     *   object: "chat.completion",
+     *   model: accumulated.model,
+     *   choices: [{
+     *     index: 0,
+     *     message: { role: "assistant", content: accumulated.text },
+     *     finish_reason: accumulated.stopReason === "stop" ? "stop" : "length",
+     *   }],
+     *   usage: accumulated.usage,
+     * })
+     * ```
+     */
+    reconstructRaw?: (accumulated: {
+        text: string;
+        reasoning: string;
+        toolCalls: Array<{
+            id: string;
+            name: string;
+            input: Record<string, unknown>;
+        }>;
+        usage: {
+            inputTokens: number;
+            outputTokens: number;
+            totalTokens: number;
+        };
+        stopReason: string;
+        model: string;
+        /** Raw chunks collected during streaming */
+        chunks: TChunk[];
+    }) => unknown;
+    /**
+     * Extract metadata (citations, annotations, etc.) from provider response.
+     * Called at the end of streaming or after non-streaming generation.
+     *
+     * Use this to normalize provider-specific metadata:
+     * - Anthropic citations → ContentMetadata.citations
+     * - Google grounding → ContentMetadata.citations + extensions
+     * - OpenAI annotations → ContentMetadata.annotations
+     *
+     * @example
+     * ```typescript
+     * extractMetadata: (chunk, accumulated) => {
+     *   if (chunk.citations?.length) {
+     *     return {
+     *       citations: chunk.citations.map(c => ({
+     *         text: c.cited_text,
+     *         url: c.source?.url,
+     *         title: c.source?.title,
+     *       })),
+     *     };
+     *   }
+     *   return undefined;
+     * }
+     * ```
+     */
+    extractMetadata?: (chunk: TChunk, accumulated: {
+        text: string;
+        reasoning: string;
+    }) => ContentMetadata | undefined;
+    /**
+     * Custom fromEngineState (optional).
+     * Converts COMInput to ModelInput before prepareInput.
+     * Most adapters don't need this - the default handles standard transformations.
+     */
+    fromEngineState?: (input: COMInput) => ModelInput | Promise<ModelInput>;
+    /**
+     * Custom toEngineState (optional).
+     * Converts ModelOutput to EngineResponse.
+     * Most adapters don't need this - the default handles standard transformations.
+     */
+    toEngineState?: (output: ModelOutput) => EngineResponse | Promise<EngineResponse>;
+    /**
+     * Called when the model component is mounted.
+     * Use for initialization when used as JSX.
+     */
+    onMount?: (ctx: COM) => void | Promise<void>;
+    /**
+     * Called when the model component is unmounted.
+     * Use for cleanup when used as JSX.
+     */
+    onUnmount?: (ctx: COM) => void | Promise<void>;
+}
+/**
+ * Declarative options using ChunkMapping instead of mapChunk function.
+ */
+export interface DeclarativeOptions<TProviderInput, TProviderOutput, TChunk> extends Omit<AdapterOptions<TProviderInput, TProviderOutput, TChunk>, "mapChunk"> {
+    /**
+     * Declarative chunk mapping.
+     * Alternative to mapChunk for simple cases.
+     */
+    chunkMapping: ChunkMapping<TChunk>;
+}
+/**
+ * Create an adapter using StreamAccumulator for clean streaming.
+ *
+ * This is the recommended way to create model adapters. StreamAccumulator
+ * handles all the complexity of converting AdapterDeltas to StreamEvents
+ * with proper lifecycle management.
+ *
+ * Returns a ModelClass that can be used:
+ * - As a JSX component: `<model temperature={0.9}><MyAgent /></model>`
+ * - With createApp: `createApp(Agent, { model })`
+ * - For direct calls: `await model.generate(input)`
+ */
+export declare function createAdapter<TProviderInput, TProviderOutput, TChunk>(options: AdapterOptions<TProviderInput, TProviderOutput, TChunk>): ModelClass;
+/**
+ * Create an adapter using declarative chunk mapping.
+ *
+ * This is even simpler than createAdapter for cases where
+ * chunk mapping can be expressed declaratively.
+ *
+ * @example
+ * ```typescript
+ * const model = createDeclarativeAdapter({
+ *   metadata: { id: 'my-model', ... },
+ *   prepareInput: (input) => ({ ... }),
+ *   execute: (input) => provider.call(input),
+ *   executeStream: (input) => provider.stream(input),
+ *   chunkMapping: {
+ *     text: { type: 'text-delta', extract: (c) => c.text },
+ *     toolCall: { type: 'tool-call', extract: (c) => ({ id: c.id, name: c.name, input: c.args }) },
+ *     messageEnd: { type: 'finish', extract: (c) => ({ stopReason: StopReason.STOP }) },
+ *   },
+ * });
+ * ```
+ */
+export declare function createDeclarativeAdapter<TProviderInput, TProviderOutput, TChunk extends {
+    type: string;
+}>(options: DeclarativeOptions<TProviderInput, TProviderOutput, TChunk>): ModelClass;
+//# sourceMappingURL=adapter.d.ts.map

package/dist/model/adapter.d.ts.map

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