@tanstack/ai 0.50.0 → 0.52.0

package/src/utilities/errors.ts

@@ -1,5 +1,47 @@
 import type { StreamChunk } from '../types'
 
+/**
+ * Thrown when a skills request exceeds a provider limit. Lives in core (rather
+ * than `@tanstack/ai-skills`) so the native tool factories in `ai-anthropic`
+ * and `openai-base` can throw it without depending on the skills package;
+ * `@tanstack/ai-skills` re-exports it for the portable path.
+ *
+ * `path` distinguishes the native provider cap (e.g. Anthropic's 8-skill
+ * limit) from a portable-path limit, so a portable user isn't sent chasing a
+ * cap that only applies to hosted skills.
+ */
+export interface SkillLimitErrorInit {
+  provider: 'anthropic' | 'openai' | 'gemini' | 'other'
+  path: 'native' | 'portable'
+  limit: string
+  allowed: number
+  actual: number
+  offending: Array<string>
+}
+
+export class SkillLimitError extends Error {
+  readonly provider: 'anthropic' | 'openai' | 'gemini' | 'other'
+  readonly path: 'native' | 'portable'
+  readonly limit: string
+  readonly allowed: number
+  readonly actual: number
+  readonly offending: Array<string>
+
+  constructor(init: SkillLimitErrorInit) {
+    super(
+      `${init.provider} ${init.path} skills limit exceeded (${init.limit}): ` +
+        `${init.actual} > ${init.allowed}`,
+    )
+    this.name = 'SkillLimitError'
+    this.provider = init.provider
+    this.path = init.path
+    this.limit = init.limit
+    this.allowed = init.allowed
+    this.actual = init.actual
+    this.offending = init.offending
+  }
+}
+
 /**
  * Best-effort extraction of a human-readable message from an unknown thrown
  * value, returning `undefined` when none can be found.