@jazzmine-ui/sdk 0.1.0

package/README.md

@@ -0,0 +1,136 @@
+# @jazzmine-ui/sdk
+
+Framework-agnostic TypeScript client for Jazzmine agentic backends.
+
+## Install
+
+```bash
+npm install @jazzmine/client
+```
+
+## Quick Start
+
+### 1) Basic chat
+
+```ts
+import JazzmineClient from "@jazzmine/client";
+
+const client = new JazzmineClient("https://your-jazzmine-api.example.com", {
+  apiKey: "your-api-key",
+});
+
+const reply = await client.chat({ message: "Summarize this dataset." });
+console.log(reply.response);
+```
+
+### 2) Streaming chat
+
+```ts
+import JazzmineClient from "@jazzmine/client";
+
+const client = new JazzmineClient("https://your-jazzmine-api.example.com");
+
+const final = await client.chatStream(
+  { message: "Plan a 5-day trip to Tokyo." },
+  {
+    onIntermediate: (event) => {
+      console.log("intermediate", event);
+    },
+    onDone: (response) => {
+      console.log("done", response.response);
+    },
+    onErrorEvent: (event) => {
+      console.error("stream error event", event);
+    },
+  },
+);
+
+console.log(final.conversation_id);
+```
+
+### 3) Convenience sendMessage flow
+
+```ts
+import JazzmineClient from "@jazzmine/client";
+
+const client = new JazzmineClient("https://your-jazzmine-api.example.com", {
+  defaultUserId: "alice",
+});
+
+const { response, conversationId } = await client.sendMessage("Start a new thread", {
+  autoCreateConversation: true,
+  conversationTitle: "Project planning",
+});
+
+console.log(conversationId, response.response);
+```
+
+## Constructor
+
+```ts
+new JazzmineClient(baseEndpoint: string, options?: JazzmineClientOptions)
+```
+
+### Constructor options
+
+| Option | Type | Default | Description |
+| --- | --- | --- | --- |
+| `apiKey` | `string` | `undefined` | Bearer token added as `Authorization: Bearer <apiKey>`. |
+| `timeoutMs` | `number` | `20000` | Request timeout in milliseconds. |
+| `retries` | `number` | `2` | Default retry attempts for retryable requests. |
+| `retryBackoffMs` | `number` | `350` | Linear backoff base in milliseconds. |
+| `autoDiscoverEndpoints` | `boolean` | `true` | Auto-load endpoint routes from `/info` when available. |
+| `defaultUserId` | `string` | `"user"` | Fallback `user_id` for requests. |
+| `fetchImpl` | `typeof fetch` | runtime `fetch` | Custom fetch implementation for non-browser runtimes. |
+
+## Public API
+
+```ts
+getHealth(requestOptions?: RequestOptions): Promise<HealthResponse>
+getInfo(requestOptions?: RequestOptions): Promise<InfoResponse>
+createConversation(payload?: ConversationCreateRequest, requestOptions?: RequestOptions): Promise<ConversationCreateResponse>
+deleteConversation(conversationId: string, requestOptions?: RequestOptions): Promise<ConversationDeleteResponse>
+chat(payload: ChatRequestPayload, requestOptions?: RequestOptions): Promise<ChatResponse>
+chatStream(payload: ChatRequestPayload, handlers?: StreamHandlers, requestOptions?: RequestOptions): Promise<ChatResponse>
+sendMessage(message: string, options?: {
+  conversationId?: string;
+  userId?: string;
+  explicitContext?: string[];
+  metadata?: Record<string, unknown>;
+  autoCreateConversation?: boolean;
+  conversationTitle?: string;
+  requestOptions?: RequestOptions;
+}): Promise<{ response: ChatResponse; conversationId: string }>
+resolveServerEndpoints(requestOptions?: RequestOptions): Promise<{
+  chat: string;
+  stream: string;
+  conversations: string;
+  health: string;
+  info: string;
+}>
+```
+
+## Error Handling
+
+Errors thrown by the client are instances of `JazzmineClientError`.
+
+```ts
+class JazzmineClientError extends Error {
+  status?: number;
+  code?: string;
+  details?: unknown;
+}
+```
+
+- `status`: HTTP status code when available.
+- `code`: Optional semantic code (for example stream error event codes).
+- `details`: Parsed response payload or low-level details when available.
+
+## Framework Compatibility
+
+`@jazzmine/client` is framework-agnostic and can be used from React, Vue, Svelte, Next.js, and vanilla JavaScript/TypeScript apps.
+
+## Node.js Note
+
+- Node.js 18+ includes `fetch` globally and works out of the box.
+- For Node.js versions below 18, provide a fetch implementation via `fetchImpl` (for example from `undici` or `cross-fetch`).

package/dist/client/JazzmineClient.d.ts

@@ -0,0 +1,41 @@
+import { JazzmineEndpoints } from '../discovery';
+import { ChatRequestPayload, ChatResponse, ConversationCreateRequest, ConversationCreateResponse, ConversationDeleteResponse, HealthResponse, InfoResponse, JazzmineClientOptions, RequestOptions, StreamHandlers } from '../types';
+export declare class JazzmineClient {
+    private readonly baseUrl;
+    private readonly apiKey?;
+    private readonly timeoutMs;
+    private readonly retries;
+    private readonly retryBackoffMs;
+    private readonly autoDiscoverEndpoints;
+    private readonly defaultUserId;
+    private readonly fetchFn;
+    private endpoints;
+    private endpointsResolved;
+    constructor(baseEndpoint: string, options?: JazzmineClientOptions);
+    getHealth(requestOptions?: RequestOptions): Promise<HealthResponse>;
+    getInfo(requestOptions?: RequestOptions): Promise<InfoResponse>;
+    createConversation(payload?: ConversationCreateRequest, requestOptions?: RequestOptions): Promise<ConversationCreateResponse>;
+    deleteConversation(conversationId: string, requestOptions?: RequestOptions): Promise<ConversationDeleteResponse>;
+    chat(payload: ChatRequestPayload, requestOptions?: RequestOptions): Promise<ChatResponse>;
+    chatStream(payload: ChatRequestPayload, handlers?: StreamHandlers, requestOptions?: RequestOptions): Promise<ChatResponse>;
+    sendMessage(message: string, options?: {
+        conversationId?: string;
+        userId?: string;
+        explicitContext?: string[];
+        metadata?: Record<string, unknown>;
+        autoCreateConversation?: boolean;
+        conversationTitle?: string;
+        requestOptions?: RequestOptions;
+    }): Promise<{
+        response: ChatResponse;
+        conversationId: string;
+    }>;
+    resolveServerEndpoints(requestOptions?: RequestOptions): Promise<JazzmineEndpoints>;
+    private ensureEndpoints;
+    private requestJson;
+    private expectChatResponse;
+    private toStreamError;
+    private errorMessage;
+}
+export default JazzmineClient;
+//# sourceMappingURL=JazzmineClient.d.ts.map

