effect-uai 0.5.2 → 0.7.0

package/CHANGELOG.md

@@ -1,5 +1,108 @@
 # effect-uai
 
+## 0.7.0
+
+### Minor Changes
+
+- 602bfa9: 0.7 is a capability-honesty pass across every audio and embedding
+  surface. The unifying rule: where a provider cannot honor a request, the
+  call now fails with `AiError.Unsupported` (load-bearing gaps) or emits a
+  structured `warnDropped` (best-effort hints), instead of silently
+  substituting a different result. Alongside that, `Duration` replaces raw
+  `durationSeconds` everywhere audio carries a length, the `MusicGenerator`
+  surface is reshaped, an ElevenLabs music provider lands, and Gemini
+  `toolChoice` is now mapped.
+
+  Most of it is mechanical (find-and-replace renames plus a
+  `Duration.seconds(n)` wrap). The parts that need judgement are the
+  removed `GeminiTranscriber` (use OpenAI / ElevenLabs / Inworld instead)
+  and the requests that now error where they previously degraded silently.
+  The full before/after diffs and the recommended order live in
+  [Migrating to 0.7](https://effect-uai.betalyra.com/migrations/v0-7/).
+
+  `@effect-uai/anthropic`, `@effect-uai/microsandbox`, and
+  `@effect-uai/deno` have no functional changes this release; they bump for
+  lockstep versioning only.
+
+## 0.6.0
+
+### Minor Changes
+
+- a332f0a: 0.6 bundles one large-but-mechanical naming sweep with a set of
+  additive features. The breaking part is source-level only — **the wire
+  format is unchanged** (`function_call` / `function_call_output` still
+  go out on the wire, so no provider payloads change). Almost every
+  rewrite is find-and-replace; the full before/after diffs and the
+  recommended order live in [Migrating to 0.6](https://effect-uai.betalyra.com/migrations/v0-6/).
+
+  ### Breaking: "function call" → "tool call" terminology
+
+  Every public name that said "function call" now says "tool call":
+  - `Item` → `HistoryItem`; `FunctionCall` → `ToolCall`;
+    `FunctionCallOutput` → `ToolCallOutput`.
+  - `Items.functionCallOutput` → `Items.toolCallOutput`;
+    `Items.isFunctionCall` → `Items.isToolCall`;
+    `Items.isFunctionCallOutput` → `Items.isToolCallOutput`.
+  - `Turn.functionCalls` → `Turn.getToolCalls`.
+
+  ### Breaking: module renames
+  - `@effect-uai/core/Outcome` → `@effect-uai/core/ToolResult`. Also
+    `ToolResult.Value` → `ToolResult.Ok`, `isValue` → `isOk`,
+    `rejected(...)` → `failed(...)`, `toFunctionCallOutput` →
+    `toToolCallOutput`.
+  - `@effect-uai/core/Resolvers` → `@effect-uai/core/Approval`. Also
+    `fromApprovalMap` → `fromMap`, `fromVerdictQueue` → `fromQueue`,
+    `ToolCallDecision` → `ApprovalDecision`, and the queue helper's
+    `announce` field → `approvalRequests`.
+
+  ### Breaking: Turn / Toolkit / Tool / ToolEvent renames
+  - `Turn.appendTurn` → `Turn.appendToHistory`.
+  - `Turn.toStructured` → `Turn.decodeStructured`.
+  - `Toolkit.executeAll` → `Toolkit.run`.
+  - `Toolkit.continueWith` → `Toolkit.continueWithResults`.
+  - `Toolkit.make(...)` + `Toolkit.toDescriptors(kit)` → just
+    `Tool.toDescriptors([...])`. The homogeneous-toolkit wrapper is gone.
+  - `Tool.AnyKindTool` → `Tool.AnyTool`.
+  - `ToolEvent.Intermediate` → `ToolEvent.Progress`;
+    `isIntermediate` → `isProgress`.
+
+  ### Breaking: Loop helper trim
+  - `Loop.loopFrom(...)` → `Loop.loopOver(...)`.
+  - `Loop.Event<A, S>` → `Loop.Step<A, S>`.
+  - `return stop` → `return stop()`.
+  - `Loop.stopWith(state)` → `Loop.stop(state)`.
+  - `nextAfter` / `stopAfter` / `stopWithAfter` / `stopEvent` /
+    `nextAfterFold` are removed — compose with `Stream.concat` instead.
+    See the migration doc for one-line replacements.
+
+  ### Additive: new Toolkit / Loop helpers
+  - `Toolkit.appendToolResults(state, turn)` — shorthand for the canonical
+    `continueWithResults` body that folds tool results into history.
+  - `Toolkit.collectResults` — lower-level drain of a `Stream<ToolEvent>`
+    to its `ToolResult`s without advancing the loop.
+
+  ### Additive: sandboxes
+
+  A new `Sandbox` capability in `@effect-uai/core/sandbox` for running
+  untrusted code, commands, or LLM-generated scripts inside an isolated
+  microVM. Two new provider packages ship behind the same
+  `SandboxService`:
+  - **`@effect-uai/microsandbox`** — local Firecracker microVMs via
+    [microsandbox](https://github.com/microsandbox/microsandbox).
+  - **`@effect-uai/deno`** — hosted Firecracker microVMs on
+    [Deno Deploy](https://docs.deno.com/deploy/).
+
+  Both cover `create` / `exec` / `execStream` / volumes / snapshots /
+  network policies / bound secrets / OCI image references. The
+  `recipes-extras/sandbox-code-interpreter` recipe shows the "run, fix,
+  repeat" pattern.
+
+  ### Additive: new recipes
+  - `sleeper-agent` — long-lived background agent waking on scheduled
+    triggers.
+  - `sandbox-code-interpreter` (in `recipes-extras/`) — agent writes
+    Python, sandbox runs it, stderr feeds back into the next turn.
+
 ## 0.5.2
 
 ### Patch Changes

package/README.md

@@ -19,5 +19,9 @@ packages live under the `@effect-uai/*` scope:
   Inworld speech.
 - [`@effect-uai/jina`](https://www.npmjs.com/package/@effect-uai/jina) —
   Jina embeddings (dense / sparse / multivector).
+- [`@effect-uai/microsandbox`](https://www.npmjs.com/package/@effect-uai/microsandbox) —
+  Local microVM sandboxes via [microsandbox](https://github.com/microsandbox/microsandbox).
+- [`@effect-uai/deno`](https://www.npmjs.com/package/@effect-uai/deno) —
+  Hosted Firecracker microVMs on Deno Deploy.
 
 Project repository: https://github.com/betalyra/effect-uai

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "effect-uai",
-  "version": "0.5.2",
+  "version": "0.7.0",
   "description": "Reserved name. See @effect-uai/core and the @effect-uai/* provider packages.",
   "homepage": "https://github.com/betalyra/effect-uai#readme",
   "bugs": {