@odla-ai/ai 0.2.0 → 0.2.2

package/dist/index.d.cts

@@ -83,6 +83,17 @@ interface OracleMessage {
      *  multi-modal / tool turns. */
     content: string | OracleContentBlock[];
 }
+
+interface OracleUsage {
+    inputTokens: number;
+    outputTokens: number;
+    cacheCreationTokens?: number;
+    cacheReadTokens?: number;
+}
+declare function emptyUsage(): OracleUsage;
+/** Accumulate `more` into `into`, in place. Cache fields sum when present. */
+declare function addUsage(into: OracleUsage, more: OracleUsage): void;
+
 interface OracleTool {
     name: string;
     description: string;
@@ -130,15 +141,6 @@ interface OracleRequest {
      *  portability across providers. */
     providerExtras?: Record<string, unknown>;
 }
-interface OracleUsage {
-    inputTokens: number;
-    outputTokens: number;
-    cacheCreationTokens?: number;
-    cacheReadTokens?: number;
-}
-declare function emptyUsage(): OracleUsage;
-/** Accumulate `more` into `into`, in place. Cache fields sum when present. */
-declare function addUsage(into: OracleUsage, more: OracleUsage): void;
 type OracleStopReason = "end_turn" | "max_tokens" | "stop_sequence" | "tool_use" | "pause_turn" | "refusal" | "error";
 interface OracleResponse {
     id: string;
@@ -150,59 +152,7 @@ interface OracleResponse {
     stopReason: OracleStopReason;
     usage: OracleUsage;
 }
-/** A discriminated union of SSE events with the same vocabulary regardless of
- *  provider. The anthropic adapter passes these through nearly 1:1; the openai
- *  and google adapters map their native streams onto this shape. */
-type OracleEvent = MessageStartEvent | ContentBlockStartEvent | ContentBlockDeltaEvent | ContentBlockStopEvent | MessageDeltaEvent | MessageStopEvent | OracleErrorEvent;
-interface MessageStartEvent {
-    type: "message_start";
-    message: {
-        id: string;
-        model: string;
-        provider: ProviderId;
-        role: "assistant";
-        content: [];
-        usage: OracleUsage;
-    };
-}
-interface ContentBlockStartEvent {
-    type: "content_block_start";
-    index: number;
-    contentBlock: OracleContentBlock;
-}
-type ContentBlockDelta = {
-    type: "text_delta";
-    text: string;
-} | {
-    type: "thinking_delta";
-    thinking: string;
-} | {
-    type: "input_json_delta";
-    partialJson: string;
-};
-interface ContentBlockDeltaEvent {
-    type: "content_block_delta";
-    index: number;
-    delta: ContentBlockDelta;
-}
-interface ContentBlockStopEvent {
-    type: "content_block_stop";
-    index: number;
-}
-interface MessageDeltaEvent {
-    type: "message_delta";
-    delta: {
-        stopReason?: OracleStopReason;
-    };
-    usage: OracleUsage;
-}
-interface MessageStopEvent {
-    type: "message_stop";
-}
-interface OracleErrorEvent {
-    type: "error";
-    error: OracleErrorShape;
-}
+
 /** The closed taxonomy of normalized error codes carried by every OdlaAIError
  *  and by the streaming `error` event. */
 type OracleErrorType = "invalid_request" | "auth" | "rate_limit" | "context_window" | "tool_input_invalid" | "capability_unsupported" | "config" | "provider_error";
@@ -276,6 +226,61 @@ declare class ProviderError extends OdlaAIError {
         cause?: unknown;
     });
 }
