@usewhisper/sdk 3.1.0 → 3.2.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;
@@ -1214,6 +1236,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 +1252,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 +1279,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 +1668,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 +1802,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;
@@ -1214,6 +1236,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 +1252,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 +1279,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 +1668,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 +1802,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
     );
@@ -2668,6 +2675,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()}`,
@@ -2749,15 +2759,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 +2822,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) {

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
     );
@@ -2619,6 +2626,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()}`,
@@ -2700,15 +2710,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 +2773,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) {

package/package.json

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