@telemai/sdk 0.4.0 → 0.5.0

package/README.md

@@ -207,30 +207,35 @@ results of each search step.
 
 ## Monitors
 
-A monitor runs a query on a schedule. Poll it to get the results that are new since
-your last poll. `poll` returns a `SearchResponse`:
+A monitor runs a query on a schedule, and its agent checks every result against the
+query and keeps the ones that match. A monitor has the agent unless you create it with
+`agent: false`, and a monitor with the agent needs a `ttl`, at most `"30d"`: without
+one, `create` throws a `TelemError` with the code `invalid_request`.
 
 ```ts
-const monitor = await telem.monitors.create("Nvidia files a new 8-K with the SEC", { frequency: "1h", ttl: "7d" })
-const response = await telem.monitors.poll(monitor.id)
+const monitor = await telem.monitors.create("Nvidia files a new 8-K with the SEC", { frequency: "1h", ttl: "30d" })
+console.log(monitor.agentState?.status) // what its agent does: compiling, then ready
 for await (const change of telem.monitors.iterateChanges(monitor.id)) {
   console.log(change.seq, change.kind, change.subject.name)
 }
+const agent = await telem.monitors.agent(monitor.id)
 await telem.monitors.update(monitor.id, { status: "paused" })
+await telem.monitors.update(monitor.id, { ttl: "30d" }) // renew: it ends 30 days from now
 await telem.monitors.delete(monitor.id)
 ```
 
-A monitor has an agent unless you create it with `agent: false`. The agent checks every
-result against the query and keeps the ones that match. `iterateChanges` reads what it
-kept, oldest first, until you are caught up, and then stops. Keep the `seq` of the last
-change you handled and pass it as `cursor` next time: no change comes twice, and none
-is skipped. `changes` returns one page (`nextCursor`, `watermark`) and takes
-`cursor`, `since`, `kinds` and `limit`. `agent` returns the agent itself: its status,
-query, frequency and plan version. `monitor.agentState` shows it on the monitor. Read
-`iterateChanges` with `for await`.
+`iterateChanges` reads what the agent kept, oldest first, until you are caught up,
+and then stops. Keep the `seq` of the last change you handled and pass it as `cursor`
+next time: no change comes twice, and none is skipped. `changes` returns one page
+(`nextCursor`, `watermark`) and takes `cursor`, `since`, `kinds` and `limit`. `agent`
+returns the agent itself: its status, query, frequency and plan version.
+`monitor.agentState` shows it on the monitor; when the agent did not start, the
+create's `monitor.agentNote` says why. Read `iterateChanges` with `for await`.
 
