telescope-ai 0.1.2 → 0.2.0

package/README.md

@@ -31,6 +31,11 @@ const client = new TelescopeClient({
 const data = await client.insights.instrument.generate({
   instrument_reference_id1: "AAPL_US",
 });
+
+const latestNews = await client.news.latest.generate({
+  instrument_reference_id1s: ["AAPL_US"],
+  instrument_group_ids: ["your-group-id"],
+});
 ```
 
 ### Streaming Example
@@ -117,6 +122,7 @@ const client = new TelescopeClient({
 - `TelescopeClient.VERSION` - Static property containing the SDK version
 - `client.insights` - Namespaced access to Insights API
 - `client.atlas` - Namespaced access to Atlas API
+- `client.news` - Namespaced access to News API
 
 #### Methods
 
@@ -147,25 +153,34 @@ const session = client.insights.instrument.streamFromResponse(response);
 const data = await client.insights.portfolio.generateFromResponse(response);
 ```
 
-### Atlas API
+> **Note:** Ripple and Guardrails clients are coming in a future release once their backends support the V2 SSE format.
+
+### News API
 
-Access via `client.atlas`:
+Access via `client.news`.
 
 ```typescript
-// Streaming
-const session = client.atlas.streamAdvice({
-  advisor_environment_id: "...",
-  client_details: "...",
-  // ... other required fields
+// Non-streaming: latest stories for instruments
+const latest = await client.news.latest.generate({
+  instrument_reference_id1s: ["AAPL_US", "NVDA_US"],
+  instrument_group_ids: ["group-uuid"],
+  limit: 20,
+  locale: "en-US",
 });
 
-// Non-streaming
-const advice = await client.atlas.getAdvice("advice-id");
-const recent = await client.atlas.getLatestAdvice(30);
-await client.atlas.archiveAdvice(["id1", "id2"], true);
-```
+// Streaming: trending topics
+const session = client.news.trendingTopics.stream({
+  topics: ["Region: Global"],
+  limit: 10,
+  locale: "en-US",
+});
 
-> **Note:** Ripple and Guardrails clients are coming in a future release once their backends support the V2 SSE format.
+// Non-streaming: trending topics
+const topics = await client.news.trendingTopics.generate({
+  topics: ["Asset Class: Crypto"],
+  limit: 10,
+});
+```
 
 ### StreamSession
 
@@ -257,7 +272,6 @@ import type {
   StreamStatus,
   StreamPhase,
   InstrumentInsightsResponse,
-  AtlasAdviceResponse,
 } from "telescope-ai";
 ```
 

package/dist/{client-QPIC24Zs.mjs → client-CLPQRhxT.mjs}

@@ -194,7 +194,7 @@ function pathToKey(path) {
 * Returns null for unknown event types (per spec: clients MUST ignore unknown events).
 */
 function parseEvent(eventName, rawData) {
-	switch (eventName) {
+	switch (eventName.toLowerCase()) {
 		case "patch": {
 			const data = rawData;
 			return {
@@ -217,7 +217,7 @@ function parseEvent(eventName, rawData) {
 				data: {
 					code: data.code,
 					message: data.message,
-					http_status: data.http_status,
+					http_status: data.http_status ?? data.status_code ?? 0,
 					path: data.path,
 					additional_data: data.additional_data
 				}
@@ -388,6 +388,7 @@ var ResponseBuilder = class {
 * - Path completion tracking
 * - Promise-based completion
 */
+init_errors();
 /**
 * StreamSession manages a single streaming request.
 *
@@ -515,6 +516,14 @@ var StreamSession = class {
 	}
 	handleError(errorData) {
 		this.notifyObservers((obs) => obs.onError?.(errorData));
+		const sseError = new SSEError(errorData);
+		this.setStatus({
+			phase: "error",
+			startedAt: this._status.startedAt,
+			completedAt: Date.now(),
+			error: sseError
+		});
+		this.completionReject(sseError);
 	}
 	handleHeartbeat() {
 		this.notifyObservers((obs) => obs.onHeartbeat?.());
@@ -544,56 +553,29 @@ var StreamSession = class {
 };
 
 //#endregion
-//#region src/insights/client.ts
-var client_exports$1 = /* @__PURE__ */ __exportAll({ InsightsClient: () => InsightsClient });
-var InstrumentInsightsClient, PortfolioInsightsClient, InsightsClient;
-var init_client$1 = __esmMin((() => {
+//#region src/insights/instrument/client.ts
+var InstrumentInsightsClient;
+var init_client$7 = __esmMin((() => {
 	init_errors();
 	InstrumentInsightsClient = class {
 		constructor(client) {
 			this.client = client;
 		}
-		/**
-		* Stream insights for a single instrument via SSE.
-		*
-		* @example
-		* ```ts
-		* const session = client.insights.instrument.stream({ instrument_id: "abc123" });
-		* session.subscribe({ onPatch: (data) => console.log(data.groups) });
-		* const result = await session.complete();
-		* ```
-		*/
 		stream(request, options) {
 			return this.client.stream("/v2/insights/instrument", {
 				...request,
 				stream: true
 			}, options);
 		}
-		/**
-		* Get insights for an instrument (non-streaming).
-		*
-		* @example
-		* ```ts
-		* const data = await client.insights.instrument.generate({ instrument_id: "abc123" });
-		* ```
-		*/
 		async generate(request) {
 			return this.client.post("/v2/insights/instrument", {
 				...request,
 				stream: false
 			});
 		}
-		/**
-		* Create a StreamSession from a pre-existing SSE response.
-		* Use this when you have a response from a proxy or custom fetch.
-		*/
 		streamFromResponse(source) {
 			return this.client.streamFromResponse(source);
 		}
-		/**
-		* Parse a pre-existing JSON response (non-streaming).
-		* Use this when you have a response from a proxy or custom fetch.
-		*/
 		async generateFromResponse(response) {
 			if (!response.ok) {
 				const body = await response.text().catch(() => "");
@@ -602,37 +584,32 @@ var init_client$1 = __esmMin((() => {
 			return response.json();
 		}
 	};
+}));
+
+//#endregion
+//#region src/insights/portfolio/client.ts
+var PortfolioInsightsClient;
+var init_client$6 = __esmMin((() => {
+	init_errors();
 	PortfolioInsightsClient = class {
 		constructor(client) {
 			this.client = client;
 		}
-		/**
-		* Stream insights for a portfolio via SSE.
-		*/
 		stream(request, options) {
 			return this.client.stream("/v2/insights/portfolio", {
 				...request,
 				stream: true
 			}, options);
 		}
-		/**
-		* Get insights for a portfolio (non-streaming).
-		*/
 		async generate(request) {
 			return this.client.post("/v2/insights/portfolio", {
 				...request,
 				stream: false
 			});
 		}
-		/**
-		* Create a StreamSession from a pre-existing SSE response.
-		*/
 		streamFromResponse(source) {
 			return this.client.streamFromResponse(source);
 		}
-		/**
-		* Parse a pre-existing JSON response (non-streaming).
-		*/
 		async generateFromResponse(response) {
 			if (!response.ok) {
 				const body = await response.text().catch(() => "");
@@ -641,23 +618,153 @@ var init_client$1 = __esmMin((() => {
 			return response.json();
 		}
 	};
+}));
+
+//#endregion
+//#region src/insights/watchlist/client.ts
+var WatchlistInsightsClient;
+var init_client$5 = __esmMin((() => {
+	init_errors();
+	WatchlistInsightsClient = class {
+		constructor(client) {
+			this.client = client;
+		}
+		stream(request, options) {
+			return this.client.stream("/v2/insights/watchlist", {
+				...request,
+				stream: true
+			}, options);
+		}
+		async generate(request) {
+			return this.client.post("/v2/insights/watchlist", {
+				...request,
+				stream: false
+			});
+		}
+		streamFromResponse(source) {
+			return this.client.streamFromResponse(source);
+		}
+		async generateFromResponse(response) {
+			if (!response.ok) {
+				const body = await response.text().catch(() => "");
+				throw new ApiError(`Response not OK: ${response.status}`, response.status, body || void 0);
+			}
+			return response.json();
+		}
+	};
+}));
+
+//#endregion
+//#region src/insights/market/client.ts
+var MarketInsightsClient;
+var init_client$4 = __esmMin((() => {
+	init_errors();
+	MarketInsightsClient = class {
+		constructor(client) {
+			this.client = client;
+		}
+		stream(request, options) {
+			return this.client.stream("/v2/insights/market", {
+				...request,
+				stream: true
+			}, options);
+		}
+		async generate(request) {
+			return this.client.post("/v2/insights/market", {
+				...request,
+				stream: false
+			});
+		}
+		streamFromResponse(source) {
+			return this.client.streamFromResponse(source);
+		}
+		async generateFromResponse(response) {
+			if (!response.ok) {
+				const body = await response.text().catch(() => "");
+				throw new ApiError(`Response not OK: ${response.status}`, response.status, body || void 0);
+			}
+			return response.json();
+		}
+	};
+}));
+
+//#endregion
+//#region src/insights/trending/client.ts
+var TrendingInsightsClient;
+var init_client$3 = __esmMin((() => {
+	init_errors();
+	TrendingInsightsClient = class {
+		constructor(client) {
+			this.client = client;
+		}
+		stream(request, options) {
+			return this.client.stream("/v2/insights/trending", {
+				...request,
+				stream: true
+			}, options);
+		}
+		async generate(request) {
+			return this.client.post("/v2/insights/trending", {
+				...request,
+				stream: false
+			});
+		}
+		streamFromResponse(source) {
+			return this.client.streamFromResponse(source);
+		}
+		async generateFromResponse(response) {
+			if (!response.ok) {
+				const body = await response.text().catch(() => "");
+				throw new ApiError(`Response not OK: ${response.status}`, response.status, body || void 0);
+			}
+			return response.json();
+		}
+	};
+}));
+
+//#endregion
+//#region src/insights/client.ts
+var client_exports$2 = /* @__PURE__ */ __exportAll({
+	InsightsClient: () => InsightsClient,
+	InstrumentInsightsClient: () => InstrumentInsightsClient,
+	MarketInsightsClient: () => MarketInsightsClient,
+	PortfolioInsightsClient: () => PortfolioInsightsClient,
+	TrendingInsightsClient: () => TrendingInsightsClient,
+	WatchlistInsightsClient: () => WatchlistInsightsClient
+});
+var InsightsClient;
+var init_client$2 = __esmMin((() => {
+	init_client$7();
+	init_client$6();
+	init_client$5();
+	init_client$4();
+	init_client$3();
+	init_client$7();
+	init_client$6();
+	init_client$5();
+	init_client$4();
+	init_client$3();
 	InsightsClient = class {
-		/** Instrument insights operations */
 		instrument;
-		/** Portfolio insights operations */
 		portfolio;
+		watchlist;
+		market;
+		trending;
 		constructor(client) {
 			this.instrument = new InstrumentInsightsClient(client);
 			this.portfolio = new PortfolioInsightsClient(client);
+			this.watchlist = new WatchlistInsightsClient(client);
+			this.market = new MarketInsightsClient(client);
+			this.trending = new TrendingInsightsClient(client);
 		}
 	};
 }));
 
 //#endregion
 //#region src/atlas/client.ts
-var client_exports = /* @__PURE__ */ __exportAll({ AtlasClient: () => AtlasClient });
+var client_exports$1 = /* @__PURE__ */ __exportAll({ AtlasClient: () => AtlasClient });
 var AtlasClient;
-var init_client = __esmMin((() => {
+var init_client$1 = __esmMin((() => {
 	AtlasClient = class {
 		constructor(client) {
 			this.client = client;
@@ -699,6 +806,86 @@ var init_client = __esmMin((() => {
 				archived
 			});
 		}
+		/**
+		* List available advisor environments.
+		*/
+		async getAdvisorEnvironments(options) {
+			const params = new URLSearchParams();
+			if (options?.region) params.set("region", options.region);
+			if (options?.currency) params.set("currency", options.currency);
+			const qs = params.toString();
+			const path = `/v2/atlas/advisor-environments${qs ? `?${qs}` : ""}`;
+			return (await this.client.get(path)).environments;
+		}
+	};
+}));
+
+//#endregion
+//#region src/news/client.ts
+var client_exports = /* @__PURE__ */ __exportAll({ NewsClient: () => NewsClient });
+var NewsLatestClient, NewsTrendingTopicsClient, NewsClient;
+var init_client = __esmMin((() => {
+	init_errors();
+	NewsLatestClient = class {
+		constructor(client) {
+			this.client = client;
+		}
+		/**
+		* Get latest stories for a set of instruments (non-streaming).
+		*/
+		async generate(request) {
+			return this.client.post("/v2/news/latest", {
+				...request,
+				stream: false
+			});
+		}
+	};
+	NewsTrendingTopicsClient = class {
+		constructor(client) {
+			this.client = client;
+		}
+		/**
+		* Stream ranked trending topics via SSE.
+		*/
+		stream(request, options) {
+			return this.client.stream("/v2/news/trending/topics", {
+				...request,
+				stream: true
+			}, options);
+		}
+		/**
+		* Get ranked trending topics (non-streaming).
+		*/
+		async generate(request) {
+			return this.client.post("/v2/news/trending/topics", {
+				...request,
+				stream: false
+			});
+		}
+		/**
+		* Create a StreamSession from a pre-existing SSE response.
+		*/
+		streamFromResponse(source) {
+			return this.client.streamFromResponse(source);
+		}
+		/**
+		* Parse a pre-existing JSON response (non-streaming).
+		*/
+		async generateFromResponse(response) {
+			if (!response.ok) {
+				const body = await response.text().catch(() => "");
+				throw new ApiError(`Response not OK: ${response.status}`, response.status, body || void 0);
+			}
+			return response.json();
+		}
+	};
+	NewsClient = class {
+		latest;
+		trendingTopics;
+		constructor(client) {
+			this.latest = new NewsLatestClient(client);
+			this.trendingTopics = new NewsTrendingTopicsClient(client);
+		}
 	};
 }));
 
@@ -706,7 +893,7 @@ var init_client = __esmMin((() => {
 //#region src/core/client.ts
 init_errors();
 /** SDK version - matches package.json */
-const VERSION = "0.1.0";
+const VERSION = "0.2.0";
 const DEFAULT_TELESCOPE_API_ORIGIN = "https://api.telescope.co";
 const DEFAULT_CONNECT_TIMEOUT = 3e4;
 const DEFAULT_JSON_HEADERS = { "Content-Type": "application/json" };
@@ -744,6 +931,7 @@ var TelescopeClient = class {
 	debugEnabled;
 	_insights;
 	_atlas;
+	_news;
 	constructor(options = {}) {
 		if (options.apiKey && options.clientToken) throw new Error("Cannot provide both apiKey and clientToken. Use one or the other.");
 		const authToken = options.clientToken ?? options.apiKey ?? getEnvVar("TELESCOPE_API_KEY");
@@ -772,7 +960,7 @@ var TelescopeClient = class {
 	get insights() {
 		let client = this._insights;
 		if (!client) {
-			const { InsightsClient } = (init_client$1(), __toCommonJS(client_exports$1));
+			const { InsightsClient } = (init_client$2(), __toCommonJS(client_exports$2));
 			client = new InsightsClient(this);
 			this._insights = client;
 		}
@@ -790,13 +978,31 @@ var TelescopeClient = class {
 	get atlas() {
 		let client = this._atlas;
 		if (!client) {
-			const { AtlasClient } = (init_client(), __toCommonJS(client_exports));
+			const { AtlasClient } = (init_client$1(), __toCommonJS(client_exports$1));
 			client = new AtlasClient(this);
 			this._atlas = client;
 		}
 		return client;
 	}
 	/**
+	* Namespaced access to News API.
+	*
+	* @example
+	* ```ts
+	* const latest = await client.news.latest.generate({ ... });
+	* const session = client.news.trendingTopics.stream({ topic: "global" });
+	* ```
+	*/
+	get news() {
+		let client = this._news;
+		if (!client) {
+			const { NewsClient } = (init_client(), __toCommonJS(client_exports));
+			client = new NewsClient(this);
+			this._news = client;
+		}
+		return client;
+	}
+	/**
 	* Log debug messages when debug mode is enabled.
 	*/
 	debug(message, data) {
@@ -817,7 +1023,7 @@ var TelescopeClient = class {
 			abortController.abort(/* @__PURE__ */ new Error(`Request timed out after ${this.connectTimeout}ms`));
 		}, this.connectTimeout);
 		try {
-			const response = await fetch(`${this.baseUrl}/v2/client-tokens`, {
+			const response = await fetch(buildApiUrl(this.baseUrl, "/v2/client-tokens"), {
 				method: "POST",
 				headers: {
 					...DEFAULT_JSON_HEADERS,
@@ -856,7 +1062,7 @@ var TelescopeClient = class {
 			hasBody: options.body != null
 		});
 		try {
-			const url = `${this.baseUrl}${path}`;
+			const url = buildApiUrl(this.baseUrl, path);
 			const headers = new Headers(options.headers || {});
 			if (!headers.has("Content-Type") && options.body != null) headers.set("Content-Type", "application/json");
 			headers.set("Authorization", `Bearer ${this.apiKey}`);
@@ -1010,13 +1216,14 @@ var TelescopeClient = class {
 			if (session.status.phase === "pending") abortController.abort(/* @__PURE__ */ new Error(`Stream connection timed out after ${connectionTimeout}ms`));
 		}, connectionTimeout);
 		try {
-			await fetchEventSource(`${this.baseUrl}${path}`, {
+			await fetchEventSource(buildApiUrl(this.baseUrl, path), {
 				method: "POST",
 				body: JSON.stringify(body ?? {}),
 				headers: {
 					...DEFAULT_JSON_HEADERS,
 					Accept: "text/event-stream",
-					Authorization: `Bearer ${this.apiKey}`
+					Authorization: `Bearer ${this.apiKey}`,
+					...options.headers
 				},
 				signal: abortController.signal,
 				openWhenHidden: true,
@@ -1095,6 +1302,10 @@ function combineSignals(...signals) {
 	}
 	return controller.signal;
 }
+function buildApiUrl(baseUrl, path) {
+	const normalizedBase = baseUrl.endsWith("/") ? baseUrl : `${baseUrl}/`;
+	return new URL(path, normalizedBase).toString();
+}
 /**
 * Safely get an environment variable in Node.js/Bun runtimes.
 * Returns undefined in browser environments.
@@ -1108,5 +1319,5 @@ function isBrowser() {
 }
 
 //#endregion
-export { TokenError as _, InsightsClient as a, isArrayIndex as c, processSSEStream as d, ApiError as f, TelescopeClientError as g, StreamingError as h, init_client as i, parseEvent as l, SSEError as m, VERSION as n, init_client$1 as o, NetworkError as p, AtlasClient as r, StreamSession as s, TelescopeClient as t, pathToKey as u, init_errors as v };
-//# sourceMappingURL=client-QPIC24Zs.mjs.map
+export { StreamingError as _, AtlasClient as a, init_errors as b, init_client$2 as c, parseEvent as d, pathToKey as f, SSEError as g, NetworkError as h, init_client as i, StreamSession as l, ApiError as m, VERSION as n, init_client$1 as o, processSSEStream as p, NewsClient as r, InsightsClient as s, TelescopeClient as t, isArrayIndex as u, TelescopeClientError as v, TokenError as y };
+//# sourceMappingURL=client-CLPQRhxT.mjs.map