smoltalk 0.4.0 → 0.4.2

package/dist/models.d.ts

@@ -42,6 +42,16 @@ export type TextModel = BaseModel & {
         levels?: readonly string[];
         /** Default reasoning level */
         defaultLevel?: string;
+        /**
+         * Anthropic thinking API shape:
+         *   "adaptive" → `thinking: {type: "adaptive"}` + `output_config: {effort}`
+         *               (Opus 4.6/4.7/4.8, Sonnet 4.6). Required on 4.7+, where the
+         *               legacy `enabled` form returns a 400.
+         *   "budget"   → `thinking: {type: "enabled", budget_tokens: N}`
+         *               (Haiku 4.5 and older models).
+         * Omit for non-Anthropic models.
+         */
+        thinkingStyle?: "adaptive" | "budget";
         /** Whether reasoning/thinking can be fully disabled */
         canDisable?: boolean;
         /** Whether the response includes visible thinking content (thinking blocks/parts) */
@@ -251,7 +261,7 @@ export declare const textModels: readonly [{
         readonly outputsThinking: false;
         readonly outputsSignatures: false;
     };
-    readonly provider: "openai";
+    readonly provider: "openai-responses";
 }, {
     readonly type: "text";
     readonly modelName: "gpt-5-mini";
@@ -269,7 +279,7 @@ export declare const textModels: readonly [{
         readonly outputsThinking: false;
         readonly outputsSignatures: false;
     };
-    readonly provider: "openai";
+    readonly provider: "openai-responses";
 }, {
     readonly type: "text";
     readonly modelName: "gpt-5-nano";
@@ -287,7 +297,7 @@ export declare const textModels: readonly [{
         readonly outputsThinking: false;
         readonly outputsSignatures: false;
     };
-    readonly provider: "openai";
+    readonly provider: "openai-responses";
 }, {
     readonly type: "text";
     readonly modelName: "gpt-5.1";
@@ -304,7 +314,7 @@ export declare const textModels: readonly [{
         readonly outputsThinking: false;
         readonly outputsSignatures: false;
     };
-    readonly provider: "openai";
+    readonly provider: "openai-responses";
 }, {
     readonly type: "text";
     readonly modelName: "gpt-5.2";
@@ -322,7 +332,7 @@ export declare const textModels: readonly [{
         readonly outputsThinking: false;
         readonly outputsSignatures: false;
     };
-    readonly provider: "openai";
+    readonly provider: "openai-responses";
 }, {
     readonly type: "text";
     readonly modelName: "gpt-5.2-pro";
@@ -336,7 +346,7 @@ export declare const textModels: readonly [{
         readonly outputsThinking: false;
         readonly outputsSignatures: false;
     };
-    readonly provider: "openai";
+    readonly provider: "openai-responses";
 }, {
     readonly type: "text";
     readonly modelName: "gpt-5.4";
@@ -353,7 +363,7 @@ export declare const textModels: readonly [{
         readonly outputsThinking: false;
         readonly outputsSignatures: false;
     };
-    readonly provider: "openai";
+    readonly provider: "openai-responses";
 }, {
     readonly type: "text";
     readonly modelName: "gpt-5.4-mini";
@@ -371,7 +381,7 @@ export declare const textModels: readonly [{
         readonly outputsThinking: false;
         readonly outputsSignatures: false;
     };
-    readonly provider: "openai";
+    readonly provider: "openai-responses";
 }, {
     readonly type: "text";
     readonly modelName: "gpt-5.4-nano";
@@ -389,7 +399,7 @@ export declare const textModels: readonly [{
         readonly outputsThinking: false;
         readonly outputsSignatures: false;
     };
-    readonly provider: "openai";
+    readonly provider: "openai-responses";
 }, {
     readonly type: "text";
     readonly modelName: "gpt-5.4-pro";
@@ -405,7 +415,7 @@ export declare const textModels: readonly [{
         readonly outputsThinking: false;
         readonly outputsSignatures: false;
     };
-    readonly provider: "openai";
+    readonly provider: "openai-responses";
 }, {
     readonly type: "text";
     readonly modelName: "gpt-5.5";
@@ -423,7 +433,7 @@ export declare const textModels: readonly [{
         readonly outputsThinking: false;
         readonly outputsSignatures: false;
     };
-    readonly provider: "openai";
+    readonly provider: "openai-responses";
 }, {
     readonly type: "text";
     readonly modelName: "gpt-5.5-pro";
@@ -439,7 +449,7 @@ export declare const textModels: readonly [{
         readonly outputsThinking: false;
         readonly outputsSignatures: false;
     };
-    readonly provider: "openai";
+    readonly provider: "openai-responses";
 }, {
     readonly type: "text";
     readonly modelName: "gemini-3.1-pro-preview";
@@ -652,6 +662,7 @@ export declare const textModels: readonly [{
     readonly cachedInputTokenCost: 0.5;
     readonly outputTokenCost: 25;
     readonly reasoning: {
+        readonly thinkingStyle: "adaptive";
         readonly canDisable: false;
         readonly outputsThinking: true;
         readonly outputsSignatures: true;
@@ -669,6 +680,7 @@ export declare const textModels: readonly [{
     readonly outputTokenCost: 25;
     readonly outputTokensPerSecond: 72;
     readonly reasoning: {
+        readonly thinkingStyle: "adaptive";
         readonly canDisable: false;
         readonly outputsThinking: true;
         readonly outputsSignatures: true;
@@ -686,6 +698,7 @@ export declare const textModels: readonly [{
     readonly outputTokenCost: 25;
     readonly outputTokensPerSecond: 53;
     readonly reasoning: {
+        readonly thinkingStyle: "adaptive";
         readonly canDisable: true;
         readonly outputsThinking: true;
         readonly outputsSignatures: true;
@@ -703,6 +716,7 @@ export declare const textModels: readonly [{
     readonly outputTokenCost: 15;
     readonly outputTokensPerSecond: 52;
     readonly reasoning: {
+        readonly thinkingStyle: "adaptive";
         readonly canDisable: true;
         readonly outputsThinking: true;
         readonly outputsSignatures: true;
@@ -720,6 +734,7 @@ export declare const textModels: readonly [{
     readonly outputTokenCost: 5;
     readonly outputTokensPerSecond: 97;
     readonly reasoning: {
+        readonly thinkingStyle: "budget";
         readonly canDisable: true;
         readonly outputsThinking: true;
         readonly outputsSignatures: true;
@@ -735,6 +750,7 @@ export declare const textModels: readonly [{
     readonly outputTokenCost: 15;
     readonly outputTokensPerSecond: 78;
     readonly reasoning: {
+        readonly thinkingStyle: "budget";
         readonly canDisable: true;
         readonly outputsThinking: true;
         readonly outputsSignatures: true;
@@ -997,7 +1013,7 @@ export declare function getModel(modelName: ModelName): TextModel | EmbeddingsMo
         readonly outputsThinking: false;
         readonly outputsSignatures: false;
     };
-    readonly provider: "openai";
+    readonly provider: "openai-responses";
 } | {
     readonly type: "text";
     readonly modelName: "gpt-5-mini";
@@ -1015,7 +1031,7 @@ export declare function getModel(modelName: ModelName): TextModel | EmbeddingsMo
         readonly outputsThinking: false;
         readonly outputsSignatures: false;
     };
-    readonly provider: "openai";
+    readonly provider: "openai-responses";
 } | {
     readonly type: "text";
     readonly modelName: "gpt-5-nano";
@@ -1033,7 +1049,7 @@ export declare function getModel(modelName: ModelName): TextModel | EmbeddingsMo
         readonly outputsThinking: false;
         readonly outputsSignatures: false;
     };
-    readonly provider: "openai";
+    readonly provider: "openai-responses";
 } | {
     readonly type: "text";
     readonly modelName: "gpt-5.1";
@@ -1050,7 +1066,7 @@ export declare function getModel(modelName: ModelName): TextModel | EmbeddingsMo
         readonly outputsThinking: false;
         readonly outputsSignatures: false;
     };
-    readonly provider: "openai";
+    readonly provider: "openai-responses";
 } | {
     readonly type: "text";
     readonly modelName: "gpt-5.2";
@@ -1068,7 +1084,7 @@ export declare function getModel(modelName: ModelName): TextModel | EmbeddingsMo
         readonly outputsThinking: false;
         readonly outputsSignatures: false;
     };
-    readonly provider: "openai";
+    readonly provider: "openai-responses";
 } | {
     readonly type: "text";
     readonly modelName: "gpt-5.2-pro";
@@ -1082,7 +1098,7 @@ export declare function getModel(modelName: ModelName): TextModel | EmbeddingsMo
         readonly outputsThinking: false;
         readonly outputsSignatures: false;
     };
-    readonly provider: "openai";
+    readonly provider: "openai-responses";
 } | {
     readonly type: "text";
     readonly modelName: "gpt-5.4";
@@ -1099,7 +1115,7 @@ export declare function getModel(modelName: ModelName): TextModel | EmbeddingsMo
         readonly outputsThinking: false;
         readonly outputsSignatures: false;
     };
-    readonly provider: "openai";
+    readonly provider: "openai-responses";
 } | {
     readonly type: "text";
     readonly modelName: "gpt-5.4-mini";
@@ -1117,7 +1133,7 @@ export declare function getModel(modelName: ModelName): TextModel | EmbeddingsMo
         readonly outputsThinking: false;
         readonly outputsSignatures: false;
     };
-    readonly provider: "openai";
+    readonly provider: "openai-responses";
 } | {
     readonly type: "text";
     readonly modelName: "gpt-5.4-nano";
@@ -1135,7 +1151,7 @@ export declare function getModel(modelName: ModelName): TextModel | EmbeddingsMo
         readonly outputsThinking: false;
         readonly outputsSignatures: false;
     };
-    readonly provider: "openai";
+    readonly provider: "openai-responses";
 } | {
     readonly type: "text";
     readonly modelName: "gpt-5.4-pro";
@@ -1151,7 +1167,7 @@ export declare function getModel(modelName: ModelName): TextModel | EmbeddingsMo
         readonly outputsThinking: false;
         readonly outputsSignatures: false;
     };
-    readonly provider: "openai";
+    readonly provider: "openai-responses";
 } | {
     readonly type: "text";
     readonly modelName: "gpt-5.5";
@@ -1169,7 +1185,7 @@ export declare function getModel(modelName: ModelName): TextModel | EmbeddingsMo
         readonly outputsThinking: false;
         readonly outputsSignatures: false;
     };
-    readonly provider: "openai";
+    readonly provider: "openai-responses";
 } | {
     readonly type: "text";
     readonly modelName: "gpt-5.5-pro";
@@ -1185,7 +1201,7 @@ export declare function getModel(modelName: ModelName): TextModel | EmbeddingsMo
         readonly outputsThinking: false;
         readonly outputsSignatures: false;
     };
-    readonly provider: "openai";
+    readonly provider: "openai-responses";
 } | {
     readonly type: "text";
     readonly modelName: "gemini-3.1-pro-preview";
@@ -1398,6 +1414,7 @@ export declare function getModel(modelName: ModelName): TextModel | EmbeddingsMo
     readonly cachedInputTokenCost: 0.5;
     readonly outputTokenCost: 25;
     readonly reasoning: {
+        readonly thinkingStyle: "adaptive";
         readonly canDisable: false;
         readonly outputsThinking: true;
         readonly outputsSignatures: true;
@@ -1415,6 +1432,7 @@ export declare function getModel(modelName: ModelName): TextModel | EmbeddingsMo
     readonly outputTokenCost: 25;
     readonly outputTokensPerSecond: 72;
     readonly reasoning: {
+        readonly thinkingStyle: "adaptive";
         readonly canDisable: false;
         readonly outputsThinking: true;
         readonly outputsSignatures: true;
@@ -1432,6 +1450,7 @@ export declare function getModel(modelName: ModelName): TextModel | EmbeddingsMo
     readonly outputTokenCost: 25;
     readonly outputTokensPerSecond: 53;
     readonly reasoning: {
+        readonly thinkingStyle: "adaptive";
         readonly canDisable: true;
         readonly outputsThinking: true;
         readonly outputsSignatures: true;
@@ -1449,6 +1468,7 @@ export declare function getModel(modelName: ModelName): TextModel | EmbeddingsMo
     readonly outputTokenCost: 15;
     readonly outputTokensPerSecond: 52;
     readonly reasoning: {
+        readonly thinkingStyle: "adaptive";
         readonly canDisable: true;
         readonly outputsThinking: true;
         readonly outputsSignatures: true;
@@ -1466,6 +1486,7 @@ export declare function getModel(modelName: ModelName): TextModel | EmbeddingsMo
     readonly outputTokenCost: 5;
     readonly outputTokensPerSecond: 97;
     readonly reasoning: {
+        readonly thinkingStyle: "budget";
         readonly canDisable: true;
         readonly outputsThinking: true;
         readonly outputsSignatures: true;
@@ -1481,6 +1502,7 @@ export declare function getModel(modelName: ModelName): TextModel | EmbeddingsMo
     readonly outputTokenCost: 15;
     readonly outputTokensPerSecond: 78;
     readonly reasoning: {
+        readonly thinkingStyle: "budget";
         readonly canDisable: true;
         readonly outputsThinking: true;
         readonly outputsSignatures: true;

package/dist/models.js

@@ -229,7 +229,7 @@ export const textModels = [
             outputsThinking: false,
             outputsSignatures: false,
         },
-        provider: "openai",
+        provider: "openai-responses",
     },
     {
         type: "text",
@@ -248,7 +248,7 @@ export const textModels = [
             outputsThinking: false,
             outputsSignatures: false,
         },
-        provider: "openai",
+        provider: "openai-responses",
     },
     {
         type: "text",
@@ -267,7 +267,7 @@ export const textModels = [
             outputsThinking: false,
             outputsSignatures: false,
         },
-        provider: "openai",
+        provider: "openai-responses",
     },
     {
         type: "text",
@@ -285,7 +285,7 @@ export const textModels = [
             outputsThinking: false,
             outputsSignatures: false,
         },
-        provider: "openai",
+        provider: "openai-responses",
     },
     {
         type: "text",
@@ -304,7 +304,7 @@ export const textModels = [
             outputsThinking: false,
             outputsSignatures: false,
         },
-        provider: "openai",
+        provider: "openai-responses",
     },
     {
         type: "text",
@@ -319,7 +319,7 @@ export const textModels = [
             outputsThinking: false,
             outputsSignatures: false,
         },
-        provider: "openai",
+        provider: "openai-responses",
     },
     {
         type: "text",
@@ -337,7 +337,7 @@ export const textModels = [
             outputsThinking: false,
             outputsSignatures: false,
         },
-        provider: "openai",
+        provider: "openai-responses",
     },
     {
         type: "text",
@@ -356,7 +356,7 @@ export const textModels = [
             outputsThinking: false,
             outputsSignatures: false,
         },
-        provider: "openai",
+        provider: "openai-responses",
     },
     {
         type: "text",
@@ -375,7 +375,7 @@ export const textModels = [
             outputsThinking: false,
             outputsSignatures: false,
         },
-        provider: "openai",
+        provider: "openai-responses",
     },
     {
         type: "text",
@@ -392,7 +392,7 @@ export const textModels = [
             outputsThinking: false,
             outputsSignatures: false,
         },
-        provider: "openai",
+        provider: "openai-responses",
     },
     {
         type: "text",
@@ -411,7 +411,7 @@ export const textModels = [
             outputsThinking: false,
             outputsSignatures: false,
         },
-        provider: "openai",
+        provider: "openai-responses",
     },
     {
         type: "text",
@@ -428,7 +428,7 @@ export const textModels = [
             outputsThinking: false,
             outputsSignatures: false,
         },
-        provider: "openai",
+        provider: "openai-responses",
     },
     {
         type: "text",
@@ -657,6 +657,7 @@ export const textModels = [
         cachedInputTokenCost: 0.5,
         outputTokenCost: 25,
         reasoning: {
+            thinkingStyle: "adaptive",
             canDisable: false,
             outputsThinking: true,
             outputsSignatures: true,
@@ -675,6 +676,7 @@ export const textModels = [
         outputTokenCost: 25,
         outputTokensPerSecond: 72,
         reasoning: {
+            thinkingStyle: "adaptive",
             canDisable: false,
             outputsThinking: true,
             outputsSignatures: true,
@@ -693,6 +695,7 @@ export const textModels = [
         outputTokenCost: 25,
         outputTokensPerSecond: 53,
         reasoning: {
+            thinkingStyle: "adaptive",
             canDisable: true,
             outputsThinking: true,
             outputsSignatures: true,
@@ -711,6 +714,7 @@ export const textModels = [
         outputTokenCost: 15,
         outputTokensPerSecond: 52,
         reasoning: {
+            thinkingStyle: "adaptive",
             canDisable: true,
             outputsThinking: true,
             outputsSignatures: true,
@@ -729,6 +733,7 @@ export const textModels = [
         outputTokenCost: 5,
         outputTokensPerSecond: 97,
         reasoning: {
+            thinkingStyle: "budget",
             canDisable: true,
             outputsThinking: true,
             outputsSignatures: true,
@@ -745,6 +750,7 @@ export const textModels = [
         outputTokenCost: 15,
         outputTokensPerSecond: 78,
         reasoning: {
+            thinkingStyle: "budget",
             canDisable: true,
             outputsThinking: true,
             outputsSignatures: true,

package/dist/smolError.d.ts

@@ -1,15 +1,88 @@
+export interface SmolErrorOptions {
+    /** HTTP status code from the provider response, when the error came from an HTTP call. */
+    status?: number;
+    /**
+     * Curated, safe-to-log subset of the provider response headers (see
+     * `extractHttpErrorFields` for the allowlist). The full, unredacted headers
+     * live on the raw provider error at `cause`.
+     */
+    headers?: Record<string, string>;
+    /**
+     * Suggested wait before retrying, in milliseconds, parsed from the
+     * `retry-after-ms` / `retry-after` response headers (when available).
+     */
+    retryAfterMs?: number;
+    /** Provider request id (`x-request-id` / `request-id`), useful for support tickets. */
+    requestId?: string;
+    /** The underlying provider error this was derived from, if any. */
+    cause?: unknown;
+}
+/**
+ * Base error type for all smoltalk failures. Carries a curated, safe-to-log
+ * snapshot of the HTTP response on `status` / `headers` / `retryAfterMs` /
+ * `requestId`.
+ *
+ * **Security note on `cause`:** the raw provider error is attached at `cause`
+ * as a non-enumerable property (using the ES2022 `Error` `{ cause }` option),
+ * so `JSON.stringify(err)` and most error serializers (Sentry, pino, Bunyan)
+ * will NOT walk it. The custom `toJSON()` below similarly omits both `cause`
+ * and `stack`. The provider error can still contain `authorization` headers,
+ * cookies, and echoed prompt bodies — direct access (`err.cause`) and Node's
+ * native `console.error` chain still work, so handle deliberately.
+ */
 export declare class SmolError extends Error {
-    constructor(message: string);
+    /** HTTP status code from the provider response, when available. */
+    readonly status?: number;
+    /**
+     * Curated, safe-to-log subset of the provider response headers. For the full,
+     * unredacted set (including any session cookies the provider sent), reach for
+     * the raw provider error on `cause` — but note that `cause` is non-enumerable
+     * specifically to keep it out of casual logging.
+     */
+    readonly headers?: Record<string, string>;
+    /**
+     * Suggested wait before retrying, in milliseconds, parsed from the
+     * `retry-after-ms` / `retry-after` response headers (when available).
+     * Always non-negative and capped at a sane ceiling (see `httpError.ts`).
+     */
+    readonly retryAfterMs?: number;
+    /** Provider request id (`x-request-id` / `request-id`), useful for support tickets. */
+    readonly requestId?: string;
+    constructor(message: string, options?: SmolErrorOptions);
+    /**
+     * Custom JSON serializer. Returns only the curated/safe fields — never
+     * `cause` or `stack`, both of which can leak secrets (auth headers in
+     * `cause`, file system paths and source snippets in `stack`).
+     */
+    toJSON(): Record<string, unknown>;
 }
 export declare class SmolStructuredOutputError extends SmolError {
-    constructor(message: string);
+    constructor(message: string, options?: SmolErrorOptions);
 }
 export declare class SmolTimeoutError extends SmolError {
-    constructor(message: string);
+    constructor(message: string, options?: SmolErrorOptions);
 }
 export declare class SmolContentPolicyError extends SmolError {
-    constructor(message: string);
+    constructor(message: string, options?: SmolErrorOptions);
 }
 export declare class SmolContextWindowExceededError extends SmolError {
-    constructor(message: string);
+    constructor(message: string, options?: SmolErrorOptions);
+}
+/** Rate limited (HTTP 429). Inspect `retryAfterMs` to back off. */
+export declare class SmolRateLimitError extends SmolError {
+    constructor(message: string, options?: SmolErrorOptions);
+}
+/** Provider temporarily overloaded/unavailable (HTTP 503, or Anthropic's 529). */
+export declare class SmolOverloadedError extends SmolError {
+    constructor(message: string, options?: SmolErrorOptions);
+}
+/** Authentication or permission failure (HTTP 401/403). */
+export declare class SmolAuthError extends SmolError {
+    constructor(message: string, options?: SmolErrorOptions);
 }
+/**
+ * Pick the most specific SmolError subclass for an HTTP status code, so retry
+ * code can `instanceof`-dispatch instead of sniffing magic status numbers.
+ * Falls back to the base `SmolError` for unclassified statuses.
+ */
+export declare function smolErrorForStatus(message: string, options?: SmolErrorOptions): SmolError;