@usewind/node 0.1.0 → 0.1.2

package/dist/index.d.cts

@@ -17,6 +17,21 @@ interface ChatMessage {
     content: unknown;
     [k: string]: unknown;
 }
+/** OpenAI-style function tool. Wind maps it onto Anthropic and Gemini for you. */
+interface ChatTool {
+    type: 'function';
+    function: {
+        name: string;
+        description?: string;
+        parameters?: Record<string, unknown>;
+    };
+}
+type ChatToolChoice = 'auto' | 'none' | 'required' | {
+    type: 'function';
+    function: {
+        name: string;
+    };
+};
 /** Present on every successful `POST /v1/ai/*` response. */
 interface WindBlock {
     feature: string | null;
@@ -49,6 +64,14 @@ interface ChatParams {
     /** Optional — hold cap resolves request → feature → app default → model ceiling. */
     max_tokens?: number;
     temperature?: number;
+    /**
+     * Function tools, OpenAI format, for every provider. Send the assistant
+     * message back unchanged (including any `extra_content` on its tool calls —
+     * Gemini needs it), then one `{ role: 'tool', tool_call_id, content }` per call.
+     */
+    tools?: ChatTool[];
+    tool_choice?: ChatToolChoice;
+    parallel_tool_calls?: boolean;
     /** Prefer `.chatStream()` over setting this directly. */
     stream?: boolean;
     /** Defaults to `crypto.randomUUID()`; the same value is reused for every internal retry. */
@@ -56,11 +79,36 @@ interface ChatParams {
     signal?: AbortSignal;
 }
 interface ChatStreamChunk {
-    /** Raw provider SSE `data:` payload, JSON-parsed. */
+    /**
+     * One provider chunk, OpenAI shape (`choices[0].delta.content` /
+     * `.tool_calls`), JSON-parsed. `null` on the final, settlement-only chunk.
+     */
     delta: unknown;
-    /** The final chunk of a stream carries the settled `wind` block; `null` on all others. */
+    /** The final chunk of a stream carries the settled `wind` block; `null` on all others, and on a final chunk that isn't `settled`. */
     wind: WindBlock | null;
+    /** Final token counts — on the final chunk only, when `settled`. */
+    usage?: ChatUsage;
+    /** How the call's charge stands — on the final chunk only. */
+    settlement?: ChatSettlement;
+    /**
+     * The call's `Idempotency-Key` — on the final chunk only. A `pending` call's
+     * `request.settled` webhook carries it as `request_id`.
+     */
+    idempotencyKey?: string;
 }
+/**
+ * - `settled`: charged on the provider's own token counts; `wind` and `usage`
+ *   are filled in.
+ * - `estimated`: the stream ended before the provider reported usage, and it
+ *   keeps no record to fetch it from (OpenAI, Anthropic, Google direct), so it
+ *   was charged on Wind's count of the tokens with the provider's tokenizer.
+ *   `wind` and `usage` are filled in from that count.
+ * - `pending`: the stream ended before the provider reported usage, but the
+ *   provider keeps a record (OpenRouter), so the charge isn't known yet.
+ *   `wind` and `usage` are null; the user's hold stays reserved until Wind
+ *   settles it, and the result arrives as a `request.settled` webhook.
+ */
+type ChatSettlement = 'settled' | 'estimated' | 'pending';
 /** 'frozen' — Wind's own risk layer, independent of anything you or the user configured; clears when the user reconnects. */
 type ConnectionStatus = 'active' | 'exhausted' | 'revoked' | 'frozen';
 interface Connection {
@@ -213,6 +261,12 @@ interface RawRequest {
     /** Use HTTP Basic client credentials for `Authorization`. */
     basic?: boolean;
     signal?: AbortSignal;
+    /**
+     * When the response is a 2xx `text/event-stream`, return its unread
+     * `ReadableStream` as `body` instead of buffering it — `.chatStream()`
+     * parses the SSE events as they arrive.
+     */
+    stream?: boolean;
 }
 interface RawResponse<T = unknown> {
     status: number;
@@ -592,7 +646,7 @@ declare class Wind {
         register: (appId: string, feature: Feature) => Promise<Feature>;
         update: (appId: string, slug: string, patch: Partial<Feature>) => Promise<Feature>;
     };
-    /** Verify a webhook's `X-Wind-Signature` and return the typed event. Needs the raw body. */
+    /** Verify a webhook's `Wind-Signature` and return the typed event. Needs the raw body. */
     verify(input: {
         payload: string | Buffer;
         signature: string;
@@ -606,4 +660,4 @@ declare function createWind(config?: Partial<WindConfig>): Wind;
  */
 declare const wind: Wind;
 
-export { type Account, AllocationExhaustedError, type AllocationRequest, type AllocationRequestParams, AppSuspendedError, type ChatMessage, type ChatParams, type ChatResult, type ChatStreamChunk, type ChatUsage, type Chattable, type ConnectTransaction, type Connection, ConnectionFrozenError, ConnectionRevokedError, ConnectionScope, type ConnectionStatus, type Feature, FeatureCostExceededError, FeatureModelNotConfiguredError, FeatureScope, type Grant, type GrantStore, IdempotencyKeyReusedError, ModelNotAllowedError, ProviderError, RateLimitedError, type RevokeResult, RiskThrottledError, type RoutesOptions, TokenExpiredError, type TokenResponse, type TransactionStore, type WebhookEvent, Wind, WindApiError, type WindBlock, type WindConfig, WindConfigError, WindError, type WindErrorEnvelope, type WindErrorInit, WindNotConnectedError, WindNotImplementedError, WindSignatureError, createWind, memoryGrantStore, wind };
+export { type Account, AllocationExhaustedError, type AllocationRequest, type AllocationRequestParams, AppSuspendedError, type ChatMessage, type ChatParams, type ChatResult, type ChatSettlement, type ChatStreamChunk, type ChatTool, type ChatToolChoice, type ChatUsage, type Chattable, type ConnectTransaction, type Connection, ConnectionFrozenError, ConnectionRevokedError, ConnectionScope, type ConnectionStatus, type Feature, FeatureCostExceededError, FeatureModelNotConfiguredError, FeatureScope, type Grant, type GrantStore, IdempotencyKeyReusedError, ModelNotAllowedError, ProviderError, RateLimitedError, type RevokeResult, RiskThrottledError, type RoutesOptions, TokenExpiredError, type TokenResponse, type TransactionStore, type WebhookEvent, Wind, WindApiError, type WindBlock, type WindConfig, WindConfigError, WindError, type WindErrorEnvelope, type WindErrorInit, WindNotConnectedError, WindNotImplementedError, WindSignatureError, createWind, memoryGrantStore, wind };

package/dist/index.d.ts

@@ -17,6 +17,21 @@ interface ChatMessage {
     content: unknown;
     [k: string]: unknown;
 }
+/** OpenAI-style function tool. Wind maps it onto Anthropic and Gemini for you. */
+interface ChatTool {
+    type: 'function';
+    function: {
+        name: string;
+        description?: string;
+        parameters?: Record<string, unknown>;
+    };
+}
+type ChatToolChoice = 'auto' | 'none' | 'required' | {
+    type: 'function';
+    function: {
+        name: string;
+    };
+};
 /** Present on every successful `POST /v1/ai/*` response. */
 interface WindBlock {
     feature: string | null;
@@ -49,6 +64,14 @@ interface ChatParams {
     /** Optional — hold cap resolves request → feature → app default → model ceiling. */
     max_tokens?: number;
     temperature?: number;
+    /**
+     * Function tools, OpenAI format, for every provider. Send the assistant
+     * message back unchanged (including any `extra_content` on its tool calls —
+     * Gemini needs it), then one `{ role: 'tool', tool_call_id, content }` per call.
+     */
+    tools?: ChatTool[];
+    tool_choice?: ChatToolChoice;
+    parallel_tool_calls?: boolean;
     /** Prefer `.chatStream()` over setting this directly. */
     stream?: boolean;
     /** Defaults to `crypto.randomUUID()`; the same value is reused for every internal retry. */
@@ -56,11 +79,36 @@ interface ChatParams {
     signal?: AbortSignal;
 }
 interface ChatStreamChunk {
-    /** Raw provider SSE `data:` payload, JSON-parsed. */
+    /**
+     * One provider chunk, OpenAI shape (`choices[0].delta.content` /
+     * `.tool_calls`), JSON-parsed. `null` on the final, settlement-only chunk.
+     */
     delta: unknown;
-    /** The final chunk of a stream carries the settled `wind` block; `null` on all others. */
+    /** The final chunk of a stream carries the settled `wind` block; `null` on all others, and on a final chunk that isn't `settled`. */
     wind: WindBlock | null;
+    /** Final token counts — on the final chunk only, when `settled`. */
+    usage?: ChatUsage;
+    /** How the call's charge stands — on the final chunk only. */
+    settlement?: ChatSettlement;
+    /**
+     * The call's `Idempotency-Key` — on the final chunk only. A `pending` call's
+     * `request.settled` webhook carries it as `request_id`.
+     */
+    idempotencyKey?: string;
 }
+/**
+ * - `settled`: charged on the provider's own token counts; `wind` and `usage`
+ *   are filled in.
+ * - `estimated`: the stream ended before the provider reported usage, and it
+ *   keeps no record to fetch it from (OpenAI, Anthropic, Google direct), so it
+ *   was charged on Wind's count of the tokens with the provider's tokenizer.
+ *   `wind` and `usage` are filled in from that count.
+ * - `pending`: the stream ended before the provider reported usage, but the
+ *   provider keeps a record (OpenRouter), so the charge isn't known yet.
+ *   `wind` and `usage` are null; the user's hold stays reserved until Wind
+ *   settles it, and the result arrives as a `request.settled` webhook.
+ */
+type ChatSettlement = 'settled' | 'estimated' | 'pending';
 /** 'frozen' — Wind's own risk layer, independent of anything you or the user configured; clears when the user reconnects. */
 type ConnectionStatus = 'active' | 'exhausted' | 'revoked' | 'frozen';
 interface Connection {
@@ -213,6 +261,12 @@ interface RawRequest {
     /** Use HTTP Basic client credentials for `Authorization`. */
     basic?: boolean;
     signal?: AbortSignal;
+    /**
+     * When the response is a 2xx `text/event-stream`, return its unread
+     * `ReadableStream` as `body` instead of buffering it — `.chatStream()`
+     * parses the SSE events as they arrive.
+     */
+    stream?: boolean;
 }
 interface RawResponse<T = unknown> {
     status: number;
@@ -592,7 +646,7 @@ declare class Wind {
         register: (appId: string, feature: Feature) => Promise<Feature>;
         update: (appId: string, slug: string, patch: Partial<Feature>) => Promise<Feature>;
     };
-    /** Verify a webhook's `X-Wind-Signature` and return the typed event. Needs the raw body. */
+    /** Verify a webhook's `Wind-Signature` and return the typed event. Needs the raw body. */
     verify(input: {
         payload: string | Buffer;
         signature: string;
@@ -606,4 +660,4 @@ declare function createWind(config?: Partial<WindConfig>): Wind;
  */
 declare const wind: Wind;
 
-export { type Account, AllocationExhaustedError, type AllocationRequest, type AllocationRequestParams, AppSuspendedError, type ChatMessage, type ChatParams, type ChatResult, type ChatStreamChunk, type ChatUsage, type Chattable, type ConnectTransaction, type Connection, ConnectionFrozenError, ConnectionRevokedError, ConnectionScope, type ConnectionStatus, type Feature, FeatureCostExceededError, FeatureModelNotConfiguredError, FeatureScope, type Grant, type GrantStore, IdempotencyKeyReusedError, ModelNotAllowedError, ProviderError, RateLimitedError, type RevokeResult, RiskThrottledError, type RoutesOptions, TokenExpiredError, type TokenResponse, type TransactionStore, type WebhookEvent, Wind, WindApiError, type WindBlock, type WindConfig, WindConfigError, WindError, type WindErrorEnvelope, type WindErrorInit, WindNotConnectedError, WindNotImplementedError, WindSignatureError, createWind, memoryGrantStore, wind };
+export { type Account, AllocationExhaustedError, type AllocationRequest, type AllocationRequestParams, AppSuspendedError, type ChatMessage, type ChatParams, type ChatResult, type ChatSettlement, type ChatStreamChunk, type ChatTool, type ChatToolChoice, type ChatUsage, type Chattable, type ConnectTransaction, type Connection, ConnectionFrozenError, ConnectionRevokedError, ConnectionScope, type ConnectionStatus, type Feature, FeatureCostExceededError, FeatureModelNotConfiguredError, FeatureScope, type Grant, type GrantStore, IdempotencyKeyReusedError, ModelNotAllowedError, ProviderError, RateLimitedError, type RevokeResult, RiskThrottledError, type RoutesOptions, TokenExpiredError, type TokenResponse, type TransactionStore, type WebhookEvent, Wind, WindApiError, type WindBlock, type WindConfig, WindConfigError, WindError, type WindErrorEnvelope, type WindErrorInit, WindNotConnectedError, WindNotImplementedError, WindSignatureError, createWind, memoryGrantStore, wind };

package/dist/index.js

@@ -234,6 +234,9 @@ var RawClient = class {
       signal: req.signal
     });
     const requestId = res.headers.get("x-request-id");
+    if (req.stream && res.ok && res.body && (res.headers.get("content-type") ?? "").includes("text/event-stream")) {
+      return { status: res.status, headers: res.headers, body: res.body, requestId };
+    }
     let parsed = void 0;
     const text = await res.text();
     if (text) {
@@ -288,7 +291,8 @@ var RawClient = class {
       bearer: args.accessToken,
       headers,
       body: args.body,
-      signal: args.signal
+      signal: args.signal,
+      stream: isStreamBody(args.body)
     });
   }
   /** `POST /v1/ai/features/{slug}`. */
@@ -299,7 +303,8 @@ var RawClient = class {
       bearer: args.accessToken,
       headers: { "Idempotency-Key": args.idempotencyKey },
       body: args.body,
-      signal: args.signal
+      signal: args.signal,
+      stream: isStreamBody(args.body)
     });
   }
   // ── Management (client-credentials) ────────────────────────────────────────
@@ -362,6 +367,9 @@ var RawClient = class {
     return this.request({ method: "POST", path, ...init });
   }
 };
+function isStreamBody(body) {
+  return typeof body === "object" && body !== null && body.stream === true;
+}
 
 // src/tokens.ts
 var ACCESS_TOKEN_SKEW_MS = 6e4;
@@ -620,6 +628,9 @@ function requestBody(params) {
     messages: params.messages,
     ...params.max_tokens !== void 0 && { max_tokens: params.max_tokens },
     ...params.temperature !== void 0 && { temperature: params.temperature },
+    ...params.tools !== void 0 && { tools: params.tools },
+    ...params.tool_choice !== void 0 && { tool_choice: params.tool_choice },
+    ...params.parallel_tool_calls !== void 0 && { parallel_tool_calls: params.parallel_tool_calls },
     ...params.stream !== void 0 && { stream: params.stream }
   };
 }
@@ -666,13 +677,60 @@ async function* billedStream(ctx, userId, params, call) {
   if (res.status < 200 || res.status >= 300) {
     throw WindError.fromResponse(res.status, res.body, { requestId: res.requestId });
   }
-  const contentType = res.headers.get("content-type") ?? "";
-  if (!contentType.includes("text/event-stream")) {
+  if (!(res.body instanceof ReadableStream)) {
     const result = res.body;
-    yield { delta: result, wind: result.wind };
+    yield { delta: result, wind: result.wind ?? null, usage: result.usage, settlement: "settled", idempotencyKey };
     return;
   }
-  yield { delta: res.body, wind: null };
+  for await (const event of sseEvents(res.body)) {
+    if (event === "[DONE]") return;
+    let data;
+    try {
+      data = JSON.parse(event);
+    } catch {
+      continue;
+    }
+    if (data?.wind_final) {
+      yield finalChunk(data.wind_final, idempotencyKey);
+    } else if (data?.error) {
+      const err = data.error.error ?? data.error;
+      const status = err.code === "provider_error" ? 502 : 403;
+      throw WindError.fromResponse(status, { error: err }, { requestId: res.requestId });
+    } else if (data?.streamed) {
+      yield finalChunk(data, idempotencyKey);
+    } else {
+      yield { delta: data, wind: null };
+    }
+  }
+}
+async function* sseEvents(stream) {
+  const reader = stream.getReader();
+  const decoder = new TextDecoder();
+  let buffer = "";
+  try {
+    while (true) {
+      const { done, value } = await reader.read();
+      if (done) break;
+      buffer += decoder.decode(value, { stream: true });
+      const lines = buffer.split("\n");
+      buffer = lines.pop() ?? "";
+      for (const line of lines) {
+        if (line.startsWith("data:")) yield line.slice(5).trim();
+      }
+    }
+    if (buffer.startsWith("data:")) yield buffer.slice(5).trim();
+  } finally {
+    reader.releaseLock();
+  }
+}
+function finalChunk(final, idempotencyKey) {
+  return {
+    delta: null,
+    wind: final.wind ?? null,
+    usage: final.usage ?? void 0,
+    settlement: final.settlement ?? "settled",
+    idempotencyKey
+  };
 }
 var TOLERANCE_S = 300;
 var WebhookVerifier = class {
@@ -995,7 +1053,7 @@ var Wind = class {
     update: (appId, slug, patch) => this.raw.updateFeature(appId, slug, patch)
   };
   // ── webhooks ─────────────────────────────────────────────────────────────
-  /** Verify a webhook's `X-Wind-Signature` and return the typed event. Needs the raw body. */
+  /** Verify a webhook's `Wind-Signature` and return the typed event. Needs the raw body. */
   verify(input) {
     return this.#verifier.verify(input);
   }