+
+/** A discriminated union of SSE events with the same vocabulary regardless of
+ *  provider. The anthropic adapter passes these through nearly 1:1; the openai
+ *  and google adapters map their native streams onto this shape. */
+type OracleEvent = MessageStartEvent | ContentBlockStartEvent | ContentBlockDeltaEvent | ContentBlockStopEvent | MessageDeltaEvent | MessageStopEvent | OracleErrorEvent;
+interface MessageStartEvent {
+    type: "message_start";
+    message: {
+        id: string;
+        model: string;
+        provider: ProviderId;
+        role: "assistant";
+        content: [];
+        usage: OracleUsage;
+    };
+}
+interface ContentBlockStartEvent {
+    type: "content_block_start";
+    index: number;
+    contentBlock: OracleContentBlock;
+}
+type ContentBlockDelta = {
+    type: "text_delta";
+    text: string;
+} | {
+    type: "thinking_delta";
+    thinking: string;
+} | {
+    type: "input_json_delta";
+    partialJson: string;
+};
+interface ContentBlockDeltaEvent {
+    type: "content_block_delta";
+    index: number;
+    delta: ContentBlockDelta;
+}
+interface ContentBlockStopEvent {
+    type: "content_block_stop";
+    index: number;
+}
+interface MessageDeltaEvent {
+    type: "message_delta";
+    delta: {
+        stopReason?: OracleStopReason;
+    };
+    usage: OracleUsage;
+}
+interface MessageStopEvent {
+    type: "message_stop";
+}
+interface OracleErrorEvent {
+    type: "error";
+    error: OracleErrorShape;
+}
+
 declare function isTextBlock(b: OracleContentBlock): b is TextBlock;
 declare function isImageBlock(b: OracleContentBlock): b is ImageBlock;
 declare function isAudioBlock(b: OracleContentBlock): b is AudioBlock;
@@ -854,10 +859,15 @@ type OdlaOp = {
 type OdlaQuery = Record<string, unknown>;
 /** The subset of the odla-db Admin client odla-ai uses. */
 interface OdlaDbClient {
-    /** Apply ops atomically; a stable `mutationId` gives exactly-once replay. */
+    /** Apply ops atomically; a stable `mutationId` gives exactly-once replay.
+     *  Mirrors odla-db 0.5's AdminDb: `duplicate` means the mutationId was
+     *  already applied and the ops did not re-run. */
     transact(ops: OdlaOp[], opts?: {
         mutationId?: string;
-    }): Promise<number>;
+    }): Promise<{
+        txId: number;
+        duplicate: boolean;
+    }>;
     /** Run an InstaQL query; returns namespace → rows. */
     query(query: OdlaQuery): Promise<Record<string, Record<string, unknown>[]>>;
     /** Read one of this app's secrets by name (app-key credential; read-only). */

package/dist/index.d.ts

@@ -83,6 +83,17 @@ interface OracleMessage {
      *  multi-modal / tool turns. */
     content: string | OracleContentBlock[];
 }