package/dist/client/JazzmineClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"JazzmineClient.d.ts","sourceRoot":"","sources":["../../src/client/JazzmineClient.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,iBAAiB,EACvB,MAAM,cAAc,CAAC;AAYtB,OAAO,KAAK,EACV,kBAAkB,EAClB,YAAY,EACZ,yBAAyB,EACzB,0BAA0B,EAC1B,0BAA0B,EAC1B,cAAc,EACd,YAAY,EACZ,qBAAqB,EACrB,cAAc,EAEd,cAAc,EACf,MAAM,UAAU,CAAC;AAYlB,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,QAAQ,CAAC,qBAAqB,CAAU;IAChD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IACvC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAe;IAEvC,OAAO,CAAC,SAAS,CAAoB;IACrC,OAAO,CAAC,iBAAiB,CAAS;gBAEtB,YAAY,EAAE,MAAM,EAAE,OAAO,GAAE,qBAA0B;IA6B/D,SAAS,CAAC,cAAc,GAAE,cAAmB,GAAG,OAAO,CAAC,cAAc,CAAC;IAYvE,OAAO,CAAC,cAAc,GAAE,cAAmB,GAAG,OAAO,CAAC,YAAY,CAAC;IAYnE,kBAAkB,CACtB,OAAO,GAAE,yBAA8B,EACvC,cAAc,GAAE,cAAmB,GAClC,OAAO,CAAC,0BAA0B,CAAC;IAiBhC,kBAAkB,CACtB,cAAc,EAAE,MAAM,EACtB,cAAc,GAAE,cAAmB,GAClC,OAAO,CAAC,0BAA0B,CAAC;IAiBhC,IAAI,CACR,OAAO,EAAE,kBAAkB,EAC3B,cAAc,GAAE,cAAmB,GAClC,OAAO,CAAC,YAAY,CAAC;IAqBlB,UAAU,CACd,OAAO,EAAE,kBAAkB,EAC3B,QAAQ,GAAE,cAAmB,EAC7B,cAAc,GAAE,cAAmB,GAClC,OAAO,CAAC,YAAY,CAAC;IA0DlB,WAAW,CACf,OAAO,EAAE,MAAM,EACf,OAAO,GAAE;QACP,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;QAC3B,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACnC,sBAAsB,CAAC,EAAE,OAAO,CAAC;QACjC,iBAAiB,CAAC,EAAE,MAAM,CAAC;QAC3B,cAAc,CAAC,EAAE,cAAc,CAAC;KAC5B,GACL,OAAO,CAAC;QAAE,QAAQ,EAAE,YAAY,CAAC;QAAC,cAAc,EAAE,MAAM,CAAA;KAAE,CAAC;IA0BxD,sBAAsB,CAAC,cAAc,GAAE,cAAmB,GAAG,OAAO,CAAC,iBAAiB,CAAC;YAmB/E,eAAe;IAS7B,OAAO,CAAC,WAAW;IAYnB,OAAO,CAAC,kBAAkB;IAe1B,OAAO,CAAC,aAAa;IAYrB,OAAO,CAAC,YAAY;CAMrB;AAED,eAAe,cAAc,CAAC"}

package/dist/client/index.d.ts

@@ -0,0 +1,3 @@
+export { JazzmineClient } from './JazzmineClient';
+export { default } from './JazzmineClient';
+//# sourceMappingURL=index.d.ts.map

package/dist/client/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/discovery/endpoints.d.ts

@@ -0,0 +1,20 @@
+import { InfoResponse, RequestOptions } from '../types';
+export interface JazzmineEndpoints {
+    chat: string;
+    stream: string;
+    conversations: string;
+    health: string;
+    info: string;
+}
+interface EnsureEndpointsConfig {
+    endpointsResolved: boolean;
+    autoDiscoverEndpoints: boolean;
+    requestOptions: RequestOptions;
+    resolveServerEndpoints: (requestOptions: RequestOptions) => Promise<JazzmineEndpoints>;
+}
+export declare const DEFAULT_ENDPOINTS: JazzmineEndpoints;
+export declare function ensureEndpoints(config: EnsureEndpointsConfig): Promise<boolean>;
+export declare function extractEndpointsFromInfo(info: InfoResponse, baseUrl: string): Partial<JazzmineEndpoints>;
+export declare function parseEndpointPath(value: unknown, expectedMethod: string, baseUrl: string): string | null;
+export {};
+//# sourceMappingURL=endpoints.d.ts.map

package/dist/discovery/endpoints.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"endpoints.d.ts","sourceRoot":"","sources":["../../src/discovery/endpoints.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAE7D,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd;AAED,UAAU,qBAAqB;IAC7B,iBAAiB,EAAE,OAAO,CAAC;IAC3B,qBAAqB,EAAE,OAAO,CAAC;IAC/B,cAAc,EAAE,cAAc,CAAC;IAC/B,sBAAsB,EAAE,CAAC,cAAc,EAAE,cAAc,KAAK,OAAO,CAAC,iBAAiB,CAAC,CAAC;CACxF;AAED,eAAO,MAAM,iBAAiB,EAAE,iBAM/B,CAAC;AAEF,wBAAsB,eAAe,CAAC,MAAM,EAAE,qBAAqB,GAAG,OAAO,CAAC,OAAO,CAAC,CAWrF;AAED,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,YAAY,EAClB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,iBAAiB,CAAC,CAgC5B;AAED,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,OAAO,EACd,cAAc,EAAE,MAAM,EACtB,OAAO,EAAE,MAAM,GACd,MAAM,GAAG,IAAI,CAsBf"}

package/dist/discovery/index.d.ts

@@ -0,0 +1,2 @@
+export * from './endpoints';
+//# sourceMappingURL=index.d.ts.map

package/dist/discovery/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/discovery/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC"}

package/dist/errors/JazzmineClientError.d.ts

@@ -0,0 +1,11 @@
+export declare class JazzmineClientError extends Error {
+    status?: number;
+    code?: string;
+    details?: unknown;
+    constructor(message: string, extras?: {
+        status?: number;
+        code?: string;
+        details?: unknown;
+    });
+}
+//# sourceMappingURL=JazzmineClientError.d.ts.map

package/dist/errors/JazzmineClientError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"JazzmineClientError.d.ts","sourceRoot":"","sources":["../../src/errors/JazzmineClientError.ts"],"names":[],"mappings":"AAAA,qBAAa,mBAAoB,SAAQ,KAAK;IAC5C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,OAAO,CAAC;gBAEN,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE;CAO5F"}

package/dist/errors/index.d.ts

@@ -0,0 +1,2 @@
+export * from './JazzmineClientError';
+//# sourceMappingURL=index.d.ts.map

package/dist/errors/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/errors/index.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC"}

package/dist/http/abort.d.ts

@@ -0,0 +1,3 @@
+export declare function combineAbortSignals(a?: AbortSignal, b?: AbortSignal): AbortSignal | undefined;
+export declare function isAbortError(error: unknown): boolean;
+//# sourceMappingURL=abort.d.ts.map

package/dist/http/abort.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"abort.d.ts","sourceRoot":"","sources":["../../src/http/abort.ts"],"names":[],"mappings":"AAAA,wBAAgB,mBAAmB,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC,EAAE,WAAW,GAAG,WAAW,GAAG,SAAS,CA6B7F;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAEpD"}

package/dist/http/index.d.ts

