defiant-jazz 0.7.0 → 0.8.0

package/README.md

@@ -28,15 +28,21 @@ await refine("Hello world", "dylan");
 ```
 
 Set `ANTHROPIC_API_KEY` or `OPENAI_API_KEY` in your environment and you're done —
-whichever is present is used automatically (Anthropic first if both are set).
+whichever one is present is used. If both are set, the library won't pick for
+you; pass `provider` instead (see [Choosing a provider](#choosing-a-provider)).
 
 **Default models: `claude-sonnet-5` (Anthropic), `gpt-4o-mini` (OpenAI).**
 Sonnet 5 was chosen over Opus 5 after a head-to-head comparison found
 matching output quality at 40% of the cost — see
 [model-comparison.md](model-comparison.md) for the full writeup, including a
 documented regression on Haiku 4.5 that ruled it out as a default. Override
-with `model` on `createDefiantJazz()` or per call; see
-[Choosing a provider](#choosing-a-provider).
+with `model` on `createDefiantJazz()` or per call. The defaults are also
+exported, so you can check what a zero-config call will run:
+
+```typescript
+import { DEFAULT_MODELS } from 'defiant-jazz';
+// { anthropic: 'claude-sonnet-5', openai: 'gpt-4o-mini' }
+```
 
 ## Lore
 
@@ -91,7 +97,28 @@ await claude.dylan("Hello world");
 await gpt.dylan("Hello world");
 ```
 
-`refine` is a shared default instance using auto-detected credentials. Use
+How the provider is chosen:
+
+- `provider` set → that provider. Its key comes from `apiKey`, or from
+  `ANTHROPIC_API_KEY` / `OPENAI_API_KEY` if `apiKey` is omitted.
+- `provider` omitted, exactly one env key set → that provider.
+- `provider` omitted, both env keys set → throws. The library never decides
+  whose account gets billed.
+- `apiKey` passed without `provider` → throws, so a key is never sent to the
+  wrong service.
+
+Only those two env var names are read. To use a key stored under a different
+name, read it yourself and pass it as `apiKey`:
+
+```typescript
+const gpt = createDefiantJazz({
+  provider: 'openai',
+  apiKey: process.env.MY_TEAM_OPENAI_KEY,
+});
+```
+
+`refine` is a shared default instance that follows the same rules; point it at
+a provider with `refine.configure({ provider: 'openai' })`. Use
 `createDefiantJazz()` whenever you need an isolated instance — a specific
 provider, different API keys per request, a non-default model, testing.
 

package/dist/client.js

@@ -12,14 +12,23 @@ function resolveProvider(options) {
         }
         return { provider: options.provider, apiKey };
     }
+    // No explicit provider. Only infer one when there's exactly one candidate;
+    // never guess between two, since that picks whose account gets billed.
     if (options.apiKey) {
-        return { provider: "anthropic", apiKey: options.apiKey };
+        throw new Error("apiKey requires provider so the key isn't sent to the wrong service. " +
+            "Pass { provider: 'anthropic' } or { provider: 'openai' } alongside it.");
     }
