@cubos/agent-sdk 0.0.1148891 → 0.0.1149194

package/dist/admin/agents.d.ts

@@ -192,6 +192,16 @@ export declare function agentsApi(t: Transport, tenantSlug: string): {
     addTaskTemplate: (agentSlug: string, templateSlug: string) => Promise<void>;
     removeTaskTemplate: (agentSlug: string, templateSlug: string) => Promise<void>;
     replaceTaskTemplateRoles: (agentSlug: string, templateSlug: string, roleSlugs: string[]) => Promise<void>;
+    listKnowledgeBases: (agentSlug: string, signal?: AbortSignal) => Promise<{
+        created_at: string;
+        display_name: string;
+        id: string;
+        pending_count: number;
+        slug: string;
+        updated_at: string;
+    }[]>;
+    attachKnowledgeBase: (agentSlug: string, kbSlug: string) => Promise<void>;
+    detachKnowledgeBase: (agentSlug: string, kbSlug: string) => Promise<void>;
     listAutoCallTools: (agentSlug: string, signal?: AbortSignal) => Promise<{
         available: import("../generated/schema.js").components["schemas"]["AutoCallableTool"][];
         enabled_mcp_count: number;

package/dist/generated/schema.d.ts

@@ -1354,6 +1354,173 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/api/v1/tenants/{tenantSlug}/agents/{agentSlug}/knowledge-bases": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * List an agent's knowledge bases
+         * @description Lists the knowledge bases attached to the agent. These reach every conversation the agent runs, read-only: conversation material is never filed into a base reached only through its agent.
+         */
+        get: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    /** @description Agent slug. */
+                    agentSlug: string;
+                    /** @description Tenant slug. */
+                    tenantSlug: string;
+                };
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["KnowledgeBaseListItem"][];
+                    };
+                };
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+                403: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/v1/tenants/{tenantSlug}/agents/{agentSlug}/knowledge-bases/{kbSlug}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        /**
+         * Attach a knowledge base to an agent
+         * @description Attaches a knowledge base to the agent so every conversation it runs searches it. Read-only from those conversations: `memory_write` files into a base only when it is also attached to the conversation or its user. Idempotent; takes effect on each conversation's next turn.
+         */
+        put: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    /** @description Agent slug. */
+                    agentSlug: string;
+                    /** @description Knowledge base slug. */
+                    kbSlug: string;
+                    /** @description Tenant slug. */
+                    tenantSlug: string;
+                };
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                204: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+                403: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+            };
+        };
+        post?: never;
+        /**
+         * Detach a knowledge base from an agent
+         * @description Stops the agent's conversations from searching the knowledge base through the agent. Links to a conversation or a user are untouched.
+         */
+        delete: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    /** @description Agent slug. */
+                    agentSlug: string;
+                    /** @description Knowledge base slug. */
+                    kbSlug: string;
+                    /** @description Tenant slug. */
+                    tenantSlug: string;
+                };
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                204: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+                403: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+            };
+        };
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/api/v1/tenants/{tenantSlug}/agents/{agentSlug}/mcps": {
         parameters: {
             query?: never;
@@ -5632,7 +5799,7 @@ export interface paths {
         };
         /**
          * List a conversation's knowledge bases
-         * @description Lists the knowledge bases this conversation searches — those attached to the conversation directly plus those attached to its user. Deduplicated.
+         * @description Lists the knowledge bases this conversation searches — those attached to the conversation directly plus those attached to its user or to its agent. Deduplicated.
          */
         get: {
             parameters: {

package/dist/index.js

@@ -88,186 +88,11 @@ function parseRetryAfter(header) {
   return Math.max(0, date - Date.now());
 }
 
-// src/sse.ts
-var MAX_BACKOFF_MS = 30000;
-var DEFAULT_IDLE_TIMEOUT_MS = 30000;
-
-class Fatal extends Error {
-  cause;
-  constructor(cause) {
-    super("fatal stream error");
-    this.cause = cause;
-  }
-}
-
-class SseIdleTimeout extends Error {
-  constructor(url, ms) {
-    super(`Stream ${url} sent nothing for ${ms}ms — reconnecting.`);
-    this.name = "SseIdleTimeout";
-  }
-}
-async function readSse(opts) {
-  const doFetch = opts.fetchImpl ?? globalThis.fetch;
-  const idleMs = opts.idleTimeoutMs ?? DEFAULT_IDLE_TIMEOUT_MS;
-  const cursor = opts.cursor ?? { lastEventId: opts.lastEventId };
-  let attempt = 0;
-  let refreshing = false;
-  while (!opts.signal.aborted) {
-    let madeProgress = false;
-    let retryAfterMs = null;
-    const connection = new AbortController;
-    const unlink = forward(opts.signal, connection);
-    let idleTimer;
-    let wentIdle = false;
-    const armIdle = () => {
-      if (idleMs <= 0)
-        return;
-      clearTimeout(idleTimer);
-      idleTimer = setTimeout(() => {
-        wentIdle = true;
-        connection.abort();
-      }, idleMs);
-    };
-    try {
-      const headers = {
-        ...await opts.headers?.({ forceRefresh: refreshing }),
-        Accept: "text/event-stream"
-      };
-      if (cursor.lastEventId !== undefined)
-        headers["Last-Event-ID"] = cursor.lastEventId;
-      armIdle();
-      const res = await doFetch(opts.url, { headers, signal: connection.signal });
-      if (opts.signal.aborted)
-        return;
-      if (res.ok && res.body) {
-        refreshing = false;
-        opts.onOpen?.();
-      }
-      if (!res.ok || !res.body) {
-        if (res.status === 401 && opts.headers && !refreshing) {
-          refreshing = true;
-          continue;
-        }
-        if (res.status === 429) {
-          retryAfterMs = Math.min(MAX_BACKOFF_MS, parseRetryAfter(res.headers.get("retry-after")) ?? MAX_BACKOFF_MS);
-          await raiseForStatus(res, `Could not open ${opts.url}.`);
-        }
-        if (res.status >= 400 && res.status < 500) {
-          await raiseForStatus(res, `Could not open ${opts.url}.`).catch((err) => {
-            throw new Fatal(err);
-          });
-          return;
-        }
-        throw new Error(`stream open failed with HTTP ${res.status}`);
-      }
-      for await (const frame of frames(res.body, connection.signal, armIdle)) {
-        const parsed = parseFrame(frame, opts.event);
-        if (parsed === null)
-          continue;
-        if (parsed.id !== null)
-          cursor.lastEventId = parsed.id;
-        opts.onEvent(parsed.data, parsed.event);
-        madeProgress = true;
-      }
-      if (wentIdle)
-        throw new SseIdleTimeout(opts.url, idleMs);
-    } catch (err) {
-      if (opts.signal.aborted)
-        return;
-      if (err instanceof Fatal)
-        throw err.cause;
-      opts.onError?.(wentIdle ? new SseIdleTimeout(opts.url, idleMs) : err);
-    } finally {
-      clearTimeout(idleTimer);
-      unlink();
-      connection.abort();
-      opts.onClose?.();
-    }
-    if (opts.signal.aborted)
-      return;
-    if (madeProgress)
-      attempt = 0;
-    const delayMs = retryAfterMs ?? Math.min(MAX_BACKOFF_MS, 1000 * 2 ** attempt);
-    attempt += 1;
-    await sleep(delayMs, opts.signal);
-  }
-}
-async function* frames(body, signal, onRead) {
-  const reader = body.getReader();
-  const decoder = new TextDecoder;
-  let buffer = "";
-  try {
-    while (!signal.aborted) {
-      const { value, done } = await reader.read();
-      if (done)
-        return;
-      onRead();
-      buffer += decoder.decode(value, { stream: true });
-      for (;; ) {
-        const sep = buffer.indexOf(`
-
-`);
-        if (sep === -1)
-          break;
-        yield buffer.slice(0, sep);
-        buffer = buffer.slice(sep + 2);
-      }
-    }
-  } finally {
-    reader.cancel().catch(() => {});
-  }
-}
-function parseFrame(frame, expectedEvent) {
-  let dataLine = null;
-  let id = null;
-  let eventName = "message";
-  for (const line of frame.split(`
-`)) {
-    if (line.startsWith(":"))
-      continue;
-    if (line.startsWith("data:"))
-      dataLine = line.slice(5).trimStart();
-    else if (line.startsWith("event:"))
-      eventName = line.slice(6).trim();
-    else if (line.startsWith("id:"))
-      id = line.slice(3).trim();
-  }
-  const wanted = typeof expectedEvent === "string" ? eventName === expectedEvent : expectedEvent.includes(eventName);
-  if (!wanted || dataLine === null)
-    return null;
-  try {
-    return { data: JSON.parse(dataLine), id, event: eventName };
-  } catch {
-    return null;
-  }
-}
-function sleep(ms, signal) {
-  return new Promise((resolve) => {
-    const onAbort = () => {
-      clearTimeout(timer);
-      resolve();
-    };
-    const timer = setTimeout(() => {
-      signal.removeEventListener("abort", onAbort);
-      resolve();
-    }, ms);
-    signal.addEventListener("abort", onAbort, { once: true });
-  });
-}
-function forward(outer, child) {
-  const onAbort = () => child.abort();
-  if (outer.aborted)
-    child.abort();
-  else
-    outer.addEventListener("abort", onAbort, { once: true });
-  return () => outer.removeEventListener("abort", onAbort);
-}
-
 // src/http.ts
 var DEFAULT_TIMEOUT_MS = 30000;
 var DEFAULT_MAX_RETRIES = 2;
 var MAX_RETRY_WAIT_MS = 20000;
-function sleep2(ms, signal) {
+function sleep(ms, signal) {
   return new Promise((resolve, reject) => {
     if (signal?.aborted) {
       reject(signal.reason ?? new Error("Aborted"));
@@ -371,7 +196,7 @@ function createTransport(baseUrl, auth, fetchImpl = globalThis.fetch, timeoutMs
       if (waitMs === null || waitMs > MAX_RETRY_WAIT_MS)
         return res;
       attempt += 1;
-      await sleep2(waitMs, opts.signal);
+      await sleep(waitMs, opts.signal);
     }
   }
   return {
@@ -451,6 +276,13 @@ function agentsApi(t, tenantSlug) {
       body: { role_slugs: roleSlugs },
       raw: true
     }),
+    listKnowledgeBases: (agentSlug, signal) => t.request("GET", `${agent(agentSlug)}/knowledge-bases`, {
+      signal
+    }),
+    attachKnowledgeBase: (agentSlug, kbSlug) => t.request("PUT", `${agent(agentSlug)}/knowledge-bases/${enc(kbSlug)}`, { raw: true }),
+    detachKnowledgeBase: (agentSlug, kbSlug) => t.request("DELETE", `${agent(agentSlug)}/knowledge-bases/${enc(kbSlug)}`, {
+      raw: true
+    }),
     listAutoCallTools: (agentSlug, signal) => t.request("GET", `${agent(agentSlug)}/auto-call-tools`, {
       signal
     }),
@@ -506,6 +338,181 @@ function channelsApi(t, tenantSlug) {
   };
 }
 
+// src/sse.ts
+var MAX_BACKOFF_MS = 30000;
+var DEFAULT_IDLE_TIMEOUT_MS = 30000;
+
+class Fatal extends Error {
+  cause;
+  constructor(cause) {
+    super("fatal stream error");
+    this.cause = cause;
+  }
+}
+
+class SseIdleTimeout extends Error {
+  constructor(url, ms) {
+    super(`Stream ${url} sent nothing for ${ms}ms — reconnecting.`);
+    this.name = "SseIdleTimeout";
+  }
+}
+async function readSse(opts) {
+  const doFetch = opts.fetchImpl ?? globalThis.fetch;
+  const idleMs = opts.idleTimeoutMs ?? DEFAULT_IDLE_TIMEOUT_MS;
+  const cursor = opts.cursor ?? { lastEventId: opts.lastEventId };
+  let attempt = 0;
+  let refreshing = false;
+  while (!opts.signal.aborted) {
+    let madeProgress = false;
+    let retryAfterMs = null;
+    const connection = new AbortController;
+    const unlink = forward(opts.signal, connection);
+    let idleTimer;
+    let wentIdle = false;
+    const armIdle = () => {
+      if (idleMs <= 0)
+        return;
+      clearTimeout(idleTimer);
+      idleTimer = setTimeout(() => {
+        wentIdle = true;
+        connection.abort();
+      }, idleMs);
+    };
+    try {
+      const headers = {
+        ...await opts.headers?.({ forceRefresh: refreshing }),
+        Accept: "text/event-stream"
+      };
+      if (cursor.lastEventId !== undefined)
+        headers["Last-Event-ID"] = cursor.lastEventId;
+      armIdle();
+      const res = await doFetch(opts.url, { headers, signal: connection.signal });
+      if (opts.signal.aborted)
+        return;
+      if (res.ok && res.body) {
+        refreshing = false;
+        opts.onOpen?.();
+      }
+      if (!res.ok || !res.body) {
+        if (res.status === 401 && opts.headers && !refreshing) {
+          refreshing = true;
+          continue;
+        }
+        if (res.status === 429) {
+          retryAfterMs = Math.min(MAX_BACKOFF_MS, parseRetryAfter(res.headers.get("retry-after")) ?? MAX_BACKOFF_MS);
+          await raiseForStatus(res, `Could not open ${opts.url}.`);
+        }
+        if (res.status >= 400 && res.status < 500) {
+          await raiseForStatus(res, `Could not open ${opts.url}.`).catch((err) => {
+            throw new Fatal(err);
+          });
+          return;
+        }
+        throw new Error(`stream open failed with HTTP ${res.status}`);
+      }
+      for await (const frame of frames(res.body, connection.signal, armIdle)) {
+        const parsed = parseFrame(frame, opts.event);
+        if (parsed === null)
+          continue;
+        if (parsed.id !== null)
+          cursor.lastEventId = parsed.id;
+        opts.onEvent(parsed.data, parsed.event);
+        madeProgress = true;
+      }
+      if (wentIdle)
+        throw new SseIdleTimeout(opts.url, idleMs);
+    } catch (err) {
+      if (opts.signal.aborted)
+        return;
+      if (err instanceof Fatal)
+        throw err.cause;
+      opts.onError?.(wentIdle ? new SseIdleTimeout(opts.url, idleMs) : err);
+    } finally {
+      clearTimeout(idleTimer);
+      unlink();
+      connection.abort();
+      opts.onClose?.();
+    }
+    if (opts.signal.aborted)
+      return;
+    if (madeProgress)
+      attempt = 0;
+    const delayMs = retryAfterMs ?? Math.min(MAX_BACKOFF_MS, 1000 * 2 ** attempt);
+    attempt += 1;
+    await sleep2(delayMs, opts.signal);
+  }
+}
+async function* frames(body, signal, onRead) {
+  const reader = body.getReader();
+  const decoder = new TextDecoder;
+  let buffer = "";
+  try {
+    while (!signal.aborted) {
+      const { value, done } = await reader.read();
+      if (done)
+        return;
+      onRead();
+      buffer += decoder.decode(value, { stream: true });
+      for (;; ) {
+        const sep = buffer.indexOf(`
+
+`);
+        if (sep === -1)
+          break;
+        yield buffer.slice(0, sep);
+        buffer = buffer.slice(sep + 2);
+      }
+    }
+  } finally {
+    reader.cancel().catch(() => {});
+  }
+}
+function parseFrame(frame, expectedEvent) {
+  let dataLine = null;
+  let id = null;
+  let eventName = "message";
+  for (const line of frame.split(`
+`)) {
+    if (line.startsWith(":"))
+      continue;
+    if (line.startsWith("data:"))
+      dataLine = line.slice(5).trimStart();
+    else if (line.startsWith("event:"))
+      eventName = line.slice(6).trim();
+    else if (line.startsWith("id:"))
+      id = line.slice(3).trim();
+  }
+  const wanted = typeof expectedEvent === "string" ? eventName === expectedEvent : expectedEvent.includes(eventName);
+  if (!wanted || dataLine === null)
+    return null;
+  try {
+    return { data: JSON.parse(dataLine), id, event: eventName };
+  } catch {
+    return null;
+  }
+}
+function sleep2(ms, signal) {
+  return new Promise((resolve) => {
+    const onAbort = () => {
+      clearTimeout(timer);
+      resolve();
+    };
+    const timer = setTimeout(() => {
+      signal.removeEventListener("abort", onAbort);
+      resolve();
+    }, ms);
+    signal.addEventListener("abort", onAbort, { once: true });
+  });
+}
+function forward(outer, child) {
+  const onAbort = () => child.abort();
+  if (outer.aborted)
+    child.abort();
+  else
+    outer.addEventListener("abort", onAbort, { once: true });
+  return () => outer.removeEventListener("abort", onAbort);
+}
+
 // src/client-tools.ts
 var DEFAULT_CLAIM_TTL_SECONDS = 70;
 var SUBMIT_ATTEMPTS = 5;
@@ -1807,8 +1814,8 @@ class AgentClient {
       const call = toClientToolCall(raw);
       if (call)
         handlers.onClientToolCall?.(call);
-      for (const call2 of toToolCallArguments(raw)) {
-        streamedArgs.set(call2.toolCallId, call2.arguments);
+      for (const call of toToolCallArguments(raw)) {
+        streamedArgs.set(call.toolCallId, call.arguments);
       }
       const activity = toToolActivity(raw);
       if (activity)
@@ -1960,23 +1967,23 @@ function createUserClient(options) {
   return new AgentClient(options);
 }
 export {
-  serveClientTools,
-  readSse,
-  mergeVoiceMessages,
-  mergeToolActivities,
-  createUserClient,
-  createAdminClient,
-  SseIdleTimeout,
-  MemoryConversationCache,
-  DEFAULT_TIMEOUT_MS,
-  DEFAULT_MAX_RETRIES,
-  DEFAULT_IDLE_TIMEOUT_MS,
-  AgentNetworkError,
-  AgentError,
-  AgentConfigError,
+  AgentApiError,
   AgentClient,
-  AgentApiError
+  AgentConfigError,
+  AgentError,
+  AgentNetworkError,
+  DEFAULT_IDLE_TIMEOUT_MS,
+  DEFAULT_MAX_RETRIES,
+  DEFAULT_TIMEOUT_MS,
+  MemoryConversationCache,
+  SseIdleTimeout,
+  createAdminClient,
+  createUserClient,
+  mergeToolActivities,
+  mergeVoiceMessages,
+  readSse,
+  serveClientTools
 };
 
-//# debugId=F147527891A76CE064756E2164756E21
+//# debugId=D6ABC1088147C99C64756E2164756E21
 //# sourceMappingURL=index.js.map