@providerkit/core 0.28.0 → 0.28.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -13,8 +13,9 @@ export interface GeminiSpeechConfig extends SpeechLimits {
13
13
  /** "wav" (the default) or "pcm". Gemini makes no other format. */
14
14
  format?: SpeechFormat;
15
15
  /**
16
- * Caps the audio tokens generated. Not sent unless set. Whether a TTS model
17
- * honours the cap is unmeasured; the text limit is the real bound on cost.
16
+ * Caps the audio tokens generated. Not sent unless set. Google enforces it (checked live on
17
+ * 2026-11-03): a clip cut by it comes back `incomplete`, which is reported as an error that
18
+ * carries the usage billed. The text limit is still the bound on cost you can rely on.
18
19
  */
19
20
  maxOutputTokens?: number;
20
21
  headers?: Record<string, string>;
@@ -1 +1 @@
1
- {"version":3,"file":"gemini-speech.d.ts","sourceRoot":"","sources":["../../src/providers/gemini-speech.ts"],"names":[],"mappings":"AAMA,OAAO,EASL,KAAK,YAAY,EACjB,KAAK,YAAY,EACjB,KAAK,cAAc,EAEpB,MAAM,mBAAmB,CAAC;AAG3B,MAAM,WAAW,kBAAmB,SAAQ,YAAY;IACtD,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,2DAA2D;IAC3D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,sCAAsC;IACtC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,gGAAgG;IAChG,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,uCAAuC;IACvC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,kEAAkE;IAClE,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB;;;OAGG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,+EAA+E;IAC/E,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;CAC1B;AAmCD,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,kBAAkB,GAAG,cAAc,CAgIrF"}
1
+ {"version":3,"file":"gemini-speech.d.ts","sourceRoot":"","sources":["../../src/providers/gemini-speech.ts"],"names":[],"mappings":"AAMA,OAAO,EASL,KAAK,YAAY,EACjB,KAAK,YAAY,EACjB,KAAK,cAAc,EAEpB,MAAM,mBAAmB,CAAC;AAG3B,MAAM,WAAW,kBAAmB,SAAQ,YAAY;IACtD,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,2DAA2D;IAC3D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,sCAAsC;IACtC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,gGAAgG;IAChG,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,uCAAuC;IACvC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,kEAAkE;IAClE,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB;;;;OAIG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,+EAA+E;IAC/E,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;CAC1B;AAkCD,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,kBAAkB,GAAG,cAAc,CAkIrF"}
@@ -23,16 +23,14 @@ function readUsage(raw) {
23
23
  return undefined;
24
24
  if (!Number.isSafeInteger(input + output) || total < input + output)
25
25
  return undefined;
26
- let cached = 0;
27
- if (usage?.total_cached_tokens !== undefined) {
28
- const reported = count(usage.total_cached_tokens);
29
- if (reported === undefined || reported > input)
30
- return undefined;
31
- cached = reported;
32
- }
26
+ // The cached count is a part of the input count and is not what a charge is made of. One that
27
+ // cannot be right (a string, a negative, more than the input) reads as none cached, because
28
+ // the type needs a number and none cached never understates what was billed. The counts a
29
+ // charge is made of stay. Absent also means none.
30
+ const reported = usage?.total_cached_tokens === undefined ? 0 : count(usage.total_cached_tokens);
33
31
  return {
34
32
  inputTokens: input,
35
- cachedInputTokens: cached,
33
+ cachedInputTokens: reported !== undefined && reported <= input ? reported : 0,
36
34
  outputTokens: output,
37
35
  totalTokens: total,
38
36
  };
@@ -95,7 +93,8 @@ export function createGeminiSpeechProvider(config) {
95
93
  // From here on the provider has answered, so it has billed: every failure
96
94
  // below carries the usage it stated.
97
95
  const usage = readUsage(envelope.usage);
98
- if (envelope.error !== undefined)
96
+ // `error: null` is "no error", as it is in most JSON APIs: it must not turn a good clip away.
97
+ if (envelope.error !== undefined && envelope.error !== null)
99
98
  throw inBandFailure(provider, envelope, usage);
100
99
  const status = envelope.status;
101
100
  if (status === "incomplete") {
@@ -1 +1 @@
1
- {"version":3,"file":"gemini-speech.js","sourceRoot":"","sources":["../../src/providers/gemini-speech.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"gemini-speech.js","sourceRoot":"","sources":["../../src/providers/gemini-speech.ts"],"names":[],"mappings":"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"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@providerkit/core",
3
- "version": "0.28.0",
3
+ "version": "0.28.1",
4
4
  "description": "The layer under your agent loop: one seam for every LLM provider, plus the failure handling you only learn in production.",
5
5
  "type": "module",
6
6
  "license": "MIT",
@@ -34,8 +34,9 @@ export interface GeminiSpeechConfig extends SpeechLimits {
34
34
  /** "wav" (the default) or "pcm". Gemini makes no other format. */
35
35
  format?: SpeechFormat;
36
36
  /**
37
- * Caps the audio tokens generated. Not sent unless set. Whether a TTS model
38
- * honours the cap is unmeasured; the text limit is the real bound on cost.
37
+ * Caps the audio tokens generated. Not sent unless set. Google enforces it (checked live on
38
+ * 2026-11-03): a clip cut by it comes back `incomplete`, which is reported as an error that
39
+ * carries the usage billed. The text limit is still the bound on cost you can rely on.
39
40
  */
40
41
  maxOutputTokens?: number;
41
42
  headers?: Record<string, string>;
@@ -62,15 +63,14 @@ function readUsage(raw: unknown): SpeechUsage | undefined {
62
63
  const total = count(usage?.total_tokens);
63
64
  if (input === undefined || output === undefined || total === undefined) return undefined;
64
65
  if (!Number.isSafeInteger(input + output) || total < input + output) return undefined;
65
- let cached = 0;
66
- if (usage?.total_cached_tokens !== undefined) {
67
- const reported = count(usage.total_cached_tokens);
68
- if (reported === undefined || reported > input) return undefined;
69
- cached = reported;
70
- }
66
+ // The cached count is a part of the input count and is not what a charge is made of. One that
67
+ // cannot be right (a string, a negative, more than the input) reads as none cached, because
68
+ // the type needs a number and none cached never understates what was billed. The counts a
69
+ // charge is made of stay. Absent also means none.
70
+ const reported = usage?.total_cached_tokens === undefined ? 0 : count(usage.total_cached_tokens);
71
71
  return {
72
72
  inputTokens: input,
73
- cachedInputTokens: cached,
73
+ cachedInputTokens: reported !== undefined && reported <= input ? reported : 0,
74
74
  outputTokens: output,
75
75
  totalTokens: total,
76
76
  };
@@ -135,7 +135,9 @@ export function createGeminiSpeechProvider(config: GeminiSpeechConfig): SpeechPr
135
135
  // From here on the provider has answered, so it has billed: every failure
136
136
  // below carries the usage it stated.
137
137
  const usage = readUsage(envelope.usage);
138
- if (envelope.error !== undefined) throw inBandFailure(provider, envelope, usage);
138
+ // `error: null` is "no error", as it is in most JSON APIs: it must not turn a good clip away.
139
+ if (envelope.error !== undefined && envelope.error !== null)
140
+ throw inBandFailure(provider, envelope, usage);
139
141
  const status = envelope.status;
140
142
  if (status === "incomplete") {
141
143
  throw unusable(