@usewind/node 0.1.0 → 0.1.1

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,10 +79,15 @@ 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. */
     wind: WindBlock | null;
+    /** Final token counts — on the final chunk only. */
+    usage?: ChatUsage;
 }
 /** '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';
@@ -213,6 +241,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 +626,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 +640,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 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,51 @@ 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 };
     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 { delta: null, wind: data.wind_final.wind ?? null, usage: data.wind_final.usage };
+    } 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 && data.wind) {
+      yield { delta: null, wind: data.wind, usage: data.usage };
+    } 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();
+  }
 }
 var TOLERANCE_S = 300;
 var WebhookVerifier = class {
@@ -995,7 +1044,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);
   }