@moikapy/origen 0.4.0 → 0.4.2

package/dist/adapter-DruYlWW-.d.ts

@@ -0,0 +1,204 @@
+import { Model, Api, Message, Context } from '@mariozechner/pi-ai';
+import { AgentTool, AgentEvent } from '@mariozechner/pi-agent-core';
+import { z } from 'zod';
+import { ModelId } from './models.js';
+
+/**
+ * Origen types — no runtime deps, safe for client + server.
+ */
+/** D1-compatible database interface for tool execution */
+interface D1Like {
+    prepare(sql: string): {
+        bind(...params: unknown[]): {
+            all(): Promise<{
+                results?: Record<string, unknown>[];
+            }>;
+            first(): Promise<Record<string, unknown> | null>;
+            run(): Promise<{
+                meta?: {
+                    changes: number;
+                    last_row_id: number;
+                };
+            }>;
+        };
+    };
+}
+/** Function that provides a D1 instance to tool executors */
+type D1Provider = () => Promise<D1Like>;
+/** Chat context passed from the UI (what the user is reading) */
+interface ReadingContext {
+    translation: string;
+    bookCode: string;
+    chapter: number;
+    selectedVerses?: number[];
+}
+interface Citation {
+    book: string;
+    chapter: number;
+    verse: number;
+}
+interface UsageInfo {
+    promptTokens?: number;
+    completionTokens?: number;
+    totalCost?: number;
+}
+/** Model configuration entry */
+interface ModelConfig {
+    name: string;
+    description: string;
+    free: boolean;
+}
+
+/**
+ * Origen — Agent Engine (v0.3)
+ *
+ * Multi-provider agent harness built on pi-ai + pi-agent-core.
+ * Supports OpenRouter, Ollama, Anthropic, Google, and any OpenAI-compatible API.
+ * Soul.md personas, streaming, parallel tool execution, abort support.
+ */
+
+/**
+ * A tool that the host app registers with Origen.
+ * Simple interface: name, description, JSON schema, and an execute function
+ * that receives (args, getD1). The adapter wraps this into pi-agent-core's AgentTool.
+ */
+interface OrigenTool {
+    name: string;
+    description: string;
+    /** OpenAI function-calling parameter schema (JSON) */
+    parameters: Record<string, unknown>;
+    /** Zod schema for runtime validation (optional) */
+    inputSchema?: z.ZodType;
+    execute: (args: Record<string, unknown>, getD1: D1Provider) => Promise<string>;
+}
+interface AgentConfig {
+    appName?: string;
+    systemPrompt?: string;
+    tools: OrigenTool[];
+    getD1: D1Provider;
+    model?: ModelId;
+    maxSteps?: number;
+    /** Custom citation extractor */
+    extractCitations?: (text: string) => Citation[];
+    /** Dynamic API key resolution per provider (e.g., for expiring OAuth tokens) */
+    getApiKey?: (provider: string) => Promise<string | undefined>;
+    /** Ollama base URL override (default: http://localhost:11434/v1) */
+    ollamaBaseUrl?: string;
+    /** Tool execution mode: "parallel" (default) or "sequential" */
+    toolExecution?: "sequential" | "parallel";
+    /** Abort signal for cancellation */
+    signal?: AbortSignal;
+    /** Reasoning/thinking level for models that support it */
+    thinkingLevel?: "off" | "minimal" | "low" | "medium" | "high";
+}
+interface AuthCheckResult {
+    authenticated: boolean;
+    apiKey: string | null;
+    provider?: string;
+    error?: string;
+}
+/**
+ * Provider-aware auth check. Tests key availability for each provider.
+ * If no provider argument, checks OpenRouter + Ollama availability.
+ */
+declare function checkAuth(getApiKey: ((provider: string) => Promise<string | undefined>) | (() => Promise<string | null>)): Promise<AuthCheckResult>;
+/** Convenience: check OpenRouter auth only (backward compat). */
+declare function checkOpenRouterAuth(getApiKey: () => Promise<string | null>): Promise<AuthCheckResult>;
+type StreamEvent = {
+    type: "reasoning";
+    content: string;
+} | {
+    type: "tool_call";
+    name: string;
+    args: Record<string, unknown>;
+} | {
+    type: "tool_result";
+    name: string;
+    result: string;
+} | {
+    type: "text";
+    content: string;
+} | {
+    type: "done";
+    message: string;
+    citations: Citation[];
+    usage?: UsageInfo;
+} | {
+    type: "error";
+    message: string;
+};
+declare function streamOrigen(messages: Array<{
+    role: "user" | "assistant";
+    content: string;
+}>, context: Record<string, unknown> | undefined, config: AgentConfig, apiKey?: string): AsyncGenerator<StreamEvent>;
+interface AgentResponse {
+    message: string;
+    citations: Citation[];
+    usage?: UsageInfo;
+}
+declare function callOrigen(messages: Array<{
+    role: "user" | "assistant";
+    content: string;
+}>, context: Record<string, unknown> | undefined, config: AgentConfig, apiKey?: string): Promise<AgentResponse>;
+
+/**
+ * Adapter: bridges Origen's simple types to pi-agent-core/pi-ai types.
+ *
+ * - OrigenTool → AgentTool (injects D1Provider)
+ * - pi-ai Model resolution (OpenRouter, Ollama, Anthropic, Google)
+ * - StreamEvent translation (AgentEvent → Origen's StreamEvent)
+ */
+
+/**
+ * Convert an OrigenTool into a pi-agent-core AgentTool.
+ * The D1Provider is captured in closure so the tool's execute gets it.
+ */
+declare function adaptTool(tool: OrigenTool, getD1: D1Provider): AgentTool;
+/** Adapt all OrigenTools for an Agent instance. */
+declare function adaptTools(tools: OrigenTool[], getD1: D1Provider): AgentTool[];
+interface ModelResolutionOptions {
+    /** Ollama base URL, e.g. "http://localhost:11434/v1" */
+    ollamaBaseUrl?: string;
+}
+/**
+ * Resolve a model ID string to a pi-ai Model object.
+ * Tries pi-ai's registry first, then falls back to built-in Ollama definitions.
+ */
+declare function resolveModel(modelId: string, options?: ModelResolutionOptions): Model<Api>;
+/** Convert Origen's simple messages to pi-ai Message format. */
+declare function convertMessages(messages: Array<{
+    role: "user" | "assistant";
+    content: string;
+}>): Message[];
+/** Build a pi-ai Context from Origen's config. */
+declare function buildContext(systemPrompt: string, messages: Message[], adaptedTools: AgentTool[]): Context;
+/** Translate a pi-agent-core AgentEvent into an Origen StreamEvent. */
+declare function translateEvent(event: AgentEvent, extractCitations?: (text: string) => Citation[]): StreamEvent | null;
+/**
+ * Eagerly subscribe to an Agent and return an async iterable of Origen StreamEvents.
+ *
+ * CRITICAL: The subscription is created synchronously when this function is called,
+ * BEFORE agent.prompt() starts. This avoids the race condition where events
+ * emitted during prompt() are missed if subscription happens after.
+ *
+ * Usage:
+ *   const { stream, unsubscribe } = createEventStream(agent, extractCitations);
+ *   agent.prompt(messages); // events flow into stream via active subscription
+ *   for await (const event of stream) { ... }
+ */
+declare function createEventStream(agent: any, // Agent from pi-agent-core
+extractCitations?: (text: string) => Citation[]): {
+    stream: AsyncGenerator<StreamEvent>;
+    unsubscribe: () => void;
+};
+/**
+ * Subscribe to an Agent and yield Origen StreamEvents.
+ * Handles the full lifecycle from agent_start to agent_end.
+ *
+ * @deprecated Use createEventStream() instead to avoid race conditions.
+ * This function subscribes lazily (on first iteration) which can miss events
+ * if the agent has already started emitting.
+ */
+declare function agentToStreamEvents(agent: any, extractCitations?: (text: string) => Citation[]): AsyncGenerator<StreamEvent>;
+
+export { type AgentConfig as A, type Citation as C, type D1Like as D, type ModelResolutionOptions as M, type OrigenTool as O, type ReadingContext as R, type StreamEvent as S, type UsageInfo as U, type AgentResponse as a, type AuthCheckResult as b, type D1Provider as c, type ModelConfig as d, callOrigen as e, checkAuth as f, checkOpenRouterAuth as g, createEventStream as h, adaptTool as i, adaptTools as j, agentToStreamEvents as k, buildContext as l, convertMessages as m, resolveModel as r, streamOrigen as s, translateEvent as t };

