@telemai/sdk 0.2.3 → 0.2.4

package/dist/index.cjs

@@ -59,7 +59,7 @@ var TimeoutError = class extends TelemError {
 };
 
 // src/version.ts
-var VERSION = "0.2.3";
+var VERSION = "0.2.4";
 
 // src/config.ts
 var DEFAULT_BASE_URL = "https://router.telem.ai";
@@ -599,8 +599,13 @@ function searchBlock(defaults, options) {
   if (maxRoutingProviders !== void 0) block.max_routing_providers = maxRoutingProviders;
   const topic = options.topic ?? defaults.topic;
   if (topic !== void 0) block.topic = topic;
+  if (options.publishedAfter !== void 0) block.published_after = isoDate(options.publishedAfter);
+  if (options.publishedBefore !== void 0) block.published_before = isoDate(options.publishedBefore);
   return block;
 }
+function isoDate(value) {
+  return typeof value === "string" ? value : value.toISOString();
+}
 function userInput(query) {
   if (typeof query === "string") {
     if (query === "") throw invalidRequest("search() requires a non-empty query");

package/dist/index.d.cts

@@ -64,6 +64,14 @@ type SearchOptions = {
     autoRouting?: string;
     maxRoutingProviders?: number;
     topic?: string;
+    /** Only results published on or after this date or date-time: an ISO 8601 string
+     *  (no time zone means UTC) or a `Date`. Results with no known date are kept.
+     *  Per-call only, like the two below. */
+    publishedAfter?: string | Date;
+    /** Only results published before this date or date-time. A date with no time
+     *  includes that whole day. A `Date` is an exact instant; pass a "YYYY-MM-DD"
+     *  string to include the whole day. */
+    publishedBefore?: string | Date;
     /** 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) —

package/dist/index.d.ts

@@ -64,6 +64,14 @@ type SearchOptions = {
     autoRouting?: string;
     maxRoutingProviders?: number;
     topic?: string;
+    /** Only results published on or after this date or date-time: an ISO 8601 string
+     *  (no time zone means UTC) or a `Date`. Results with no known date are kept.
+     *  Per-call only, like the two below. */
+    publishedAfter?: string | Date;
+    /** Only results published before this date or date-time. A date with no time
+     *  includes that whole day. A `Date` is an exact instant; pass a "YYYY-MM-DD"
+     *  string to include the whole day. */
+    publishedBefore?: string | Date;
     /** 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) —

package/dist/index.js

@@ -22,7 +22,7 @@ import {
 } from "./chunk-RYY4S5LP.js";
 
 // src/version.ts
-var VERSION = "0.2.3";
+var VERSION = "0.2.4";
 
 // src/config.ts
 var DEFAULT_BASE_URL = "https://router.telem.ai";
@@ -234,8 +234,13 @@ function searchBlock(defaults, options) {
   if (maxRoutingProviders !== void 0) block.max_routing_providers = maxRoutingProviders;
   const topic = options.topic ?? defaults.topic;
   if (topic !== void 0) block.topic = topic;
+  if (options.publishedAfter !== void 0) block.published_after = isoDate(options.publishedAfter);
+  if (options.publishedBefore !== void 0) block.published_before = isoDate(options.publishedBefore);
   return block;
 }
+function isoDate(value) {
+  return typeof value === "string" ? value : value.toISOString();
+}
 function userInput(query) {
   if (typeof query === "string") {
     if (query === "") throw invalidRequest("search() requires a non-empty query");

package/dist/vercel/index.cjs

@@ -452,7 +452,10 @@ async function turnAnchor(messages, windowId) {
   return await contentAnchor(String(messages.length), windowId, text);
 }
 function compact(response) {
-  return response.results.slice(0, RESULT_CAP).map(({ provider, title, url, summary }) => ({ provider, title, url, summary }));
+  return response.results.slice(0, RESULT_CAP).map(({ provider, title, url, summary, publishDate }) => {
+    const published = publishDate?.trim();
+    return published ? { provider, title, url, summary, published } : { provider, title, url, summary };
+  });
 }
 function page(response) {
   const first = response.results[0];
@@ -477,6 +480,14 @@ var SEARCH_SCHEMA = (0, import_ai.jsonSchema)({
     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."
+    },
+    published_after: {
+      type: "string",
+      description: "Optional. Only return results published on or after this date or date-time, in ISO 8601 (for example 2026-10-01 or 2026-10-01T09:00:00Z). A value with no time zone is read as UTC. Results with no known publication date are kept. Set it only when the task needs sources from a time period; leave it unset otherwise."
+    },
+    published_before: {
+      type: "string",
+      description: "Optional. Only return results published before this date or date-time, in ISO 8601. A value with no time zone is read as UTC, and a date with no time includes that whole day. Results with no known publication date are kept. Set it only when the task needs sources from a time period; leave it unset otherwise."
     }
   },
   required: ["query"],
@@ -567,7 +578,14 @@ 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, topic: opts.topic }
+      input: {
+        query,
+        goal: opts.goal,
+        context: opts.context,
+        topic: opts.topic,
+        published_after: opts.publishedAfter,
+        published_before: opts.publishedBefore
+      }
     });
     const response = await state.sendWithOmissionRetry(
       plan,
@@ -624,12 +642,18 @@ function createTelemVercelAgent(options) {
   }
   const tools = {
     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.",
+      description: "Search the public web. One query per call; returns the top results with provider, title, url, summary and, when known, publication date. Use telem_fetch to read a page in full.",
       inputSchema: SEARCH_SCHEMA,
       execute: async (input, execution) => {
         const topic = input.topic?.trim() || void 0;
+        const publishedAfter = input.published_after?.trim() || void 0;
+        const publishedBefore = input.published_before?.trim() || void 0;
         return renderSearch(
-          await search(input.query, { goal: input.goal, context: input.context, topic }, execution)
+          await search(
+            input.query,
+            { goal: input.goal, context: input.context, topic, publishedAfter, publishedBefore },
+            execution
+          )
         );
       }
     },

package/dist/vercel/index.d.cts

@@ -142,17 +142,21 @@ type TelemVercelSearchInput = {
     goal?: string;
     context?: string;
     topic?: string;
+    published_after?: string;
+    published_before?: string;
 };
 type TelemVercelFetchInput = {
     url: string;
     goal?: string;
 };
-/** The default `render.search`: the top results, compact. */
+/** The default `render.search`: the top results, compact. `published` is there only
+ *  when the result has a publication date. */
 type TelemVercelSearchOutput = Array<{
     provider: string;
     title: string;
     url: string;
     summary: string | null;
+    published?: string;
 }>;
 /** The default `render.fetch`: one page's status, error and text. */
 type TelemVercelFetchOutput = {

package/dist/vercel/index.d.ts

@@ -142,17 +142,21 @@ type TelemVercelSearchInput = {
     goal?: string;
     context?: string;
     topic?: string;
+    published_after?: string;
+    published_before?: string;
 };
 type TelemVercelFetchInput = {
     url: string;
     goal?: string;
 };
-/** The default `render.search`: the top results, compact. */
+/** The default `render.search`: the top results, compact. `published` is there only
+ *  when the result has a publication date. */
 type TelemVercelSearchOutput = Array<{
     provider: string;
     title: string;
     url: string;
     summary: string | null;
+    published?: string;
 }>;
 /** The default `render.fetch`: one page's status, error and text. */
 type TelemVercelFetchOutput = {

package/dist/vercel/index.js

@@ -290,7 +290,10 @@ async function turnAnchor(messages, windowId) {
   return await contentAnchor(String(messages.length), windowId, text);
 }
 function compact(response) {
-  return response.results.slice(0, RESULT_CAP).map(({ provider, title, url, summary }) => ({ provider, title, url, summary }));
+  return response.results.slice(0, RESULT_CAP).map(({ provider, title, url, summary, publishDate }) => {
+    const published = publishDate?.trim();
+    return published ? { provider, title, url, summary, published } : { provider, title, url, summary };
+  });
 }
 function page(response) {
   const first = response.results[0];
@@ -315,6 +318,14 @@ var SEARCH_SCHEMA = jsonSchema({
     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."
+    },
+    published_after: {
+      type: "string",
+      description: "Optional. Only return results published on or after this date or date-time, in ISO 8601 (for example 2026-10-01 or 2026-10-01T09:00:00Z). A value with no time zone is read as UTC. Results with no known publication date are kept. Set it only when the task needs sources from a time period; leave it unset otherwise."
+    },
+    published_before: {
+      type: "string",
+      description: "Optional. Only return results published before this date or date-time, in ISO 8601. A value with no time zone is read as UTC, and a date with no time includes that whole day. Results with no known publication date are kept. Set it only when the task needs sources from a time period; leave it unset otherwise."
     }
   },
   required: ["query"],
@@ -405,7 +416,14 @@ 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, topic: opts.topic }
+      input: {
+        query,
+        goal: opts.goal,
+        context: opts.context,
+        topic: opts.topic,
+        published_after: opts.publishedAfter,
+        published_before: opts.publishedBefore
+      }
     });
     const response = await state.sendWithOmissionRetry(
       plan,
@@ -462,12 +480,18 @@ function createTelemVercelAgent(options) {
   }
   const tools = {
     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.",
+      description: "Search the public web. One query per call; returns the top results with provider, title, url, summary and, when known, publication date. Use telem_fetch to read a page in full.",
       inputSchema: SEARCH_SCHEMA,
       execute: async (input, execution) => {
         const topic = input.topic?.trim() || void 0;
+        const publishedAfter = input.published_after?.trim() || void 0;
+        const publishedBefore = input.published_before?.trim() || void 0;
         return renderSearch(
-          await search(input.query, { goal: input.goal, context: input.context, topic }, execution)
+          await search(
+            input.query,
+            { goal: input.goal, context: input.context, topic, publishedAfter, publishedBefore },
+            execution
+          )
         );
       }
     },

package/package.json

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