@inkdropapp/ai 0.1.3 → 0.1.5

package/types/utils/map-ai-sdk-error.d.ts

@@ -0,0 +1,21 @@
+import { AIError } from '../errors.js';
+/**
+ * Reduces an arbitrary unknown error coming out of the AI SDK to one of our
+ * {@link AIError} variants.
+ *
+ * Mapping rules:
+ * - Existing `AIError` → returned unchanged.
+ * - `LoadAPIKeyError` → `NoApiKey`.
+ * - `APICallError` with status:
+ *   - 401 / 403 → `AuthenticationError`
+ *   - 429 → `RateLimitExceeded` (with `retryAfter` parsed from header)
+ *   - 503 / 529 → `ServerOverloaded` (with `retryAfter`)
+ *   - 413, or any message that "looks like" a context-length overflow → `PromptTooLarge`
+ *   - anything else → `UpstreamError` carrying status + cause
+ * - Other `AISDKError` / `Error` instances → `UpstreamError` (or `PromptTooLarge`
+ *   if the message matches).
+ *
+ * @param providerId - Used to attribute the error in messages and downstream
+ * routing decisions.
+ */
+export declare const mapAiSdkError: (error: unknown, providerId: string) => AIError;

package/types/utils/map-ai-sdk-stream.d.ts

@@ -0,0 +1,25 @@
+import type { StreamTextResult, ToolSet } from 'ai';
+import type { StreamEvent } from '../events.js';
+/**
+ * Adapts the AI SDK's `streamText().fullStream` into the library's
+ * provider-agnostic {@link StreamEvent} stream.
+ *
+ * Three contracts that downstream code relies on:
+ *
+ * 1. **No throwing.** Errors thrown by the iterator (e.g. mid-stream HTTP
+ *    failure) are caught and re-emitted as `{ kind: 'error', error }`.
+ *    The iterator always terminates cleanly, so consumers that pump events
+ *    over IPC don't need to wrap iteration in try/catch.
+ * 2. **Errors are terminal.** When an `error` event from the SDK is observed
+ *    the iterator returns immediately — any subsequent SDK chunks are dropped.
+ * 3. **Unknown SDK part types are silently ignored.** Forward-compat with
+ *    new AI SDK chunk variants without a library bump.
+ *
+ * Emits in this order over the lifetime of one completion:
+ * `text-delta*` → `usage-update?` → `finish | error`.
+ *
+ * @param result - The object returned by `streamText()`.
+ *                 Only its `fullStream` is consumed.
+ * @param providerId - Provider id used to attribute any wrapped errors.
+ */
+export declare function mapAiSdkStream(result: Pick<StreamTextResult<ToolSet, never, never>, 'fullStream'>, providerId: string): AsyncIterable<StreamEvent>;

package/src/stream-events.ts

@@ -1,53 +0,0 @@
-import type { AIError } from './errors.js'
-
-/**
- * Why a completion stream stopped producing output.
- *
- * Mirrors the AI SDK's `FinishReason`. Unknown / provider-specific values are
- * normalised to `'other'` rather than silently passed through.
- */
-export type FinishReason =
-  | 'stop'
-  | 'length'
-  | 'content-filter'
-  | 'tool-calls'
-  | 'error'
-  | 'other'
-
-/**
- * Token usage for a single completion. Every field is optional because
- * not every provider reports every counter.
- */
-export type Usage = {
-  /** Tokens consumed from the prompt. */
-  inputTokens?: number
-  /** Tokens generated in the response. */
-  outputTokens?: number
-  /** `inputTokens + outputTokens` as reported by the provider. */
-  totalTokens?: number
-  /** Of `inputTokens`, how many were a cache hit (Anthropic prompt-cache reads). */
-  cacheReadInputTokens?: number
-  /** Of `inputTokens`, how many were written to the prompt cache for future reads. */
-  cacheCreationInputTokens?: number
-  /** Subset of `outputTokens` spent on reasoning / thinking content. */
-  reasoningTokens?: number
-}
-
-/**
- * Provider-agnostic streaming events. Every concrete provider's stream is
- * reduced to this discriminated union so consumers never branch on provider id.
- *
- * Errors arrive as `{ kind: 'error', ... }` events, not as thrown exceptions —
- * this lets the host pump events across an Electron IPC boundary one at a time
- * without needing try/catch around the iterator.
- *
- * `tool-call` and `tool-result` are typed but never produced in the current
- * version (one-shot text completions only). They're reserved for forward compat.
- */
-export type StreamEvent =
-  | { kind: 'text-delta'; delta: string }
-  | { kind: 'tool-call'; id: string; name: string; input: unknown }
-  | { kind: 'tool-result'; id: string; name: string; result: unknown }
-  | { kind: 'usage-update'; usage: Usage }
-  | { kind: 'finish'; finishReason: FinishReason; usage: Usage }
-  | { kind: 'error'; error: AIError }