@@ -0,0 +1,4 @@
+export * from './abort';
+export * from './request';
+export * from './retry';
+//# sourceMappingURL=index.d.ts.map

package/dist/http/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/http/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,WAAW,CAAC;AAC1B,cAAc,SAAS,CAAC"}

package/dist/http/request.d.ts

@@ -0,0 +1,24 @@
+import { JazzmineClientError } from '../errors';
+export interface RequestConfig {
+    method: string;
+    path: string;
+    body?: unknown;
+    timeoutMs: number;
+    retries: number;
+    signal?: AbortSignal;
+    allowRetry: boolean;
+}
+export interface RequestContext {
+    baseUrl: string;
+    apiKey?: string;
+    fetchFn: typeof fetch;
+    retryBackoffMs: number;
+}
+export declare function requestJson<T>(context: RequestContext, config: RequestConfig): Promise<T>;
+export declare function toHttpError(response: Response, path: string): Promise<JazzmineClientError>;
+export declare function buildHeaders(apiKey: string | undefined, options: {
+    accept?: string;
+    contentType?: string;
+}): HeadersInit;
+export declare function resolveUrl(baseUrl: string, path: string): string;
+//# sourceMappingURL=request.d.ts.map

package/dist/http/request.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"request.d.ts","sourceRoot":"","sources":["../../src/http/request.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAKhD,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,UAAU,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,OAAO,KAAK,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;CACxB;AAuBD,wBAAsB,WAAW,CAAC,CAAC,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,CAAC,CAAC,CAmF/F;AAED,wBAAsB,WAAW,CAAC,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAkBhG;AAED,wBAAgB,YAAY,CAC1B,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,OAAO,EAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,GACjD,WAAW,CAYb;AAED,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAEhE"}

package/dist/http/retry.d.ts

@@ -0,0 +1,10 @@
+export interface RetryLoopOptions<T> {
+    retries: number;
+    allowRetry: boolean;
+    retryBackoffMs: number;
+    runAttempt: (attempt: number) => Promise<T>;
+    shouldRetry: (error: unknown) => boolean;
+}
+export declare function delayWithBackoff(retryBackoffMs: number, attempt: number): Promise<void>;
+export declare function runWithRetry<T>(options: RetryLoopOptions<T>): Promise<T>;
+//# sourceMappingURL=retry.d.ts.map

package/dist/http/retry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.d.ts","sourceRoot":"","sources":["../../src/http/retry.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,gBAAgB,CAAC,CAAC;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,OAAO,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC;IAC5C,WAAW,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC;CAC1C;AAED,wBAAsB,gBAAgB,CAAC,cAAc,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAM7F;AAED,wBAAsB,YAAY,CAAC,CAAC,EAAE,OAAO,EAAE,gBAAgB,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAmB9E"}

package/dist/index.cjs