-    if (process.env.ANTHROPIC_API_KEY) {
-        return { provider: "anthropic", apiKey: process.env.ANTHROPIC_API_KEY };
+    const anthropicKey = process.env.ANTHROPIC_API_KEY;
+    const openaiKey = process.env.OPENAI_API_KEY;
+    if (anthropicKey && openaiKey) {
+        throw new Error("Both ANTHROPIC_API_KEY and OPENAI_API_KEY are set. " +
+            "Pass { provider: 'anthropic' } or { provider: 'openai' } to choose.");
     }
-    if (process.env.OPENAI_API_KEY) {
-        return { provider: "openai", apiKey: process.env.OPENAI_API_KEY };
+    if (anthropicKey) {
+        return { provider: "anthropic", apiKey: anthropicKey };
+    }
+    if (openaiKey) {
+        return { provider: "openai", apiKey: openaiKey };
     }
     throw new Error("No API key found. Set ANTHROPIC_API_KEY or OPENAI_API_KEY " +
         "(or pass apiKey/provider to configure()/createDefiantJazz()).");

package/dist/defaults.d.ts

@@ -0,0 +1,7 @@
+import type { Provider } from "./types.js";
+/**
+ * The model each provider uses when `model` is not set. Exported so callers
+ * can see what a zero-config call will run (and be billed for) without
+ * reading the docs. See model-comparison.md for why Sonnet 5 is the default.
+ */
+export declare const DEFAULT_MODELS: Readonly<Record<Provider, string>>;

package/dist/defaults.js

@@ -0,0 +1,9 @@
+/**
+ * The model each provider uses when `model` is not set. Exported so callers
+ * can see what a zero-config call will run (and be billed for) without
+ * reading the docs. See model-comparison.md for why Sonnet 5 is the default.
+ */
+export const DEFAULT_MODELS = Object.freeze({
+    anthropic: "claude-sonnet-5",
+    openai: "gpt-4o-mini",
+});

package/dist/index.d.ts

@@ -1,8 +1,9 @@
 import { createDefiantJazz, type DefiantJazz } from "./client.js";
+import { DEFAULT_MODELS } from "./defaults.js";
 import { CHARACTERS } from "./prompt.js";
 import type { CharacterKey, DefiantJazzOptions, Effort, RefineOptions, RefineResult, TokenUsage } from "./types.js";
 export type { CharacterKey, DefiantJazzOptions, Effort, RefineOptions, RefineResult, TokenUsage, };
-export { CHARACTERS, createDefiantJazz };
+export { CHARACTERS, DEFAULT_MODELS, createDefiantJazz };
 /**
  * Configure the default `refine` instance with an API key and optional
  * model/provider overrides. Prefer `createDefiantJazz()` for an isolated

package/dist/index.js

@@ -1,6 +1,7 @@
 import { createDefiantJazz } from "./client.js";
+import { DEFAULT_MODELS } from "./defaults.js";
 import { CHARACTERS } from "./prompt.js";
-export { CHARACTERS, createDefiantJazz };
+export { CHARACTERS, DEFAULT_MODELS, createDefiantJazz };
 let defaultInstance = null;
 function getDefaultInstance() {
     if (!defaultInstance) {

package/dist/providers/anthropic.js

@@ -1,5 +1,6 @@
 import Anthropic from "@anthropic-ai/sdk";
-const DEFAULT_MODEL = "claude-sonnet-5";
+import { DEFAULT_MODELS } from "../defaults.js";
+const DEFAULT_MODEL = DEFAULT_MODELS.anthropic;
 const DEFAULT_MAX_TOKENS = 4096;
 export function createAnthropicClient(apiKey) {
     return new Anthropic({ apiKey });

package/dist/providers/openai.js

@@ -1,5 +1,6 @@
 import OpenAI from "openai";
-const DEFAULT_MODEL = "gpt-4o-mini";
+import { DEFAULT_MODELS } from "../defaults.js";
+const DEFAULT_MODEL = DEFAULT_MODELS.openai;
 const DEFAULT_MAX_TOKENS = 4096;
 export function createOpenAiClient(apiKey) {
     return new OpenAI({ apiKey });

package/dist/types.d.ts

@@ -17,7 +17,11 @@ export interface RefineResult {
     usage?: TokenUsage;
 }
 export interface DefiantJazzOptions {
-    /** Explicit provider. Defaults to whichever API key is set (Anthropic first). */
+    /**
+     * Which API to call. Optional only when exactly one of `ANTHROPIC_API_KEY`
+     * or `OPENAI_API_KEY` is set and `apiKey` is not passed; when the choice
+     * would be ambiguous, the library throws rather than guess.
+     */
     provider?: Provider;
     apiKey?: string;
     model?: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "defiant-jazz",
-  "version": "0.7.0",
+  "version": "0.8.0",
   "description": "Transform quotes into Severance character voices using Claude or OpenAI",
   "license": "MIT",
   "author": "pelikenjones",