ainvoker 3.0.0 → 3.2.0

package/README.md

@@ -6,7 +6,7 @@ Official TypeScript/JavaScript SDK for the AInvoker AI gateway.
 
 AInvoker is an AI gateway. This package calls one HTTP API and routes to providers such as OpenAI and Gemini. Create projects, API keys, and billing in the [dashboard](https://ainvoker.com). Use the SDK to call models from your application.
 
-Current release: **2.0.0** (`ai.text.chat` for `POST /v1/text/chat`).
+Current release: **3.2.0** (`ai.text.chat` and `ai.text.stream` for `POST /v1/text/chat` and `POST /v1/text/stream`, with optional `reasoning`).
 
 ## Install
 
@@ -44,7 +44,7 @@ try {
 
 1. [Sign up](https://ainvoker.com/signup) and open your Personal workspace.
 2. Create a project and an API key (`ain_…`). Keep it server-side.
-3. Call `ai.text.chat`. See [Getting Started](https://ainvoker.com/docs/getting-started).
+3. Call `ai.text.chat` or `ai.text.stream`. See [Getting Started](https://ainvoker.com/docs/getting-started).
 
 ## Client options
 
@@ -64,13 +64,39 @@ try {
 | `messages` | Yes | At least one message. Roles: `system`, `user`, `assistant`. |
 | `temperature` | No | Sampling temperature from 0 to 2. |
 | `maxTokens` | No | Maximum tokens to generate. When omitted, the gateway reserves and caps output at 8192. |
+| `reasoning` | No | `minimal`, `low`, `medium`, or `high`. Thinking depth for models that support it (Gemini); lower reaches the first token faster. Ignored by models without thinking, such as `gpt-4o-mini`. Omit for the provider default. |
 
-The result is `{ id, model, message, usage }`. `usage` is `{ inputTokens, outputTokens, totalTokens }` or `null` when the gateway does not report it.
+The result is `{ id, model, message, usage }`. `usage` is `{ inputTokens, outputTokens, totalTokens }` or `null` when the gateway does not report it. For thinking models, `outputTokens` includes thinking tokens.
 
-For Gemini models, include at least one `user` or `assistant` message. A system-only prompt is not enough. Streaming is not available.
+For Gemini models, include at least one `user` or `assistant` message. A system-only prompt is not enough.
 
 Model catalog and plan limits: [Models](https://ainvoker.com/docs/models) · [Limits](https://ainvoker.com/docs/limits).
 
+## Text stream
+
+`ai.text.stream(params)` calls `POST /v1/text/stream` with the same params as chat. It returns an async iterable of typed events (it does **not** unwrap a `{ data }` envelope):
+
+| Event | Fields |
+| --- | --- |
+| `meta` | `id`, `model` |
+| `delta` | `content` |
+| `done` | `message`, `usage` |
+| `error` | `code`, `message` |
+
+```ts
+for await (const event of ai.text.stream({
+  provider: "openai",
+  model: "gpt-4o-mini",
+  messages: [{ role: "user", content: "Hello" }],
+})) {
+  if (event.type === "delta") process.stdout.write(event.content)
+}
+```
+
+Non-2xx responses before the stream starts throw `AInvokerError` like chat. If an `error` event arrives mid-stream, the SDK yields that event and then throws `AInvokerError` (HTTP status `200` because the SSE response already started; `code` and `message` come from the event).
+
+See [Text Stream](https://ainvoker.com/docs/text-stream).
+
 ## Errors
 
 Failures throw `AInvokerError` (`status`, `code`, `message`, and `body` when the response was parsed). Use `isAInvokerError` to narrow the type.

package/dist/index.cjs

@@ -35,6 +35,144 @@ function parseErrorPayload(json) {
 function hasDataEnvelope(json) {
   return isRecord(json) && "data" in json;
 }
+function mapSseEvent(eventName, data) {
+  if (!isRecord(data)) {
+    return null;
+  }
+  if (eventName === "meta") {
+    if (typeof data.id === "string" && typeof data.model === "string") {
+      return { type: "meta", id: data.id, model: data.model };
+    }
+    return null;
+  }
+  if (eventName === "delta") {
+    if (typeof data.content === "string") {
+      return { type: "delta", content: data.content };
+    }
+    return null;
+  }
+  if (eventName === "done") {
+    if (isRecord(data.message) && (data.message.role === "system" || data.message.role === "user" || data.message.role === "assistant") && typeof data.message.content === "string") {
+      const usage = data.usage === null ? null : isRecord(data.usage) && typeof data.usage.inputTokens === "number" && typeof data.usage.outputTokens === "number" && typeof data.usage.totalTokens === "number" ? {
+        inputTokens: data.usage.inputTokens,
+        outputTokens: data.usage.outputTokens,
+        totalTokens: data.usage.totalTokens
+      } : null;
+      return {
+        type: "done",
+        message: {
+          role: data.message.role,
+          content: data.message.content
+        },
+        usage
+      };
+    }
+    return null;
+  }
+  if (eventName === "error") {
+    if (typeof data.code === "string" && typeof data.message === "string") {
+      return { type: "error", code: data.code, message: data.message };
+    }
+    return null;
+  }
+  return null;
+}
+async function* parseTextStreamBody(body, responseStatus) {
+  const reader = body.getReader();
+  const decoder = new TextDecoder();
+  let buffer = "";
+  let eventName = "message";
+  const dataLines = [];
+  const flush = () => {
+    if (dataLines.length === 0) {
+      eventName = "message";
+      return null;
+    }
+    const raw = dataLines.join("\n");
+    dataLines.length = 0;
+    const name = eventName;
+    eventName = "message";
+    let json;
+    try {
+      json = JSON.parse(raw);
+    } catch {
+      throw new AInvokerError(
+        responseStatus,
+        "INVALID_RESPONSE",
+        "Stream event data was not valid JSON",
+        raw
+      );
+    }
+    const mapped = mapSseEvent(name, json);
+    if (!mapped) {
+      throw new AInvokerError(
+        responseStatus,
+        "INVALID_RESPONSE",
+        `Unrecognized stream event "${name}"`,
+        json
+      );
+    }
+    return mapped;
+  };
+  try {
+    while (true) {
+      const { done, value } = await reader.read();
+      if (done) {
+        break;
+      }
+      buffer += decoder.decode(value, { stream: true });
+      while (true) {
+        const newlineIndex = buffer.indexOf("\n");
+        if (newlineIndex < 0) {
+          break;
+        }
+        let line = buffer.slice(0, newlineIndex);
+        buffer = buffer.slice(newlineIndex + 1);
+        if (line.endsWith("\r")) {
+          line = line.slice(0, -1);
+        }
+        if (line === "") {
+          const event2 = flush();
+          if (event2) {
+            yield event2;
+            if (event2.type === "error") {
+              throw new AInvokerError(responseStatus, event2.code, event2.message, event2);
+            }
+          }
+          continue;
+        }
+        if (line.startsWith(":")) {
+          continue;
+        }
+        if (line.startsWith("event:")) {
+          eventName = line.slice(6).replace(/^ /, "");
+          continue;
+        }
+        if (line.startsWith("data:")) {
+          dataLines.push(line.slice(5).replace(/^ /, ""));
+        }
+      }
+    }
+    buffer += decoder.decode();
+    if (buffer.length > 0) {
+      const trailing = buffer.replace(/\r$/, "");
+      if (trailing.startsWith("event:")) {
+        eventName = trailing.slice(6).replace(/^ /, "");
+      } else if (trailing.startsWith("data:")) {
+        dataLines.push(trailing.slice(5).replace(/^ /, ""));
+      }
+    }
+    const event = flush();
+    if (event) {
+      yield event;
+      if (event.type === "error") {
+        throw new AInvokerError(responseStatus, event.code, event.message, event);
+      }
+    }
+  } finally {
+    reader.releaseLock();
+  }
+}
 var HttpClient = class {
   apiKey;
   baseUrl;
@@ -42,11 +180,14 @@ var HttpClient = class {
     this.apiKey = options.apiKey;
     this.baseUrl = options.baseUrl.replace(/\/+$/, "");
   }
+  urlFor(path) {
+    return `${this.baseUrl}${path.startsWith("/") ? path : `/${path}`}`;
+  }
   /**
    * POST JSON to a path under `baseUrl`. Unwraps `{ data: T }` on success.
    */
   async post(path, body) {
-    const url = `${this.baseUrl}${path.startsWith("/") ? path : `/${path}`}`;
+    const url = this.urlFor(path);
     let response;
     try {
       response = await fetch(url, {
@@ -95,9 +236,66 @@ var HttpClient = class {
     }
     return json.data;
   }
+  /**
+   * POST JSON and consume an SSE body as typed {@link TextStreamEvent}s.
+   * Does not unwrap a `{ data }` envelope. Non-2xx before the stream throws like {@link post}.
+   */
+  async *postStream(path, body) {
+    const url = this.urlFor(path);
+    let response;
+    try {
+      response = await fetch(url, {
+        method: "POST",
+        headers: {
+          Authorization: `Bearer ${this.apiKey}`,
+          "Content-Type": "application/json",
+          Accept: "text/event-stream"
+        },
+        body: JSON.stringify(body)
+      });
+    } catch (cause) {
+      const message = cause instanceof Error ? cause.message : "Network request failed";
+      throw new AInvokerError(0, "NETWORK_ERROR", message);
+    }
+    if (!response.ok) {
+      const text = await response.text();
+      let json = void 0;
+      if (text.length > 0) {
+        try {
+          json = JSON.parse(text);
+        } catch {
+          throw new AInvokerError(
+            response.status,
+            "INVALID_RESPONSE",
+            "Response body was not valid JSON",
+            text
+          );
+        }
+      }
+      const parsed = parseErrorPayload(json);
+      throw new AInvokerError(
+        response.status,
+        parsed?.code ?? "HTTP_ERROR",
+        parsed?.message ?? `Request failed with status ${response.status}`,
+        json
+      );
+    }
+    if (!response.body) {
+      throw new AInvokerError(
+        response.status,
+        "INVALID_RESPONSE",
+        "Stream response missing body"
+      );
+    }
+    yield* parseTextStreamBody(response.body, response.status);
+  }
 };
 
 // src/resources/text.ts
+function toGatewayModel(params) {
+  const { provider, model } = params;
+  return provider !== void 0 && provider !== "" ? `${provider}/${model}` : model;
+}
 var TextResource = class {
   constructor(http) {
     this.http = http;
@@ -105,10 +303,16 @@ var TextResource = class {
   http;
   chat(params) {
     const { provider, model, ...rest } = params;
-    const gatewayModel = provider !== void 0 && provider !== "" ? `${provider}/${model}` : model;
     return this.http.post("/v1/text/chat", {
       ...rest,
-      model: gatewayModel
+      model: toGatewayModel({ provider, model })
+    });
+  }
+  stream(params) {
+    const { provider, model, ...rest } = params;
+    return this.http.postStream("/v1/text/stream", {
+      ...rest,
+      model: toGatewayModel({ provider, model })
     });
   }
 };

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/errors.ts","../src/http.ts","../src/resources/text.ts","../src/client.ts"],"names":[],"mappings":"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","file":"index.cjs","sourcesContent":["/**\r\n * Known AInvoker API / SDK error codes.\r\n * Unknown server codes remain assignable via the open string union.\r\n */\r\nexport type AInvokerErrorCode =\r\n  | \"UNAUTHORIZED\"\r\n  | \"FORBIDDEN\"\r\n  | \"NOT_FOUND\"\r\n  | \"VALIDATION_ERROR\"\r\n  | \"CONFLICT\"\r\n  | \"UPSTREAM_ERROR\"\r\n  | \"INTERNAL_ERROR\"\r\n  | \"NETWORK_ERROR\"\r\n  | \"INVALID_RESPONSE\"\r\n  | \"HTTP_ERROR\"\r\n  | (string & {})\r\n\r\n/**\r\n * Error thrown when the AInvoker API returns a non-success response\r\n * or the response body cannot be parsed as expected.\r\n */\r\nexport class AInvokerError extends Error {\r\n  readonly status: number\r\n  readonly code: AInvokerErrorCode\r\n  /** Parsed response body when available (error envelope or raw JSON). */\r\n  readonly body: unknown\r\n\r\n  constructor(\r\n    status: number,\r\n    code: AInvokerErrorCode,\r\n    message: string,\r\n    body: unknown = undefined,\r\n  ) {\r\n    super(message)\r\n    this.name = \"AInvokerError\"\r\n    this.status = status\r\n    this.code = code\r\n    this.body = body\r\n  }\r\n}\r\n\r\n/** Type guard for {@link AInvokerError}. */\r\nexport function isAInvokerError(error: unknown): error is AInvokerError {\r\n  return error instanceof AInvokerError\r\n}\r\n","import { AInvokerError } from \"./errors.js\"\r\nimport type { AInvokerErrorCode } from \"./errors.js\"\r\nimport type { DataEnvelope } from \"./types.js\"\r\n\r\nexport interface HttpClientOptions {\r\n  apiKey: string\r\n  baseUrl: string\r\n}\r\n\r\nfunction isRecord(value: unknown): value is Record<string, unknown> {\r\n  return value !== null && typeof value === \"object\"\r\n}\r\n\r\nfunction parseErrorPayload(json: unknown): { code: AInvokerErrorCode; message: string } | null {\r\n  if (!isRecord(json) || !isRecord(json.error)) {\r\n    return null\r\n  }\r\n  const { code, message } = json.error\r\n  if (typeof code !== \"string\" || typeof message !== \"string\") {\r\n    return null\r\n  }\r\n  return { code, message }\r\n}\r\n\r\nfunction hasDataEnvelope(json: unknown): json is DataEnvelope<unknown> {\r\n  return isRecord(json) && \"data\" in json\r\n}\r\n\r\nexport class HttpClient {\r\n  private readonly apiKey: string\r\n  private readonly baseUrl: string\r\n\r\n  constructor(options: HttpClientOptions) {\r\n    this.apiKey = options.apiKey\r\n    this.baseUrl = options.baseUrl.replace(/\\/+$/, \"\")\r\n  }\r\n\r\n  /**\r\n   * POST JSON to a path under `baseUrl`. Unwraps `{ data: T }` on success.\r\n   */\r\n  async post<T>(path: string, body: unknown): Promise<T> {\r\n    const url = `${this.baseUrl}${path.startsWith(\"/\") ? path : `/${path}`}`\r\n\r\n    let response: Response\r\n    try {\r\n      response = await fetch(url, {\r\n        method: \"POST\",\r\n        headers: {\r\n          Authorization: `Bearer ${this.apiKey}`,\r\n          \"Content-Type\": \"application/json\",\r\n          Accept: \"application/json\",\r\n        },\r\n        body: JSON.stringify(body),\r\n      })\r\n    } catch (cause) {\r\n      const message = cause instanceof Error ? cause.message : \"Network request failed\"\r\n      throw new AInvokerError(0, \"NETWORK_ERROR\", message)\r\n    }\r\n\r\n    const text = await response.text()\r\n    let json: unknown = undefined\r\n    if (text.length > 0) {\r\n      try {\r\n        json = JSON.parse(text) as unknown\r\n      } catch {\r\n        throw new AInvokerError(\r\n          response.status,\r\n          \"INVALID_RESPONSE\",\r\n          \"Response body was not valid JSON\",\r\n          text,\r\n        )\r\n      }\r\n    }\r\n\r\n    if (!response.ok) {\r\n      const parsed = parseErrorPayload(json)\r\n      throw new AInvokerError(\r\n        response.status,\r\n        parsed?.code ?? \"HTTP_ERROR\",\r\n        parsed?.message ?? `Request failed with status ${response.status}`,\r\n        json,\r\n      )\r\n    }\r\n\r\n    if (!hasDataEnvelope(json)) {\r\n      throw new AInvokerError(\r\n        response.status,\r\n        \"INVALID_RESPONSE\",\r\n        \"Response missing data envelope\",\r\n        json,\r\n      )\r\n    }\r\n\r\n    return json.data as T\r\n  }\r\n}\r\n","import type { HttpClient } from \"../http.js\"\r\nimport type {\r\n  TextChatEscapeParams,\r\n  TextChatParams,\r\n  TextChatResult,\r\n} from \"../types.js\"\r\n\r\n/**\r\n * Text modality methods (`/v1/text/...`).\r\n */\r\nexport class TextResource {\r\n  constructor(private readonly http: HttpClient) {}\r\n\r\n  /**\r\n   * Text chat completion via the AInvoker gateway (`POST /v1/text/chat`).\r\n   *\r\n   * Pass `provider` and `model` for typed autocomplete. When `provider` is set,\r\n   * the SDK joins them into a `provider/model` slug. When `provider` is omitted,\r\n   * the bare `model` name is sent and the API resolves it.\r\n   */\r\n  chat(params: TextChatParams): Promise<TextChatResult>\r\n  chat<P extends string, M extends string>(\r\n    params: TextChatEscapeParams<P, M>,\r\n  ): Promise<TextChatResult>\r\n  chat(\r\n    params: TextChatParams | TextChatEscapeParams<string, string>,\r\n  ): Promise<TextChatResult> {\r\n    const { provider, model, ...rest } = params\r\n    const gatewayModel =\r\n      provider !== undefined && provider !== \"\"\r\n        ? `${provider}/${model}`\r\n        : model\r\n\r\n    return this.http.post<TextChatResult>(\"/v1/text/chat\", {\r\n      ...rest,\r\n      model: gatewayModel,\r\n    })\r\n  }\r\n}\r\n","import { HttpClient } from \"./http.js\"\r\nimport { TextResource } from \"./resources/text.js\"\r\nimport type { AInvokerOptions } from \"./types.js\"\r\n\r\nconst DEFAULT_BASE_URL = \"https://ainvoker-api.onrender.com\"\r\n\r\n/**\r\n * Official AInvoker SDK client.\r\n *\r\n * Use modality namespaces such as {@link AInvoker.text} for gateway calls.\r\n */\r\nexport class AInvoker {\r\n  /** Text modality (`/v1/text/...`). */\r\n  readonly text: TextResource\r\n\r\n  constructor(options: AInvokerOptions) {\r\n    if (!options.apiKey || options.apiKey.trim().length === 0) {\r\n      throw new Error(\"AInvoker: apiKey is required\")\r\n    }\r\n\r\n    const http = new HttpClient({\r\n      apiKey: options.apiKey,\r\n      baseUrl: options.baseUrl ?? DEFAULT_BASE_URL,\r\n    })\r\n\r\n    this.text = new TextResource(http)\r\n  }\r\n}\r\n"]}
+{"version":3,"sources":["../src/errors.ts","../src/http.ts","../src/resources/text.ts","../src/client.ts"],"names":["event"],"mappings":"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","file":"index.cjs","sourcesContent":["/**\r\n * Known AInvoker API / SDK error codes.\r\n * Unknown server codes remain assignable via the open string union.\r\n */\r\nexport type AInvokerErrorCode =\r\n  | \"UNAUTHORIZED\"\r\n  | \"FORBIDDEN\"\r\n  | \"NOT_FOUND\"\r\n  | \"VALIDATION_ERROR\"\r\n  | \"CONFLICT\"\r\n  | \"UPSTREAM_ERROR\"\r\n  | \"INTERNAL_ERROR\"\r\n  | \"NETWORK_ERROR\"\r\n  | \"INVALID_RESPONSE\"\r\n  | \"HTTP_ERROR\"\r\n  | (string & {})\r\n\r\n/**\r\n * Error thrown when the AInvoker API returns a non-success response\r\n * or the response body cannot be parsed as expected.\r\n */\r\nexport class AInvokerError extends Error {\r\n  readonly status: number\r\n  readonly code: AInvokerErrorCode\r\n  /** Parsed response body when available (error envelope or raw JSON). */\r\n  readonly body: unknown\r\n\r\n  constructor(\r\n    status: number,\r\n    code: AInvokerErrorCode,\r\n    message: string,\r\n    body: unknown = undefined,\r\n  ) {\r\n    super(message)\r\n    this.name = \"AInvokerError\"\r\n    this.status = status\r\n    this.code = code\r\n    this.body = body\r\n  }\r\n}\r\n\r\n/** Type guard for {@link AInvokerError}. */\r\nexport function isAInvokerError(error: unknown): error is AInvokerError {\r\n  return error instanceof AInvokerError\r\n}\r\n","import { AInvokerError } from \"./errors.js\"\r\nimport type { AInvokerErrorCode } from \"./errors.js\"\r\nimport type { DataEnvelope, TextStreamEvent } from \"./types.js\"\r\n\r\nexport interface HttpClientOptions {\r\n  apiKey: string\r\n  baseUrl: string\r\n}\r\n\r\nfunction isRecord(value: unknown): value is Record<string, unknown> {\r\n  return value !== null && typeof value === \"object\"\r\n}\r\n\r\nfunction parseErrorPayload(json: unknown): { code: AInvokerErrorCode; message: string } | null {\r\n  if (!isRecord(json) || !isRecord(json.error)) {\r\n    return null\r\n  }\r\n  const { code, message } = json.error\r\n  if (typeof code !== \"string\" || typeof message !== \"string\") {\r\n    return null\r\n  }\r\n  return { code, message }\r\n}\r\n\r\nfunction hasDataEnvelope(json: unknown): json is DataEnvelope<unknown> {\r\n  return isRecord(json) && \"data\" in json\r\n}\r\n\r\nfunction mapSseEvent(eventName: string, data: unknown): TextStreamEvent | null {\r\n  if (!isRecord(data)) {\r\n    return null\r\n  }\r\n\r\n  if (eventName === \"meta\") {\r\n    if (typeof data.id === \"string\" && typeof data.model === \"string\") {\r\n      return { type: \"meta\", id: data.id, model: data.model }\r\n    }\r\n    return null\r\n  }\r\n\r\n  if (eventName === \"delta\") {\r\n    if (typeof data.content === \"string\") {\r\n      return { type: \"delta\", content: data.content }\r\n    }\r\n    return null\r\n  }\r\n\r\n  if (eventName === \"done\") {\r\n    if (\r\n      isRecord(data.message) &&\r\n      (data.message.role === \"system\" ||\r\n        data.message.role === \"user\" ||\r\n        data.message.role === \"assistant\") &&\r\n      typeof data.message.content === \"string\"\r\n    ) {\r\n      const usage =\r\n        data.usage === null\r\n          ? null\r\n          : isRecord(data.usage) &&\r\n              typeof data.usage.inputTokens === \"number\" &&\r\n              typeof data.usage.outputTokens === \"number\" &&\r\n              typeof data.usage.totalTokens === \"number\"\r\n            ? {\r\n                inputTokens: data.usage.inputTokens,\r\n                outputTokens: data.usage.outputTokens,\r\n                totalTokens: data.usage.totalTokens,\r\n              }\r\n            : null\r\n      return {\r\n        type: \"done\",\r\n        message: {\r\n          role: data.message.role,\r\n          content: data.message.content,\r\n        },\r\n        usage,\r\n      }\r\n    }\r\n    return null\r\n  }\r\n\r\n  if (eventName === \"error\") {\r\n    if (typeof data.code === \"string\" && typeof data.message === \"string\") {\r\n      return { type: \"error\", code: data.code, message: data.message }\r\n    }\r\n    return null\r\n  }\r\n\r\n  return null\r\n}\r\n\r\n/**\r\n * Parse SSE from a fetch body. Yields typed gateway stream events.\r\n * After an `error` event is yielded, throws AInvokerError.\r\n */\r\nasync function* parseTextStreamBody(\r\n  body: ReadableStream<Uint8Array>,\r\n  responseStatus: number,\r\n): AsyncGenerator<TextStreamEvent> {\r\n  const reader = body.getReader()\r\n  const decoder = new TextDecoder()\r\n  let buffer = \"\"\r\n  let eventName = \"message\"\r\n  const dataLines: string[] = []\r\n\r\n  const flush = (): TextStreamEvent | null => {\r\n    if (dataLines.length === 0) {\r\n      eventName = \"message\"\r\n      return null\r\n    }\r\n    const raw = dataLines.join(\"\\n\")\r\n    dataLines.length = 0\r\n    const name = eventName\r\n    eventName = \"message\"\r\n\r\n    let json: unknown\r\n    try {\r\n      json = JSON.parse(raw) as unknown\r\n    } catch {\r\n      throw new AInvokerError(\r\n        responseStatus,\r\n        \"INVALID_RESPONSE\",\r\n        \"Stream event data was not valid JSON\",\r\n        raw,\r\n      )\r\n    }\r\n\r\n    const mapped = mapSseEvent(name, json)\r\n    if (!mapped) {\r\n      throw new AInvokerError(\r\n        responseStatus,\r\n        \"INVALID_RESPONSE\",\r\n        `Unrecognized stream event \"${name}\"`,\r\n        json,\r\n      )\r\n    }\r\n    return mapped\r\n  }\r\n\r\n  try {\r\n    while (true) {\r\n      const { done, value } = await reader.read()\r\n      if (done) {\r\n        break\r\n      }\r\n\r\n      buffer += decoder.decode(value, { stream: true })\r\n\r\n      while (true) {\r\n        const newlineIndex = buffer.indexOf(\"\\n\")\r\n        if (newlineIndex < 0) {\r\n          break\r\n        }\r\n\r\n        let line = buffer.slice(0, newlineIndex)\r\n        buffer = buffer.slice(newlineIndex + 1)\r\n        if (line.endsWith(\"\\r\")) {\r\n          line = line.slice(0, -1)\r\n        }\r\n\r\n        if (line === \"\") {\r\n          const event = flush()\r\n          if (event) {\r\n            yield event\r\n            if (event.type === \"error\") {\r\n              throw new AInvokerError(responseStatus, event.code, event.message, event)\r\n            }\r\n          }\r\n          continue\r\n        }\r\n\r\n        if (line.startsWith(\":\")) {\r\n          continue\r\n        }\r\n\r\n        if (line.startsWith(\"event:\")) {\r\n          eventName = line.slice(6).replace(/^ /, \"\")\r\n          continue\r\n        }\r\n\r\n        if (line.startsWith(\"data:\")) {\r\n          dataLines.push(line.slice(5).replace(/^ /, \"\"))\r\n        }\r\n      }\r\n    }\r\n\r\n    buffer += decoder.decode()\r\n    if (buffer.length > 0) {\r\n      const trailing = buffer.replace(/\\r$/, \"\")\r\n      if (trailing.startsWith(\"event:\")) {\r\n        eventName = trailing.slice(6).replace(/^ /, \"\")\r\n      } else if (trailing.startsWith(\"data:\")) {\r\n        dataLines.push(trailing.slice(5).replace(/^ /, \"\"))\r\n      }\r\n    }\r\n\r\n    const event = flush()\r\n    if (event) {\r\n      yield event\r\n      if (event.type === \"error\") {\r\n        throw new AInvokerError(responseStatus, event.code, event.message, event)\r\n      }\r\n    }\r\n  } finally {\r\n    reader.releaseLock()\r\n  }\r\n}\r\n\r\nexport class HttpClient {\r\n  private readonly apiKey: string\r\n  private readonly baseUrl: string\r\n\r\n  constructor(options: HttpClientOptions) {\r\n    this.apiKey = options.apiKey\r\n    this.baseUrl = options.baseUrl.replace(/\\/+$/, \"\")\r\n  }\r\n\r\n  private urlFor(path: string): string {\r\n    return `${this.baseUrl}${path.startsWith(\"/\") ? path : `/${path}`}`\r\n  }\r\n\r\n  /**\r\n   * POST JSON to a path under `baseUrl`. Unwraps `{ data: T }` on success.\r\n   */\r\n  async post<T>(path: string, body: unknown): Promise<T> {\r\n    const url = this.urlFor(path)\r\n\r\n    let response: Response\r\n    try {\r\n      response = await fetch(url, {\r\n        method: \"POST\",\r\n        headers: {\r\n          Authorization: `Bearer ${this.apiKey}`,\r\n          \"Content-Type\": \"application/json\",\r\n          Accept: \"application/json\",\r\n        },\r\n        body: JSON.stringify(body),\r\n      })\r\n    } catch (cause) {\r\n      const message = cause instanceof Error ? cause.message : \"Network request failed\"\r\n      throw new AInvokerError(0, \"NETWORK_ERROR\", message)\r\n    }\r\n\r\n    const text = await response.text()\r\n    let json: unknown = undefined\r\n    if (text.length > 0) {\r\n      try {\r\n        json = JSON.parse(text) as unknown\r\n      } catch {\r\n        throw new AInvokerError(\r\n          response.status,\r\n          \"INVALID_RESPONSE\",\r\n          \"Response body was not valid JSON\",\r\n          text,\r\n        )\r\n      }\r\n    }\r\n\r\n    if (!response.ok) {\r\n      const parsed = parseErrorPayload(json)\r\n      throw new AInvokerError(\r\n        response.status,\r\n        parsed?.code ?? \"HTTP_ERROR\",\r\n        parsed?.message ?? `Request failed with status ${response.status}`,\r\n        json,\r\n      )\r\n    }\r\n\r\n    if (!hasDataEnvelope(json)) {\r\n      throw new AInvokerError(\r\n        response.status,\r\n        \"INVALID_RESPONSE\",\r\n        \"Response missing data envelope\",\r\n        json,\r\n      )\r\n    }\r\n\r\n    return json.data as T\r\n  }\r\n\r\n  /**\r\n   * POST JSON and consume an SSE body as typed {@link TextStreamEvent}s.\r\n   * Does not unwrap a `{ data }` envelope. Non-2xx before the stream throws like {@link post}.\r\n   */\r\n  async *postStream(path: string, body: unknown): AsyncGenerator<TextStreamEvent> {\r\n    const url = this.urlFor(path)\r\n\r\n    let response: Response\r\n    try {\r\n      response = await fetch(url, {\r\n        method: \"POST\",\r\n        headers: {\r\n          Authorization: `Bearer ${this.apiKey}`,\r\n          \"Content-Type\": \"application/json\",\r\n          Accept: \"text/event-stream\",\r\n        },\r\n        body: JSON.stringify(body),\r\n      })\r\n    } catch (cause) {\r\n      const message = cause instanceof Error ? cause.message : \"Network request failed\"\r\n      throw new AInvokerError(0, \"NETWORK_ERROR\", message)\r\n    }\r\n\r\n    if (!response.ok) {\r\n      const text = await response.text()\r\n      let json: unknown = undefined\r\n      if (text.length > 0) {\r\n        try {\r\n          json = JSON.parse(text) as unknown\r\n        } catch {\r\n          throw new AInvokerError(\r\n            response.status,\r\n            \"INVALID_RESPONSE\",\r\n            \"Response body was not valid JSON\",\r\n            text,\r\n          )\r\n        }\r\n      }\r\n      const parsed = parseErrorPayload(json)\r\n      throw new AInvokerError(\r\n        response.status,\r\n        parsed?.code ?? \"HTTP_ERROR\",\r\n        parsed?.message ?? `Request failed with status ${response.status}`,\r\n        json,\r\n      )\r\n    }\r\n\r\n    if (!response.body) {\r\n      throw new AInvokerError(\r\n        response.status,\r\n        \"INVALID_RESPONSE\",\r\n        \"Stream response missing body\",\r\n      )\r\n    }\r\n\r\n    yield* parseTextStreamBody(response.body, response.status)\r\n  }\r\n}\r\n","import type { HttpClient } from \"../http.js\"\r\nimport type {\r\n  TextChatEscapeParams,\r\n  TextChatParams,\r\n  TextChatResult,\r\n  TextStreamEvent,\r\n} from \"../types.js\"\r\n\r\nfunction toGatewayModel(params: {\r\n  provider?: string\r\n  model: string\r\n}): string {\r\n  const { provider, model } = params\r\n  return provider !== undefined && provider !== \"\" ? `${provider}/${model}` : model\r\n}\r\n\r\n/**\r\n * Text modality methods (`/v1/text/...`).\r\n */\r\nexport class TextResource {\r\n  constructor(private readonly http: HttpClient) {}\r\n\r\n  /**\r\n   * Text chat completion via the AInvoker gateway (`POST /v1/text/chat`).\r\n   *\r\n   * Pass `provider` and `model` for typed autocomplete. When `provider` is set,\r\n   * the SDK joins them into a `provider/model` slug. When `provider` is omitted,\r\n   * the bare `model` name is sent and the API resolves it.\r\n   */\r\n  chat(params: TextChatParams): Promise<TextChatResult>\r\n  chat<P extends string, M extends string>(\r\n    params: TextChatEscapeParams<P, M>,\r\n  ): Promise<TextChatResult>\r\n  chat(\r\n    params: TextChatParams | TextChatEscapeParams<string, string>,\r\n  ): Promise<TextChatResult> {\r\n    const { provider, model, ...rest } = params\r\n    return this.http.post<TextChatResult>(\"/v1/text/chat\", {\r\n      ...rest,\r\n      model: toGatewayModel({ provider, model }),\r\n    })\r\n  }\r\n\r\n  /**\r\n   * Stream a text completion (`POST /v1/text/stream`) as an async iterable of\r\n   * {@link TextStreamEvent}. Same params and provider/model joining as {@link chat}.\r\n   *\r\n   * Non-2xx before the stream starts throws {@link AInvokerError}. An `error`\r\n   * event is yielded, then the iterator throws {@link AInvokerError}.\r\n   */\r\n  stream(params: TextChatParams): AsyncGenerator<TextStreamEvent>\r\n  stream<P extends string, M extends string>(\r\n    params: TextChatEscapeParams<P, M>,\r\n  ): AsyncGenerator<TextStreamEvent>\r\n  stream(\r\n    params: TextChatParams | TextChatEscapeParams<string, string>,\r\n  ): AsyncGenerator<TextStreamEvent> {\r\n    const { provider, model, ...rest } = params\r\n    return this.http.postStream(\"/v1/text/stream\", {\r\n      ...rest,\r\n      model: toGatewayModel({ provider, model }),\r\n    })\r\n  }\r\n}\r\n","import { HttpClient } from \"./http.js\"\r\nimport { TextResource } from \"./resources/text.js\"\r\nimport type { AInvokerOptions } from \"./types.js\"\r\n\r\nconst DEFAULT_BASE_URL = \"https://ainvoker-api.onrender.com\"\r\n\r\n/**\r\n * Official AInvoker SDK client.\r\n *\r\n * Use modality namespaces such as {@link AInvoker.text} for gateway calls.\r\n */\r\nexport class AInvoker {\r\n  /** Text modality (`/v1/text/...`). */\r\n  readonly text: TextResource\r\n\r\n  constructor(options: AInvokerOptions) {\r\n    if (!options.apiKey || options.apiKey.trim().length === 0) {\r\n      throw new Error(\"AInvoker: apiKey is required\")\r\n    }\r\n\r\n    const http = new HttpClient({\r\n      apiKey: options.apiKey,\r\n      baseUrl: options.baseUrl ?? DEFAULT_BASE_URL,\r\n    })\r\n\r\n    this.text = new TextResource(http)\r\n  }\r\n}\r\n"]}

package/dist/index.d.cts

@@ -1,17 +1,3 @@
-interface HttpClientOptions {
-    apiKey: string;
-    baseUrl: string;
-}
-declare class HttpClient {
-    private readonly apiKey;
-    private readonly baseUrl;
-    constructor(options: HttpClientOptions);
-    /**
-     * POST JSON to a path under `baseUrl`. Unwraps `{ data: T }` on success.
-     */
-    post<T>(path: string, body: unknown): Promise<T>;
-}
-
 /**
  * Client configuration for {@link AInvoker}.
  */
@@ -51,6 +37,8 @@ type TextCatalogPair = {
         model: TextCatalog[P];
     };
 }[TextProvider];
+/** Thinking depth for models that support it. */
+type TextReasoning = "minimal" | "low" | "medium" | "high";
 type TextChatFields = {
     messages: ChatMessage[];
     /** Sampling temperature (0–2). */
@@ -60,6 +48,12 @@ type TextChatFields = {
      * When omitted, the gateway reserves and caps output at 8192.
      */
     maxTokens?: number;
+    /**
+     * Thinking depth for models that support it (Gemini). Lower is faster to the
+     * first token. Ignored by models without thinking (for example gpt-4o-mini).
+     * When omitted, the provider default applies.
+     */
+    reasoning?: TextReasoning;
 };
 /**
  * Provider omitted: model may be any catalog name (or a future API name).
@@ -108,6 +102,46 @@ interface TextChatResult {
     message: ChatMessage;
     usage: ChatUsage | null;
 }
+/**
+ * Events from {@link TextResource.stream} (`POST /v1/text/stream`).
+ * The SDK adds `type`; the wire SSE uses the event name instead.
+ */
+type TextStreamEvent = {
+    type: "meta";
+    id: string;
+    model: string;
+} | {
+    type: "delta";
+    content: string;
+} | {
+    type: "done";
+    message: ChatMessage;
+    usage: ChatUsage | null;
+} | {
+    type: "error";
+    code: string;
+    message: string;
+};
+
+interface HttpClientOptions {
+    apiKey: string;
+    baseUrl: string;
+}
+declare class HttpClient {
+    private readonly apiKey;
+    private readonly baseUrl;
+    constructor(options: HttpClientOptions);
+    private urlFor;
+    /**
+     * POST JSON to a path under `baseUrl`. Unwraps `{ data: T }` on success.
+     */
+    post<T>(path: string, body: unknown): Promise<T>;
+    /**
+     * POST JSON and consume an SSE body as typed {@link TextStreamEvent}s.
+     * Does not unwrap a `{ data }` envelope. Non-2xx before the stream throws like {@link post}.
+     */
+    postStream(path: string, body: unknown): AsyncGenerator<TextStreamEvent>;
+}
 
 /**
  * Text modality methods (`/v1/text/...`).
@@ -124,6 +158,15 @@ declare class TextResource {
      */
     chat(params: TextChatParams): Promise<TextChatResult>;
     chat<P extends string, M extends string>(params: TextChatEscapeParams<P, M>): Promise<TextChatResult>;
+    /**
+     * Stream a text completion (`POST /v1/text/stream`) as an async iterable of
+     * {@link TextStreamEvent}. Same params and provider/model joining as {@link chat}.
+     *
+     * Non-2xx before the stream starts throws {@link AInvokerError}. An `error`
+     * event is yielded, then the iterator throws {@link AInvokerError}.
+     */
+    stream(params: TextChatParams): AsyncGenerator<TextStreamEvent>;
+    stream<P extends string, M extends string>(params: TextChatEscapeParams<P, M>): AsyncGenerator<TextStreamEvent>;
 }
 
 /**
@@ -156,4 +199,4 @@ declare class AInvokerError extends Error {
 /** Type guard for {@link AInvokerError}. */
 declare function isAInvokerError(error: unknown): error is AInvokerError;
 
-export { AInvoker, AInvokerError, type AInvokerErrorCode, type AInvokerOptions, type ChatMessage, type ChatUsage, type TextCatalog, type TextCatalogPair, type TextChatEscapeParams, type TextChatParams, type TextChatResult, type TextModel, type TextProvider, isAInvokerError };
+export { AInvoker, AInvokerError, type AInvokerErrorCode, type AInvokerOptions, type ChatMessage, type ChatUsage, type TextCatalog, type TextCatalogPair, type TextChatEscapeParams, type TextChatParams, type TextChatResult, type TextModel, type TextProvider, type TextReasoning, type TextStreamEvent, isAInvokerError };

package/dist/index.d.ts

@@ -1,17 +1,3 @@
-interface HttpClientOptions {
-    apiKey: string;
-    baseUrl: string;
-}
-declare class HttpClient {
-    private readonly apiKey;
-    private readonly baseUrl;
-    constructor(options: HttpClientOptions);
-    /**
-     * POST JSON to a path under `baseUrl`. Unwraps `{ data: T }` on success.
-     */
-    post<T>(path: string, body: unknown): Promise<T>;
-}
-
 /**
  * Client configuration for {@link AInvoker}.
  */
@@ -51,6 +37,8 @@ type TextCatalogPair = {
         model: TextCatalog[P];
     };
 }[TextProvider];
+/** Thinking depth for models that support it. */
+type TextReasoning = "minimal" | "low" | "medium" | "high";
 type TextChatFields = {
     messages: ChatMessage[];
     /** Sampling temperature (0–2). */
@@ -60,6 +48,12 @@ type TextChatFields = {
      * When omitted, the gateway reserves and caps output at 8192.
      */
     maxTokens?: number;
+    /**
+     * Thinking depth for models that support it (Gemini). Lower is faster to the
+     * first token. Ignored by models without thinking (for example gpt-4o-mini).
+     * When omitted, the provider default applies.
+     */
+    reasoning?: TextReasoning;
 };
 /**
  * Provider omitted: model may be any catalog name (or a future API name).
@@ -108,6 +102,46 @@ interface TextChatResult {
     message: ChatMessage;
     usage: ChatUsage | null;
 }
+/**
+ * Events from {@link TextResource.stream} (`POST /v1/text/stream`).
+ * The SDK adds `type`; the wire SSE uses the event name instead.
+ */
+type TextStreamEvent = {
+    type: "meta";
+    id: string;
+    model: string;
+} | {
+    type: "delta";
+    content: string;
+} | {
+    type: "done";
+    message: ChatMessage;
+    usage: ChatUsage | null;
+} | {
+    type: "error";
+    code: string;
+    message: string;
+};
+
+interface HttpClientOptions {
+    apiKey: string;
+    baseUrl: string;
+}
+declare class HttpClient {
+    private readonly apiKey;
+    private readonly baseUrl;
+    constructor(options: HttpClientOptions);
+    private urlFor;
+    /**
+     * POST JSON to a path under `baseUrl`. Unwraps `{ data: T }` on success.
+     */
+    post<T>(path: string, body: unknown): Promise<T>;
+    /**
+     * POST JSON and consume an SSE body as typed {@link TextStreamEvent}s.
+     * Does not unwrap a `{ data }` envelope. Non-2xx before the stream throws like {@link post}.
+     */
+    postStream(path: string, body: unknown): AsyncGenerator<TextStreamEvent>;
+}
 
 /**
  * Text modality methods (`/v1/text/...`).
@@ -124,6 +158,15 @@ declare class TextResource {
      */
     chat(params: TextChatParams): Promise<TextChatResult>;
     chat<P extends string, M extends string>(params: TextChatEscapeParams<P, M>): Promise<TextChatResult>;
+    /**
+     * Stream a text completion (`POST /v1/text/stream`) as an async iterable of
+     * {@link TextStreamEvent}. Same params and provider/model joining as {@link chat}.
+     *
+     * Non-2xx before the stream starts throws {@link AInvokerError}. An `error`
+     * event is yielded, then the iterator throws {@link AInvokerError}.
+     */
+    stream(params: TextChatParams): AsyncGenerator<TextStreamEvent>;
+    stream<P extends string, M extends string>(params: TextChatEscapeParams<P, M>): AsyncGenerator<TextStreamEvent>;
 }
 
 /**
@@ -156,4 +199,4 @@ declare class AInvokerError extends Error {
 /** Type guard for {@link AInvokerError}. */
 declare function isAInvokerError(error: unknown): error is AInvokerError;
 
-export { AInvoker, AInvokerError, type AInvokerErrorCode, type AInvokerOptions, type ChatMessage, type ChatUsage, type TextCatalog, type TextCatalogPair, type TextChatEscapeParams, type TextChatParams, type TextChatResult, type TextModel, type TextProvider, isAInvokerError };
+export { AInvoker, AInvokerError, type AInvokerErrorCode, type AInvokerOptions, type ChatMessage, type ChatUsage, type TextCatalog, type TextCatalogPair, type TextChatEscapeParams, type TextChatParams, type TextChatResult, type TextModel, type TextProvider, type TextReasoning, type TextStreamEvent, isAInvokerError };

package/dist/index.js

@@ -33,6 +33,144 @@ function parseErrorPayload(json) {
 function hasDataEnvelope(json) {
   return isRecord(json) && "data" in json;
 }
+function mapSseEvent(eventName, data) {
+  if (!isRecord(data)) {
+    return null;
+  }
+  if (eventName === "meta") {
+    if (typeof data.id === "string" && typeof data.model === "string") {
+      return { type: "meta", id: data.id, model: data.model };
+    }
+    return null;
+  }
+  if (eventName === "delta") {
+    if (typeof data.content === "string") {
+      return { type: "delta", content: data.content };
+    }
+    return null;
+  }
+  if (eventName === "done") {
+    if (isRecord(data.message) && (data.message.role === "system" || data.message.role === "user" || data.message.role === "assistant") && typeof data.message.content === "string") {
+      const usage = data.usage === null ? null : isRecord(data.usage) && typeof data.usage.inputTokens === "number" && typeof data.usage.outputTokens === "number" && typeof data.usage.totalTokens === "number" ? {
+        inputTokens: data.usage.inputTokens,
+        outputTokens: data.usage.outputTokens,
+        totalTokens: data.usage.totalTokens
+      } : null;
+      return {
+        type: "done",
+        message: {
+          role: data.message.role,
+          content: data.message.content
+        },
+        usage
+      };
+    }
+    return null;
+  }
+  if (eventName === "error") {
+    if (typeof data.code === "string" && typeof data.message === "string") {
+      return { type: "error", code: data.code, message: data.message };
+    }
+    return null;
+  }
+  return null;
+}
+async function* parseTextStreamBody(body, responseStatus) {
+  const reader = body.getReader();
+  const decoder = new TextDecoder();
+  let buffer = "";
+  let eventName = "message";
+  const dataLines = [];
+  const flush = () => {
+    if (dataLines.length === 0) {
+      eventName = "message";
+      return null;
+    }
+    const raw = dataLines.join("\n");
+    dataLines.length = 0;
+    const name = eventName;
+    eventName = "message";
+    let json;
+    try {
+      json = JSON.parse(raw);
+    } catch {
+      throw new AInvokerError(
+        responseStatus,
+        "INVALID_RESPONSE",
+        "Stream event data was not valid JSON",
+        raw
+      );
+    }
+    const mapped = mapSseEvent(name, json);
+    if (!mapped) {
+      throw new AInvokerError(
+        responseStatus,
+        "INVALID_RESPONSE",
+        `Unrecognized stream event "${name}"`,
+        json
+      );
+    }
+    return mapped;
+  };
+  try {
+    while (true) {
+      const { done, value } = await reader.read();
+      if (done) {
+        break;
+      }
+      buffer += decoder.decode(value, { stream: true });
+      while (true) {
+        const newlineIndex = buffer.indexOf("\n");
+        if (newlineIndex < 0) {
+          break;
+        }
+        let line = buffer.slice(0, newlineIndex);
+        buffer = buffer.slice(newlineIndex + 1);
+        if (line.endsWith("\r")) {
+          line = line.slice(0, -1);
+        }
+        if (line === "") {
+          const event2 = flush();
+          if (event2) {
+            yield event2;
+            if (event2.type === "error") {
+              throw new AInvokerError(responseStatus, event2.code, event2.message, event2);
+            }
+          }
+          continue;
+        }
+        if (line.startsWith(":")) {
+          continue;
+        }
+        if (line.startsWith("event:")) {
+          eventName = line.slice(6).replace(/^ /, "");
+          continue;
+        }
+        if (line.startsWith("data:")) {
+          dataLines.push(line.slice(5).replace(/^ /, ""));
+        }
+      }
+    }
+    buffer += decoder.decode();
+    if (buffer.length > 0) {
+      const trailing = buffer.replace(/\r$/, "");
+      if (trailing.startsWith("event:")) {
+        eventName = trailing.slice(6).replace(/^ /, "");
+      } else if (trailing.startsWith("data:")) {
+        dataLines.push(trailing.slice(5).replace(/^ /, ""));
+      }
+    }
+    const event = flush();
+    if (event) {
+      yield event;
+      if (event.type === "error") {
+        throw new AInvokerError(responseStatus, event.code, event.message, event);
+      }
+    }
+  } finally {
+    reader.releaseLock();
+  }
+}
 var HttpClient = class {
   apiKey;
   baseUrl;
@@ -40,11 +178,14 @@ var HttpClient = class {
     this.apiKey = options.apiKey;
     this.baseUrl = options.baseUrl.replace(/\/+$/, "");
   }
+  urlFor(path) {
+    return `${this.baseUrl}${path.startsWith("/") ? path : `/${path}`}`;
+  }
   /**
    * POST JSON to a path under `baseUrl`. Unwraps `{ data: T }` on success.
    */
   async post(path, body) {
-    const url = `${this.baseUrl}${path.startsWith("/") ? path : `/${path}`}`;
+    const url = this.urlFor(path);
     let response;
     try {
       response = await fetch(url, {
@@ -93,9 +234,66 @@ var HttpClient = class {
     }
     return json.data;
   }
+  /**
+   * POST JSON and consume an SSE body as typed {@link TextStreamEvent}s.
+   * Does not unwrap a `{ data }` envelope. Non-2xx before the stream throws like {@link post}.
+   */
+  async *postStream(path, body) {
+    const url = this.urlFor(path);
+    let response;
+    try {
+      response = await fetch(url, {
+        method: "POST",
+        headers: {
+          Authorization: `Bearer ${this.apiKey}`,
+          "Content-Type": "application/json",
+          Accept: "text/event-stream"
+        },
+        body: JSON.stringify(body)
+      });
+    } catch (cause) {
+      const message = cause instanceof Error ? cause.message : "Network request failed";
+      throw new AInvokerError(0, "NETWORK_ERROR", message);
+    }
+    if (!response.ok) {
+      const text = await response.text();
+      let json = void 0;
+      if (text.length > 0) {
+        try {
+          json = JSON.parse(text);
+        } catch {
+          throw new AInvokerError(
+            response.status,
+            "INVALID_RESPONSE",
+            "Response body was not valid JSON",
+            text
+          );
+        }
+      }
+      const parsed = parseErrorPayload(json);
+      throw new AInvokerError(
+        response.status,
+        parsed?.code ?? "HTTP_ERROR",
+        parsed?.message ?? `Request failed with status ${response.status}`,
+        json
+      );
+    }
+    if (!response.body) {
+      throw new AInvokerError(
+        response.status,
+        "INVALID_RESPONSE",
+        "Stream response missing body"
+      );
+    }
+    yield* parseTextStreamBody(response.body, response.status);
+  }
 };
 
 // src/resources/text.ts
+function toGatewayModel(params) {
+  const { provider, model } = params;
+  return provider !== void 0 && provider !== "" ? `${provider}/${model}` : model;
+}
 var TextResource = class {
   constructor(http) {
     this.http = http;
@@ -103,10 +301,16 @@ var TextResource = class {
   http;
   chat(params) {
     const { provider, model, ...rest } = params;
-    const gatewayModel = provider !== void 0 && provider !== "" ? `${provider}/${model}` : model;
     return this.http.post("/v1/text/chat", {
       ...rest,
-      model: gatewayModel
+      model: toGatewayModel({ provider, model })
+    });
+  }
+  stream(params) {
+    const { provider, model, ...rest } = params;
+    return this.http.postStream("/v1/text/stream", {
+      ...rest,
+      model: toGatewayModel({ provider, model })
     });
   }
 };

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/errors.ts","../src/http.ts","../src/resources/text.ts","../src/client.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["/**\r\n * Known AInvoker API / SDK error codes.\r\n * Unknown server codes remain assignable via the open string union.\r\n */\r\nexport type AInvokerErrorCode =\r\n  | \"UNAUTHORIZED\"\r\n  | \"FORBIDDEN\"\r\n  | \"NOT_FOUND\"\r\n  | \"VALIDATION_ERROR\"\r\n  | \"CONFLICT\"\r\n  | \"UPSTREAM_ERROR\"\r\n  | \"INTERNAL_ERROR\"\r\n  | \"NETWORK_ERROR\"\r\n  | \"INVALID_RESPONSE\"\r\n  | \"HTTP_ERROR\"\r\n  | (string & {})\r\n\r\n/**\r\n * Error thrown when the AInvoker API returns a non-success response\r\n * or the response body cannot be parsed as expected.\r\n */\r\nexport class AInvokerError extends Error {\r\n  readonly status: number\r\n  readonly code: AInvokerErrorCode\r\n  /** Parsed response body when available (error envelope or raw JSON). */\r\n  readonly body: unknown\r\n\r\n  constructor(\r\n    status: number,\r\n    code: AInvokerErrorCode,\r\n    message: string,\r\n    body: unknown = undefined,\r\n  ) {\r\n    super(message)\r\n    this.name = \"AInvokerError\"\r\n    this.status = status\r\n    this.code = code\r\n    this.body = body\r\n  }\r\n}\r\n\r\n/** Type guard for {@link AInvokerError}. */\r\nexport function isAInvokerError(error: unknown): error is AInvokerError {\r\n  return error instanceof AInvokerError\r\n}\r\n","import { AInvokerError } from \"./errors.js\"\r\nimport type { AInvokerErrorCode } from \"./errors.js\"\r\nimport type { DataEnvelope } from \"./types.js\"\r\n\r\nexport interface HttpClientOptions {\r\n  apiKey: string\r\n  baseUrl: string\r\n}\r\n\r\nfunction isRecord(value: unknown): value is Record<string, unknown> {\r\n  return value !== null && typeof value === \"object\"\r\n}\r\n\r\nfunction parseErrorPayload(json: unknown): { code: AInvokerErrorCode; message: string } | null {\r\n  if (!isRecord(json) || !isRecord(json.error)) {\r\n    return null\r\n  }\r\n  const { code, message } = json.error\r\n  if (typeof code !== \"string\" || typeof message !== \"string\") {\r\n    return null\r\n  }\r\n  return { code, message }\r\n}\r\n\r\nfunction hasDataEnvelope(json: unknown): json is DataEnvelope<unknown> {\r\n  return isRecord(json) && \"data\" in json\r\n}\r\n\r\nexport class HttpClient {\r\n  private readonly apiKey: string\r\n  private readonly baseUrl: string\r\n\r\n  constructor(options: HttpClientOptions) {\r\n    this.apiKey = options.apiKey\r\n    this.baseUrl = options.baseUrl.replace(/\\/+$/, \"\")\r\n  }\r\n\r\n  /**\r\n   * POST JSON to a path under `baseUrl`. Unwraps `{ data: T }` on success.\r\n   */\r\n  async post<T>(path: string, body: unknown): Promise<T> {\r\n    const url = `${this.baseUrl}${path.startsWith(\"/\") ? path : `/${path}`}`\r\n\r\n    let response: Response\r\n    try {\r\n      response = await fetch(url, {\r\n        method: \"POST\",\r\n        headers: {\r\n          Authorization: `Bearer ${this.apiKey}`,\r\n          \"Content-Type\": \"application/json\",\r\n          Accept: \"application/json\",\r\n        },\r\n        body: JSON.stringify(body),\r\n      })\r\n    } catch (cause) {\r\n      const message = cause instanceof Error ? cause.message : \"Network request failed\"\r\n      throw new AInvokerError(0, \"NETWORK_ERROR\", message)\r\n    }\r\n\r\n    const text = await response.text()\r\n    let json: unknown = undefined\r\n    if (text.length > 0) {\r\n      try {\r\n        json = JSON.parse(text) as unknown\r\n      } catch {\r\n        throw new AInvokerError(\r\n          response.status,\r\n          \"INVALID_RESPONSE\",\r\n          \"Response body was not valid JSON\",\r\n          text,\r\n        )\r\n      }\r\n    }\r\n\r\n    if (!response.ok) {\r\n      const parsed = parseErrorPayload(json)\r\n      throw new AInvokerError(\r\n        response.status,\r\n        parsed?.code ?? \"HTTP_ERROR\",\r\n        parsed?.message ?? `Request failed with status ${response.status}`,\r\n        json,\r\n      )\r\n    }\r\n\r\n    if (!hasDataEnvelope(json)) {\r\n      throw new AInvokerError(\r\n        response.status,\r\n        \"INVALID_RESPONSE\",\r\n        \"Response missing data envelope\",\r\n        json,\r\n      )\r\n    }\r\n\r\n    return json.data as T\r\n  }\r\n}\r\n","import type { HttpClient } from \"../http.js\"\r\nimport type {\r\n  TextChatEscapeParams,\r\n  TextChatParams,\r\n  TextChatResult,\r\n} from \"../types.js\"\r\n\r\n/**\r\n * Text modality methods (`/v1/text/...`).\r\n */\r\nexport class TextResource {\r\n  constructor(private readonly http: HttpClient) {}\r\n\r\n  /**\r\n   * Text chat completion via the AInvoker gateway (`POST /v1/text/chat`).\r\n   *\r\n   * Pass `provider` and `model` for typed autocomplete. When `provider` is set,\r\n   * the SDK joins them into a `provider/model` slug. When `provider` is omitted,\r\n   * the bare `model` name is sent and the API resolves it.\r\n   */\r\n  chat(params: TextChatParams): Promise<TextChatResult>\r\n  chat<P extends string, M extends string>(\r\n    params: TextChatEscapeParams<P, M>,\r\n  ): Promise<TextChatResult>\r\n  chat(\r\n    params: TextChatParams | TextChatEscapeParams<string, string>,\r\n  ): Promise<TextChatResult> {\r\n    const { provider, model, ...rest } = params\r\n    const gatewayModel =\r\n      provider !== undefined && provider !== \"\"\r\n        ? `${provider}/${model}`\r\n        : model\r\n\r\n    return this.http.post<TextChatResult>(\"/v1/text/chat\", {\r\n      ...rest,\r\n      model: gatewayModel,\r\n    })\r\n  }\r\n}\r\n","import { HttpClient } from \"./http.js\"\r\nimport { TextResource } from \"./resources/text.js\"\r\nimport type { AInvokerOptions } from \"./types.js\"\r\n\r\nconst DEFAULT_BASE_URL = \"https://ainvoker-api.onrender.com\"\r\n\r\n/**\r\n * Official AInvoker SDK client.\r\n *\r\n * Use modality namespaces such as {@link AInvoker.text} for gateway calls.\r\n */\r\nexport class AInvoker {\r\n  /** Text modality (`/v1/text/...`). */\r\n  readonly text: TextResource\r\n\r\n  constructor(options: AInvokerOptions) {\r\n    if (!options.apiKey || options.apiKey.trim().length === 0) {\r\n      throw new Error(\"AInvoker: apiKey is required\")\r\n    }\r\n\r\n    const http = new HttpClient({\r\n      apiKey: options.apiKey,\r\n      baseUrl: options.baseUrl ?? DEFAULT_BASE_URL,\r\n    })\r\n\r\n    this.text = new TextResource(http)\r\n  }\r\n}\r\n"]}
+{"version":3,"sources":["../src/errors.ts","../src/http.ts","../src/resources/text.ts","../src/client.ts"],"names":["event"],"mappings":"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","file":"index.js","sourcesContent":["/**\r\n * Known AInvoker API / SDK error codes.\r\n * Unknown server codes remain assignable via the open string union.\r\n */\r\nexport type AInvokerErrorCode =\r\n  | \"UNAUTHORIZED\"\r\n  | \"FORBIDDEN\"\r\n  | \"NOT_FOUND\"\r\n  | \"VALIDATION_ERROR\"\r\n  | \"CONFLICT\"\r\n  | \"UPSTREAM_ERROR\"\r\n  | \"INTERNAL_ERROR\"\r\n  | \"NETWORK_ERROR\"\r\n  | \"INVALID_RESPONSE\"\r\n  | \"HTTP_ERROR\"\r\n  | (string & {})\r\n\r\n/**\r\n * Error thrown when the AInvoker API returns a non-success response\r\n * or the response body cannot be parsed as expected.\r\n */\r\nexport class AInvokerError extends Error {\r\n  readonly status: number\r\n  readonly code: AInvokerErrorCode\r\n  /** Parsed response body when available (error envelope or raw JSON). */\r\n  readonly body: unknown\r\n\r\n  constructor(\r\n    status: number,\r\n    code: AInvokerErrorCode,\r\n    message: string,\r\n    body: unknown = undefined,\r\n  ) {\r\n    super(message)\r\n    this.name = \"AInvokerError\"\r\n    this.status = status\r\n    this.code = code\r\n    this.body = body\r\n  }\r\n}\r\n\r\n/** Type guard for {@link AInvokerError}. */\r\nexport function isAInvokerError(error: unknown): error is AInvokerError {\r\n  return error instanceof AInvokerError\r\n}\r\n","import { AInvokerError } from \"./errors.js\"\r\nimport type { AInvokerErrorCode } from \"./errors.js\"\r\nimport type { DataEnvelope, TextStreamEvent } from \"./types.js\"\r\n\r\nexport interface HttpClientOptions {\r\n  apiKey: string\r\n  baseUrl: string\r\n}\r\n\r\nfunction isRecord(value: unknown): value is Record<string, unknown> {\r\n  return value !== null && typeof value === \"object\"\r\n}\r\n\r\nfunction parseErrorPayload(json: unknown): { code: AInvokerErrorCode; message: string } | null {\r\n  if (!isRecord(json) || !isRecord(json.error)) {\r\n    return null\r\n  }\r\n  const { code, message } = json.error\r\n  if (typeof code !== \"string\" || typeof message !== \"string\") {\r\n    return null\r\n  }\r\n  return { code, message }\r\n}\r\n\r\nfunction hasDataEnvelope(json: unknown): json is DataEnvelope<unknown> {\r\n  return isRecord(json) && \"data\" in json\r\n}\r\n\r\nfunction mapSseEvent(eventName: string, data: unknown): TextStreamEvent | null {\r\n  if (!isRecord(data)) {\r\n    return null\r\n  }\r\n\r\n  if (eventName === \"meta\") {\r\n    if (typeof data.id === \"string\" && typeof data.model === \"string\") {\r\n      return { type: \"meta\", id: data.id, model: data.model }\r\n    }\r\n    return null\r\n  }\r\n\r\n  if (eventName === \"delta\") {\r\n    if (typeof data.content === \"string\") {\r\n      return { type: \"delta\", content: data.content }\r\n    }\r\n    return null\r\n  }\r\n\r\n  if (eventName === \"done\") {\r\n    if (\r\n      isRecord(data.message) &&\r\n      (data.message.role === \"system\" ||\r\n        data.message.role === \"user\" ||\r\n        data.message.role === \"assistant\") &&\r\n      typeof data.message.content === \"string\"\r\n    ) {\r\n      const usage =\r\n        data.usage === null\r\n          ? null\r\n          : isRecord(data.usage) &&\r\n              typeof data.usage.inputTokens === \"number\" &&\r\n              typeof data.usage.outputTokens === \"number\" &&\r\n              typeof data.usage.totalTokens === \"number\"\r\n            ? {\r\n                inputTokens: data.usage.inputTokens,\r\n                outputTokens: data.usage.outputTokens,\r\n                totalTokens: data.usage.totalTokens,\r\n              }\r\n            : null\r\n      return {\r\n        type: \"done\",\r\n        message: {\r\n          role: data.message.role,\r\n          content: data.message.content,\r\n        },\r\n        usage,\r\n      }\r\n    }\r\n    return null\r\n  }\r\n\r\n  if (eventName === \"error\") {\r\n    if (typeof data.code === \"string\" && typeof data.message === \"string\") {\r\n      return { type: \"error\", code: data.code, message: data.message }\r\n    }\r\n    return null\r\n  }\r\n\r\n  return null\r\n}\r\n\r\n/**\r\n * Parse SSE from a fetch body. Yields typed gateway stream events.\r\n * After an `error` event is yielded, throws AInvokerError.\r\n */\r\nasync function* parseTextStreamBody(\r\n  body: ReadableStream<Uint8Array>,\r\n  responseStatus: number,\r\n): AsyncGenerator<TextStreamEvent> {\r\n  const reader = body.getReader()\r\n  const decoder = new TextDecoder()\r\n  let buffer = \"\"\r\n  let eventName = \"message\"\r\n  const dataLines: string[] = []\r\n\r\n  const flush = (): TextStreamEvent | null => {\r\n    if (dataLines.length === 0) {\r\n      eventName = \"message\"\r\n      return null\r\n    }\r\n    const raw = dataLines.join(\"\\n\")\r\n    dataLines.length = 0\r\n    const name = eventName\r\n    eventName = \"message\"\r\n\r\n    let json: unknown\r\n    try {\r\n      json = JSON.parse(raw) as unknown\r\n    } catch {\r\n      throw new AInvokerError(\r\n        responseStatus,\r\n        \"INVALID_RESPONSE\",\r\n        \"Stream event data was not valid JSON\",\r\n        raw,\r\n      )\r\n    }\r\n\r\n    const mapped = mapSseEvent(name, json)\r\n    if (!mapped) {\r\n      throw new AInvokerError(\r\n        responseStatus,\r\n        \"INVALID_RESPONSE\",\r\n        `Unrecognized stream event \"${name}\"`,\r\n        json,\r\n      )\r\n    }\r\n    return mapped\r\n  }\r\n\r\n  try {\r\n    while (true) {\r\n      const { done, value } = await reader.read()\r\n      if (done) {\r\n        break\r\n      }\r\n\r\n      buffer += decoder.decode(value, { stream: true })\r\n\r\n      while (true) {\r\n        const newlineIndex = buffer.indexOf(\"\\n\")\r\n        if (newlineIndex < 0) {\r\n          break\r\n        }\r\n\r\n        let line = buffer.slice(0, newlineIndex)\r\n        buffer = buffer.slice(newlineIndex + 1)\r\n        if (line.endsWith(\"\\r\")) {\r\n          line = line.slice(0, -1)\r\n        }\r\n\r\n        if (line === \"\") {\r\n          const event = flush()\r\n          if (event) {\r\n            yield event\r\n            if (event.type === \"error\") {\r\n              throw new AInvokerError(responseStatus, event.code, event.message, event)\r\n            }\r\n          }\r\n          continue\r\n        }\r\n\r\n        if (line.startsWith(\":\")) {\r\n          continue\r\n        }\r\n\r\n        if (line.startsWith(\"event:\")) {\r\n          eventName = line.slice(6).replace(/^ /, \"\")\r\n          continue\r\n        }\r\n\r\n        if (line.startsWith(\"data:\")) {\r\n          dataLines.push(line.slice(5).replace(/^ /, \"\"))\r\n        }\r\n      }\r\n    }\r\n\r\n    buffer += decoder.decode()\r\n    if (buffer.length > 0) {\r\n      const trailing = buffer.replace(/\\r$/, \"\")\r\n      if (trailing.startsWith(\"event:\")) {\r\n        eventName = trailing.slice(6).replace(/^ /, \"\")\r\n      } else if (trailing.startsWith(\"data:\")) {\r\n        dataLines.push(trailing.slice(5).replace(/^ /, \"\"))\r\n      }\r\n    }\r\n\r\n    const event = flush()\r\n    if (event) {\r\n      yield event\r\n      if (event.type === \"error\") {\r\n        throw new AInvokerError(responseStatus, event.code, event.message, event)\r\n      }\r\n    }\r\n  } finally {\r\n    reader.releaseLock()\r\n  }\r\n}\r\n\r\nexport class HttpClient {\r\n  private readonly apiKey: string\r\n  private readonly baseUrl: string\r\n\r\n  constructor(options: HttpClientOptions) {\r\n    this.apiKey = options.apiKey\r\n    this.baseUrl = options.baseUrl.replace(/\\/+$/, \"\")\r\n  }\r\n\r\n  private urlFor(path: string): string {\r\n    return `${this.baseUrl}${path.startsWith(\"/\") ? path : `/${path}`}`\r\n  }\r\n\r\n  /**\r\n   * POST JSON to a path under `baseUrl`. Unwraps `{ data: T }` on success.\r\n   */\r\n  async post<T>(path: string, body: unknown): Promise<T> {\r\n    const url = this.urlFor(path)\r\n\r\n    let response: Response\r\n    try {\r\n      response = await fetch(url, {\r\n        method: \"POST\",\r\n        headers: {\r\n          Authorization: `Bearer ${this.apiKey}`,\r\n          \"Content-Type\": \"application/json\",\r\n          Accept: \"application/json\",\r\n        },\r\n        body: JSON.stringify(body),\r\n      })\r\n    } catch (cause) {\r\n      const message = cause instanceof Error ? cause.message : \"Network request failed\"\r\n      throw new AInvokerError(0, \"NETWORK_ERROR\", message)\r\n    }\r\n\r\n    const text = await response.text()\r\n    let json: unknown = undefined\r\n    if (text.length > 0) {\r\n      try {\r\n        json = JSON.parse(text) as unknown\r\n      } catch {\r\n        throw new AInvokerError(\r\n          response.status,\r\n          \"INVALID_RESPONSE\",\r\n          \"Response body was not valid JSON\",\r\n          text,\r\n        )\r\n      }\r\n    }\r\n\r\n    if (!response.ok) {\r\n      const parsed = parseErrorPayload(json)\r\n      throw new AInvokerError(\r\n        response.status,\r\n        parsed?.code ?? \"HTTP_ERROR\",\r\n        parsed?.message ?? `Request failed with status ${response.status}`,\r\n        json,\r\n      )\r\n    }\r\n\r\n    if (!hasDataEnvelope(json)) {\r\n      throw new AInvokerError(\r\n        response.status,\r\n        \"INVALID_RESPONSE\",\r\n        \"Response missing data envelope\",\r\n        json,\r\n      )\r\n    }\r\n\r\n    return json.data as T\r\n  }\r\n\r\n  /**\r\n   * POST JSON and consume an SSE body as typed {@link TextStreamEvent}s.\r\n   * Does not unwrap a `{ data }` envelope. Non-2xx before the stream throws like {@link post}.\r\n   */\r\n  async *postStream(path: string, body: unknown): AsyncGenerator<TextStreamEvent> {\r\n    const url = this.urlFor(path)\r\n\r\n    let response: Response\r\n    try {\r\n      response = await fetch(url, {\r\n        method: \"POST\",\r\n        headers: {\r\n          Authorization: `Bearer ${this.apiKey}`,\r\n          \"Content-Type\": \"application/json\",\r\n          Accept: \"text/event-stream\",\r\n        },\r\n        body: JSON.stringify(body),\r\n      })\r\n    } catch (cause) {\r\n      const message = cause instanceof Error ? cause.message : \"Network request failed\"\r\n      throw new AInvokerError(0, \"NETWORK_ERROR\", message)\r\n    }\r\n\r\n    if (!response.ok) {\r\n      const text = await response.text()\r\n      let json: unknown = undefined\r\n      if (text.length > 0) {\r\n        try {\r\n          json = JSON.parse(text) as unknown\r\n        } catch {\r\n          throw new AInvokerError(\r\n            response.status,\r\n            \"INVALID_RESPONSE\",\r\n            \"Response body was not valid JSON\",\r\n            text,\r\n          )\r\n        }\r\n      }\r\n      const parsed = parseErrorPayload(json)\r\n      throw new AInvokerError(\r\n        response.status,\r\n        parsed?.code ?? \"HTTP_ERROR\",\r\n        parsed?.message ?? `Request failed with status ${response.status}`,\r\n        json,\r\n      )\r\n    }\r\n\r\n    if (!response.body) {\r\n      throw new AInvokerError(\r\n        response.status,\r\n        \"INVALID_RESPONSE\",\r\n        \"Stream response missing body\",\r\n      )\r\n    }\r\n\r\n    yield* parseTextStreamBody(response.body, response.status)\r\n  }\r\n}\r\n","import type { HttpClient } from \"../http.js\"\r\nimport type {\r\n  TextChatEscapeParams,\r\n  TextChatParams,\r\n  TextChatResult,\r\n  TextStreamEvent,\r\n} from \"../types.js\"\r\n\r\nfunction toGatewayModel(params: {\r\n  provider?: string\r\n  model: string\r\n}): string {\r\n  const { provider, model } = params\r\n  return provider !== undefined && provider !== \"\" ? `${provider}/${model}` : model\r\n}\r\n\r\n/**\r\n * Text modality methods (`/v1/text/...`).\r\n */\r\nexport class TextResource {\r\n  constructor(private readonly http: HttpClient) {}\r\n\r\n  /**\r\n   * Text chat completion via the AInvoker gateway (`POST /v1/text/chat`).\r\n   *\r\n   * Pass `provider` and `model` for typed autocomplete. When `provider` is set,\r\n   * the SDK joins them into a `provider/model` slug. When `provider` is omitted,\r\n   * the bare `model` name is sent and the API resolves it.\r\n   */\r\n  chat(params: TextChatParams): Promise<TextChatResult>\r\n  chat<P extends string, M extends string>(\r\n    params: TextChatEscapeParams<P, M>,\r\n  ): Promise<TextChatResult>\r\n  chat(\r\n    params: TextChatParams | TextChatEscapeParams<string, string>,\r\n  ): Promise<TextChatResult> {\r\n    const { provider, model, ...rest } = params\r\n    return this.http.post<TextChatResult>(\"/v1/text/chat\", {\r\n      ...rest,\r\n      model: toGatewayModel({ provider, model }),\r\n    })\r\n  }\r\n\r\n  /**\r\n   * Stream a text completion (`POST /v1/text/stream`) as an async iterable of\r\n   * {@link TextStreamEvent}. Same params and provider/model joining as {@link chat}.\r\n   *\r\n   * Non-2xx before the stream starts throws {@link AInvokerError}. An `error`\r\n   * event is yielded, then the iterator throws {@link AInvokerError}.\r\n   */\r\n  stream(params: TextChatParams): AsyncGenerator<TextStreamEvent>\r\n  stream<P extends string, M extends string>(\r\n    params: TextChatEscapeParams<P, M>,\r\n  ): AsyncGenerator<TextStreamEvent>\r\n  stream(\r\n    params: TextChatParams | TextChatEscapeParams<string, string>,\r\n  ): AsyncGenerator<TextStreamEvent> {\r\n    const { provider, model, ...rest } = params\r\n    return this.http.postStream(\"/v1/text/stream\", {\r\n      ...rest,\r\n      model: toGatewayModel({ provider, model }),\r\n    })\r\n  }\r\n}\r\n","import { HttpClient } from \"./http.js\"\r\nimport { TextResource } from \"./resources/text.js\"\r\nimport type { AInvokerOptions } from \"./types.js\"\r\n\r\nconst DEFAULT_BASE_URL = \"https://ainvoker-api.onrender.com\"\r\n\r\n/**\r\n * Official AInvoker SDK client.\r\n *\r\n * Use modality namespaces such as {@link AInvoker.text} for gateway calls.\r\n */\r\nexport class AInvoker {\r\n  /** Text modality (`/v1/text/...`). */\r\n  readonly text: TextResource\r\n\r\n  constructor(options: AInvokerOptions) {\r\n    if (!options.apiKey || options.apiKey.trim().length === 0) {\r\n      throw new Error(\"AInvoker: apiKey is required\")\r\n    }\r\n\r\n    const http = new HttpClient({\r\n      apiKey: options.apiKey,\r\n      baseUrl: options.baseUrl ?? DEFAULT_BASE_URL,\r\n    })\r\n\r\n    this.text = new TextResource(http)\r\n  }\r\n}\r\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ainvoker",
-  "version": "3.0.0",
+  "version": "3.2.0",
   "description": "Official TypeScript/JavaScript SDK for the AInvoker AI gateway",
   "license": "MIT",
   "author": "AInvoker",