@@ -0,0 +1,2 @@
+"use strict";Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:"Module"}});const x={chat:"/chat",stream:"/chat/stream",conversations:"/conversations",health:"/health",info:"/info"};async function I(r){if(r.endpointsResolved||!r.autoDiscoverEndpoints)return r.endpointsResolved;try{return await r.resolveServerEndpoints(r.requestOptions),!0}catch{return!0}}function A(r,t){const e={},n=r==null?void 0:r.endpoints;if(!n||typeof n!="object")return e;const s=m(n.chat,"POST",t),i=m(n.stream,"POST",t),a=m(n.conversations_create,"POST",t),h=m(n.health,"GET",t),d=m(n.info,"GET",t);return s&&(e.chat=s),i?e.stream=i:s&&(e.stream=`${s.replace(/\/+$/,"")}/stream`),a&&(e.conversations=a),h&&(e.health=h),d&&(e.info=d),e}function m(r,t,e){if(typeof r!="string")return null;const n=r.match(/^([A-Z]+)\s+(.+)$/i);if(!n)return null;const s=n[1].toUpperCase(),i=n[2].trim();if(s!==t.toUpperCase())return null;try{const a=new URL(i,e);return`${a.pathname}${a.search}`}catch{return null}}class o extends Error{constructor(t,e){super(t),this.name="JazzmineClientError",this.status=e==null?void 0:e.status,this.code=e==null?void 0:e.code,this.details=e==null?void 0:e.details}}function b(r,t){if(!r&&!t)return;if(!r)return t;if(!t)return r;const e=AbortSignal.any;if(typeof e=="function")return e([r,t]);const n=new AbortController,s=()=>{n.abort()};return r.aborted||t.aborted?(n.abort(),n.signal):(r.addEventListener("abort",s,{once:!0}),t.addEventListener("abort",s,{once:!0}),n.signal)}function M(r){return r instanceof DOMException&&(r.name==="AbortError"||r.name==="TimeoutError")}function U(r){const t=r.trim().replace(/\/+$/,"");let e;try{e=new URL(t)}catch{throw new o("Invalid baseEndpoint. Provide a full URL like https://api.example.com or http://127.0.0.1:8010.")}if(!e.protocol.startsWith("http"))throw new o("baseEndpoint must use http or https.");return`${e.protocol}//${e.host}${e.pathname.replace(/\/+$/,"")}`}function k(r,t){const e=t.startsWith("/")?t:`/${t}`;return`${r}${e}`}function E(r){const t=r==null?void 0:r.message;if(typeof t!="string"||!t.trim())throw new o("chat payload requires a non-empty message string.");if(r.explicit_context&&!Array.isArray(r.explicit_context))throw new o("explicit_context must be an array of strings.");if(Array.isArray(r.explicit_context)&&r.explicit_context.some(n=>typeof n!="string"))throw new o("explicit_context must contain only strings.");if(r.metadata!==void 0&&(r.metadata===null||typeof r.metadata!="object"))throw new o("metadata must be an object when provided.")}function J(r,t,e){if(r===void 0)return t;if(!Number.isFinite(r)||r<=0)throw new o(`${e} must be a positive number.`);return Math.round(r)}function g(r,t,e,n,s){if(r===void 0)return t;if(!Number.isInteger(r)||r<n||r>s)throw new o(`${e} must be an integer between ${n} and ${s}.`);return r}async function N(r,t){const e=r*(t+1);e<=0||await new Promise(n=>setTimeout(n,e))}async function P(r){let t;for(let e=0;e<=r.retries;e+=1)try{return await r.runAttempt(e)}catch(n){if(t=n,r.allowRetry&&e<r.retries&&r.shouldRetry(n)){await N(r.retryBackoffMs,e);continue}throw n}throw t}class w extends Error{constructor(t){const e=`Request timed out after ${t} ms.`;super(e),this.name="RetryableTimeoutError",this.finalError=new o(e)}}class p extends Error{constructor(t){super(t),this.name="RetryableNetworkError",this.finalError=new o(t)}}async function z(r,t){try{return await P({retries:t.retries,allowRetry:t.allowRetry,retryBackoffMs:r.retryBackoffMs,runAttempt:async()=>{const e=new AbortController,n=setTimeout(()=>{e.abort()},t.timeoutMs),s=b(t.signal,e.signal);try{const i=await r.fetchFn(T(r.baseUrl,t.path),{method:t.method,headers:_(r.apiKey,{accept:"application/json",contentType:t.body!==void 0?"application/json":void 0}),body:t.body!==void 0?JSON.stringify(t.body):void 0,signal:s});if(!i.ok)throw await R(i,t.path);const a=await i.text();if(!a.trim())return{};try{return JSON.parse(a)}catch{throw new o(`Expected JSON response from ${t.path}, but received invalid JSON.`)}}catch(i){throw M(i)?new w(t.timeoutMs):i instanceof o?i:i instanceof TypeError?new p(y(i,"Network request failed.")):new o(y(i,"Network request failed."))}finally{clearTimeout(n)}},shouldRetry:e=>{if(e instanceof w||e instanceof p)return!0;if(e instanceof o){const n=e.status??0;return n===429||n>=500}return!1}})}catch(e){throw e instanceof w||e instanceof p?e.finalError:e instanceof o?e:new o(y(e,"Network request failed."))}}async function R(r,t){const e=await r.text();let n;if(e.trim())try{n=JSON.parse(e)}catch{n=e}const s=D(n),i=`HTTP ${r.status} on ${t}${s?`: ${s}`:""}`;return new o(i,{status:r.status,details:n})}function _(r,t){const e={};return t.accept&&(e.Accept=t.accept),t.contentType&&(e["Content-Type"]=t.contentType),r&&(e.Authorization=`Bearer ${r}`),e}function T(r,t){return k(r,t)}function D(r){if(!r)return"";if(typeof r=="string")return r.slice(0,300);if(typeof r=="object"){const t=r,e=t.detail,n=t.error;if(typeof e=="string")return e.slice(0,300);if(typeof n=="string")return n.slice(0,300)}return""}function y(r,t){return r instanceof Error&&r.message?r.message:t}function j(r){const t=r.split(/\r?\n/).map(i=>i.trimEnd()).filter(i=>i.length>0&&!i.startsWith(":"));if(t.length===0)return null;let e="message";const n=[];for(const i of t){if(i.startsWith("event:")){e=i.slice(6).trim()||"message";continue}i.startsWith("data:")&&n.push(i.slice(5).trim())}const s=n.join(`
+`);if(!s)return{event:e,data:null};try{return{event:e,data:JSON.parse(s)}}catch{return{event:e,data:s}}}async function F(r){var a,h,d,c;const t=r.handlers??{},e=r.body.getReader(),n=new TextDecoder("utf-8");let s="",i=null;for(;;){const{done:l,value:C}=await e.read();if(l)break;s+=n.decode(C,{stream:!0});const v=s.split(/\n\n/);s=v.pop()??"";for(const $ of v){const u=j($);if(u){if((a=t.onRawEvent)==null||a.call(t,u.event,u.data),u.event==="intermediate"){(h=t.onIntermediate)==null||h.call(t,u.data);continue}if(u.event==="done"){i=r.expectChatResponse(u.data),(d=t.onDone)==null||d.call(t,i);continue}if(u.event==="error"){const f=r.toStreamError(u.data);throw(c=t.onErrorEvent)==null||c.call(t,f),new o(f.detail||f.error||"Stream error event received.",{code:f.error,details:f})}}}}if(!i)throw new o("Stream ended without a final done event containing ChatResponse.");return i}const B=2e4,L=2,W=350;class S{constructor(t,e={}){if(this.endpointsResolved=!1,!t||!t.trim())throw new o("baseEndpoint is required.");if(typeof fetch!="function"&&!e.fetchImpl)throw new o("fetch is not available in this runtime. Provide options.fetchImpl.");this.baseUrl=U(t),this.apiKey=e.apiKey,this.timeoutMs=J(e.timeoutMs,B,"timeoutMs"),this.retries=g(e.retries,L,"retries",0,10),this.retryBackoffMs=g(e.retryBackoffMs,W,"retryBackoffMs",0,6e4),this.autoDiscoverEndpoints=e.autoDiscoverEndpoints!==!1,this.defaultUserId=(e.defaultUserId??"user").trim()||"user",this.fetchFn=e.fetchImpl??fetch,this.endpoints={...x}}async getHealth(t={}){return await this.ensureEndpoints(t),this.requestJson({method:"GET",path:this.endpoints.health,timeoutMs:t.timeoutMs??this.timeoutMs,retries:t.retries??this.retries,signal:t.signal,allowRetry:!0})}async getInfo(t={}){return await this.ensureEndpoints(t),this.requestJson({method:"GET",path:this.endpoints.info,timeoutMs:t.timeoutMs??this.timeoutMs,retries:t.retries??this.retries,signal:t.signal,allowRetry:!0})}async createConversation(t={},e={}){return await this.ensureEndpoints(e),this.requestJson({method:"POST",path:this.endpoints.conversations,body:{conversation_id:t.conversation_id??"",user_id:t.user_id??this.defaultUserId,title:t.title??"New conversation"},timeoutMs:e.timeoutMs??this.timeoutMs,retries:e.retries??0,signal:e.signal,allowRetry:!1})}async deleteConversation(t,e={}){const n=t==null?void 0:t.trim();if(!n)throw new o("conversationId is required.");return await this.ensureEndpoints(e),this.requestJson({method:"DELETE",path:`${this.endpoints.conversations}/${encodeURIComponent(n)}`,timeoutMs:e.timeoutMs??this.timeoutMs,retries:e.retries??this.retries,signal:e.signal,allowRetry:!0})}async chat(t,e={}){return E(t),await this.ensureEndpoints(e),this.requestJson({method:"POST",path:this.endpoints.chat,body:{message:t.message,conversation_id:t.conversation_id??"",user_id:t.user_id??this.defaultUserId,explicit_context:t.explicit_context,metadata:t.metadata??{}},timeoutMs:e.timeoutMs??this.timeoutMs,retries:e.retries??0,signal:e.signal,allowRetry:!1})}async chatStream(t,e={},n={}){E(t),await this.ensureEndpoints(n);const s=n.timeoutMs??this.timeoutMs,i=n.signal,a=new AbortController,h=setTimeout(()=>{a.abort()},s),d=b(i,a.signal);try{const c=await this.fetchFn(T(this.baseUrl,this.endpoints.stream),{method:"POST",headers:_(this.apiKey,{accept:"text/event-stream",contentType:"application/json"}),body:JSON.stringify({message:t.message,conversation_id:t.conversation_id??"",user_id:t.user_id??this.defaultUserId,explicit_context:t.explicit_context,metadata:t.metadata??{}}),signal:d});if(!c.ok)throw await R(c,this.endpoints.stream);if(!c.body)throw new o("Streaming response body is missing.");return await F({body:c.body,handlers:e,expectChatResponse:l=>this.expectChatResponse(l),toStreamError:l=>this.toStreamError(l)})}catch(c){throw M(c)?new o(`Streaming request timed out after ${s} ms.`):c instanceof o?c:new o(this.errorMessage(c,"Streaming request failed."))}finally{clearTimeout(h)}}async sendMessage(t,e={}){var a;const n={message:t,conversation_id:e.conversationId,user_id:e.userId,explicit_context:e.explicitContext,metadata:e.metadata};let s=(a=e.conversationId)==null?void 0:a.trim();!s&&e.autoCreateConversation&&(s=(await this.createConversation({user_id:e.userId??this.defaultUserId,title:e.conversationTitle??"New conversation"},e.requestOptions)).conversation_id,n.conversation_id=s);const i=await this.chat(n,e.requestOptions);return{response:i,conversationId:i.conversation_id||s||""}}async resolveServerEndpoints(t={}){const e=await this.requestJson({method:"GET",path:this.endpoints.info,timeoutMs:t.timeoutMs??this.timeoutMs,retries:t.retries??this.retries,signal:t.signal,allowRetry:!0}),n=A(e,this.baseUrl);return this.endpoints={...this.endpoints,...n},this.endpointsResolved=!0,{...this.endpoints}}async ensureEndpoints(t={}){this.endpointsResolved=await I({endpointsResolved:this.endpointsResolved,autoDiscoverEndpoints:this.autoDiscoverEndpoints,requestOptions:t,resolveServerEndpoints:e=>this.resolveServerEndpoints(e)})}requestJson(t){return z({baseUrl:this.baseUrl,apiKey:this.apiKey,fetchFn:this.fetchFn,retryBackoffMs:this.retryBackoffMs},t)}expectChatResponse(t){if(!t||typeof t!="object")throw new o("Invalid stream done payload: expected ChatResponse object.");const e=t;if(typeof e.response!="string"||typeof e.conversation_id!="string")throw new o("Invalid ChatResponse payload: missing required fields response/conversation_id.");return e}toStreamError(t){if(!t||typeof t!="object")return{error:"stream_error",detail:"Unknown stream error payload."};const e=t;return{error:typeof e.error=="string"?e.error:"stream_error",detail:typeof e.detail=="string"?e.detail:void 0}}errorMessage(t,e){return t instanceof Error&&t.message?t.message:e}}exports.JazzmineClient=S;exports.JazzmineClientError=o;exports.default=S;

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export { JazzmineClient } from './client';
+export { default } from './client';
+export { JazzmineClientError } from './errors';
+export * from './types';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAC1C,OAAO,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AACnC,OAAO,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAC/C,cAAc,SAAS,CAAC"}

