@cubos/agent-sdk 0.0.1136563

package/dist/http.d.ts

@@ -0,0 +1,42 @@
+import type { FetchLike } from "./sse.js";
+/** Called before every request. Cache inside your own implementation if the
+ * token is expensive to mint; the SDK calls this freely. `forceRefresh` is set
+ * on the retry after a 401 — return a newly minted token, not the cached one. */
+export type TokenSource = (opts: {
+    forceRefresh: boolean;
+}) => Promise<string> | string;
+/**
+ * A long-lived api_key, or a short-lived end-user token fetched on demand.
+ *
+ * The distinction is not cosmetic: an api_key is tenant-wide and must never
+ * reach a browser, while a user token is scoped to one user and expires. The
+ * two client constructors keep them apart at the type level.
+ */
+export type Auth = {
+    apiKey: string | (() => string | Promise<string>);
+} | {
+    getToken: TokenSource;
+};
+interface RequestOptions {
+    body?: unknown;
+    query?: Record<string, string | number | boolean | undefined>;
+    signal?: AbortSignal;
+    /** Skip JSON parsing; used by endpoints that answer 204 or raw bytes. */
+    raw?: boolean;
+}
+export interface Transport {
+    request<T>(method: string, path: string, opts?: RequestOptions): Promise<T>;
+    fetchRaw(method: string, path: string, opts?: RequestOptions): Promise<Response>;
+    /** Headers for a stream connect, refreshed per (re)connect attempt. */
+    streamHeaders(): Promise<Record<string, string>>;
+    url(path: string, query?: RequestOptions["query"]): string;
+    fetchImpl: FetchLike;
+}
+/** Long enough for a slow upload on a bad connection, short enough that a hung
+ * server surfaces as an error instead of a spinner that never resolves. */
+export declare const DEFAULT_TIMEOUT_MS = 30000;
+/** How many times a 429 is retried before giving up. Two covers a burst that
+ * briefly outran the budget; more would just delay an error the caller needs. */
+export declare const DEFAULT_MAX_RETRIES = 2;
+export declare function createTransport(baseUrl: string, auth: Auth, fetchImpl?: FetchLike, timeoutMs?: number, maxRetries?: number): Transport;
+export {};

package/dist/index.d.ts

@@ -0,0 +1,16 @@
+export type { AdminClient, AdminClientOptions, TenantScope } from "./admin/index.js";
+export { createAdminClient } from "./admin/index.js";
+export type { CachedConversation, ConversationCache, MemoryConversationCacheOptions, } from "./cache.js";
+export { MemoryConversationCache } from "./cache.js";
+export type { ClientOptions, ClientOptions as UserClientOptions, ConversationHandlers, ConversationSubscription, HistoryStart, ListHandlers, UserCredential, } from "./client.js";
+export { AgentClient, createUserClient } from "./client.js";
+export type { ClientTool, ClientToolContext, ClientToolsSession, ServeClientToolsOptions, } from "./client-tools.js";
+export { serveClientTools } from "./client-tools.js";
+export { AgentApiError, AgentConfigError, AgentError, AgentNetworkError } from "./errors.js";
+export type { Auth, TokenSource, Transport } from "./http.js";
+export { DEFAULT_MAX_RETRIES, DEFAULT_TIMEOUT_MS } from "./http.js";
+export { mergeToolActivities, mergeVoiceMessages } from "./mapping.js";
+export type { Schemas } from "./schemas.js";
+export type { FetchLike } from "./sse.js";
+export { readSse } from "./sse.js";
+export type { Activity, Attachment, AttachmentKind, Block, ClientToolCall, Conversation, ConversationEvent, CreateConversationOptions, EnabledComponents, EventPage, Identity, ListConversationsOptions, Message, MessagePage, MessageRole, Page, PlanSnapshot, Todo, TodoStatus, ToolActivity, WorkspaceDir, WorkspaceEntry, } from "./types.js";