+
+interface OracleUsage {
+    inputTokens: number;
+    outputTokens: number;
+    cacheCreationTokens?: number;
+    cacheReadTokens?: number;
+}
+declare function emptyUsage(): OracleUsage;
+/** Accumulate `more` into `into`, in place. Cache fields sum when present. */
+declare function addUsage(into: OracleUsage, more: OracleUsage): void;
+
 interface OracleTool {
     name: string;
     description: string;
@@ -130,15 +141,6 @@ interface OracleRequest {
      *  portability across providers. */
     providerExtras?: Record<string, unknown>;
 }
-interface OracleUsage {
-    inputTokens: number;
-    outputTokens: number;
-    cacheCreationTokens?: number;
-    cacheReadTokens?: number;
-}
-declare function emptyUsage(): OracleUsage;
-/** Accumulate `more` into `into`, in place. Cache fields sum when present. */
-declare function addUsage(into: OracleUsage, more: OracleUsage): void;
 type OracleStopReason = "end_turn" | "max_tokens" | "stop_sequence" | "tool_use" | "pause_turn" | "refusal" | "error";
 interface OracleResponse {
     id: string;
@@ -150,59 +152,7 @@ interface OracleResponse {
     stopReason: OracleStopReason;
     usage: OracleUsage;
 }
-/** A discriminated union of SSE events with the same vocabulary regardless of
- *  provider. The anthropic adapter passes these through nearly 1:1; the openai
- *  and google adapters map their native streams onto this shape. */
-type OracleEvent = MessageStartEvent | ContentBlockStartEvent | ContentBlockDeltaEvent | ContentBlockStopEvent | MessageDeltaEvent | MessageStopEvent | OracleErrorEvent;
-interface MessageStartEvent {
-    type: "message_start";
-    message: {
-        id: string;
-        model: string;
-        provider: ProviderId;
-        role: "assistant";
-        content: [];
-        usage: OracleUsage;
-    };
-}
-interface ContentBlockStartEvent {
-    type: "content_block_start";
-    index: number;
-    contentBlock: OracleContentBlock;
-}
-type ContentBlockDelta = {
-    type: "text_delta";
-    text: string;
-} | {
-    type: "thinking_delta";
-    thinking: string;
-} | {
-    type: "input_json_delta";
-    partialJson: string;
-};
-interface ContentBlockDeltaEvent {
-    type: "content_block_delta";
-    index: number;
-    delta: ContentBlockDelta;
-}
-interface ContentBlockStopEvent {
-    type: "content_block_stop";
-    index: number;
-}
-interface MessageDeltaEvent {
-    type: "message_delta";
-    delta: {
-        stopReason?: OracleStopReason;
-    };
-    usage: OracleUsage;
-}
-interface MessageStopEvent {
-    type: "message_stop";
-}
-interface OracleErrorEvent {
-    type: "error";
-    error: OracleErrorShape;
-}
+
 /** The closed taxonomy of normalized error codes carried by every OdlaAIError
  *  and by the streaming `error` event. */
 type OracleErrorType = "invalid_request" | "auth" | "rate_limit" | "context_window" | "tool_input_invalid" | "capability_unsupported" | "config" | "provider_error";
@@ -276,6 +226,61 @@ declare class ProviderError extends OdlaAIError {
         cause?: unknown;
     });
 }
+
+/** A discriminated union of SSE events with the same vocabulary regardless of
+ *  provider. The anthropic adapter passes these through nearly 1:1; the openai
+ *  and google adapters map their native streams onto this shape. */
+type OracleEvent = MessageStartEvent | ContentBlockStartEvent | ContentBlockDeltaEvent | ContentBlockStopEvent | MessageDeltaEvent | MessageStopEvent | OracleErrorEvent;
+interface MessageStartEvent {
+    type: "message_start";
+    message: {
+        id: string;
+        model: string;
+        provider: ProviderId;
+        role: "assistant";
+        content: [];
+        usage: OracleUsage;
+    };
+}
+interface ContentBlockStartEvent {
+    type: "content_block_start";
+    index: number;
+    contentBlock: OracleContentBlock;
+}
+type ContentBlockDelta = {
+    type: "text_delta";
+    text: string;
+} | {
+    type: "thinking_delta";
+    thinking: string;
+} | {
+    type: "input_json_delta";
+    partialJson: string;
+};
+interface ContentBlockDeltaEvent {
+    type: "content_block_delta";
+    index: number;
+    delta: ContentBlockDelta;
+}
+interface ContentBlockStopEvent {
+    type: "content_block_stop";
+    index: number;
+}
+interface MessageDeltaEvent {
+    type: "message_delta";
+    delta: {
+        stopReason?: OracleStopReason;
+    };
+    usage: OracleUsage;
+}
+interface MessageStopEvent {
+    type: "message_stop";
+}
+interface OracleErrorEvent {
+    type: "error";
+    error: OracleErrorShape;
+}
+
 declare function isTextBlock(b: OracleContentBlock): b is TextBlock;
 declare function isImageBlock(b: OracleContentBlock): b is ImageBlock;
 declare function isAudioBlock(b: OracleContentBlock): b is AudioBlock;