package/dist/index.js

@@ -0,0 +1,486 @@
+const C = {
+  chat: "/chat",
+  stream: "/chat/stream",
+  conversations: "/conversations",
+  health: "/health",
+  info: "/info"
+};
+async function $(r) {
+  if (r.endpointsResolved || !r.autoDiscoverEndpoints)
+    return r.endpointsResolved;
+  try {
+    return await r.resolveServerEndpoints(r.requestOptions), !0;
+  } catch {
+    return !0;
+  }
+}
+function I(r, t) {
+  const e = {}, n = r == null ? void 0 : r.endpoints;
+  if (!n || typeof n != "object")
+    return e;
+  const i = m(n.chat, "POST", t), s = m(n.stream, "POST", t), a = m(n.conversations_create, "POST", t), h = m(n.health, "GET", t), d = m(n.info, "GET", t);
+  return i && (e.chat = i), s ? e.stream = s : i && (e.stream = `${i.replace(/\/+$/, "")}/stream`), a && (e.conversations = a), h && (e.health = h), d && (e.info = d), e;
+}
+function m(r, t, e) {
+  if (typeof r != "string")
+    return null;
+  const n = r.match(/^([A-Z]+)\s+(.+)$/i);
+  if (!n)
+    return null;
+  const i = n[1].toUpperCase(), s = n[2].trim();
+  if (i !== t.toUpperCase())
+    return null;
+  try {
+    const a = new URL(s, e);
+    return `${a.pathname}${a.search}`;
+  } catch {
+    return null;
+  }
+}
+class o extends Error {
+  constructor(t, e) {
+    super(t), this.name = "JazzmineClientError", this.status = e == null ? void 0 : e.status, this.code = e == null ? void 0 : e.code, this.details = e == null ? void 0 : e.details;
+  }
+}
+function b(r, t) {
+  if (!r && !t)
+    return;
+  if (!r)
+    return t;
+  if (!t)
+    return r;
+  const e = AbortSignal.any;
+  if (typeof e == "function")
+    return e([r, t]);
+  const n = new AbortController(), i = () => {
+    n.abort();
+  };
+  return r.aborted || t.aborted ? (n.abort(), n.signal) : (r.addEventListener("abort", i, { once: !0 }), t.addEventListener("abort", i, { once: !0 }), n.signal);
+}
+function R(r) {
+  return r instanceof DOMException && (r.name === "AbortError" || r.name === "TimeoutError");
+}
+function A(r) {
+  const t = r.trim().replace(/\/+$/, "");
+  let e;
+  try {
+    e = new URL(t);
+  } catch {
+    throw new o(
+      "Invalid baseEndpoint. Provide a full URL like https://api.example.com or http://127.0.0.1:8010."
+    );
+  }
+  if (!e.protocol.startsWith("http"))
+    throw new o("baseEndpoint must use http or https.");
+  return `${e.protocol}//${e.host}${e.pathname.replace(/\/+$/, "")}`;
+}
+function U(r, t) {
+  const e = t.startsWith("/") ? t : `/${t}`;
+  return `${r}${e}`;
+}
+function E(r) {
+  const t = r == null ? void 0 : r.message;
+  if (typeof t != "string" || !t.trim())
+    throw new o("chat payload requires a non-empty message string.");
+  if (r.explicit_context && !Array.isArray(r.explicit_context))
+    throw new o("explicit_context must be an array of strings.");
+  if (Array.isArray(r.explicit_context) && r.explicit_context.some((n) => typeof n != "string"))
+    throw new o("explicit_context must contain only strings.");
+  if (r.metadata !== void 0 && (r.metadata === null || typeof r.metadata != "object"))
+    throw new o("metadata must be an object when provided.");
+}
+function k(r, t, e) {
+  if (r === void 0)
+    return t;
+  if (!Number.isFinite(r) || r <= 0)
+    throw new o(`${e} must be a positive number.`);
+  return Math.round(r);
+}
+function g(r, t, e, n, i) {
+  if (r === void 0)
+    return t;
+  if (!Number.isInteger(r) || r < n || r > i)
+    throw new o(`${e} must be an integer between ${n} and ${i}.`);
+  return r;
+}
+async function J(r, t) {
+  const e = r * (t + 1);
+  e <= 0 || await new Promise((n) => setTimeout(n, e));
+}
+async function N(r) {
+  let t;
+  for (let e = 0; e <= r.retries; e += 1)
+    try {
+      return await r.runAttempt(e);
+    } catch (n) {
+      if (t = n, r.allowRetry && e < r.retries && r.shouldRetry(n)) {
+        await J(r.retryBackoffMs, e);
+        continue;
+      }
+      throw n;
+    }
+  throw t;
+}
+class w extends Error {
+  constructor(t) {
+    const e = `Request timed out after ${t} ms.`;
+    super(e), this.name = "RetryableTimeoutError", this.finalError = new o(e);
+  }
+}
+class p extends Error {
+  constructor(t) {
+    super(t), this.name = "RetryableNetworkError", this.finalError = new o(t);
+  }
+}
+async function D(r, t) {
+  try {
+    return await N({
+      retries: t.retries,
+      allowRetry: t.allowRetry,
+      retryBackoffMs: r.retryBackoffMs,
+      runAttempt: async () => {
+        const e = new AbortController(), n = setTimeout(() => {
+          e.abort();
+        }, t.timeoutMs), i = b(t.signal, e.signal);
+        try {
+          const s = await r.fetchFn(_(r.baseUrl, t.path), {
+            method: t.method,
+            headers: T(r.apiKey, {
+              accept: "application/json",
+              contentType: t.body !== void 0 ? "application/json" : void 0
+            }),
+            body: t.body !== void 0 ? JSON.stringify(t.body) : void 0,
+            signal: i
+          });
+          if (!s.ok)
+            throw await M(s, t.path);
+          const a = await s.text();
+          if (!a.trim())
+            return {};
+          try {
+            return JSON.parse(a);
+          } catch {
+            throw new o(
+              `Expected JSON response from ${t.path}, but received invalid JSON.`
+            );
+          }
+        } catch (s) {
+          throw R(s) ? new w(t.timeoutMs) : s instanceof o ? s : s instanceof TypeError ? new p(y(s, "Network request failed.")) : new o(y(s, "Network request failed."));
+        } finally {
+          clearTimeout(n);
+        }
+      },
+      shouldRetry: (e) => {
+        if (e instanceof w || e instanceof p)
+          return !0;
+        if (e instanceof o) {
+          const n = e.status ?? 0;
+          return n === 429 || n >= 500;
+        }
+        return !1;
+      }
+    });
+  } catch (e) {
+    throw e instanceof w || e instanceof p ? e.finalError : e instanceof o ? e : new o(y(e, "Network request failed."));
+  }
+}
+async function M(r, t) {
+  const e = await r.text();
+  let n;
+  if (e.trim())
+    try {
+      n = JSON.parse(e);
+    } catch {
+      n = e;
+    }
+  const i = P(n), s = `HTTP ${r.status} on ${t}${i ? `: ${i}` : ""}`;
+  return new o(s, {
+    status: r.status,
+    details: n
+  });
+}
+function T(r, t) {
+  const e = {};
+  return t.accept && (e.Accept = t.accept), t.contentType && (e["Content-Type"] = t.contentType), r && (e.Authorization = `Bearer ${r}`), e;
+}
+function _(r, t) {
+  return U(r, t);
+}
+function P(r) {
+  if (!r)
+    return "";
+  if (typeof r == "string")
+    return r.slice(0, 300);
+  if (typeof r == "object") {
+    const t = r, e = t.detail, n = t.error;
+    if (typeof e == "string")
+      return e.slice(0, 300);
+    if (typeof n == "string")
+      return n.slice(0, 300);
+  }
+  return "";
+}
+function y(r, t) {
+  return r instanceof Error && r.message ? r.message : t;
+}
+function j(r) {
+  const t = r.split(/\r?\n/).map((s) => s.trimEnd()).filter((s) => s.length > 0 && !s.startsWith(":"));
+  if (t.length === 0)
+    return null;
+  let e = "message";
+  const n = [];
+  for (const s of t) {
+    if (s.startsWith("event:")) {
+      e = s.slice(6).trim() || "message";
+      continue;
+    }
+    s.startsWith("data:") && n.push(s.slice(5).trim());
+  }
+  const i = n.join(`
+`);
+  if (!i)
+    return { event: e, data: null };
+  try {
+    return { event: e, data: JSON.parse(i) };
+  } catch {
+    return { event: e, data: i };
+  }
+}
+async function F(r) {
+  var a, h, d, c;
+  const t = r.handlers ?? {}, e = r.body.getReader(), n = new TextDecoder("utf-8");
+  let i = "", s = null;
+  for (; ; ) {
+    const { done: l, value: S } = await e.read();
+    if (l)
+      break;
+    i += n.decode(S, { stream: !0 });
+    const v = i.split(/\n\n/);
+    i = v.pop() ?? "";
+    for (const x of v) {
+      const u = j(x);
+      if (u) {
+        if ((a = t.onRawEvent) == null || a.call(t, u.event, u.data), u.event === "intermediate") {
+          (h = t.onIntermediate) == null || h.call(t, u.data);
+          continue;
+        }
+        if (u.event === "done") {
+          s = r.expectChatResponse(u.data), (d = t.onDone) == null || d.call(t, s);
+          continue;
+        }
+        if (u.event === "error") {
+          const f = r.toStreamError(u.data);
+          throw (c = t.onErrorEvent) == null || c.call(t, f), new o(f.detail || f.error || "Stream error event received.", {
+            code: f.error,
+            details: f
+          });
+        }
+      }
+    }
+  }
+  if (!s)
+    throw new o(
+      "Stream ended without a final done event containing ChatResponse."
+    );
+  return s;
+}
+const B = 2e4, z = 2, L = 350;
+class W {
+  constructor(t, e = {}) {
+    if (this.endpointsResolved = !1, !t || !t.trim())
+      throw new o("baseEndpoint is required.");
+    if (typeof fetch != "function" && !e.fetchImpl)
+      throw new o(
+        "fetch is not available in this runtime. Provide options.fetchImpl."
+      );
+    this.baseUrl = A(t), this.apiKey = e.apiKey, this.timeoutMs = k(e.timeoutMs, B, "timeoutMs"), this.retries = g(e.retries, z, "retries", 0, 10), this.retryBackoffMs = g(
+      e.retryBackoffMs,
+      L,
+      "retryBackoffMs",
+      0,
+      6e4
+    ), this.autoDiscoverEndpoints = e.autoDiscoverEndpoints !== !1, this.defaultUserId = (e.defaultUserId ?? "user").trim() || "user", this.fetchFn = e.fetchImpl ?? fetch, this.endpoints = { ...C };
+  }
+  async getHealth(t = {}) {
+    return await this.ensureEndpoints(t), this.requestJson({
+      method: "GET",
+      path: this.endpoints.health,
+      timeoutMs: t.timeoutMs ?? this.timeoutMs,
+      retries: t.retries ?? this.retries,
+      signal: t.signal,
+      allowRetry: !0
+    });
+  }
+  async getInfo(t = {}) {
+    return await this.ensureEndpoints(t), this.requestJson({
+      method: "GET",
+      path: this.endpoints.info,
+      timeoutMs: t.timeoutMs ?? this.timeoutMs,
+      retries: t.retries ?? this.retries,
+      signal: t.signal,
+      allowRetry: !0
+    });
+  }
+  async createConversation(t = {}, e = {}) {
+    return await this.ensureEndpoints(e), this.requestJson({
+      method: "POST",
+      path: this.endpoints.conversations,
+      body: {
+        conversation_id: t.conversation_id ?? "",
+        user_id: t.user_id ?? this.defaultUserId,
+        title: t.title ?? "New conversation"
+      },
+      timeoutMs: e.timeoutMs ?? this.timeoutMs,
+      retries: e.retries ?? 0,
+      signal: e.signal,
+      allowRetry: !1
+    });
+  }
+  async deleteConversation(t, e = {}) {
+    const n = t == null ? void 0 : t.trim();
+    if (!n)
+      throw new o("conversationId is required.");
+    return await this.ensureEndpoints(e), this.requestJson({
+      method: "DELETE",
+      path: `${this.endpoints.conversations}/${encodeURIComponent(n)}`,
+      timeoutMs: e.timeoutMs ?? this.timeoutMs,
+      retries: e.retries ?? this.retries,
+      signal: e.signal,
+      allowRetry: !0
+    });
+  }
+  async chat(t, e = {}) {
+    return E(t), await this.ensureEndpoints(e), this.requestJson({
+      method: "POST",
+      path: this.endpoints.chat,
+      body: {
+        message: t.message,
+        conversation_id: t.conversation_id ?? "",
+        user_id: t.user_id ?? this.defaultUserId,
+        explicit_context: t.explicit_context,
+        metadata: t.metadata ?? {}
+      },
+      timeoutMs: e.timeoutMs ?? this.timeoutMs,
+      retries: e.retries ?? 0,
+      signal: e.signal,
+      allowRetry: !1
+    });
+  }
+  async chatStream(t, e = {}, n = {}) {
+    E(t), await this.ensureEndpoints(n);
+    const i = n.timeoutMs ?? this.timeoutMs, s = n.signal, a = new AbortController(), h = setTimeout(() => {
+      a.abort();
+    }, i), d = b(s, a.signal);
+    try {
+      const c = await this.fetchFn(_(this.baseUrl, this.endpoints.stream), {
+        method: "POST",
+        headers: T(this.apiKey, {
+          accept: "text/event-stream",
+          contentType: "application/json"
+        }),
+        body: JSON.stringify({
+          message: t.message,
+          conversation_id: t.conversation_id ?? "",
+          user_id: t.user_id ?? this.defaultUserId,
+          explicit_context: t.explicit_context,
+          metadata: t.metadata ?? {}
+        }),
+        signal: d
+      });
+      if (!c.ok)
+        throw await M(c, this.endpoints.stream);
+      if (!c.body)
+        throw new o("Streaming response body is missing.");
+      return await F({
+        body: c.body,
+        handlers: e,
+        expectChatResponse: (l) => this.expectChatResponse(l),
+        toStreamError: (l) => this.toStreamError(l)
+      });
+    } catch (c) {
+      throw R(c) ? new o(`Streaming request timed out after ${i} ms.`) : c instanceof o ? c : new o(this.errorMessage(c, "Streaming request failed."));
+    } finally {
+      clearTimeout(h);
+    }
+  }
+  async sendMessage(t, e = {}) {
+    var a;
+    const n = {
+      message: t,
+      conversation_id: e.conversationId,
+      user_id: e.userId,
+      explicit_context: e.explicitContext,
+      metadata: e.metadata
+    };
+    let i = (a = e.conversationId) == null ? void 0 : a.trim();
+    !i && e.autoCreateConversation && (i = (await this.createConversation(
+      {
+        user_id: e.userId ?? this.defaultUserId,
+        title: e.conversationTitle ?? "New conversation"
+      },
+      e.requestOptions
+    )).conversation_id, n.conversation_id = i);
+    const s = await this.chat(n, e.requestOptions);
+    return { response: s, conversationId: s.conversation_id || i || "" };
+  }
+  async resolveServerEndpoints(t = {}) {
+    const e = await this.requestJson({
+      method: "GET",
+      path: this.endpoints.info,
+      timeoutMs: t.timeoutMs ?? this.timeoutMs,
+      retries: t.retries ?? this.retries,
+      signal: t.signal,
+      allowRetry: !0
+    }), n = I(e, this.baseUrl);
+    return this.endpoints = {
+      ...this.endpoints,
+      ...n
+    }, this.endpointsResolved = !0, { ...this.endpoints };
+  }
+  async ensureEndpoints(t = {}) {
+    this.endpointsResolved = await $({
+      endpointsResolved: this.endpointsResolved,
+      autoDiscoverEndpoints: this.autoDiscoverEndpoints,
+      requestOptions: t,
+      resolveServerEndpoints: (e) => this.resolveServerEndpoints(e)
+    });
+  }
+  requestJson(t) {
+    return D(
+      {
+        baseUrl: this.baseUrl,
+        apiKey: this.apiKey,
+        fetchFn: this.fetchFn,
+        retryBackoffMs: this.retryBackoffMs
+      },
+      t
+    );
+  }
+  expectChatResponse(t) {
+    if (!t || typeof t != "object")
+      throw new o("Invalid stream done payload: expected ChatResponse object.");
+    const e = t;
+    if (typeof e.response != "string" || typeof e.conversation_id != "string")
+      throw new o(
+        "Invalid ChatResponse payload: missing required fields response/conversation_id."
+      );
+    return e;
+  }
+  toStreamError(t) {
+    if (!t || typeof t != "object")
+      return { error: "stream_error", detail: "Unknown stream error payload." };
+    const e = t;
+    return {
+      error: typeof e.error == "string" ? e.error : "stream_error",
+      detail: typeof e.detail == "string" ? e.detail : void 0
+    };
+  }
+  errorMessage(t, e) {
+    return t instanceof Error && t.message ? t.message : e;
+  }
+}
+export {
+  W as JazzmineClient,
+  o as JazzmineClientError,
+  W as default
+};