-`telem.monitors` also has `get` and `list`. See [Monitors](https://docs.telem.ai/resources/monitors/)
-for the fields and the errors.
+`telem.monitors` also has `get` and `list`. `poll` is deprecated and warns once:
+read the agent's changes with `iterateChanges` instead.
+See [Monitors](https://docs.telem.ai/resources/monitors/) for the fields, the errors and
+the older reads.
 
 ## Vercel AI SDK
 
@@ -381,7 +386,7 @@ try {
 
 | Situation | Result |
 |---|---|
-| Bad input (empty query, empty URL list) | `TelemError`, `code: "invalid_request"`, nothing sent |
+| Bad input (empty query, empty URL list, a monitor with an agent and no `ttl`) | `TelemError`, `code: "invalid_request"`, nothing sent |
 | Network failure | `TelemError`, `code: "connection_error"`, after the retries |
 | 5xx or 429 | Retried with backoff (`Retry-After` applies), then `TelemError` with the status |
 | Other 4xx | `TelemError` with the status and the code from the server, not retried |

package/dist/index.cjs

@@ -60,7 +60,7 @@ var TimeoutError = class extends TelemError {
 };
 
 // src/version.ts
-var VERSION = "0.4.0";
+var VERSION = "0.5.0";
 
 // src/config.ts
 var DEFAULT_BASE_URL = "https://router.telem.ai";
@@ -726,6 +726,14 @@ async function search(config, query, options) {
 }
 
 // src/methods/monitors.ts
+var NEEDS_TTL = 'A monitor with an agent must end: pass ttl, such as ttl: "30d" (at most 30 days), or agent: false for a monitor without an agent.';
+var POLL_DEPRECATED = "@telemai/sdk: monitors.poll() is deprecated: read what the monitor agent finds with monitors.iterateChanges() or monitors.changes().";
+var pollWarned = false;
+function warnPollDeprecated() {
+  if (pollWarned) return;
+  pollWarned = true;
+  console.warn(POLL_DEPRECATED);
+}
 function agentStateFrom(data) {
   return {
     engine: String(data.engine ?? ""),
@@ -755,6 +763,7 @@ function monitorFrom(body) {
     expiresAt: data.expires_at ?? null,
     webhookUrl: data.webhook_url ?? null,
     webhookSecret: data.webhook_secret ?? null,
+    agentNote: typeof data.agent_note === "string" ? data.agent_note : null,
     raw: data
   };
   if (data.agent_state !== void 0) {
@@ -837,20 +846,23 @@ function createMonitors(config) {
     return changesPageFrom(await request(config, "GET", route, void 0, options.signal));
   };
   return {
-    /** Create a monitor. Telem runs `query` on the schedule. */
-    async create(query, options = {}) {
+    /** Create a monitor. Telem runs `query` on the schedule, and its agent keeps what matches. */
+    async create(query, options) {
+      const given = options ?? {};
+      const agent = given.agent == null ? true : Boolean(given.agent);
+      if (agent && !given.ttl) throw invalidRequest(NEEDS_TTL);
       const monitorOptions = {};
-      if (options.frequency !== void 0) monitorOptions.frequency = options.frequency;
-      if (options.includeDomains !== void 0) {
-        monitorOptions.include_domains = options.includeDomains;
+      if (given.frequency !== void 0) monitorOptions.frequency = given.frequency;
+      if (given.includeDomains !== void 0) {
+        monitorOptions.include_domains = given.includeDomains;
       }
-      if (options.search !== void 0) monitorOptions.search = searchBlock({}, options.search);
+      if (given.search !== void 0) monitorOptions.search = searchBlock({}, given.search);
       const body = { query, options: monitorOptions };
-      if (options.metadata !== void 0) body.metadata = options.metadata;
-      if (options.webhookUrl !== void 0) body.webhook_url = options.webhookUrl;
-      if (options.ttl !== void 0) body.ttl = options.ttl;
-      if (options.agent !== void 0) body.agent = options.agent;
-      const data = await request(config, "POST", "/v1/monitors", body, options.signal, "rate_limit").catch(
+      if (given.metadata !== void 0) body.metadata = given.metadata;
+      if (given.webhookUrl !== void 0) body.webhook_url = given.webhookUrl;
+      if (given.ttl !== void 0) body.ttl = given.ttl;
+      body.agent = agent;
+      const data = await request(config, "POST", "/v1/monitors", body, given.signal, "rate_limit").catch(
         (error) => {
           if (error instanceof TimeoutError) {
             throw new TimeoutError(
@@ -872,17 +884,20 @@ function createMonitors(config) {
     async get(monitorId, options = {}) {
       return monitorFrom(await request(config, "GET", path(monitorId), void 0, options.signal));
     },
-    /** Pause, resume or change a monitor. Only the fields given are sent. */
+    /** Pause, resume, renew or change a monitor. Only the fields given are sent. */
     async update(monitorId, options) {
       const body = {};
       if (options.status !== void 0) body.status = options.status;
       if (options.frequency !== void 0) body.frequency = options.frequency;
+      if (options.ttl !== void 0) body.ttl = options.ttl;
       if (options.webhookUrl !== void 0) body.webhook_url = options.webhookUrl || null;
       const route = path(monitorId);
       return monitorFrom(await request(config, "PATCH", route, body, options.signal));
     },
-    /** Get the results that are new since the last poll. */
+    /** Get the monitor's own results that are new since the last poll. Deprecated: it
+     *  warns once per process. */
     async poll(monitorId, options = {}) {
+      warnPollDeprecated();
       const body = {};
       if (options.session !== void 0) body.session_id = options.session;
       if (options.metadata !== void 0) body.metadata = options.metadata;
@@ -1012,8 +1027,8 @@ var Telem = class {
   maxRetries;
   /** The session read surface: `list` and `results(id)`. */
   sessions;
-  /** Monitors: `create`, `list`, `listPage`, `get`, `update`, `poll`, `delete`, and the
-   *  agent reads `agent`, `changes` and `iterateChanges`. */
+  /** Monitors: `create`, `list`, `listPage`, `get`, `update` and `delete`, the agent reads
+   *  `agent`, `changes` and `iterateChanges`, and the deprecated `poll`. */
   monitors;
   #config;
   /**

package/dist/index.d.cts

@@ -238,28 +238,41 @@ type SessionsResource = {
 };
 /** The search options a monitor can run on its schedule (`MonitorCreateOptions.search`). */
 type MonitorSearchOptions = Pick<SearchOptions, "tier" | "numResults">;
-/** Options for `monitors.create`. */
-type MonitorCreateOptions = {
+/** The options of `monitors.create` that a monitor takes with the agent or without. */
+type MonitorCreateCommonOptions = {
     /** `"1h"`, `"6h"`, `"12h"`, `"1d"` or `"7d"`. If you leave it out, the monitor runs once a day. */
     frequency?: string;
     /** Also run a web search for the query on the schedule, with these options. `{}`
-     *  uses the defaults. Client search defaults do not apply. */
+     *  uses the defaults. Client search defaults do not apply. It adds to what a poll returns. */
     search?: MonitorSearchOptions;
-    /** Only results from these sites and their subdomains, such as `["sec.gov"]`,
-     *  from every source of the monitor. */
+    /** Only results from these sites and their subdomains, such as `["sec.gov"]`, in what
+     *  a poll returns. */
     includeDomains?: string[];
-    /** Request metadata (query lineage keys), sent as given. */
+    /** Query lineage keys, sent as given. They choose the session that records the polls of
+     *  the monitor. */
     metadata?: Json;
     /** An `https` URL that receives the new results. */
     webhookUrl?: string;
-    /** Delete the monitor after this long, such as `"12h"` or `"7d"` (at most `"30d"`). Without it, the monitor never expires. */
-    ttl?: string;
-    /** Start the monitor agent with the monitor: it checks every result against the query
-     *  and keeps the ones that match. Telem turns it on when you leave this out; `false`
-     *  creates the monitor without one. Read what the agent keeps with `monitors.changes`. */
-    agent?: boolean;
     signal?: AbortSignal;
 };
+/** Options for `monitors.create`. A monitor has the agent unless `agent` is `false`,
+ *  and a monitor with the agent must end: then `ttl` is required. */
+type MonitorCreateOptions = MonitorCreateCommonOptions & ({
+    /** `false` creates a monitor without an agent, which you read with the deprecated
+     *  `monitors.poll`. */
+    agent: false;
+    /** End the monitor after this long, such as `"7d"` or `"30d"` (at most `"30d"`).
+     *  Without it, a monitor without an agent never ends. */
+    ttl?: string;
+} | {
+    /** Start the monitor agent with the monitor, the default: it checks every result
+     *  against the query and keeps the ones that match. Read what it keeps with
+     *  `monitors.iterateChanges` or `monitors.changes`. */
+    agent?: true;
+    /** End the monitor after this long, such as `"7d"` or `"30d"` (at most `"30d"`).
+     *  Required with the agent. */
+    ttl: string;
+});
 /** Options for `monitors.update`. Send at least one field. */
 type MonitorUpdateOptions = {
     /** `"paused"` or `"active"`. */
@@ -267,9 +280,13 @@ type MonitorUpdateOptions = {
     frequency?: string;
     /** A new webhook URL, with a new `webhookSecret` in the response. `null` or `""` removes it. */
     webhookUrl?: string | null;
+    /** A new end, this long from now, such as `"30d"` (at most `"30d"`). It renews a monitor
+     *  before it ends; an ended monitor cannot be renewed. */
+    ttl?: string;
     signal?: AbortSignal;
 };
-/** Options for `monitors.poll`. */
+/** Options for `monitors.poll`.
+ *  @deprecated `poll` is deprecated: read the agent with `monitors.iterateChanges`. */
 type MonitorPollOptions = {
     /** Record this poll in another session (default: the monitor's own). */
     session?: string;
@@ -295,6 +312,9 @@ type Monitor = {
     /** The monitor agent's state. `null`: the monitor has no agent. Absent when the router
      *  sends none, as a router from before the agent reads does. */
     agentState?: AgentState | null;
+    /** Only in the answer to a create: why the monitor agent did not start, or not yet.
+     *  `null` when it started, and in every other answer. */
+    agentNote: string | null;
     raw: Json;
 };
 /** The latest compile of an agent's plan (`AgentState.compile`). */
@@ -417,13 +437,19 @@ type MonitorPage = {
 };
 /** The `telem.monitors` namespace. */
 type MonitorsResource = {
-    create(query: string, options?: MonitorCreateOptions): Promise<Monitor>;
+    /** Create a monitor. It has the agent unless `agent` is `false`, and with the agent
+     *  `ttl` is required: a create without it throws a `TelemError` (`invalid_request`)
+     *  before anything is sent. */
+    create(query: string, options: MonitorCreateOptions): Promise<Monitor>;
     list(options?: MonitorListOptions): Promise<Monitor[]>;
     listPage(options?: MonitorListOptions): Promise<MonitorPage>;
     get(monitorId: string, options?: {
         signal?: AbortSignal;
     }): Promise<Monitor>;
     update(monitorId: string, options: MonitorUpdateOptions): Promise<Monitor>;
+    /** Get the monitor's own results that are new since the last poll.
+     *  @deprecated Read what the monitor agent finds with `iterateChanges` or `changes`.
+     *  A poll still works, and warns once per process with `console.warn`. */
     poll(monitorId: string, options?: MonitorPollOptions): Promise<SearchResponse>;
     delete(monitorId: string, options?: {
         signal?: AbortSignal;
@@ -579,8 +605,8 @@ declare class Telem {
     readonly maxRetries: number;
     /** The session read surface: `list` and `results(id)`. */
     readonly sessions: SessionsResource;
-    /** Monitors: `create`, `list`, `listPage`, `get`, `update`, `poll`, `delete`, and the
-     *  agent reads `agent`, `changes` and `iterateChanges`. */
+    /** Monitors: `create`, `list`, `listPage`, `get`, `update` and `delete`, the agent reads
+     *  `agent`, `changes` and `iterateChanges`, and the deprecated `poll`. */
     readonly monitors: MonitorsResource;
     /**
      * @param options - An API key string, or an options object. Anything left unset

package/dist/index.d.ts

@@ -238,28 +238,41 @@ type SessionsResource = {
 };
 /** The search options a monitor can run on its schedule (`MonitorCreateOptions.search`). */
 type MonitorSearchOptions = Pick<SearchOptions, "tier" | "numResults">;
-/** Options for `monitors.create`. */
-type MonitorCreateOptions = {
+/** The options of `monitors.create` that a monitor takes with the agent or without. */
+type MonitorCreateCommonOptions = {
     /** `"1h"`, `"6h"`, `"12h"`, `"1d"` or `"7d"`. If you leave it out, the monitor runs once a day. */
     frequency?: string;
     /** Also run a web search for the query on the schedule, with these options. `{}`
-     *  uses the defaults. Client search defaults do not apply. */
+     *  uses the defaults. Client search defaults do not apply. It adds to what a poll returns. */
     search?: MonitorSearchOptions;
-    /** Only results from these sites and their subdomains, such as `["sec.gov"]`,
-     *  from every source of the monitor. */
+    /** Only results from these sites and their subdomains, such as `["sec.gov"]`, in what
+     *  a poll returns. */
     includeDomains?: string[];
-    /** Request metadata (query lineage keys), sent as given. */
+    /** Query lineage keys, sent as given. They choose the session that records the polls of
+     *  the monitor. */
     metadata?: Json;
     /** An `https` URL that receives the new results. */
     webhookUrl?: string;
-    /** Delete the monitor after this long, such as `"12h"` or `"7d"` (at most `"30d"`). Without it, the monitor never expires. */
-    ttl?: string;
-    /** Start the monitor agent with the monitor: it checks every result against the query
-     *  and keeps the ones that match. Telem turns it on when you leave this out; `false`
-     *  creates the monitor without one. Read what the agent keeps with `monitors.changes`. */
-    agent?: boolean;
     signal?: AbortSignal;
 };
+/** Options for `monitors.create`. A monitor has the agent unless `agent` is `false`,
+ *  and a monitor with the agent must end: then `ttl` is required. */
+type MonitorCreateOptions = MonitorCreateCommonOptions & ({
+    /** `false` creates a monitor without an agent, which you read with the deprecated
+     *  `monitors.poll`. */
+    agent: false;
+    /** End the monitor after this long, such as `"7d"` or `"30d"` (at most `"30d"`).
+     *  Without it, a monitor without an agent never ends. */
+    ttl?: string;
+} | {
+    /** Start the monitor agent with the monitor, the default: it checks every result
+     *  against the query and keeps the ones that match. Read what it keeps with
+     *  `monitors.iterateChanges` or `monitors.changes`. */
+    agent?: true;
+    /** End the monitor after this long, such as `"7d"` or `"30d"` (at most `"30d"`).
+     *  Required with the agent. */
+    ttl: string;
+});
 /** Options for `monitors.update`. Send at least one field. */
 type MonitorUpdateOptions = {
     /** `"paused"` or `"active"`. */
@@ -267,9 +280,13 @@ type MonitorUpdateOptions = {
     frequency?: string;
     /** A new webhook URL, with a new `webhookSecret` in the response. `null` or `""` removes it. */
     webhookUrl?: string | null;
+    /** A new end, this long from now, such as `"30d"` (at most `"30d"`). It renews a monitor
+     *  before it ends; an ended monitor cannot be renewed. */
+    ttl?: string;
     signal?: AbortSignal;
 };
-/** Options for `monitors.poll`. */
+/** Options for `monitors.poll`.
+ *  @deprecated `poll` is deprecated: read the agent with `monitors.iterateChanges`. */
 type MonitorPollOptions = {
     /** Record this poll in another session (default: the monitor's own). */
     session?: string;
@@ -295,6 +312,9 @@ type Monitor = {
     /** The monitor agent's state. `null`: the monitor has no agent. Absent when the router
      *  sends none, as a router from before the agent reads does. */
     agentState?: AgentState | null;
+    /** Only in the answer to a create: why the monitor agent did not start, or not yet.
+     *  `null` when it started, and in every other answer. */
+    agentNote: string | null;
     raw: Json;
 };
 /** The latest compile of an agent's plan (`AgentState.compile`). */
@@ -417,13 +437,19 @@ type MonitorPage = {
 };
 /** The `telem.monitors` namespace. */
 type MonitorsResource = {
-    create(query: string, options?: MonitorCreateOptions): Promise<Monitor>;
+    /** Create a monitor. It has the agent unless `agent` is `false`, and with the agent
+     *  `ttl` is required: a create without it throws a `TelemError` (`invalid_request`)
+     *  before anything is sent. */
+    create(query: string, options: MonitorCreateOptions): Promise<Monitor>;
     list(options?: MonitorListOptions): Promise<Monitor[]>;
     listPage(options?: MonitorListOptions): Promise<MonitorPage>;
     get(monitorId: string, options?: {
         signal?: AbortSignal;
     }): Promise<Monitor>;
     update(monitorId: string, options: MonitorUpdateOptions): Promise<Monitor>;
+    /** Get the monitor's own results that are new since the last poll.
+     *  @deprecated Read what the monitor agent finds with `iterateChanges` or `changes`.
+     *  A poll still works, and warns once per process with `console.warn`. */
     poll(monitorId: string, options?: MonitorPollOptions): Promise<SearchResponse>;
     delete(monitorId: string, options?: {
         signal?: AbortSignal;
@@ -579,8 +605,8 @@ declare class Telem {
     readonly maxRetries: number;
     /** The session read surface: `list` and `results(id)`. */
     readonly sessions: SessionsResource;
-    /** Monitors: `create`, `list`, `listPage`, `get`, `update`, `poll`, `delete`, and the
-     *  agent reads `agent`, `changes` and `iterateChanges`. */
+    /** Monitors: `create`, `list`, `listPage`, `get`, `update` and `delete`, the agent reads
+     *  `agent`, `changes` and `iterateChanges`, and the deprecated `poll`. */
     readonly monitors: MonitorsResource;
     /**
      * @param options - An API key string, or an options object. Anything left unset

package/dist/index.js

@@ -22,7 +22,7 @@ import {
 } from "./chunk-SQ3ZZA72.js";
 
 // src/version.ts
-var VERSION = "0.4.0";
+var VERSION = "0.5.0";
 
 // src/config.ts
 var DEFAULT_BASE_URL = "https://router.telem.ai";
@@ -357,6 +357,14 @@ async function search(config, query, options) {
 }
 
 // src/methods/monitors.ts
+var NEEDS_TTL = 'A monitor with an agent must end: pass ttl, such as ttl: "30d" (at most 30 days), or agent: false for a monitor without an agent.';
+var POLL_DEPRECATED = "@telemai/sdk: monitors.poll() is deprecated: read what the monitor agent finds with monitors.iterateChanges() or monitors.changes().";
+var pollWarned = false;
+function warnPollDeprecated() {
+  if (pollWarned) return;
+  pollWarned = true;
+  console.warn(POLL_DEPRECATED);
+}
 function agentStateFrom(data) {
   return {
     engine: String(data.engine ?? ""),
@@ -386,6 +394,7 @@ function monitorFrom(body) {
     expiresAt: data.expires_at ?? null,
     webhookUrl: data.webhook_url ?? null,
     webhookSecret: data.webhook_secret ?? null,
+    agentNote: typeof data.agent_note === "string" ? data.agent_note : null,
     raw: data
   };
   if (data.agent_state !== void 0) {
@@ -468,20 +477,23 @@ function createMonitors(config) {
     return changesPageFrom(await request(config, "GET", route, void 0, options.signal));
   };
   return {
-    /** Create a monitor. Telem runs `query` on the schedule. */
-    async create(query, options = {}) {
+    /** Create a monitor. Telem runs `query` on the schedule, and its agent keeps what matches. */
+    async create(query, options) {
+      const given = options ?? {};
+      const agent = given.agent == null ? true : Boolean(given.agent);
+      if (agent && !given.ttl) throw invalidRequest(NEEDS_TTL);
       const monitorOptions = {};
-      if (options.frequency !== void 0) monitorOptions.frequency = options.frequency;
-      if (options.includeDomains !== void 0) {
-        monitorOptions.include_domains = options.includeDomains;
+      if (given.frequency !== void 0) monitorOptions.frequency = given.frequency;
+      if (given.includeDomains !== void 0) {
+        monitorOptions.include_domains = given.includeDomains;
       }
-      if (options.search !== void 0) monitorOptions.search = searchBlock({}, options.search);
+      if (given.search !== void 0) monitorOptions.search = searchBlock({}, given.search);
       const body = { query, options: monitorOptions };
-      if (options.metadata !== void 0) body.metadata = options.metadata;
-      if (options.webhookUrl !== void 0) body.webhook_url = options.webhookUrl;
-      if (options.ttl !== void 0) body.ttl = options.ttl;
-      if (options.agent !== void 0) body.agent = options.agent;
-      const data = await request(config, "POST", "/v1/monitors", body, options.signal, "rate_limit").catch(
+      if (given.metadata !== void 0) body.metadata = given.metadata;
+      if (given.webhookUrl !== void 0) body.webhook_url = given.webhookUrl;
+      if (given.ttl !== void 0) body.ttl = given.ttl;
+      body.agent = agent;
+      const data = await request(config, "POST", "/v1/monitors", body, given.signal, "rate_limit").catch(
         (error) => {
           if (error instanceof TimeoutError) {
             throw new TimeoutError(
@@ -503,17 +515,20 @@ function createMonitors(config) {
     async get(monitorId, options = {}) {
       return monitorFrom(await request(config, "GET", path(monitorId), void 0, options.signal));
     },
-    /** Pause, resume or change a monitor. Only the fields given are sent. */
+    /** Pause, resume, renew or change a monitor. Only the fields given are sent. */
     async update(monitorId, options) {
       const body = {};
       if (options.status !== void 0) body.status = options.status;
       if (options.frequency !== void 0) body.frequency = options.frequency;
+      if (options.ttl !== void 0) body.ttl = options.ttl;
       if (options.webhookUrl !== void 0) body.webhook_url = options.webhookUrl || null;
       const route = path(monitorId);
       return monitorFrom(await request(config, "PATCH", route, body, options.signal));
     },
-    /** Get the results that are new since the last poll. */
+    /** Get the monitor's own results that are new since the last poll. Deprecated: it
+     *  warns once per process. */
     async poll(monitorId, options = {}) {
+      warnPollDeprecated();
       const body = {};
       if (options.session !== void 0) body.session_id = options.session;
       if (options.metadata !== void 0) body.metadata = options.metadata;
@@ -643,8 +658,8 @@ var Telem = class {
   maxRetries;
   /** The session read surface: `list` and `results(id)`. */
   sessions;
-  /** Monitors: `create`, `list`, `listPage`, `get`, `update`, `poll`, `delete`, and the
-   *  agent reads `agent`, `changes` and `iterateChanges`. */
+  /** Monitors: `create`, `list`, `listPage`, `get`, `update` and `delete`, the agent reads
+   *  `agent`, `changes` and `iterateChanges`, and the deprecated `poll`. */
   monitors;
   #config;
   /**

package/package.json

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