@telemai/sdk 0.2.0 → 0.2.2

package/dist/index.cjs

@@ -59,7 +59,7 @@ var TimeoutError = class extends TelemError {
 };
 
 // src/version.ts
-var VERSION = "0.2.0";
+var VERSION = "0.2.2";
 
 // src/config.ts
 var DEFAULT_BASE_URL = "https://router.telem.ai";
@@ -74,6 +74,9 @@ function csvEnv(raw) {
   const items = raw.split(",").map(trimBlank).filter((item) => item !== "");
   return items.length ? items : void 0;
 }
+function intEnv(raw) {
+  return raw !== void 0 && /^\s*[+-]?\d+\s*$/.test(raw) ? Number(raw) : void 0;
+}
 function readCredentials(env) {
   try {
     const proc = globalThis.process;
@@ -150,7 +153,10 @@ function resolveConfig(options) {
       fields: opts.fields ?? csvEnv(env.TELEM_FIELDS),
       providersInclude: opts.providersInclude ?? csvEnv(env.TELEM_PROVIDERS_INCLUDE),
       providersExclude: opts.providersExclude ?? csvEnv(env.TELEM_PROVIDERS_EXCLUDE),
-      includeFullContent: opts.includeFullContent ?? (env.TELEM_FULL_CONTENT === "1" || void 0)
+      includeFullContent: opts.includeFullContent ?? (env.TELEM_FULL_CONTENT === "1" || void 0),
+      autoRouting: opts.autoRouting ?? (trimBlank(env.TELEM_AUTO_ROUTING ?? "") || void 0),
+      maxRoutingProviders: opts.maxRoutingProviders ?? intEnv(env.TELEM_MAX_ROUTING_PROVIDERS),
+      topic: opts.topic ?? (trimBlank(env.TELEM_TOPIC ?? "") || void 0)
     }
   };
 }