package/dist/stream/index.d.ts

@@ -0,0 +1,2 @@
+export * from './parser';
+//# sourceMappingURL=index.d.ts.map

package/dist/stream/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/stream/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC"}

package/dist/stream/parser.d.ts

@@ -0,0 +1,15 @@
+import { ChatResponse, StreamErrorEvent, StreamHandlers } from '../types';
+interface ParsedSseEvent {
+    event: string;
+    data: unknown;
+}
+interface ConsumeStreamOptions {
+    body: ReadableStream<Uint8Array>;
+    handlers?: StreamHandlers;
+    expectChatResponse: (value: unknown) => ChatResponse;
+    toStreamError: (value: unknown) => StreamErrorEvent;
+}
+export declare function parseSseChunk(chunk: string): ParsedSseEvent | null;
+export declare function consumeStream(options: ConsumeStreamOptions): Promise<ChatResponse>;
+export {};
+//# sourceMappingURL=parser.d.ts.map

package/dist/stream/parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../../src/stream/parser.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,gBAAgB,EAAE,cAAc,EAA2B,MAAM,UAAU,CAAC;AAExG,UAAU,cAAc;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,OAAO,CAAC;CACf;AAED,UAAU,oBAAoB;IAC5B,IAAI,EAAE,cAAc,CAAC,UAAU,CAAC,CAAC;IACjC,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B,kBAAkB,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,YAAY,CAAC;IACrD,aAAa,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,gBAAgB,CAAC;CACrD;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI,CAiClE;AAED,wBAAsB,aAAa,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,YAAY,CAAC,CAsDxF"}

