@usewhisper/sdk 3.1.0 → 3.3.0

package/index.d.mts

@@ -215,6 +215,7 @@ interface RuntimeClientOptions {
     compatMode?: CompatMode;
     timeouts?: Partial<TimeoutBudgets>;
     retryPolicy?: RetryPolicy;
+    fetchImpl?: typeof fetch;
 }
 interface RuntimeResponse<T> {
     data: T;
@@ -325,6 +326,7 @@ declare class RuntimeClient {
     private readonly diagnostics;
     private readonly inFlight;
     private readonly sendApiKeyHeader;
+    private readonly fetchImpl;
     constructor(options: RuntimeClientOptions, diagnostics?: DiagnosticsStore);
     getDiagnosticsStore(): DiagnosticsStore;
     getCompatMode(): CompatMode;
@@ -414,11 +416,13 @@ interface MemoryWriteAck$1 {
     success: boolean;
     mode?: "async" | "sync";
     trace_id?: string;
+    memory_id?: string;
     job_id?: string;
     status_url?: string;
     accepted_at?: string;
     visibility_sla_ms?: number;
     pending_visibility?: boolean;
+    semantic_status?: "pending" | "ready";
     queued?: boolean;
     event_id?: string;
     created?: number;
@@ -619,6 +623,7 @@ interface WhisperClientConfig {
     baseUrl?: string;
     project?: string;
     compatMode?: CompatMode;
+    fetch?: typeof fetch;
     timeouts?: Partial<TimeoutBudgets>;
     retryPolicy?: RetryPolicy;
     cache?: {
@@ -1036,6 +1041,9 @@ interface CanonicalSourceCreateParams {
     name?: string;
     auto_index?: boolean;
     metadata?: Record<string, string>;
+    ingestion_profile?: "auto" | "repo" | "web_docs" | "pdf_layout" | "video_transcript" | "plain_text";
+    strategy_override?: "fixed" | "recursive" | "semantic" | "hierarchical" | "adaptive";
+    profile_config?: Record<string, any>;
     owner?: string;
     repo?: string;
     branch?: string;
@@ -1147,6 +1155,20 @@ interface MemoryWriteAck {
     pending_visibility?: boolean;
     [key: string]: any;
 }
+interface MemoryWriteResult {
+    id: string;
+    success: boolean;
+    path: "sota" | "legacy";
+    fallback_used: boolean;
+    mode?: "async" | "sync";
+    memory_id?: string;
+    job_id?: string;
+    status_url?: string;
+    accepted_at?: string;
+    visibility_sla_ms?: number;
+    pending_visibility?: boolean;
+    semantic_status?: "pending" | "ready";
+}
 type WhisperErrorCode = "INVALID_API_KEY" | "PROJECT_NOT_FOUND" | "PROJECT_AMBIGUOUS" | "RATE_LIMITED" | "TEMPORARY_UNAVAILABLE" | "NETWORK_ERROR" | "TIMEOUT" | "REQUEST_FAILED" | "MISSING_PROJECT";
 declare class WhisperError extends Error {
     code: WhisperErrorCode;
@@ -1175,9 +1197,13 @@ declare class WhisperContext {
     withProject(project: string): WhisperContext;
     private getRequiredProject;
     private refreshProjectCache;
+    private fetchResolvedProject;
+    resolveProject(projectRef?: string): Promise<Project>;
     private resolveProjectId;
     private getProjectRefCandidates;
     private withProjectRefFallback;
+    private shouldRetryWithResolvedProjectId;
+    private withProjectPathFallback;
     private classifyError;
     private isEndpointNotFoundError;
     private inferOperation;
@@ -1194,6 +1220,14 @@ declare class WhisperContext {
     getProject(id: string): Promise<Project & {
         sources: Source[];
     }>;
+    listSources(project?: string): Promise<{
+        project: {
+            id: string;
+            name: string;
+            slug: string;
+        };
+        sources: Source[];
+    }>;
     deleteProject(id: string): Promise<{
         deleted: boolean;
     }>;
@@ -1214,6 +1248,9 @@ declare class WhisperContext {
         allow_stt_fallback?: boolean;
         max_duration_minutes?: number;
         name?: string;
+        ingestion_profile?: "auto" | "repo" | "web_docs" | "pdf_layout" | "video_transcript" | "plain_text";
+        strategy_override?: "fixed" | "recursive" | "semantic" | "hierarchical" | "adaptive";
+        profile_config?: Record<string, any>;
     }): Promise<{
         source_id: string;
         sync_job_id?: string | null;
@@ -1227,6 +1264,9 @@ declare class WhisperContext {
         content: string;
         metadata?: Record<string, any>;
         file_path?: string;
+        ingestion_profile?: "auto" | "repo" | "web_docs" | "pdf_layout" | "video_transcript" | "plain_text";
+        strategy_override?: "fixed" | "recursive" | "semantic" | "hierarchical" | "adaptive";
+        profile_config?: Record<string, any>;
     }>): Promise<{
         ingested: number;
     }>;
@@ -1251,12 +1291,7 @@ declare class WhisperContext {
         async?: boolean;
         write_mode?: "async" | "sync";
         allow_legacy_fallback?: boolean;
-    }): Promise<{
-        id: string;
-        success: boolean;
-        path: "sota" | "legacy";
-        fallback_used: boolean;
-    }>;
+    }): Promise<MemoryWriteResult>;
     addMemoriesBulk(params: {
         project?: string;
         memories: Array<{
@@ -1645,12 +1680,7 @@ declare class WhisperContext {
         getStatus: (sourceId: string) => Promise<VideoIngestionStatus>;
     };
     readonly memory: {
-        add: (params: Parameters<WhisperContext["addMemory"]>[0]) => Promise<{
-            id: string;
-            success: boolean;
-            path: "sota" | "legacy";
-            fallback_used: boolean;
-        }>;
+        add: (params: Parameters<WhisperContext["addMemory"]>[0]) => Promise<MemoryWriteResult>;
         addBulk: (params: Parameters<WhisperContext["addMemoriesBulk"]>[0]) => Promise<any>;
         extract: (params: Parameters<WhisperContext["extractMemories"]>[0]) => Promise<MemoryExtractionResult>;
         extractSession: (params: Parameters<WhisperContext["extractSessionMemories"]>[0]) => Promise<{
@@ -1784,4 +1814,4 @@ declare class WhisperContext {
     };
 }
 
-export { type CanonicalSourceCreateParams, type CanonicalSourceCreateResult, type CanonicalSourceType, type ExtractedMemory, LangChainMemoryAdapter, LangGraphCheckpointAdapter, type Memory, type MemoryExtractionResult, type MemoryKind, type MemoryLatencyBreakdown, type MemorySearchResponse, type MemoryWriteAck, type Project, type QueryParams, type QueryResult, type Source, type VideoIngestionStatus, type VideoSourceMetadata, Whisper, WhisperAgentMiddleware, WhisperClient, type WhisperConfig, WhisperContext, Whisper as WhisperDefault, WhisperError, type WhisperErrorCode, WhisperClient as WhisperRuntimeClient, createAgentMiddleware, createLangChainMemoryAdapter, createLangGraphCheckpointAdapter, WhisperContext as default, memoryGraphToMermaid };
+export { type CanonicalSourceCreateParams, type CanonicalSourceCreateResult, type CanonicalSourceType, type ExtractedMemory, LangChainMemoryAdapter, LangGraphCheckpointAdapter, type Memory, type MemoryExtractionResult, type MemoryKind, type MemoryLatencyBreakdown, type MemorySearchResponse, type MemoryWriteAck, type MemoryWriteResult, type Project, type QueryParams, type QueryResult, type Source, type VideoIngestionStatus, type VideoSourceMetadata, Whisper, WhisperAgentMiddleware, WhisperClient, type WhisperConfig, WhisperContext, Whisper as WhisperDefault, WhisperError, type WhisperErrorCode, WhisperClient as WhisperRuntimeClient, createAgentMiddleware, createLangChainMemoryAdapter, createLangGraphCheckpointAdapter, WhisperContext as default, memoryGraphToMermaid };

package/index.d.ts

@@ -215,6 +215,7 @@ interface RuntimeClientOptions {
     compatMode?: CompatMode;
     timeouts?: Partial<TimeoutBudgets>;
     retryPolicy?: RetryPolicy;
+    fetchImpl?: typeof fetch;
 }
 interface RuntimeResponse<T> {
     data: T;
@@ -325,6 +326,7 @@ declare class RuntimeClient {
     private readonly diagnostics;
     private readonly inFlight;
     private readonly sendApiKeyHeader;
+    private readonly fetchImpl;
     constructor(options: RuntimeClientOptions, diagnostics?: DiagnosticsStore);
     getDiagnosticsStore(): DiagnosticsStore;
     getCompatMode(): CompatMode;
@@ -414,11 +416,13 @@ interface MemoryWriteAck$1 {
     success: boolean;
     mode?: "async" | "sync";
     trace_id?: string;
+    memory_id?: string;
     job_id?: string;
     status_url?: string;
     accepted_at?: string;
     visibility_sla_ms?: number;
     pending_visibility?: boolean;
+    semantic_status?: "pending" | "ready";
     queued?: boolean;
     event_id?: string;
     created?: number;
@@ -619,6 +623,7 @@ interface WhisperClientConfig {
     baseUrl?: string;
     project?: string;
     compatMode?: CompatMode;
+    fetch?: typeof fetch;
     timeouts?: Partial<TimeoutBudgets>;
     retryPolicy?: RetryPolicy;
     cache?: {
@@ -1036,6 +1041,9 @@ interface CanonicalSourceCreateParams {
     name?: string;
     auto_index?: boolean;
     metadata?: Record<string, string>;
+    ingestion_profile?: "auto" | "repo" | "web_docs" | "pdf_layout" | "video_transcript" | "plain_text";
+    strategy_override?: "fixed" | "recursive" | "semantic" | "hierarchical" | "adaptive";
+    profile_config?: Record<string, any>;
     owner?: string;
     repo?: string;
     branch?: string;
@@ -1147,6 +1155,20 @@ interface MemoryWriteAck {
     pending_visibility?: boolean;
     [key: string]: any;
 }
+interface MemoryWriteResult {
+    id: string;
+    success: boolean;
+    path: "sota" | "legacy";
+    fallback_used: boolean;
+    mode?: "async" | "sync";
+    memory_id?: string;
+    job_id?: string;
+    status_url?: string;
+    accepted_at?: string;
+    visibility_sla_ms?: number;
+    pending_visibility?: boolean;
+    semantic_status?: "pending" | "ready";
+}
 type WhisperErrorCode = "INVALID_API_KEY" | "PROJECT_NOT_FOUND" | "PROJECT_AMBIGUOUS" | "RATE_LIMITED" | "TEMPORARY_UNAVAILABLE" | "NETWORK_ERROR" | "TIMEOUT" | "REQUEST_FAILED" | "MISSING_PROJECT";
 declare class WhisperError extends Error {
     code: WhisperErrorCode;
@@ -1175,9 +1197,13 @@ declare class WhisperContext {
     withProject(project: string): WhisperContext;
     private getRequiredProject;
     private refreshProjectCache;
+    private fetchResolvedProject;
+    resolveProject(projectRef?: string): Promise<Project>;
     private resolveProjectId;
     private getProjectRefCandidates;
     private withProjectRefFallback;
+    private shouldRetryWithResolvedProjectId;
+    private withProjectPathFallback;
     private classifyError;
     private isEndpointNotFoundError;
     private inferOperation;
@@ -1194,6 +1220,14 @@ declare class WhisperContext {
     getProject(id: string): Promise<Project & {
         sources: Source[];
     }>;
+    listSources(project?: string): Promise<{
+        project: {
+            id: string;
+            name: string;
+            slug: string;
+        };
+        sources: Source[];
+    }>;
     deleteProject(id: string): Promise<{
         deleted: boolean;
     }>;
@@ -1214,6 +1248,9 @@ declare class WhisperContext {
         allow_stt_fallback?: boolean;
         max_duration_minutes?: number;
         name?: string;
+        ingestion_profile?: "auto" | "repo" | "web_docs" | "pdf_layout" | "video_transcript" | "plain_text";
+        strategy_override?: "fixed" | "recursive" | "semantic" | "hierarchical" | "adaptive";
+        profile_config?: Record<string, any>;
     }): Promise<{
         source_id: string;
         sync_job_id?: string | null;
@@ -1227,6 +1264,9 @@ declare class WhisperContext {
         content: string;
         metadata?: Record<string, any>;
         file_path?: string;
+        ingestion_profile?: "auto" | "repo" | "web_docs" | "pdf_layout" | "video_transcript" | "plain_text";
+        strategy_override?: "fixed" | "recursive" | "semantic" | "hierarchical" | "adaptive";
+        profile_config?: Record<string, any>;
     }>): Promise<{
         ingested: number;
     }>;
@@ -1251,12 +1291,7 @@ declare class WhisperContext {
         async?: boolean;
         write_mode?: "async" | "sync";
         allow_legacy_fallback?: boolean;
-    }): Promise<{
-        id: string;
-        success: boolean;
-        path: "sota" | "legacy";
-        fallback_used: boolean;
-    }>;
+    }): Promise<MemoryWriteResult>;
     addMemoriesBulk(params: {
         project?: string;
         memories: Array<{
@@ -1645,12 +1680,7 @@ declare class WhisperContext {
         getStatus: (sourceId: string) => Promise<VideoIngestionStatus>;
     };
     readonly memory: {
-        add: (params: Parameters<WhisperContext["addMemory"]>[0]) => Promise<{
-            id: string;
-            success: boolean;
-            path: "sota" | "legacy";
-            fallback_used: boolean;
-        }>;
+        add: (params: Parameters<WhisperContext["addMemory"]>[0]) => Promise<MemoryWriteResult>;
         addBulk: (params: Parameters<WhisperContext["addMemoriesBulk"]>[0]) => Promise<any>;
         extract: (params: Parameters<WhisperContext["extractMemories"]>[0]) => Promise<MemoryExtractionResult>;
         extractSession: (params: Parameters<WhisperContext["extractSessionMemories"]>[0]) => Promise<{
@@ -1784,4 +1814,4 @@ declare class WhisperContext {
     };
 }
 
-export { type CanonicalSourceCreateParams, type CanonicalSourceCreateResult, type CanonicalSourceType, type ExtractedMemory, LangChainMemoryAdapter, LangGraphCheckpointAdapter, type Memory, type MemoryExtractionResult, type MemoryKind, type MemoryLatencyBreakdown, type MemorySearchResponse, type MemoryWriteAck, type Project, type QueryParams, type QueryResult, type Source, type VideoIngestionStatus, type VideoSourceMetadata, Whisper, WhisperAgentMiddleware, WhisperClient, type WhisperConfig, WhisperContext, Whisper as WhisperDefault, WhisperError, type WhisperErrorCode, WhisperClient as WhisperRuntimeClient, createAgentMiddleware, createLangChainMemoryAdapter, createLangGraphCheckpointAdapter, WhisperContext as default, memoryGraphToMermaid };
+export { type CanonicalSourceCreateParams, type CanonicalSourceCreateResult, type CanonicalSourceType, type ExtractedMemory, LangChainMemoryAdapter, LangGraphCheckpointAdapter, type Memory, type MemoryExtractionResult, type MemoryKind, type MemoryLatencyBreakdown, type MemorySearchResponse, type MemoryWriteAck, type MemoryWriteResult, type Project, type QueryParams, type QueryResult, type Source, type VideoIngestionStatus, type VideoSourceMetadata, Whisper, WhisperAgentMiddleware, WhisperClient, type WhisperConfig, WhisperContext, Whisper as WhisperDefault, WhisperError, type WhisperErrorCode, WhisperClient as WhisperRuntimeClient, createAgentMiddleware, createLangChainMemoryAdapter, createLangGraphCheckpointAdapter, WhisperContext as default, memoryGraphToMermaid };

package/index.js

@@ -184,6 +184,7 @@ var RuntimeClient = class {
   diagnostics;
   inFlight = /* @__PURE__ */ new Map();
   sendApiKeyHeader;
+  fetchImpl;
   constructor(options, diagnostics) {
     if (!options.apiKey) {
       throw new RuntimeClientError({
@@ -208,6 +209,7 @@ var RuntimeClient = class {
       ...options.timeouts || {}
     };
     this.sendApiKeyHeader = process.env.WHISPER_SEND_X_API_KEY === "1";
+    this.fetchImpl = options.fetchImpl || fetch;
     this.diagnostics = diagnostics || new DiagnosticsStore(1e3);
   }
   getDiagnosticsStore() {
@@ -328,7 +330,7 @@ var RuntimeClient = class {
       const timeout = setTimeout(() => controller.abort(), timeoutMs);
       try {
         const attachApiKeyHeader = this.shouldAttachApiKeyHeader(normalizedEndpoint);
-        const response = await fetch(`${this.baseUrl}${normalizedEndpoint}`, {
+        const response = await this.fetchImpl(`${this.baseUrl}${normalizedEndpoint}`, {
           method,
           signal: controller.signal,
           keepalive: method !== "GET",
@@ -1037,7 +1039,7 @@ var MemoryModule = class {
   async add(params) {
     const project = this.resolveProject(params.project);
     const queueEnabled = this.options.queueEnabled !== false;
-    const useQueue = queueEnabled && params.write_mode !== "sync" && params.async !== false;
+    const useQueue = queueEnabled && (params.write_mode === "async" || params.async === true);
     if (useQueue) {
       const queued = await this.queue.enqueue({
         project,
@@ -1082,14 +1084,18 @@ var MemoryModule = class {
           metadata: params.metadata,
           document_date: params.document_date,
           event_date: params.event_date,
-          write_mode: "sync"
+          write_mode: params.write_mode === "async" || params.async === true ? "async" : "sync"
         }
       });
       this.invalidate(project, params.user_id, params.session_id);
       return {
         success: true,
         mode: "sync",
-        trace_id: response.traceId
+        trace_id: response.trace_id || response.traceId,
+        memory_id: response.memory_id || response.memory?.id,
+        semantic_status: response.semantic_status || response.memory?.semantic_status,
+        pending_visibility: Boolean(response.pending_visibility),
+        visibility_sla_ms: response.visibility_sla_ms
       };
     } catch (error) {
       if (this.client.getCompatMode() !== "fallback" || !isEndpointNotFound(error)) {
@@ -1127,7 +1133,7 @@ var MemoryModule = class {
       });
     }
     const queueEnabled = this.options.queueEnabled !== false;
-    const useQueue = queueEnabled && params.write_mode !== "sync" && params.async !== false;
+    const useQueue = queueEnabled && (params.write_mode === "async" || params.async === true);
     if (useQueue) {
       const queued = await Promise.all(
         params.memories.map(
@@ -1171,7 +1177,7 @@ var MemoryModule = class {
             ...memory,
             memory_type: toSotaType(memory.memory_type)
           })),
-          write_mode: "sync"
+          write_mode: params.write_mode === "async" || params.async === true ? "async" : "sync"
         }
       });
       for (const memory of params.memories) {
@@ -1604,7 +1610,8 @@ var WhisperClient = class _WhisperClient {
         baseUrl: config.baseUrl,
         compatMode: config.compatMode || "fallback",
         timeouts: config.timeouts,
-        retryPolicy: config.retryPolicy
+        retryPolicy: config.retryPolicy,
+        fetchImpl: config.fetch
       },
       this.diagnosticsStore
     );
@@ -2416,9 +2423,71 @@ var WhisperContext = class _WhisperContext {
       this.projectRefToId.set(p.slug, p.id);
       this.projectRefToId.set(p.name, p.id);
     }
+    if (this.defaultProject) {
+      const hasDefaultProject = this.projectCache.some(
+        (project) => project.id === this.defaultProject || project.slug === this.defaultProject || project.name === this.defaultProject
+      );
+      if (!hasDefaultProject) {
+        const resolvedDefault = await this.fetchResolvedProject(this.defaultProject);
+        if (resolvedDefault) {
+          this.projectCache = [...this.projectCache, resolvedDefault];
+          this.projectRefToId.set(resolvedDefault.id, resolvedDefault.id);
+          this.projectRefToId.set(resolvedDefault.slug, resolvedDefault.id);
+          this.projectRefToId.set(resolvedDefault.name, resolvedDefault.id);
+        }
+      }
+    }
     this.projectCacheExpiresAt = Date.now() + PROJECT_CACHE_TTL_MS;
     return this.projectCache;
   }
+  async fetchResolvedProject(projectRef) {
+    if (!projectRef) return null;
+    try {
+      const response = await this.request(`/v1/projects/resolve?project=${encodeURIComponent(projectRef)}`, { method: "GET" });
+      return response?.resolved || null;
+    } catch (error) {
+      if (error instanceof WhisperError && error.code === "PROJECT_NOT_FOUND") {
+        return null;
+      }
+      throw error;
+    }
+  }
+  async resolveProject(projectRef) {
+    const resolvedRef = this.getRequiredProject(projectRef);
+    const cachedProjects = await this.refreshProjectCache(false);
+    const cachedProject = cachedProjects.find(
+      (project) => project.id === resolvedRef || project.slug === resolvedRef || project.name === resolvedRef
+    );
+    if (cachedProject) {
+      return cachedProject;
+    }
+    const resolvedProject = await this.fetchResolvedProject(resolvedRef);
+    if (resolvedProject) {
+      this.projectRefToId.set(resolvedProject.id, resolvedProject.id);
+      this.projectRefToId.set(resolvedProject.slug, resolvedProject.id);
+      this.projectRefToId.set(resolvedProject.name, resolvedProject.id);
+      this.projectCache = [
+        ...this.projectCache.filter((project) => project.id !== resolvedProject.id),
+        resolvedProject
+      ];
+      this.projectCacheExpiresAt = Date.now() + PROJECT_CACHE_TTL_MS;
+      return resolvedProject;
+    }
+    if (isLikelyProjectId(resolvedRef)) {
+      return {
+        id: resolvedRef,
+        orgId: "",
+        name: resolvedRef,
+        slug: resolvedRef,
+        createdAt: (/* @__PURE__ */ new Date(0)).toISOString(),
+        updatedAt: (/* @__PURE__ */ new Date(0)).toISOString()
+      };
+    }
+    throw new WhisperError({
+      code: "PROJECT_NOT_FOUND",
+      message: `Project '${resolvedRef}' not found`
+    });
+  }
   async resolveProjectId(projectRef) {
     if (this.projectRefToId.has(projectRef)) {
       return this.projectRefToId.get(projectRef);
@@ -2439,6 +2508,18 @@ var WhisperContext = class _WhisperContext {
     if (isLikelyProjectId(projectRef)) {
       return projectRef;
     }
+    const resolvedProject = await this.fetchResolvedProject(projectRef);
+    if (resolvedProject) {
+      this.projectRefToId.set(resolvedProject.id, resolvedProject.id);
+      this.projectRefToId.set(resolvedProject.slug, resolvedProject.id);
+      this.projectRefToId.set(resolvedProject.name, resolvedProject.id);
+      this.projectCache = [
+        ...this.projectCache.filter((project) => project.id !== resolvedProject.id),
+        resolvedProject
+      ];
+      this.projectCacheExpiresAt = Date.now() + PROJECT_CACHE_TTL_MS;
+      return resolvedProject.id;
+    }
     throw new WhisperError({
       code: "PROJECT_NOT_FOUND",
       message: `Project '${projectRef}' not found`
@@ -2494,6 +2575,26 @@ var WhisperContext = class _WhisperContext {
       message: `Project '${projectRef}' not found`
     });
   }
+  shouldRetryWithResolvedProjectId(error) {
+    return error instanceof WhisperError && error.status === 404 && !this.isEndpointNotFoundError(error);
+  }
+  async withProjectPathFallback(projectRef, execute) {
+    try {
+      return await execute(projectRef);
+    } catch (error) {
+      if (!this.shouldRetryWithResolvedProjectId(error)) {
+        throw error;
+      }
+    }
+    const resolvedProjectId = await this.resolveProjectId(projectRef);
+    if (resolvedProjectId === projectRef) {
+      throw new WhisperError({
+        code: "PROJECT_NOT_FOUND",
+        message: `Project '${projectRef}' not found`
+      });
+    }
+    return execute(resolvedProjectId);
+  }
   classifyError(status, message) {
     if (status === 401 || /api key|unauthorized|forbidden/i.test(message)) {
       return { code: "INVALID_API_KEY", retryable: false };
@@ -2609,29 +2710,42 @@ var WhisperContext = class _WhisperContext {
     return projects;
   }
   async getProject(id) {
-    const projectId = await this.resolveProjectId(id);
-    return this.request(`/v1/projects/${projectId}`);
+    return this.withProjectPathFallback(
+      this.getRequiredProject(id),
+      (projectPathRef) => this.request(`/v1/projects/${encodeURIComponent(projectPathRef)}`)
+    );
+  }
+  async listSources(project) {
+    const projectRef = this.getRequiredProject(project);
+    return this.withProjectRefFallback(
+      projectRef,
+      (resolvedProject) => this.request(`/v1/sources?project=${encodeURIComponent(resolvedProject)}`, { method: "GET" })
+    );
   }
   async deleteProject(id) {
     const projectId = await this.resolveProjectId(id);
     return this.request(`/v1/projects/${projectId}`, { method: "DELETE" });
   }
   async addSource(projectId, params) {
-    const resolvedProjectId = await this.resolveProjectId(projectId);
-    return this.request(`/v1/projects/${resolvedProjectId}/sources`, {
-      method: "POST",
-      body: JSON.stringify(params)
-    });
+    return this.withProjectPathFallback(
+      this.getRequiredProject(projectId),
+      (projectPathRef) => this.request(`/v1/projects/${encodeURIComponent(projectPathRef)}/sources`, {
+        method: "POST",
+        body: JSON.stringify(params)
+      })
+    );
   }
   async syncSource(sourceId) {
     return this.request(`/v1/sources/${sourceId}/sync`, { method: "POST" });
   }
   async addSourceByType(projectId, params) {
-    const resolvedProjectId = await this.resolveProjectId(projectId);
-    return this.request(`/v1/projects/${resolvedProjectId}/add_source`, {
-      method: "POST",
-      body: JSON.stringify(params)
-    });
+    return this.withProjectPathFallback(
+      this.getRequiredProject(projectId),
+      (projectPathRef) => this.request(`/v1/projects/${encodeURIComponent(projectPathRef)}/add_source`, {
+        method: "POST",
+        body: JSON.stringify(params)
+      })
+    );
   }
   async getSourceStatus(sourceId) {
     return this.request(`/v1/sources/${sourceId}/status`, { method: "GET" });
@@ -2668,6 +2782,9 @@ var WhisperContext = class _WhisperContext {
       if (params.auth_ref) config.auth_ref = params.auth_ref;
     }
     if (params.metadata) config.metadata = params.metadata;
+    if (params.ingestion_profile) config.ingestion_profile = params.ingestion_profile;
+    if (params.strategy_override) config.strategy_override = params.strategy_override;
+    if (params.profile_config) config.profile_config = params.profile_config;
     config.auto_index = params.auto_index ?? true;
     const created = await this.addSource(project, {
       name: params.name || `${params.type}-source-${Date.now()}`,
@@ -2690,14 +2807,16 @@ var WhisperContext = class _WhisperContext {
     };
   }
   async ingest(projectId, documents) {
-    const resolvedProjectId = await this.resolveProjectId(projectId);
-    return this.request(`/v1/projects/${resolvedProjectId}/ingest`, {
-      method: "POST",
-      body: JSON.stringify({ documents })
-    });
+    return this.withProjectPathFallback(
+      this.getRequiredProject(projectId),
+      (projectPathRef) => this.request(`/v1/projects/${encodeURIComponent(projectPathRef)}/ingest`, {
+        method: "POST",
+        body: JSON.stringify({ documents })
+      })
+    );
   }
   async addContext(params) {
-    const projectId = await this.resolveProjectId(this.getRequiredProject(params.project));
+    const projectId = (await this.resolveProject(this.getRequiredProject(params.project))).id;
     return this.ingest(projectId, [
       {
         title: params.title || "Context",
@@ -2749,15 +2868,42 @@ var WhisperContext = class _WhisperContext {
             importance: params.importance,
             metadata: params.metadata,
             async: params.async,
-            write_mode: params.write_mode
+            write_mode: params.write_mode || (params.async === true ? "async" : "sync")
           })
         });
-        const id2 = direct?.memory?.id || direct?.id || direct?.memory_id || direct?.job_id;
+        const mode = direct?.mode === "async" ? "async" : direct?.mode === "sync" ? "sync" : void 0;
+        const memoryId = direct?.memory?.id || direct?.memory_id || (mode !== "async" ? direct?.id : void 0);
+        const jobId = direct?.job_id || (mode === "async" ? direct?.id : void 0);
+        const id2 = memoryId || jobId || "";
         if (id2) {
-          return { id: id2, success: true, path: "sota", fallback_used: false };
+          return {
+            id: id2,
+            success: true,
+            path: "sota",
+            fallback_used: false,
+            mode,
+            ...memoryId ? { memory_id: memoryId } : {},
+            ...jobId ? { job_id: jobId } : {},
+            ...direct?.status_url ? { status_url: direct.status_url } : {},
+            ...direct?.accepted_at ? { accepted_at: direct.accepted_at } : {},
+            ...direct?.visibility_sla_ms ? { visibility_sla_ms: direct.visibility_sla_ms } : {},
+            ...direct?.pending_visibility !== void 0 ? { pending_visibility: Boolean(direct.pending_visibility) } : {},
+            ...direct?.semantic_status ? { semantic_status: direct.semantic_status } : {}
+          };
         }
         if (direct?.success === true) {
-          return { id: "", success: true, path: "sota", fallback_used: false };
+          return {
+            id: "",
+            success: true,
+            path: "sota",
+            fallback_used: false,
+            mode,
+            ...direct?.status_url ? { status_url: direct.status_url } : {},
+            ...direct?.accepted_at ? { accepted_at: direct.accepted_at } : {},
+            ...direct?.visibility_sla_ms ? { visibility_sla_ms: direct.visibility_sla_ms } : {},
+            ...direct?.pending_visibility !== void 0 ? { pending_visibility: Boolean(direct.pending_visibility) } : {},
+            ...direct?.semantic_status ? { semantic_status: direct.semantic_status } : {}
+          };
         }
       } catch (error) {
         if (params.allow_legacy_fallback === false) {
@@ -2785,7 +2931,15 @@ var WhisperContext = class _WhisperContext {
           message: "Memory create succeeded but no memory id was returned by the API"
         });
       }
-      return { id, success: true, path: "legacy", fallback_used: true };
+      return {
+        id,
+        success: true,
+        path: "legacy",
+        fallback_used: true,
+        mode: "sync",
+        memory_id: id,
+        semantic_status: "ready"
+      };
     });
   }
   async addMemoriesBulk(params) {
@@ -3072,28 +3226,37 @@ var WhisperContext = class _WhisperContext {
     });
   }
   async createSharedContext(params) {
-    const project = await this.resolveProjectId(this.getRequiredProject(params.project));
-    return this.request("/v1/context/share", {
-      method: "POST",
-      body: JSON.stringify({ ...params, project })
-    });
+    const projectRef = this.getRequiredProject(params.project);
+    return this.withProjectRefFallback(
+      projectRef,
+      (project) => this.request("/v1/context/share", {
+        method: "POST",
+        body: JSON.stringify({ ...params, project })
+      })
+    );
   }
   async loadSharedContext(shareId) {
     return this.request(`/v1/context/shared/${shareId}`);
   }
   async resumeFromSharedContext(params) {
-    const project = await this.resolveProjectId(this.getRequiredProject(params.project));
-    return this.request("/v1/context/resume", {
-      method: "POST",
-      body: JSON.stringify({ ...params, project })
-    });
+    const projectRef = this.getRequiredProject(params.project);
+    return this.withProjectRefFallback(
+      projectRef,
+      (project) => this.request("/v1/context/resume", {
+        method: "POST",
+        body: JSON.stringify({ ...params, project })
+      })
+    );
   }
   async consolidateMemories(params) {
-    const project = await this.resolveProjectId(this.getRequiredProject(params.project));
-    return this.request("/v1/memory/consolidate", {
-      method: "POST",
-      body: JSON.stringify({ ...params, project })
-    });
+    const projectRef = this.getRequiredProject(params.project);
+    return this.withProjectRefFallback(
+      projectRef,
+      (project) => this.request("/v1/memory/consolidate", {
+        method: "POST",
+        body: JSON.stringify({ ...params, project })
+      })
+    );
   }
   async updateImportanceDecay(params) {
     const project = await this.resolveProjectId(this.getRequiredProject(params.project));

package/index.mjs

@@ -135,6 +135,7 @@ var RuntimeClient = class {
   diagnostics;
   inFlight = /* @__PURE__ */ new Map();
   sendApiKeyHeader;
+  fetchImpl;
   constructor(options, diagnostics) {
     if (!options.apiKey) {
       throw new RuntimeClientError({
@@ -159,6 +160,7 @@ var RuntimeClient = class {
       ...options.timeouts || {}
     };
     this.sendApiKeyHeader = process.env.WHISPER_SEND_X_API_KEY === "1";
+    this.fetchImpl = options.fetchImpl || fetch;
     this.diagnostics = diagnostics || new DiagnosticsStore(1e3);
   }
   getDiagnosticsStore() {
@@ -279,7 +281,7 @@ var RuntimeClient = class {
       const timeout = setTimeout(() => controller.abort(), timeoutMs);
       try {
         const attachApiKeyHeader = this.shouldAttachApiKeyHeader(normalizedEndpoint);
-        const response = await fetch(`${this.baseUrl}${normalizedEndpoint}`, {
+        const response = await this.fetchImpl(`${this.baseUrl}${normalizedEndpoint}`, {
           method,
           signal: controller.signal,
           keepalive: method !== "GET",
@@ -988,7 +990,7 @@ var MemoryModule = class {
   async add(params) {
     const project = this.resolveProject(params.project);
     const queueEnabled = this.options.queueEnabled !== false;
-    const useQueue = queueEnabled && params.write_mode !== "sync" && params.async !== false;
+    const useQueue = queueEnabled && (params.write_mode === "async" || params.async === true);
     if (useQueue) {
       const queued = await this.queue.enqueue({
         project,
@@ -1033,14 +1035,18 @@ var MemoryModule = class {
           metadata: params.metadata,
           document_date: params.document_date,
           event_date: params.event_date,
-          write_mode: "sync"
+          write_mode: params.write_mode === "async" || params.async === true ? "async" : "sync"
         }
       });
       this.invalidate(project, params.user_id, params.session_id);
       return {
         success: true,
         mode: "sync",
-        trace_id: response.traceId
+        trace_id: response.trace_id || response.traceId,
+        memory_id: response.memory_id || response.memory?.id,
+        semantic_status: response.semantic_status || response.memory?.semantic_status,
+        pending_visibility: Boolean(response.pending_visibility),
+        visibility_sla_ms: response.visibility_sla_ms
       };
     } catch (error) {
       if (this.client.getCompatMode() !== "fallback" || !isEndpointNotFound(error)) {
@@ -1078,7 +1084,7 @@ var MemoryModule = class {
       });
     }
     const queueEnabled = this.options.queueEnabled !== false;
-    const useQueue = queueEnabled && params.write_mode !== "sync" && params.async !== false;
+    const useQueue = queueEnabled && (params.write_mode === "async" || params.async === true);
     if (useQueue) {
       const queued = await Promise.all(
         params.memories.map(
@@ -1122,7 +1128,7 @@ var MemoryModule = class {
             ...memory,
             memory_type: toSotaType(memory.memory_type)
           })),
-          write_mode: "sync"
+          write_mode: params.write_mode === "async" || params.async === true ? "async" : "sync"
         }
       });
       for (const memory of params.memories) {
@@ -1555,7 +1561,8 @@ var WhisperClient = class _WhisperClient {
         baseUrl: config.baseUrl,
         compatMode: config.compatMode || "fallback",
         timeouts: config.timeouts,
-        retryPolicy: config.retryPolicy
+        retryPolicy: config.retryPolicy,
+        fetchImpl: config.fetch
       },
       this.diagnosticsStore
     );
@@ -2367,9 +2374,71 @@ var WhisperContext = class _WhisperContext {
       this.projectRefToId.set(p.slug, p.id);
       this.projectRefToId.set(p.name, p.id);
     }
+    if (this.defaultProject) {
+      const hasDefaultProject = this.projectCache.some(
+        (project) => project.id === this.defaultProject || project.slug === this.defaultProject || project.name === this.defaultProject
+      );
+      if (!hasDefaultProject) {
+        const resolvedDefault = await this.fetchResolvedProject(this.defaultProject);
+        if (resolvedDefault) {
+          this.projectCache = [...this.projectCache, resolvedDefault];
+          this.projectRefToId.set(resolvedDefault.id, resolvedDefault.id);
+          this.projectRefToId.set(resolvedDefault.slug, resolvedDefault.id);
+          this.projectRefToId.set(resolvedDefault.name, resolvedDefault.id);
+        }
+      }
+    }
     this.projectCacheExpiresAt = Date.now() + PROJECT_CACHE_TTL_MS;
     return this.projectCache;
   }
+  async fetchResolvedProject(projectRef) {
+    if (!projectRef) return null;
+    try {
+      const response = await this.request(`/v1/projects/resolve?project=${encodeURIComponent(projectRef)}`, { method: "GET" });
+      return response?.resolved || null;
+    } catch (error) {
+      if (error instanceof WhisperError && error.code === "PROJECT_NOT_FOUND") {
+        return null;
+      }
+      throw error;
+    }
+  }
+  async resolveProject(projectRef) {
+    const resolvedRef = this.getRequiredProject(projectRef);
+    const cachedProjects = await this.refreshProjectCache(false);
+    const cachedProject = cachedProjects.find(
+      (project) => project.id === resolvedRef || project.slug === resolvedRef || project.name === resolvedRef
+    );
+    if (cachedProject) {
+      return cachedProject;
+    }
+    const resolvedProject = await this.fetchResolvedProject(resolvedRef);
+    if (resolvedProject) {
+      this.projectRefToId.set(resolvedProject.id, resolvedProject.id);
+      this.projectRefToId.set(resolvedProject.slug, resolvedProject.id);
+      this.projectRefToId.set(resolvedProject.name, resolvedProject.id);
+      this.projectCache = [
+        ...this.projectCache.filter((project) => project.id !== resolvedProject.id),
+        resolvedProject
+      ];
+      this.projectCacheExpiresAt = Date.now() + PROJECT_CACHE_TTL_MS;
+      return resolvedProject;
+    }
+    if (isLikelyProjectId(resolvedRef)) {
+      return {
+        id: resolvedRef,
+        orgId: "",
+        name: resolvedRef,
+        slug: resolvedRef,
+        createdAt: (/* @__PURE__ */ new Date(0)).toISOString(),
+        updatedAt: (/* @__PURE__ */ new Date(0)).toISOString()
+      };
+    }
+    throw new WhisperError({
+      code: "PROJECT_NOT_FOUND",
+      message: `Project '${resolvedRef}' not found`
+    });
+  }
   async resolveProjectId(projectRef) {
     if (this.projectRefToId.has(projectRef)) {
       return this.projectRefToId.get(projectRef);
@@ -2390,6 +2459,18 @@ var WhisperContext = class _WhisperContext {
     if (isLikelyProjectId(projectRef)) {
       return projectRef;
     }
+    const resolvedProject = await this.fetchResolvedProject(projectRef);
+    if (resolvedProject) {
+      this.projectRefToId.set(resolvedProject.id, resolvedProject.id);
+      this.projectRefToId.set(resolvedProject.slug, resolvedProject.id);
+      this.projectRefToId.set(resolvedProject.name, resolvedProject.id);
+      this.projectCache = [
+        ...this.projectCache.filter((project) => project.id !== resolvedProject.id),
+        resolvedProject
+      ];
+      this.projectCacheExpiresAt = Date.now() + PROJECT_CACHE_TTL_MS;
+      return resolvedProject.id;
+    }
     throw new WhisperError({
       code: "PROJECT_NOT_FOUND",
       message: `Project '${projectRef}' not found`
@@ -2445,6 +2526,26 @@ var WhisperContext = class _WhisperContext {
       message: `Project '${projectRef}' not found`
     });
   }
+  shouldRetryWithResolvedProjectId(error) {
+    return error instanceof WhisperError && error.status === 404 && !this.isEndpointNotFoundError(error);
+  }
+  async withProjectPathFallback(projectRef, execute) {
+    try {
+      return await execute(projectRef);
+    } catch (error) {
+      if (!this.shouldRetryWithResolvedProjectId(error)) {
+        throw error;
+      }
+    }
+    const resolvedProjectId = await this.resolveProjectId(projectRef);
+    if (resolvedProjectId === projectRef) {
+      throw new WhisperError({
+        code: "PROJECT_NOT_FOUND",
+        message: `Project '${projectRef}' not found`
+      });
+    }
+    return execute(resolvedProjectId);
+  }
   classifyError(status, message) {
     if (status === 401 || /api key|unauthorized|forbidden/i.test(message)) {
       return { code: "INVALID_API_KEY", retryable: false };
@@ -2560,29 +2661,42 @@ var WhisperContext = class _WhisperContext {
     return projects;
   }
   async getProject(id) {
-    const projectId = await this.resolveProjectId(id);
-    return this.request(`/v1/projects/${projectId}`);
+    return this.withProjectPathFallback(
+      this.getRequiredProject(id),
+      (projectPathRef) => this.request(`/v1/projects/${encodeURIComponent(projectPathRef)}`)
+    );
+  }
+  async listSources(project) {
+    const projectRef = this.getRequiredProject(project);
+    return this.withProjectRefFallback(
+      projectRef,
+      (resolvedProject) => this.request(`/v1/sources?project=${encodeURIComponent(resolvedProject)}`, { method: "GET" })
+    );
   }
   async deleteProject(id) {
     const projectId = await this.resolveProjectId(id);
     return this.request(`/v1/projects/${projectId}`, { method: "DELETE" });
   }
   async addSource(projectId, params) {
-    const resolvedProjectId = await this.resolveProjectId(projectId);
-    return this.request(`/v1/projects/${resolvedProjectId}/sources`, {
-      method: "POST",
-      body: JSON.stringify(params)
-    });
+    return this.withProjectPathFallback(
+      this.getRequiredProject(projectId),
+      (projectPathRef) => this.request(`/v1/projects/${encodeURIComponent(projectPathRef)}/sources`, {
+        method: "POST",
+        body: JSON.stringify(params)
+      })
+    );
   }
   async syncSource(sourceId) {
     return this.request(`/v1/sources/${sourceId}/sync`, { method: "POST" });
   }
   async addSourceByType(projectId, params) {
-    const resolvedProjectId = await this.resolveProjectId(projectId);
-    return this.request(`/v1/projects/${resolvedProjectId}/add_source`, {
-      method: "POST",
-      body: JSON.stringify(params)
-    });
+    return this.withProjectPathFallback(
+      this.getRequiredProject(projectId),
+      (projectPathRef) => this.request(`/v1/projects/${encodeURIComponent(projectPathRef)}/add_source`, {
+        method: "POST",
+        body: JSON.stringify(params)
+      })
+    );
   }
   async getSourceStatus(sourceId) {
     return this.request(`/v1/sources/${sourceId}/status`, { method: "GET" });
@@ -2619,6 +2733,9 @@ var WhisperContext = class _WhisperContext {
       if (params.auth_ref) config.auth_ref = params.auth_ref;
     }
     if (params.metadata) config.metadata = params.metadata;
+    if (params.ingestion_profile) config.ingestion_profile = params.ingestion_profile;
+    if (params.strategy_override) config.strategy_override = params.strategy_override;
+    if (params.profile_config) config.profile_config = params.profile_config;
     config.auto_index = params.auto_index ?? true;
     const created = await this.addSource(project, {
       name: params.name || `${params.type}-source-${Date.now()}`,
@@ -2641,14 +2758,16 @@ var WhisperContext = class _WhisperContext {
     };
   }
   async ingest(projectId, documents) {
-    const resolvedProjectId = await this.resolveProjectId(projectId);
-    return this.request(`/v1/projects/${resolvedProjectId}/ingest`, {
-      method: "POST",
-      body: JSON.stringify({ documents })
-    });
+    return this.withProjectPathFallback(
+      this.getRequiredProject(projectId),
+      (projectPathRef) => this.request(`/v1/projects/${encodeURIComponent(projectPathRef)}/ingest`, {
+        method: "POST",
+        body: JSON.stringify({ documents })
+      })
+    );
   }
   async addContext(params) {
-    const projectId = await this.resolveProjectId(this.getRequiredProject(params.project));
+    const projectId = (await this.resolveProject(this.getRequiredProject(params.project))).id;
     return this.ingest(projectId, [
       {
         title: params.title || "Context",
@@ -2700,15 +2819,42 @@ var WhisperContext = class _WhisperContext {
             importance: params.importance,
             metadata: params.metadata,
             async: params.async,
-            write_mode: params.write_mode
+            write_mode: params.write_mode || (params.async === true ? "async" : "sync")
           })
         });
-        const id2 = direct?.memory?.id || direct?.id || direct?.memory_id || direct?.job_id;
+        const mode = direct?.mode === "async" ? "async" : direct?.mode === "sync" ? "sync" : void 0;
+        const memoryId = direct?.memory?.id || direct?.memory_id || (mode !== "async" ? direct?.id : void 0);
+        const jobId = direct?.job_id || (mode === "async" ? direct?.id : void 0);
+        const id2 = memoryId || jobId || "";
         if (id2) {
-          return { id: id2, success: true, path: "sota", fallback_used: false };
+          return {
+            id: id2,
+            success: true,
+            path: "sota",
+            fallback_used: false,
+            mode,
+            ...memoryId ? { memory_id: memoryId } : {},
+            ...jobId ? { job_id: jobId } : {},
+            ...direct?.status_url ? { status_url: direct.status_url } : {},
+            ...direct?.accepted_at ? { accepted_at: direct.accepted_at } : {},
+            ...direct?.visibility_sla_ms ? { visibility_sla_ms: direct.visibility_sla_ms } : {},
+            ...direct?.pending_visibility !== void 0 ? { pending_visibility: Boolean(direct.pending_visibility) } : {},
+            ...direct?.semantic_status ? { semantic_status: direct.semantic_status } : {}
+          };
         }
         if (direct?.success === true) {
-          return { id: "", success: true, path: "sota", fallback_used: false };
+          return {
+            id: "",
+            success: true,
+            path: "sota",
+            fallback_used: false,
+            mode,
+            ...direct?.status_url ? { status_url: direct.status_url } : {},
+            ...direct?.accepted_at ? { accepted_at: direct.accepted_at } : {},
+            ...direct?.visibility_sla_ms ? { visibility_sla_ms: direct.visibility_sla_ms } : {},
+            ...direct?.pending_visibility !== void 0 ? { pending_visibility: Boolean(direct.pending_visibility) } : {},
+            ...direct?.semantic_status ? { semantic_status: direct.semantic_status } : {}
+          };
         }
       } catch (error) {
         if (params.allow_legacy_fallback === false) {
@@ -2736,7 +2882,15 @@ var WhisperContext = class _WhisperContext {
           message: "Memory create succeeded but no memory id was returned by the API"
         });
       }
-      return { id, success: true, path: "legacy", fallback_used: true };
+      return {
+        id,
+        success: true,
+        path: "legacy",
+        fallback_used: true,
+        mode: "sync",
+        memory_id: id,
+        semantic_status: "ready"
+      };
     });
   }
   async addMemoriesBulk(params) {
@@ -3023,28 +3177,37 @@ var WhisperContext = class _WhisperContext {
     });
   }
   async createSharedContext(params) {
-    const project = await this.resolveProjectId(this.getRequiredProject(params.project));
-    return this.request("/v1/context/share", {
-      method: "POST",
-      body: JSON.stringify({ ...params, project })
-    });
+    const projectRef = this.getRequiredProject(params.project);
+    return this.withProjectRefFallback(
+      projectRef,
+      (project) => this.request("/v1/context/share", {
+        method: "POST",
+        body: JSON.stringify({ ...params, project })
+      })
+    );
   }
   async loadSharedContext(shareId) {
     return this.request(`/v1/context/shared/${shareId}`);
   }
   async resumeFromSharedContext(params) {
-    const project = await this.resolveProjectId(this.getRequiredProject(params.project));
-    return this.request("/v1/context/resume", {
-      method: "POST",
-      body: JSON.stringify({ ...params, project })
-    });
+    const projectRef = this.getRequiredProject(params.project);
+    return this.withProjectRefFallback(
+      projectRef,
+      (project) => this.request("/v1/context/resume", {
+        method: "POST",
+        body: JSON.stringify({ ...params, project })
+      })
+    );
   }
   async consolidateMemories(params) {
-    const project = await this.resolveProjectId(this.getRequiredProject(params.project));
-    return this.request("/v1/memory/consolidate", {
-      method: "POST",
-      body: JSON.stringify({ ...params, project })
-    });
+    const projectRef = this.getRequiredProject(params.project);
+    return this.withProjectRefFallback(
+      projectRef,
+      (project) => this.request("/v1/memory/consolidate", {
+        method: "POST",
+        body: JSON.stringify({ ...params, project })
+      })
+    );
   }
   async updateImportanceDecay(params) {
     const project = await this.resolveProjectId(this.getRequiredProject(params.project));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@usewhisper/sdk",
-  "version": "3.1.0",
+  "version": "3.3.0",
   "whisperContractVersion": "2026.03.09",
   "scripts": {
     "build": "tsup ../src/sdk/index.ts --format esm,cjs --dts --out-dir .",