@@ -587,6 +593,12 @@ function searchBlock(defaults, options) {
   if (options.includeRaw !== void 0) block.include_raw = options.includeRaw;
   if (options.rerank !== void 0) block.rerank = options.rerank;
   if (includeFullContent !== void 0) block.include_full_content = includeFullContent;
+  const autoRouting = options.autoRouting ?? defaults.autoRouting;
+  if (autoRouting !== void 0) block.auto_routing = autoRouting;
+  const maxRoutingProviders = options.maxRoutingProviders ?? defaults.maxRoutingProviders;
+  if (maxRoutingProviders !== void 0) block.max_routing_providers = maxRoutingProviders;
+  const topic = options.topic ?? defaults.topic;
+  if (topic !== void 0) block.topic = topic;
   return block;
 }
 function userInput(query) {

package/dist/index.d.cts

@@ -61,6 +61,9 @@ type SearchOptions = {
     numResults?: number;
     includeRaw?: boolean;
     includeFullContent?: boolean;
+    autoRouting?: string;
+    maxRoutingProviders?: number;
+    topic?: string;
     /** Opt this request into the server's rerank stage. It is the only path where
      *  `context`, the reasoning on the last assistant entry of the lineage history
      *  (that entry only), and `goal` change result ORDER (in that precedence) —
@@ -80,7 +83,7 @@ type SearchOptions = {
 };
 /** The subset of search options that may also be set as a client default.
  *  `numResults`/`includeRaw`/`rerank`/`providerOverrides` are per-call intent only. */
-type SearchDefaults = Pick<SearchOptions, "tier" | "fields" | "providersInclude" | "providersExclude" | "includeFullContent">;
+type SearchDefaults = Pick<SearchOptions, "tier" | "fields" | "providersInclude" | "providersExclude" | "includeFullContent" | "autoRouting" | "maxRoutingProviders" | "topic">;
 type FetchOptions = {
     providers?: string[];
     inlineContent?: boolean;
@@ -264,7 +267,7 @@ declare function snapshotNodeKey(harness: string, conversationId: string, messag
 /** Stable anchor id for content a host did not assign an id to.
  *  Length-prefixed like every other key component, so concatenation stays injective. */
 declare function contentAnchor(...parts: string[]): Promise<string>;
-/** `tool_marker` from telem/integrations/_trajectory_v5.py: one tool call as the
+/** `tool_marker` from the Python SDK's _trajectory_v5.py: one tool call as the
  *  compact acting-trace marker every harness renders into history. The exporter
  *  cuts goals on `[tool telem_search:`, so the text is a contract. Compact JSON,
  *  key order kept, matches Python's `separators=(",", ":")`; an unserializable

package/dist/index.d.ts

@@ -61,6 +61,9 @@ type SearchOptions = {
     numResults?: number;
     includeRaw?: boolean;
     includeFullContent?: boolean;
+    autoRouting?: string;
+    maxRoutingProviders?: number;
+    topic?: string;
     /** Opt this request into the server's rerank stage. It is the only path where
      *  `context`, the reasoning on the last assistant entry of the lineage history
      *  (that entry only), and `goal` change result ORDER (in that precedence) —
@@ -80,7 +83,7 @@ type SearchOptions = {
 };
 /** The subset of search options that may also be set as a client default.
  *  `numResults`/`includeRaw`/`rerank`/`providerOverrides` are per-call intent only. */
-type SearchDefaults = Pick<SearchOptions, "tier" | "fields" | "providersInclude" | "providersExclude" | "includeFullContent">;
+type SearchDefaults = Pick<SearchOptions, "tier" | "fields" | "providersInclude" | "providersExclude" | "includeFullContent" | "autoRouting" | "maxRoutingProviders" | "topic">;
 type FetchOptions = {
     providers?: string[];
     inlineContent?: boolean;
@@ -264,7 +267,7 @@ declare function snapshotNodeKey(harness: string, conversationId: string, messag
 /** Stable anchor id for content a host did not assign an id to.
  *  Length-prefixed like every other key component, so concatenation stays injective. */
 declare function contentAnchor(...parts: string[]): Promise<string>;
-/** `tool_marker` from telem/integrations/_trajectory_v5.py: one tool call as the
+/** `tool_marker` from the Python SDK's _trajectory_v5.py: one tool call as the
  *  compact acting-trace marker every harness renders into history. The exporter
  *  cuts goals on `[tool telem_search:`, so the text is a contract. Compact JSON,
  *  key order kept, matches Python's `separators=(",", ":")`; an unserializable

package/dist/index.js

@@ -22,7 +22,7 @@ import {
 } from "./chunk-RYY4S5LP.js";
 
 // src/version.ts
-var VERSION = "0.2.0";
+var VERSION = "0.2.2";
 
 // src/config.ts
 var DEFAULT_BASE_URL = "https://router.telem.ai";
@@ -37,6 +37,9 @@ function csvEnv(raw) {
   const items = raw.split(",").map(trimBlank).filter((item) => item !== "");
   return items.length ? items : void 0;
 }
+function intEnv(raw) {
+  return raw !== void 0 && /^\s*[+-]?\d+\s*$/.test(raw) ? Number(raw) : void 0;
+}
 function readCredentials(env) {
   try {
     const proc = globalThis.process;
@@ -113,7 +116,10 @@ function resolveConfig(options) {
       fields: opts.fields ?? csvEnv(env.TELEM_FIELDS),
       providersInclude: opts.providersInclude ?? csvEnv(env.TELEM_PROVIDERS_INCLUDE),
       providersExclude: opts.providersExclude ?? csvEnv(env.TELEM_PROVIDERS_EXCLUDE),
-      includeFullContent: opts.includeFullContent ?? (env.TELEM_FULL_CONTENT === "1" || void 0)
+      includeFullContent: opts.includeFullContent ?? (env.TELEM_FULL_CONTENT === "1" || void 0),
+      autoRouting: opts.autoRouting ?? (trimBlank(env.TELEM_AUTO_ROUTING ?? "") || void 0),
+      maxRoutingProviders: opts.maxRoutingProviders ?? intEnv(env.TELEM_MAX_ROUTING_PROVIDERS),
+      topic: opts.topic ?? (trimBlank(env.TELEM_TOPIC ?? "") || void 0)
     }
   };
 }
@@ -222,6 +228,12 @@ function searchBlock(defaults, options) {
   if (options.includeRaw !== void 0) block.include_raw = options.includeRaw;
   if (options.rerank !== void 0) block.rerank = options.rerank;
   if (includeFullContent !== void 0) block.include_full_content = includeFullContent;
+  const autoRouting = options.autoRouting ?? defaults.autoRouting;
+  if (autoRouting !== void 0) block.auto_routing = autoRouting;
+  const maxRoutingProviders = options.maxRoutingProviders ?? defaults.maxRoutingProviders;
+  if (maxRoutingProviders !== void 0) block.max_routing_providers = maxRoutingProviders;
+  const topic = options.topic ?? defaults.topic;
+  if (topic !== void 0) block.topic = topic;
   return block;
 }
 function userInput(query) {

package/dist/vercel/index.cjs

@@ -473,6 +473,10 @@ var SEARCH_SCHEMA = (0, import_ai.jsonSchema)({
     context: {
       type: "string",
       description: "Two or three sentences of your reasoning: what you want to find out and why, given what you already know. Not a restatement of the query."
+    },
+    topic: {
+      type: "string",
+      description: "Optional. Set it only when the answer must come from one site: linkedin, reddit, or x (twitter is also accepted). Leave it unset otherwise."
     }
   },
   required: ["query"],
@@ -563,7 +567,7 @@ function createTelemVercelAgent(options) {
     const opts = { ...searchOptions ?? {}, signal: signalFor(execution, searchOptions?.signal) };
     const { envelope, plan } = await lineage(execution, {
       name: SEARCH_TOOL,
-      input: { query, goal: opts.goal, context: opts.context }
+      input: { query, goal: opts.goal, context: opts.context, topic: opts.topic }
     });
     const response = await state.sendWithOmissionRetry(
       plan,
@@ -622,7 +626,12 @@ function createTelemVercelAgent(options) {
     telem_search: {
       description: "Search the public web. One query per call; returns the top results with provider, title, url and summary. Use telem_fetch to read a page in full.",
       inputSchema: SEARCH_SCHEMA,
-      execute: async (input, execution) => renderSearch(await search(input.query, { goal: input.goal, context: input.context }, execution))
+      execute: async (input, execution) => {
+        const topic = input.topic?.trim() || void 0;
+        return renderSearch(
+          await search(input.query, { goal: input.goal, context: input.context, topic }, execution)
+        );
+      }
     },
     telem_fetch: {
       description: "Read the text of one web page by URL. telem_search returns snippets; this returns the page.",

package/dist/vercel/index.d.cts

@@ -141,6 +141,7 @@ type TelemVercelSearchInput = {
     query: string;
     goal?: string;
     context?: string;
+    topic?: string;
 };
 type TelemVercelFetchInput = {
     url: string;
@@ -238,11 +239,7 @@ type TelemVercelTools<T extends Record<string, TelemVercelToolLike>> = T & Telem
  *
  * @example
  * ```ts
- * const delegate = tool({
- *   description: "Research one question.",
- *   inputSchema: z.object({ brief: z.string() }),
- *   execute: async ({ brief }): Promise<string> => (await generateText({ model, tools, prompt: brief })).text,
- * })
+ * // `delegate` is a tool of yours whose execute starts another generateText with the same `tools`.
  * const tools = createTelemVercelTools({ telem, harness: "my-app", tools: { delegate } })
  * await generateText({ model, tools, prompt })
  * ```

package/dist/vercel/index.d.ts

@@ -141,6 +141,7 @@ type TelemVercelSearchInput = {
     query: string;
     goal?: string;
     context?: string;
+    topic?: string;
 };
 type TelemVercelFetchInput = {
     url: string;
@@ -238,11 +239,7 @@ type TelemVercelTools<T extends Record<string, TelemVercelToolLike>> = T & Telem
  *
  * @example
  * ```ts
- * const delegate = tool({
- *   description: "Research one question.",
- *   inputSchema: z.object({ brief: z.string() }),
- *   execute: async ({ brief }): Promise<string> => (await generateText({ model, tools, prompt: brief })).text,
- * })
+ * // `delegate` is a tool of yours whose execute starts another generateText with the same `tools`.
  * const tools = createTelemVercelTools({ telem, harness: "my-app", tools: { delegate } })
  * await generateText({ model, tools, prompt })
  * ```

package/dist/vercel/index.js

@@ -311,6 +311,10 @@ var SEARCH_SCHEMA = jsonSchema({
     context: {
       type: "string",
       description: "Two or three sentences of your reasoning: what you want to find out and why, given what you already know. Not a restatement of the query."
+    },
+    topic: {
+      type: "string",
+      description: "Optional. Set it only when the answer must come from one site: linkedin, reddit, or x (twitter is also accepted). Leave it unset otherwise."
     }
   },
   required: ["query"],
@@ -401,7 +405,7 @@ function createTelemVercelAgent(options) {
     const opts = { ...searchOptions ?? {}, signal: signalFor(execution, searchOptions?.signal) };
     const { envelope, plan } = await lineage(execution, {
       name: SEARCH_TOOL,
-      input: { query, goal: opts.goal, context: opts.context }
+      input: { query, goal: opts.goal, context: opts.context, topic: opts.topic }
     });
     const response = await state.sendWithOmissionRetry(
       plan,
@@ -460,7 +464,12 @@ function createTelemVercelAgent(options) {
     telem_search: {
       description: "Search the public web. One query per call; returns the top results with provider, title, url and summary. Use telem_fetch to read a page in full.",
       inputSchema: SEARCH_SCHEMA,
-      execute: async (input, execution) => renderSearch(await search(input.query, { goal: input.goal, context: input.context }, execution))
+      execute: async (input, execution) => {
+        const topic = input.topic?.trim() || void 0;
+        return renderSearch(
+          await search(input.query, { goal: input.goal, context: input.context, topic }, execution)
+        );
+      }
     },
     telem_fetch: {
       description: "Read the text of one web page by URL. telem_search returns snippets; this returns the page.",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@telemai/sdk",
-  "version": "0.2.0",
+  "version": "0.2.2",
   "description": "Telem web search and fetch for JavaScript and TypeScript.",
   "type": "module",
   "license": "Apache-2.0",