package/dist/types/chat.d.ts

@@ -0,0 +1,22 @@
+export interface ChatRequestPayload {
+    message: string;
+    conversation_id?: string;
+    user_id?: string;
+    explicit_context?: string[];
+    metadata?: Record<string, unknown>;
+}
+export interface ChatResponse {
+    response: string;
+    response_markdown: string;
+    message_id: string;
+    trace_id: string;
+    conversation_id: string;
+    user_id: string;
+    invoked_flows: string[];
+    invoked_tools: string[];
+    errors: string[];
+    turn_number: number;
+    is_blocked: boolean;
+    latency_ms: number;
+}
+//# sourceMappingURL=chat.d.ts.map

package/dist/types/chat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat.d.ts","sourceRoot":"","sources":["../../src/types/chat.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC5B,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe,EAAE,MAAM,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,OAAO,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;CACpB"}

package/dist/types/conversation.d.ts

@@ -0,0 +1,18 @@
+export interface ConversationCreateRequest {
+    conversation_id?: string;
+    user_id?: string;
+    title?: string;
+}
+export interface ConversationCreateResponse {
+    conversation_id: string;
+    user_id: string;
+    agent_id: string;
+    title: string;
+    created_at: number;
+    last_updated_at: number;
+}
+export interface ConversationDeleteResponse {
+    conversation_id: string;
+    deleted: boolean;
+}
+//# sourceMappingURL=conversation.d.ts.map

