@jazzmine-ui/sdk 0.1.2 → 0.1.4

package/dist/client/JazzmineClient.d.ts

@@ -1,5 +1,5 @@
 import { JazzmineEndpoints } from '../discovery';
-import { ChatRequestPayload, ChatResponse, ConversationCreateRequest, ConversationCreateResponse, ConversationDeleteResponse, HealthResponse, InfoResponse, JazzmineClientOptions, RequestOptions, StreamHandlers } from '../types';
+import { ChatRequestPayload, ChatResponse, ConversationCreateRequest, ConversationCreateResponse, ConversationDeleteResponse, ConversationListParams, ConversationPage, ConversationSearchParams, ConversationUpdateRequest, ConversationUpdateResponse, HealthResponse, InfoResponse, JazzmineClientOptions, RequestOptions, StreamHandlers } from '../types';
 export declare class JazzmineClient {
     private readonly baseUrl;
     private readonly apiKey?;
@@ -16,6 +16,9 @@ export declare class JazzmineClient {
     getInfo(requestOptions?: RequestOptions): Promise<InfoResponse>;
     createConversation(payload?: ConversationCreateRequest, requestOptions?: RequestOptions): Promise<ConversationCreateResponse>;
     deleteConversation(conversationId: string, requestOptions?: RequestOptions): Promise<ConversationDeleteResponse>;
+    listConversations(params: ConversationListParams, requestOptions?: RequestOptions): Promise<ConversationPage>;
+    searchConversations(params: ConversationSearchParams, requestOptions?: RequestOptions): Promise<ConversationPage>;
+    updateConversation(conversationId: string, payload: ConversationUpdateRequest, requestOptions?: RequestOptions): Promise<ConversationUpdateResponse>;
     chat(payload: ChatRequestPayload, requestOptions?: RequestOptions): Promise<ChatResponse>;
     chatStream(payload: ChatRequestPayload, handlers?: StreamHandlers, requestOptions?: RequestOptions): Promise<ChatResponse>;
     sendMessage(message: string, options?: {

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

@@ -1 +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"}
+{"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,sBAAsB,EAEtB,gBAAgB,EAChB,wBAAwB,EACxB,yBAAyB,EACzB,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,iBAAiB,CACrB,MAAM,EAAE,sBAAsB,EAC9B,cAAc,GAAE,cAAmB,GAClC,OAAO,CAAC,gBAAgB,CAAC;IAmCtB,mBAAmB,CACvB,MAAM,EAAE,wBAAwB,EAChC,cAAc,GAAE,cAAmB,GAClC,OAAO,CAAC,gBAAgB,CAAC;IA4CtB,kBAAkB,CACtB,cAAc,EAAE,MAAM,EACtB,OAAO,EAAE,yBAAyB,EAClC,cAAc,GAAE,cAAmB,GAClC,OAAO,CAAC,0BAA0B,CAAC;IAwBhC,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/index.cjs

@@ -1,2 +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(_(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: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 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 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.bind(globalThis),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(_(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 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;
+"use strict";Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:"Module"}});const I={chat:"/chat",stream:"/chat/stream",conversations:"/conversations",health:"/health",info:"/info"};async function x(r){if(r.endpointsResolved||!r.autoDiscoverEndpoints)return r.endpointsResolved;try{return await r.resolveServerEndpoints(r.requestOptions),!0}catch{return!0}}function U(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),u=m(n.health,"GET",t),h=m(n.info,"GET",t);return s&&(e.chat=s),i?e.stream=i:s&&(e.stream=`${s.replace(/\/+$/,"")}/stream`),a&&(e.conversations=a),u&&(e.health=u),h&&(e.info=h),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 M(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 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 J(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 b(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 P(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 P(r.retryBackoffMs,e);continue}throw n}throw t}class p extends Error{constructor(t){const e=`Request timed out after ${t} ms.`;super(e),this.name="RetryableTimeoutError",this.finalError=new o(e)}}class y extends Error{constructor(t){super(t),this.name="RetryableNetworkError",this.finalError=new o(t)}}async function z(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),s=M(t.signal,e.signal);try{const i=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:s});if(!i.ok)throw await S(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 R(i)?new p(t.timeoutMs):i instanceof o?i:i instanceof TypeError?new y(v(i,"Network request failed.")):new o(v(i,"Network request failed."))}finally{clearTimeout(n)}},shouldRetry:e=>{if(e instanceof p||e instanceof y)return!0;if(e instanceof o){const n=e.status??0;return n===429||n>=500}return!1}})}catch(e){throw e instanceof p||e instanceof y?e.finalError:e instanceof o?e:new o(v(e,"Network request failed."))}}async function S(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 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 J(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 v(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,u,h,c;const t=r.handlers??{},e=r.body.getReader(),n=new TextDecoder("utf-8");let s="",i=null;for(;;){const{done:d,value:w}=await e.read();if(d)break;s+=n.decode(w,{stream:!0});const g=s.split(/\n\n/);s=g.pop()??"";for(const $ of g){const l=j($);if(l){if((a=t.onRawEvent)==null||a.call(t,l.event,l.data),l.event==="intermediate"){(u=t.onIntermediate)==null||u.call(t,l.data);continue}if(l.event==="done"){i=r.expectChatResponse(l.data),(h=t.onDone)==null||h.call(t,i);continue}if(l.event==="error"){const f=r.toStreamError(l.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 L=2e4,B=2,q=350;class C{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,L,"timeoutMs"),this.retries=b(e.retries,B,"retries",0,10),this.retryBackoffMs=b(e.retryBackoffMs,q,"retryBackoffMs",0,6e4),this.autoDiscoverEndpoints=e.autoDiscoverEndpoints!==!1,this.defaultUserId=(e.defaultUserId??"user").trim()||"user",this.fetchFn=e.fetchImpl??fetch.bind(globalThis),this.endpoints={...I}}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 listConversations(t,e={}){var h;const n=(h=t.userId)==null?void 0:h.trim();if(!n)throw new o("userId is required.");const s=t.limit??100,i=t.offset??0;await this.ensureEndpoints(e);const a=new URLSearchParams({user_id:n,limit:String(s),offset:String(i)}).toString(),u=await this.requestJson({method:"GET",path:`${this.endpoints.conversations}?${a}`,timeoutMs:e.timeoutMs??this.timeoutMs,retries:e.retries??this.retries,signal:e.signal,allowRetry:!0});return{conversations:u.conversations,total:u.total,limit:u.limit,offset:u.offset,hasMore:u.total>i+u.conversations.length}}async searchConversations(t,e={}){var d,w;const n=(d=t.userId)==null?void 0:d.trim(),s=(w=t.query)==null?void 0:w.trim();if(!n)throw new o("userId is required.");if(!s)throw new o("query is required.");const i=t.limit??100,a=t.offset??0;await this.ensureEndpoints(e);const u=new URLSearchParams({user_id:n,query:s,limit:String(i),offset:String(a)}).toString(),h=`${this.endpoints.conversations}/search?${u}`,c=await this.requestJson({method:"GET",path:h,timeoutMs:e.timeoutMs??this.timeoutMs,retries:e.retries??this.retries,signal:e.signal,allowRetry:!0});return{conversations:c.conversations,total:c.total,limit:c.limit,offset:c.offset,hasMore:c.total>a+c.conversations.length,query:c.query}}async updateConversation(t,e,n={}){var a;const s=t==null?void 0:t.trim();if(!s)throw new o("conversationId is required.");const i=(a=e.title)==null?void 0:a.trim();if(!i)throw new o("title is required.");return await this.ensureEndpoints(n),this.requestJson({method:"PATCH",path:`${this.endpoints.conversations}/${encodeURIComponent(s)}`,body:{title:i},timeoutMs:n.timeoutMs??this.timeoutMs,retries:n.retries??0,signal:n.signal,allowRetry:!1})}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,u=setTimeout(()=>{a.abort()},s),h=M(i,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:h});if(!c.ok)throw await S(c,this.endpoints.stream);if(!c.body)throw new o("Streaming response body is missing.");return await F({body:c.body,handlers:e,expectChatResponse:d=>this.expectChatResponse(d),toStreamError:d=>this.toStreamError(d)})}catch(c){throw R(c)?new o(`Streaming request timed out after ${s} ms.`):c instanceof o?c:new o(this.errorMessage(c,"Streaming request failed."))}finally{clearTimeout(u)}}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=U(e,this.baseUrl);return this.endpoints={...this.endpoints,...n},this.endpointsResolved=!0,{...this.endpoints}}async ensureEndpoints(t={}){this.endpointsResolved=await x({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=C;exports.JazzmineClientError=o;exports.default=C;

package/dist/index.js

@@ -5,7 +5,7 @@ const C = {
   health: "/health",
   info: "/info"
 };
-async function $(r) {
+async function I(r) {
   if (r.endpointsResolved || !r.autoDiscoverEndpoints)
     return r.endpointsResolved;
   try {
@@ -14,12 +14,12 @@ async function $(r) {
     return !0;
   }
 }
-function I(r, t) {
+function x(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;
+  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), u = 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), u && (e.info = u), e;
 }
 function m(r, t, e) {
   if (typeof r != "string")
@@ -27,11 +27,11 @@ function m(r, t, e) {
   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())
+  const s = n[1].toUpperCase(), i = n[2].trim();
+  if (s !== t.toUpperCase())
     return null;
   try {
-    const a = new URL(s, e);
+    const a = new URL(i, e);
     return `${a.pathname}${a.search}`;
   } catch {
     return null;
@@ -42,7 +42,7 @@ class o extends Error {
     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) {
+function M(r, t) {
   if (!r && !t)
     return;
   if (!r)
@@ -52,15 +52,15 @@ function b(r, t) {
   const e = AbortSignal.any;
   if (typeof e == "function")
     return e([r, t]);
-  const n = new AbortController(), i = () => {
+  const n = new AbortController(), s = () => {
     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);
+  return r.aborted || t.aborted ? (n.abort(), n.signal) : (r.addEventListener("abort", s, { once: !0 }), t.addEventListener("abort", s, { once: !0 }), n.signal);
 }
 function R(r) {
   return r instanceof DOMException && (r.name === "AbortError" || r.name === "TimeoutError");
 }
-function A(r) {
+function U(r) {
   const t = r.trim().replace(/\/+$/, "");
   let e;
   try {
@@ -74,7 +74,7 @@ function A(r) {
     throw new o("baseEndpoint must use http or https.");
   return `${e.protocol}//${e.host}${e.pathname.replace(/\/+$/, "")}`;
 }
-function U(r, t) {
+function A(r, t) {
   const e = t.startsWith("/") ? t : `/${t}`;
   return `${r}${e}`;
 }
@@ -89,72 +89,72 @@ function E(r) {
   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) {
+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, i) {
+function b(r, t, e, n, s) {
   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}.`);
+  if (!Number.isInteger(r) || r < n || r > s)
+    throw new o(`${e} must be an integer between ${n} and ${s}.`);
   return r;
 }
-async function J(r, t) {
+async function k(r, t) {
   const e = r * (t + 1);
   e <= 0 || await new Promise((n) => setTimeout(n, e));
 }
-async function N(r) {
+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 J(r.retryBackoffMs, e);
+        await k(r.retryBackoffMs, e);
         continue;
       }
       throw n;
     }
   throw t;
 }
-class w extends Error {
+class p 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 {
+class y extends Error {
   constructor(t) {
     super(t), this.name = "RetryableNetworkError", this.finalError = new o(t);
   }
 }
-async function D(r, t) {
+async function N(r, t) {
   try {
-    return await N({
+    return await P({
       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);
+        }, t.timeoutMs), s = M(t.signal, e.signal);
         try {
-          const s = await r.fetchFn(_(r.baseUrl, t.path), {
+          const i = 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
+            signal: s
           });
-          if (!s.ok)
-            throw await M(s, t.path);
-          const a = await s.text();
+          if (!i.ok)
+            throw await S(i, t.path);
+          const a = await i.text();
           if (!a.trim())
             return {};
           try {
@@ -164,14 +164,14 @@ async function D(r, t) {
               `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."));
+        } catch (i) {
+          throw R(i) ? new p(t.timeoutMs) : i instanceof o ? i : i instanceof TypeError ? new y(v(i, "Network request failed.")) : new o(v(i, "Network request failed."));
         } finally {
           clearTimeout(n);
         }
       },
       shouldRetry: (e) => {
-        if (e instanceof w || e instanceof p)
+        if (e instanceof p || e instanceof y)
           return !0;
         if (e instanceof o) {
           const n = e.status ?? 0;
@@ -181,10 +181,10 @@ async function D(r, t) {
       }
     });
   } catch (e) {
-    throw e instanceof w || e instanceof p ? e.finalError : e instanceof o ? e : new o(y(e, "Network request failed."));
+    throw e instanceof p || e instanceof y ? e.finalError : e instanceof o ? e : new o(v(e, "Network request failed."));
   }
 }
-async function M(r, t) {
+async function S(r, t) {
   const e = await r.text();
   let n;
   if (e.trim())
@@ -193,8 +193,8 @@ async function M(r, t) {
     } catch {
       n = e;
     }
-  const i = P(n), s = `HTTP ${r.status} on ${t}${i ? `: ${i}` : ""}`;
-  return new o(s, {
+  const s = D(n), i = `HTTP ${r.status} on ${t}${s ? `: ${s}` : ""}`;
+  return new o(i, {
     status: r.status,
     details: n
   });
@@ -204,9 +204,9 @@ function T(r, t) {
   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);
+  return A(r, t);
 }
-function P(r) {
+function D(r) {
   if (!r)
     return "";
   if (typeof r == "string")
@@ -220,56 +220,56 @@ function P(r) {
   }
   return "";
 }
-function y(r, t) {
+function v(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(":"));
+  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 s of t) {
-    if (s.startsWith("event:")) {
-      e = s.slice(6).trim() || "message";
+  for (const i of t) {
+    if (i.startsWith("event:")) {
+      e = i.slice(6).trim() || "message";
       continue;
     }
-    s.startsWith("data:") && n.push(s.slice(5).trim());
+    i.startsWith("data:") && n.push(i.slice(5).trim());
   }
-  const i = n.join(`
+  const s = n.join(`
 `);
-  if (!i)
+  if (!s)
     return { event: e, data: null };
   try {
-    return { event: e, data: JSON.parse(i) };
+    return { event: e, data: JSON.parse(s) };
   } catch {
-    return { event: e, data: i };
+    return { event: e, data: s };
   }
 }
 async function F(r) {
-  var a, h, d, c;
+  var a, h, u, c;
   const t = r.handlers ?? {}, e = r.body.getReader(), n = new TextDecoder("utf-8");
-  let i = "", s = null;
+  let s = "", i = null;
   for (; ; ) {
-    const { done: l, value: S } = await e.read();
+    const { done: l, value: w } = 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);
+    s += n.decode(w, { stream: !0 });
+    const g = s.split(/\n\n/);
+    s = g.pop() ?? "";
+    for (const $ of g) {
+      const d = j($);
+      if (d) {
+        if ((a = t.onRawEvent) == null || a.call(t, d.event, d.data), d.event === "intermediate") {
+          (h = t.onIntermediate) == null || h.call(t, d.data);
           continue;
         }
-        if (u.event === "done") {
-          s = r.expectChatResponse(u.data), (d = t.onDone) == null || d.call(t, s);
+        if (d.event === "done") {
+          i = r.expectChatResponse(d.data), (u = t.onDone) == null || u.call(t, i);
           continue;
         }
-        if (u.event === "error") {
-          const f = r.toStreamError(u.data);
+        if (d.event === "error") {
+          const f = r.toStreamError(d.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
@@ -278,14 +278,14 @@ async function F(r) {
       }
     }
   }
-  if (!s)
+  if (!i)
     throw new o(
       "Stream ended without a final done event containing ChatResponse."
     );
-  return s;
+  return i;
 }
-const B = 2e4, z = 2, L = 350;
-class W {
+const L = 2e4, B = 2, z = 350;
+class q {
   constructor(t, e = {}) {
     if (this.endpointsResolved = !1, !t || !t.trim())
       throw new o("baseEndpoint is required.");
@@ -293,9 +293,9 @@ class W {
       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(
+    this.baseUrl = U(t), this.apiKey = e.apiKey, this.timeoutMs = J(e.timeoutMs, L, "timeoutMs"), this.retries = b(e.retries, B, "retries", 0, 10), this.retryBackoffMs = b(
       e.retryBackoffMs,
-      L,
+      z,
       "retryBackoffMs",
       0,
       6e4
@@ -349,6 +349,82 @@ class W {
       allowRetry: !0
     });
   }
+  async listConversations(t, e = {}) {
+    var u;
+    const n = (u = t.userId) == null ? void 0 : u.trim();
+    if (!n)
+      throw new o("userId is required.");
+    const s = t.limit ?? 100, i = t.offset ?? 0;
+    await this.ensureEndpoints(e);
+    const a = new URLSearchParams({
+      user_id: n,
+      limit: String(s),
+      offset: String(i)
+    }).toString(), h = await this.requestJson({
+      method: "GET",
+      path: `${this.endpoints.conversations}?${a}`,
+      timeoutMs: e.timeoutMs ?? this.timeoutMs,
+      retries: e.retries ?? this.retries,
+      signal: e.signal,
+      allowRetry: !0
+    });
+    return {
+      conversations: h.conversations,
+      total: h.total,
+      limit: h.limit,
+      offset: h.offset,
+      hasMore: h.total > i + h.conversations.length
+    };
+  }
+  async searchConversations(t, e = {}) {
+    var l, w;
+    const n = (l = t.userId) == null ? void 0 : l.trim(), s = (w = t.query) == null ? void 0 : w.trim();
+    if (!n)
+      throw new o("userId is required.");
+    if (!s)
+      throw new o("query is required.");
+    const i = t.limit ?? 100, a = t.offset ?? 0;
+    await this.ensureEndpoints(e);
+    const h = new URLSearchParams({
+      user_id: n,
+      query: s,
+      limit: String(i),
+      offset: String(a)
+    }).toString(), u = `${this.endpoints.conversations}/search?${h}`, c = await this.requestJson({
+      method: "GET",
+      path: u,
+      timeoutMs: e.timeoutMs ?? this.timeoutMs,
+      retries: e.retries ?? this.retries,
+      signal: e.signal,
+      allowRetry: !0
+    });
+    return {
+      conversations: c.conversations,
+      total: c.total,
+      limit: c.limit,
+      offset: c.offset,
+      hasMore: c.total > a + c.conversations.length,
+      query: c.query
+    };
+  }
+  async updateConversation(t, e, n = {}) {
+    var a;
+    const s = t == null ? void 0 : t.trim();
+    if (!s)
+      throw new o("conversationId is required.");
+    const i = (a = e.title) == null ? void 0 : a.trim();
+    if (!i)
+      throw new o("title is required.");
+    return await this.ensureEndpoints(n), this.requestJson({
+      method: "PATCH",
+      path: `${this.endpoints.conversations}/${encodeURIComponent(s)}`,
+      body: { title: i },
+      timeoutMs: n.timeoutMs ?? this.timeoutMs,
+      retries: n.retries ?? 0,
+      signal: n.signal,
+      allowRetry: !1
+    });
+  }
   async chat(t, e = {}) {
     return E(t), await this.ensureEndpoints(e), this.requestJson({
       method: "POST",
@@ -368,9 +444,9 @@ class W {
   }
   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(() => {
+    const s = n.timeoutMs ?? this.timeoutMs, i = n.signal, a = new AbortController(), h = setTimeout(() => {
       a.abort();
-    }, i), d = b(s, a.signal);
+    }, s), u = M(i, a.signal);
     try {
       const c = await this.fetchFn(_(this.baseUrl, this.endpoints.stream), {
         method: "POST",
@@ -385,10 +461,10 @@ class W {
           explicit_context: t.explicit_context,
           metadata: t.metadata ?? {}
         }),
-        signal: d
+        signal: u
       });
       if (!c.ok)
-        throw await M(c, this.endpoints.stream);
+        throw await S(c, this.endpoints.stream);
       if (!c.body)
         throw new o("Streaming response body is missing.");
       return await F({
@@ -398,7 +474,7 @@ class W {
         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."));
+      throw R(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);
     }
@@ -412,16 +488,16 @@ class W {
       explicit_context: e.explicitContext,
       metadata: e.metadata
     };
-    let i = (a = e.conversationId) == null ? void 0 : a.trim();
-    !i && e.autoCreateConversation && (i = (await this.createConversation(
+    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 = i);
-    const s = await this.chat(n, e.requestOptions);
-    return { response: s, conversationId: s.conversation_id || i || "" };
+    )).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({
@@ -431,14 +507,14 @@ class W {
       retries: t.retries ?? this.retries,
       signal: t.signal,
       allowRetry: !0
-    }), n = I(e, this.baseUrl);
+    }), n = x(e, this.baseUrl);
     return this.endpoints = {
       ...this.endpoints,
       ...n
     }, this.endpointsResolved = !0, { ...this.endpoints };
   }
   async ensureEndpoints(t = {}) {
-    this.endpointsResolved = await $({
+    this.endpointsResolved = await I({
       endpointsResolved: this.endpointsResolved,
       autoDiscoverEndpoints: this.autoDiscoverEndpoints,
       requestOptions: t,
@@ -446,7 +522,7 @@ class W {
     });
   }
   requestJson(t) {
-    return D(
+    return N(
       {
         baseUrl: this.baseUrl,
         apiKey: this.apiKey,
@@ -480,7 +556,7 @@ class W {
   }
 }
 export {
-  W as JazzmineClient,
+  q as JazzmineClient,
   o as JazzmineClientError,
-  W as default
+  q as default
 };

package/dist/types/conversation.d.ts

@@ -15,4 +15,46 @@ export interface ConversationDeleteResponse {
     conversation_id: string;
     deleted: boolean;
 }
+export interface ConversationListParams {
+    userId: string;
+    limit?: number;
+    offset?: number;
+}
+export interface ConversationSearchParams {
+    userId: string;
+    query: string;
+    limit?: number;
+    offset?: number;
+}
+export interface ConversationUpdateRequest {
+    title: string;
+}
+export interface ConversationUpdateResponse {
+    conversation_id: string;
+    user_id: string;
+    agent_id: string;
+    title: string;
+    created_at: number;
+    last_updated_at: number;
+}
+export interface ConversationListResponse {
+    user_id: string;
+    total: number;
+    limit: number;
+    offset: number;
+    query?: string;
+    conversations: ConversationCreateResponse[];
+}
+/**
+ * Helper type for infinite scroll pagination.
+ * Tells the consumer whether more pages are available.
+ */
+export interface ConversationPage {
+    conversations: ConversationCreateResponse[];
+    total: number;
+    limit: number;
+    offset: number;
+    hasMore: boolean;
+    query?: string;
+}
 //# sourceMappingURL=conversation.d.ts.map

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

@@ -1 +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"}
+{"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;AAED,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,wBAAwB;IACvC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,yBAAyB;IACxC,KAAK,EAAE,MAAM,CAAC;CACf;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,wBAAwB;IACvC,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,0BAA0B,EAAE,CAAC;CAC7C;AAED;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,aAAa,EAAE,0BAA0B,EAAE,CAAC;IAC5C,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB"}

package/dist/types/index.d.ts

@@ -1,5 +1,5 @@
 export * from './chat';
-export * from './conversation';
+export type { ConversationCreateRequest, ConversationCreateResponse, ConversationDeleteResponse, ConversationListParams, ConversationSearchParams, ConversationUpdateRequest, ConversationUpdateResponse, ConversationListResponse, ConversationPage, } from './conversation';
 export * from './health';
 export * from './info';
 export * from './options';

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

@@ -1 +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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,cAAc,QAAQ,CAAC;AACvB,YAAY,EACX,yBAAyB,EACzB,0BAA0B,EAC1B,0BAA0B,EAC1B,sBAAsB,EACtB,wBAAwB,EACxB,yBAAyB,EACzB,0BAA0B,EAC1B,wBAAwB,EACxB,gBAAgB,GAChB,MAAM,gBAAgB,CAAC;AACxB,cAAc,UAAU,CAAC;AACzB,cAAc,QAAQ,CAAC;AACvB,cAAc,WAAW,CAAC;AAC1B,cAAc,UAAU,CAAC"}

package/dist/types/info.d.ts

@@ -1,4 +1,4 @@
-export type InfoEndpointsMap = Record<string, string>;
+export type InfoEndpointsMap = Partial<Record<"chat" | "stream" | "conversations_create" | "conversations_list" | "conversations_search" | "conversations_update" | "conversations_delete" | "health" | "info", string>>;
 export interface InfoResponse {
     agent_name: string;
     agent_id: string;

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

@@ -1 +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"}
+{"version":3,"file":"info.d.ts","sourceRoot":"","sources":["../../src/types/info.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,gBAAgB,GAAG,OAAO,CACpC,MAAM,CACF,MAAM,GACN,QAAQ,GACR,sBAAsB,GACtB,oBAAoB,GACpB,sBAAsB,GACtB,sBAAsB,GACtB,sBAAsB,GACtB,QAAQ,GACR,MAAM,EACR,MAAM,CACP,CACF,CAAC;AAEF,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/package.json

@@ -1,8 +1,16 @@
 {
   "name": "@jazzmine-ui/sdk",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "type": "module",
   "description": "Framework-agnostic TypeScript client for Jazzmine agentic backends",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/AbderrazagB/jazzmine-ui-sdk.git"
+  },
+  "bugs": {
+    "url": "https://github.com/AbderrazagB/jazzmine-ui-sdk/issues"
+  },
+  "homepage": "https://github.com/AbderrazagB/jazzmine-ui-sdk#readme",
   "main": "./dist/index.cjs",
   "module": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -25,7 +33,10 @@
     "test:watch": "vitest",
     "lint": "eslint src tests",
     "typecheck": "tsc --noEmit",
-    "prepublishOnly": "npm run typecheck && npm run test && npm run build"
+    "prepublishOnly": "npm run typecheck && npm run test && npm run build",
+    "release:patch": "npm version patch && git push --follow-tags origin HEAD",
+    "release:minor": "npm version minor && git push --follow-tags origin HEAD",
+    "release:major": "npm version major && git push --follow-tags origin HEAD"
   },
   "devDependencies": {
     "@types/node": "^25.5.2",