package/dist/adapter.d.ts

@@ -1,204 +1,5 @@
-import { ModelId } from './models.js';
-import { z } from 'zod';
-import { Model, Api, Message, Context } from '@mariozechner/pi-ai';
-import { AgentTool, AgentEvent } from '@mariozechner/pi-agent-core';
-
-/**
- * Origen types — no runtime deps, safe for client + server.
- */
-/** D1-compatible database interface for tool execution */
-interface D1Like {
-    prepare(sql: string): {
-        bind(...params: unknown[]): {
-            all(): Promise<{
-                results?: Record<string, unknown>[];
-            }>;
-            first(): Promise<Record<string, unknown> | null>;
-            run(): Promise<{
-                meta?: {
-                    changes: number;
-                    last_row_id: number;
-                };
-            }>;
-        };
-    };
-}
-/** Function that provides a D1 instance to tool executors */
-type D1Provider = () => Promise<D1Like>;
-/** Chat context passed from the UI (what the user is reading) */
-interface ReadingContext {
-    translation: string;
-    bookCode: string;
-    chapter: number;
-    selectedVerses?: number[];
-}
-interface Citation {
-    book: string;
-    chapter: number;
-    verse: number;
-}
-interface UsageInfo {
-    promptTokens?: number;
-    completionTokens?: number;
-    totalCost?: number;
-}
-/** Model configuration entry */
-interface ModelConfig {
-    name: string;
-    description: string;
-    free: boolean;
-}
-
-/**
- * Origen — Agent Engine (v0.3)
- *
- * Multi-provider agent harness built on pi-ai + pi-agent-core.
- * Supports OpenRouter, Ollama, Anthropic, Google, and any OpenAI-compatible API.
- * Soul.md personas, streaming, parallel tool execution, abort support.
- */
-
-/**
- * A tool that the host app registers with Origen.
- * Simple interface: name, description, JSON schema, and an execute function
- * that receives (args, getD1). The adapter wraps this into pi-agent-core's AgentTool.
- */
-interface OrigenTool {
-    name: string;
-    description: string;
-    /** OpenAI function-calling parameter schema (JSON) */
-    parameters: Record<string, unknown>;
-    /** Zod schema for runtime validation (optional) */
-    inputSchema?: z.ZodType;
-    execute: (args: Record<string, unknown>, getD1: D1Provider) => Promise<string>;
-}
-interface AgentConfig {
-    appName?: string;
-    systemPrompt?: string;
-    tools: OrigenTool[];
-    getD1: D1Provider;
-    model?: ModelId;
-    maxSteps?: number;
-    /** Custom citation extractor */
-    extractCitations?: (text: string) => Citation[];
-    /** Dynamic API key resolution per provider (e.g., for expiring OAuth tokens) */
-    getApiKey?: (provider: string) => Promise<string | undefined>;
-    /** Ollama base URL override (default: http://localhost:11434/v1) */
-    ollamaBaseUrl?: string;
-    /** Tool execution mode: "parallel" (default) or "sequential" */
-    toolExecution?: "sequential" | "parallel";
-    /** Abort signal for cancellation */
-    signal?: AbortSignal;
-    /** Reasoning/thinking level for models that support it */
-    thinkingLevel?: "off" | "minimal" | "low" | "medium" | "high";
-}
-interface AuthCheckResult {
-    authenticated: boolean;
-    apiKey: string | null;
-    provider?: string;
-    error?: string;
-}
-/**
- * Provider-aware auth check. Tests key availability for each provider.
- * If no provider argument, checks OpenRouter + Ollama availability.
- */
-declare function checkAuth(getApiKey: ((provider: string) => Promise<string | undefined>) | (() => Promise<string | null>)): Promise<AuthCheckResult>;
-/** Convenience: check OpenRouter auth only (backward compat). */
-declare function checkOpenRouterAuth(getApiKey: () => Promise<string | null>): Promise<AuthCheckResult>;
-type StreamEvent = {
-    type: "reasoning";
-    content: string;
-} | {
-    type: "tool_call";
-    name: string;
-    args: Record<string, unknown>;
-} | {
-    type: "tool_result";
-    name: string;
-    result: string;
-} | {
-    type: "text";
-    content: string;
-} | {
-    type: "done";
-    message: string;
-    citations: Citation[];
-    usage?: UsageInfo;
-} | {
-    type: "error";
-    message: string;
-};
-declare function streamOrigen(messages: Array<{
-    role: "user" | "assistant";
-    content: string;
-}>, context: Record<string, unknown> | undefined, config: AgentConfig, apiKey?: string): AsyncGenerator<StreamEvent>;
-interface AgentResponse {
-    message: string;
-    citations: Citation[];
-    usage?: UsageInfo;
-}
-declare function callOrigen(messages: Array<{
-    role: "user" | "assistant";
-    content: string;
-}>, context: Record<string, unknown> | undefined, config: AgentConfig, apiKey?: string): Promise<AgentResponse>;
-
-/**
- * Adapter: bridges Origen's simple types to pi-agent-core/pi-ai types.
- *
- * - OrigenTool → AgentTool (injects D1Provider)
- * - pi-ai Model resolution (OpenRouter, Ollama, Anthropic, Google)
- * - StreamEvent translation (AgentEvent → Origen's StreamEvent)
- */
-
-/**
- * Convert an OrigenTool into a pi-agent-core AgentTool.
- * The D1Provider is captured in closure so the tool's execute gets it.
- */
-declare function adaptTool(tool: OrigenTool, getD1: D1Provider): AgentTool;
-/** Adapt all OrigenTools for an Agent instance. */
-declare function adaptTools(tools: OrigenTool[], getD1: D1Provider): AgentTool[];
-interface ModelResolutionOptions {
-    /** Ollama base URL, e.g. "http://localhost:11434/v1" */
-    ollamaBaseUrl?: string;
-}
-/**
- * Resolve a model ID string to a pi-ai Model object.
- * Tries pi-ai's registry first, then falls back to built-in Ollama definitions.
- */
-declare function resolveModel(modelId: string, options?: ModelResolutionOptions): Model<Api>;
-/** Convert Origen's simple messages to pi-ai Message format. */
-declare function convertMessages(messages: Array<{
-    role: "user" | "assistant";
-    content: string;
-}>): Message[];
-/** Build a pi-ai Context from Origen's config. */
-declare function buildContext(systemPrompt: string, messages: Message[], adaptedTools: AgentTool[]): Context;
-/** Translate a pi-agent-core AgentEvent into an Origen StreamEvent. */
-declare function translateEvent(event: AgentEvent, extractCitations?: (text: string) => Citation[]): StreamEvent | null;
-/**
- * Eagerly subscribe to an Agent and return an async iterable of Origen StreamEvents.
- *
- * CRITICAL: The subscription is created synchronously when this function is called,
- * BEFORE agent.prompt() starts. This avoids the race condition where events
- * emitted during prompt() are missed if subscription happens after.
- *
- * Usage:
- *   const { stream, unsubscribe } = createEventStream(agent, extractCitations);
- *   agent.prompt(messages); // events flow into stream via active subscription
- *   for await (const event of stream) { ... }
- */
-declare function createEventStream(agent: any, // Agent from pi-agent-core
-extractCitations?: (text: string) => Citation[]): {
-    stream: AsyncGenerator<StreamEvent>;
-    unsubscribe: () => void;
-};
-/**
- * Subscribe to an Agent and yield Origen StreamEvents.
- * Handles the full lifecycle from agent_start to agent_end.
- *
- * @deprecated Use createEventStream() instead to avoid race conditions.
- * This function subscribes lazily (on first iteration) which can miss events
- * if the agent has already started emitting.
- */
-declare function agentToStreamEvents(agent: any, extractCitations?: (text: string) => Citation[]): AsyncGenerator<StreamEvent>;
-
-export { type AgentConfig as A, type Citation as C, type D1Like as D, type ModelConfig as M, type ModelResolutionOptions, type OrigenTool as O, type ReadingContext as R, type StreamEvent as S, type UsageInfo as U, type AgentResponse as a, adaptTool, adaptTools, agentToStreamEvents, type AuthCheckResult as b, buildContext, type D1Provider as c, convertMessages, createEventStream, callOrigen as d, checkAuth as e, checkOpenRouterAuth as f, resolveModel, streamOrigen as s, translateEvent };
+import '@mariozechner/pi-ai';
+import '@mariozechner/pi-agent-core';
+export { M as ModelResolutionOptions, i as adaptTool, j as adaptTools, k as agentToStreamEvents, l as buildContext, m as convertMessages, h as createEventStream, r as resolveModel, t as translateEvent } from './adapter-DruYlWW-.js';
+import 'zod';
+import './models.js';