package/dist/types/conversation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversation.d.ts","sourceRoot":"","sources":["../../src/types/conversation.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,yBAAyB;IACxC,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,0BAA0B;IACzC,eAAe,EAAE,MAAM,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,0BAA0B;IACzC,eAAe,EAAE,MAAM,CAAC;IACxB,OAAO,EAAE,OAAO,CAAC;CAClB"}

package/dist/types/health.d.ts

@@ -0,0 +1,6 @@
+export interface HealthResponse {
+    status: string;
+    agent_name: string;
+    uptime_s: number;
+}
+//# sourceMappingURL=health.d.ts.map

package/dist/types/health.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"health.d.ts","sourceRoot":"","sources":["../../src/types/health.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;CAClB"}

package/dist/types/index.d.ts

@@ -0,0 +1,7 @@
+export * from './chat';
+export * from './conversation';
+export * from './health';
+export * from './info';
+export * from './options';
+export * from './stream';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,cAAc,QAAQ,CAAC;AACvB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,UAAU,CAAC;AACzB,cAAc,QAAQ,CAAC;AACvB,cAAc,WAAW,CAAC;AAC1B,cAAc,UAAU,CAAC"}

package/dist/types/info.d.ts

@@ -0,0 +1,11 @@
+export type InfoEndpointsMap = Record<string, string>;
+export interface InfoResponse {
+    agent_name: string;
+    agent_id: string;
+    version: string;
+    api_version: string;
+    has_tools: boolean;
+    has_memory: boolean;
+    endpoints: InfoEndpointsMap;
+}
+//# sourceMappingURL=info.d.ts.map

package/dist/types/info.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"info.d.ts","sourceRoot":"","sources":["../../src/types/info.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,gBAAgB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAEtD,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,OAAO,CAAC;IACnB,UAAU,EAAE,OAAO,CAAC;IACpB,SAAS,EAAE,gBAAgB,CAAC;CAC7B"}

package/dist/types/options.d.ts

@@ -0,0 +1,15 @@
+export interface JazzmineClientOptions {
+    apiKey?: string;
+    timeoutMs?: number;
+    retries?: number;
+    retryBackoffMs?: number;
+    autoDiscoverEndpoints?: boolean;
+    defaultUserId?: string;
+    fetchImpl?: typeof fetch;
+}
+export interface RequestOptions {
+    timeoutMs?: number;
+    signal?: AbortSignal;
+    retries?: number;
+}
+//# sourceMappingURL=options.d.ts.map

package/dist/types/options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.d.ts","sourceRoot":"","sources":["../../src/types/options.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,qBAAqB;IACpC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;CAC1B;AAED,MAAM,WAAW,cAAc;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB"}

package/dist/types/stream.d.ts

@@ -0,0 +1,15 @@
+import { ChatResponse } from './chat';
+export interface StreamIntermediateEvent {
+    [key: string]: unknown;
+}
+export interface StreamErrorEvent {
+    error: string;
+    detail?: string;
+}
+export interface StreamHandlers {
+    onIntermediate?: (event: StreamIntermediateEvent) => void;
+    onDone?: (response: ChatResponse) => void;
+    onErrorEvent?: (event: StreamErrorEvent) => void;
+    onRawEvent?: (eventName: string, data: unknown) => void;
+}
+//# sourceMappingURL=stream.d.ts.map

package/dist/types/stream.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream.d.ts","sourceRoot":"","sources":["../../src/types/stream.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAE3C,MAAM,WAAW,uBAAuB;IACtC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,cAAc;IAC7B,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,uBAAuB,KAAK,IAAI,CAAC;IAC1D,MAAM,CAAC,EAAE,CAAC,QAAQ,EAAE,YAAY,KAAK,IAAI,CAAC;IAC1C,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,gBAAgB,KAAK,IAAI,CAAC;IACjD,UAAU,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;CACzD"}

package/dist/utils/index.d.ts

@@ -0,0 +1,3 @@
+export * from './url';
+export * from './validation';
+//# sourceMappingURL=index.d.ts.map

package/dist/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,OAAO,CAAC;AACtB,cAAc,cAAc,CAAC"}

package/dist/utils/url.d.ts

@@ -0,0 +1,3 @@
+export declare function normalizeBaseUrl(baseEndpoint: string): string;
+export declare function buildUrl(baseUrl: string, path: string): string;
+//# sourceMappingURL=url.d.ts.map

package/dist/utils/url.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"url.d.ts","sourceRoot":"","sources":["../../src/utils/url.ts"],"names":[],"mappings":"AAEA,wBAAgB,gBAAgB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAgB7D;AAED,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAG9D"}

package/dist/utils/validation.d.ts

@@ -0,0 +1,5 @@
+import { ChatRequestPayload } from '../types';
+export declare function validateChatPayload(payload: ChatRequestPayload): void;
+export declare function normalizePositiveInt(value: number | undefined, fallback: number, field: string): number;
+export declare function normalizeRangeInt(value: number | undefined, fallback: number, field: string, min: number, max: number): number;
+//# sourceMappingURL=validation.d.ts.map

package/dist/utils/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../src/utils/validation.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAEnD,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,kBAAkB,GAAG,IAAI,CAoBrE;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAQvG;AAED,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,MAAM,GAAG,SAAS,EACzB,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,EACb,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,MAAM,GACV,MAAM,CAQR"}

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@jazzmine-ui/sdk",
+  "version": "0.1.0",
+  "type": "module",
+  "description": "Framework-agnostic TypeScript client for Jazzmine agentic backends",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "sideEffects": false,
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json && vite build",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "lint": "eslint src tests",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "npm run typecheck && npm run test && npm run build"
+  },
+  "devDependencies": {
+    "@types/node": "^25.5.2",
+    "@vitest/coverage-v8": "^2.0.0",
+    "eslint": "^9.0.0",
+    "happy-dom": "^15.0.0",
+    "prettier": "^3.0.0",
+    "typescript": "~5.5.0",
+    "typescript-eslint": "^8.0.0",
+    "vite": "^5.0.0",
+    "vite-plugin-dts": "^4.0.0",
+    "vitest": "^2.0.0"
+  }
+}