@telemai/sdk 0.2.1 → 0.2.2

package/README.md

@@ -42,7 +42,7 @@ See [Authentication](https://docs.telem.ai/authentication/) for the full rules.
 
 ```ts
 
-const telem = new Telem          // environment, then ~/.telem/credentials.json
+const telem = new Telem()          // environment, then ~/.telem/credentials.json
 const telem = new Telem("tlm_...") // just a key
 const telem = new Telem({
   apiKey: "tlm_...",
@@ -176,7 +176,7 @@ Do not expect a shorter list. The options are on the
 List the providers the deployment can run:
 
 ```ts
-for (const provider of await telem.providers) {
+for (const provider of await telem.providers()) {
   console.log(provider.name, provider.activeByDefault, provider.tiers)
 }
 ```
@@ -187,7 +187,7 @@ Every search belongs to a session. The response carries its id as `sessionId`. R
 your sessions back to see what an agent searched for. Both methods require an API key:
 
 ```ts
-for (const session of await telem.sessions.list) {
+for (const session of await telem.sessions.list()) {
   console.log(session.id, session.interactionCount, session.latestInteractionAt)
 }
 
@@ -210,7 +210,7 @@ import { generateText } from "ai"
 import Telem from "@telemai/sdk"
 import { createTelemVercelTools } from "@telemai/sdk/vercel"
 
-const telem = new Telem
+const telem = new Telem()
 const tools = createTelemVercelTools({ telem, harness: "my-app" })
 
 const result = await generateText({ model, tools, prompt: "Is the Nintendo Museum open over New Year?" })
@@ -222,7 +222,7 @@ then appear in the console under the tool call that started it. `ai` version 5
 or later is an optional peer dependency, used by this subpath only. The full
 guide, subagents, your own tools, and the options, is on the
 [Vercel AI SDK page](https://docs.telem.ai/integrations/vercel-ai/). The runnable example is `examples/vercel-ai-agents.mjs`
-in the SDK source, first in the [examples list](https://github.com/TelemAI/telem-js-sdk/tree/main/examples).
+in the SDK source, first in the [examples list](https://github.com/TelemAI/TelemSDK/tree/main/js-sdk/examples).
 
 ## Query lineage
 
@@ -251,8 +251,8 @@ Node SDK, where the completion id is the turn and each tool call has its own id:
 
 ```ts
 
-const telem = new Telem
-const openai = new OpenAI
+const telem = new Telem()
+const openai = new OpenAI()
 const messages = [{ role: "user" as const, content: "Is the Nintendo Museum open over New Year?" }]
 const tools = [
   {
@@ -269,7 +269,7 @@ const tools = [
   },
 ]
 
-const conversationId = crypto.randomUUID     // once, when the conversation starts
+const conversationId = crypto.randomUUID()     // once, when the conversation starts
 const windowId = await windowAnchor(messages)  // once, from the first message
 
 const completion = await openai.chat.completions.create({ model: "gpt-4o", messages, tools })

package/dist/index.cjs

@@ -59,7 +59,7 @@ var TimeoutError = class extends TelemError {
 };
 
 // src/version.ts
-var VERSION = "0.2.1";
+var VERSION = "0.2.2";
 
 // src/config.ts
 var DEFAULT_BASE_URL = "https://router.telem.ai";
@@ -767,7 +767,7 @@ var Telem = class {
   timeoutMs;
   /** Resolved retry budget (attempts after the first). */
   maxRetries;
-  /** The session read surface: `list` and `results(id)`. */
+  /** The session read surface: `list()` and `results(id)`. */
   sessions;
   #config;
   /**

package/dist/index.d.cts

@@ -190,7 +190,7 @@ type ProviderInfo = {
     normalized: boolean;
     tiers: string[];
 };
-/** One session as `sessions.list` reports it. */
+/** One session as `sessions.list()` reports it. */
 type SessionSummary = {
     id: string;
     createdAt: string | null;
@@ -333,7 +333,7 @@ declare function withTrajectory(options: FetchOptions, envelope: TrajectoryEnvel
  *
  * @example
  * ```ts
- * const telem = new Telem                    // env / credentials-file resolution
+ * const telem = new Telem()                    // env / credentials-file resolution
  * const telem = new Telem("tlm_...")           // bare API-key shorthand
  * const telem = new Telem({ apiKey, baseUrl, tier: "max" })
  * ```
@@ -348,7 +348,7 @@ declare class Telem {
     readonly timeoutMs: number;
     /** Resolved retry budget (attempts after the first). */
     readonly maxRetries: number;
-    /** The session read surface: `list` and `results(id)`. */
+    /** The session read surface: `list()` and `results(id)`. */
     readonly sessions: SessionsResource;
     /**
      * @param options - An API key string, or an options object. Anything left unset

package/dist/index.d.ts

@@ -190,7 +190,7 @@ type ProviderInfo = {
     normalized: boolean;
     tiers: string[];
 };
-/** One session as `sessions.list` reports it. */
+/** One session as `sessions.list()` reports it. */
 type SessionSummary = {
     id: string;
     createdAt: string | null;
@@ -333,7 +333,7 @@ declare function withTrajectory(options: FetchOptions, envelope: TrajectoryEnvel
  *
  * @example
  * ```ts
- * const telem = new Telem                    // env / credentials-file resolution
+ * const telem = new Telem()                    // env / credentials-file resolution
  * const telem = new Telem("tlm_...")           // bare API-key shorthand
  * const telem = new Telem({ apiKey, baseUrl, tier: "max" })
  * ```
@@ -348,7 +348,7 @@ declare class Telem {
     readonly timeoutMs: number;
     /** Resolved retry budget (attempts after the first). */
     readonly maxRetries: number;
-    /** The session read surface: `list` and `results(id)`. */
+    /** The session read surface: `list()` and `results(id)`. */
     readonly sessions: SessionsResource;
     /**
      * @param options - An API key string, or an options object. Anything left unset

package/dist/index.js

@@ -22,7 +22,7 @@ import {
 } from "./chunk-RYY4S5LP.js";
 
 // src/version.ts
-var VERSION = "0.2.1";
+var VERSION = "0.2.2";
 
 // src/config.ts
 var DEFAULT_BASE_URL = "https://router.telem.ai";
@@ -402,7 +402,7 @@ var Telem = class {
   timeoutMs;
   /** Resolved retry budget (attempts after the first). */
   maxRetries;
-  /** The session read surface: `list` and `results(id)`. */
+  /** The session read surface: `list()` and `results(id)`. */
   sessions;
   #config;
   /**

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

@@ -121,7 +121,7 @@ type TelemVercelAgentOptions = {
      *  several HTTP requests must pass a stable id (the chat id), or every request
      *  becomes its own session. */
     conversationId?: string;
-    /** The root-first chain this agent hangs under; `child` fills it. */
+    /** The root-first chain this agent hangs under; `child()` fills it. */
     ancestors?: readonly TrajectorySnapshot[];
     /** `ancestors` (phase 1, the default), `history` (both phases) or `off`.
      *  Unset reads `TELEM_INCREMENTAL` per call. */
@@ -133,7 +133,7 @@ type TelemVercelAgentOptions = {
      *  without replacing a tool. A throw or a rejection here is swallowed; it
      *  never fails the call. */
     onResponse?: (event: TelemVercelCallEvent) => void | Promise<void>;
-    /** Advanced: the ledgers to share. `child` passes its parent's, so a child
+    /** Advanced: the ledgers to share. `child()` passes its parent's, so a child
      *  never re-sends what the parent already proved delivered. */
     incrementalState?: IncrementalState;
 };
@@ -141,6 +141,7 @@ type TelemVercelSearchInput = {
     query: string;
     goal?: string;
     context?: string;
+    topic?: string;
 };
 type TelemVercelFetchInput = {
     url: string;

package/dist/vercel/index.d.ts

@@ -121,7 +121,7 @@ type TelemVercelAgentOptions = {
      *  several HTTP requests must pass a stable id (the chat id), or every request
      *  becomes its own session. */
     conversationId?: string;
-    /** The root-first chain this agent hangs under; `child` fills it. */
+    /** The root-first chain this agent hangs under; `child()` fills it. */
     ancestors?: readonly TrajectorySnapshot[];
     /** `ancestors` (phase 1, the default), `history` (both phases) or `off`.
      *  Unset reads `TELEM_INCREMENTAL` per call. */
@@ -133,7 +133,7 @@ type TelemVercelAgentOptions = {
      *  without replacing a tool. A throw or a rejection here is swallowed; it
      *  never fails the call. */
     onResponse?: (event: TelemVercelCallEvent) => void | Promise<void>;
-    /** Advanced: the ledgers to share. `child` passes its parent's, so a child
+    /** Advanced: the ledgers to share. `child()` passes its parent's, so a child
      *  never re-sends what the parent already proved delivered. */
     incrementalState?: IncrementalState;
 };
@@ -141,6 +141,7 @@ type TelemVercelSearchInput = {
     query: string;
     goal?: string;
     context?: string;
+    topic?: string;
 };
 type TelemVercelFetchInput = {
     url: string;

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.1",
+  "version": "0.2.2",
   "description": "Telem web search and fetch for JavaScript and TypeScript.",
   "type": "module",
   "license": "Apache-2.0",
@@ -42,10 +42,14 @@
     "node": ">=20.16"
   },
   "scripts": {
-    "build": "tsup",
+    "pretest": "npm run build",
+    "test": "node --test 'test/**/*.test.ts'",
     "typecheck": "tsc --noEmit",
+    "gen-version": "node scripts/gen-version.mjs",
+    "prebuild": "node scripts/gen-version.mjs",
+    "build": "tsup",
     "prepack": "npm run build",
-    "test": "node scripts/smoke.mjs"
+    "smoke:vercel": "node scripts/vercel-live.mjs"
   },
   "devDependencies": {
     "@types/node": "^22.20.1",
@@ -67,13 +71,5 @@
         "./dist/vercel/index.d.ts"
       ]
     }
-  },
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/TelemAI/telem-js-sdk.git"
-  },
-  "homepage": "https://docs.telem.ai/sdks/javascript/",
-  "bugs": {
-    "url": "https://github.com/TelemAI/telem-js-sdk/issues"
   }
 }