@@ -854,10 +859,15 @@ type OdlaOp = {
 type OdlaQuery = Record<string, unknown>;
 /** The subset of the odla-db Admin client odla-ai uses. */
 interface OdlaDbClient {
-    /** Apply ops atomically; a stable `mutationId` gives exactly-once replay. */
+    /** Apply ops atomically; a stable `mutationId` gives exactly-once replay.
+     *  Mirrors odla-db 0.5's AdminDb: `duplicate` means the mutationId was
+     *  already applied and the ops did not re-run. */
     transact(ops: OdlaOp[], opts?: {
         mutationId?: string;
-    }): Promise<number>;
+    }): Promise<{
+        txId: number;
+        duplicate: boolean;
+    }>;
     /** Run an InstaQL query; returns namespace → rows. */
     query(query: OdlaQuery): Promise<Record<string, Record<string, unknown>[]>>;
     /** Read one of this app's secrets by name (app-key credential; read-only). */

package/dist/index.js

@@ -8,19 +8,41 @@ import {
   ProviderError,
   RateLimitError,
   addUsage,
-  blocksOf,
   emptyUsage,
-  extractText,
-  extractToolUses,
-  isAudioBlock,
-  isDocumentBlock,
-  isImageBlock,
-  isTextBlock,
-  isThinkingBlock,
-  isToolResultBlock,
-  isToolUseBlock,
   normalizeError
-} from "./chunk-LANGYP65.js";
+} from "./chunk-QFT2DU2X.js";
+
+// src/shape/helpers.ts
+function isTextBlock(b) {
+  return b.type === "text";
+}
+function isImageBlock(b) {
+  return b.type === "image";
+}
+function isAudioBlock(b) {
+  return b.type === "audio";
+}
+function isDocumentBlock(b) {
+  return b.type === "document";
+}
+function isToolUseBlock(b) {
+  return b.type === "tool_use";
+}
+function isToolResultBlock(b) {
+  return b.type === "tool_result";
+}
+function isThinkingBlock(b) {
+  return b.type === "thinking";
+}
+function blocksOf(content) {
+  return typeof content === "string" ? [{ type: "text", text: content }] : content;
+}
+function extractText(content) {
+  return content.filter(isTextBlock).map((b) => b.text).join("");
+}
+function extractToolUses(content) {
+  return content.filter(isToolUseBlock);
+}
 
 // src/shape/capabilities.ts
 function chatCapabilities(overrides = {}) {
@@ -250,17 +272,17 @@ async function getProvider(id, apiKey) {
   let provider;
   switch (id) {
     case "anthropic": {
-      const { AnthropicProvider } = await import("./anthropic-JXDXR7O7.js");
+      const { AnthropicProvider } = await import("./anthropic-BIGCVQE4.js");
       provider = new AnthropicProvider(apiKey);
       break;
     }
     case "openai": {
-      const { OpenAIProvider } = await import("./openai-XZRXMKCC.js");
+      const { OpenAIProvider } = await import("./openai-PTZPJYTT.js");
       provider = new OpenAIProvider(apiKey);
       break;
     }
     case "google": {
-      const { GoogleProvider } = await import("./google-3TFOFIQO.js");
+      const { GoogleProvider } = await import("./google-QY5B4T5O.js");
       provider = new GoogleProvider(apiKey);
       break;
     }
@@ -386,6 +408,10 @@ function generateLlmsTxt(catalog = DEFAULT_CATALOG) {
   const models = Object.values(catalog).map((s) => `- \`${s.id}\` (${s.provider}) \u2014 ${capsSummary(s.capabilities)}`).join("\n");
   return `# @odla-ai/ai \u2014 LLM context
 
+> EXPERIMENTAL \u2014 an agentic-coding experiment. This package is built and operated
+> by autonomous coding agents as an experiment in agentic loops. APIs change
+> without notice and nothing here is production-hardened. Use at your own risk.
+
 One general-purpose interface for AI inference across Anthropic (Claude), OpenAI
 (GPT), and Google (Gemini) \u2014 text, image, and audio \u2014 plus a tool-use agent
 engine and an eval harness. Library-only: import in-process, bring your own keys.