@usewhisper/sdk 3.10.1 → 3.11.0

package/adapters/ai-sdk.d.mts

@@ -1082,6 +1082,27 @@ interface RunContext {
     sessionId?: string;
     traceId?: string;
 }
+interface RememberParams {
+    messages: Array<{
+        role: string;
+        content: string;
+        timestamp?: string;
+    }>;
+    userId?: string;
+    sessionId?: string;
+    project?: string;
+}
+interface IngestParams {
+    url: string;
+    name?: string;
+    token?: string;
+    project?: string;
+}
+type QueryInput = Omit<QueryParams, "query"> & {
+    query?: string;
+    q?: string;
+    userId?: string;
+};
 declare class WhisperClient {
     private readonly config;
     readonly diagnostics: {
@@ -1169,7 +1190,14 @@ declare class WhisperClient {
         project?: string;
         requireIdentity?: boolean;
     }): Promise<WhisperPreflightResult>;
-    query(params: QueryParams): Promise<QueryResult>;
+    query(params: QueryInput): Promise<QueryResult>;
+    remember(params: RememberParams): Promise<LearnResult>;
+    ingest(params: IngestParams): Promise<LearnResult>;
+    userProfile(userId: string): Promise<{
+        user_id: string;
+        memories: unknown[];
+        count: number;
+    }>;
     ingestSession(params: {
         project?: string;
         session_id: string;
@@ -2431,4 +2459,4 @@ declare class WhisperContext {
     };
 }
 
-export { type WhisperEnvironment as $, type AgentRunContext as A, type MemoryKind as B, type CanonicalSourceCreateParams as C, type MemoryLatencyBreakdown as D, type ExtractedMemory as E, type MemorySearchResponse as F, type MemoryWriteAck as G, type MemoryWriteResult as H, type Project as I, type QueryResult as J, type TurnInput as K, LangChainMemoryAdapter as L, type MemoryRouterConfig as M, type VideoSourceMetadata as N, Whisper as O, type PreparedTurn as P, type QueryParams as Q, type RunContext as R, type Source as S, type TurnCaptureResult as T, WhisperAgentMiddleware as U, type VideoIngestionStatus as V, type WhisperToolDefinition as W, type WithWhisperOptions, WhisperClient as X, type WhisperClientConfig as Y, type WhisperConfig as Z, WhisperContext as _, type WhisperToolsOptions as a, WhisperError as a0, type WhisperErrorCode as a1, type WhisperIdentityMode as a2, type WhisperPreflightCheck as a3, type WhisperPreflightResult as a4, type WhisperResolvedIdentity as a5, type WorkEvent as a6, type WorkEventKind as a7, type WorkEventSalience as a8, createAgentMiddleware as a9, createLangChainMemoryAdapter as aa, createLangGraphCheckpointAdapter as ab, memoryGraphToMermaid as ac, type MemoryRouterFallbackReason as b, type MemoryRouterResult as c, type MemoryRouterTrace as d, WhisperMemoryRouter as e, createMemoryRouter as f, type AgentRuntimeOptions as g, type AgentRuntimeRankWeights as h, type AgentRuntimeRetrievalOptions as i, type AgentRuntimeSourceActivityOptions as j, type AgentRuntimeStatus as k, type CanonicalSourceCreateResult as l, type CanonicalSourceType as m, LangGraphCheckpointAdapter as n, type LearnConversationInput as o, type LearnConversationResult as p, type LearnInput as q, type LearnResult as r, type LearnSourceInput as s, type LearnSourceResult as t, type LearnSourceType as u, type LearnTextInput as v, whisperTools as w, withWhisper, type LearnTextResult as x, type Memory as y, type MemoryExtractionResult as z };
+export { type WhisperClientConfig as $, type AgentRunContext as A, type MemoryKind as B, type CanonicalSourceCreateParams as C, type MemoryLatencyBreakdown as D, type ExtractedMemory as E, type MemorySearchResponse as F, type MemoryWriteAck as G, type MemoryWriteResult as H, type IngestParams as I, type Project as J, type QueryParams as K, LangChainMemoryAdapter as L, type MemoryRouterConfig as M, type QueryResult as N, type RunContext as O, type PreparedTurn as P, type QueryInput as Q, type RememberParams as R, type Source as S, type TurnCaptureResult as T, type TurnInput as U, type VideoIngestionStatus as V, type WhisperToolDefinition as W, type WithWhisperOptions, type VideoSourceMetadata as X, Whisper as Y, WhisperAgentMiddleware as Z, WhisperClient as _, type WhisperToolsOptions as a, type WhisperConfig as a0, WhisperContext as a1, type WhisperEnvironment as a2, WhisperError as a3, type WhisperErrorCode as a4, type WhisperIdentityMode as a5, type WhisperPreflightCheck as a6, type WhisperPreflightResult as a7, type WhisperResolvedIdentity as a8, type WorkEvent as a9, type WorkEventKind as aa, type WorkEventSalience as ab, createAgentMiddleware as ac, createLangChainMemoryAdapter as ad, createLangGraphCheckpointAdapter as ae, memoryGraphToMermaid as af, type MemoryRouterFallbackReason as b, type MemoryRouterResult as c, type MemoryRouterTrace as d, WhisperMemoryRouter as e, createMemoryRouter as f, type AgentRuntimeOptions as g, type AgentRuntimeRankWeights as h, type AgentRuntimeRetrievalOptions as i, type AgentRuntimeSourceActivityOptions as j, type AgentRuntimeStatus as k, type CanonicalSourceCreateResult as l, type CanonicalSourceType as m, LangGraphCheckpointAdapter as n, type LearnConversationInput as o, type LearnConversationResult as p, type LearnInput as q, type LearnResult as r, type LearnSourceInput as s, type LearnSourceResult as t, type LearnSourceType as u, type LearnTextInput as v, whisperTools as w, withWhisper, type LearnTextResult as x, type Memory as y, type MemoryExtractionResult as z };

package/adapters/ai-sdk.d.ts

@@ -1082,6 +1082,27 @@ interface RunContext {
     sessionId?: string;
     traceId?: string;
 }
+interface RememberParams {
+    messages: Array<{
+        role: string;
+        content: string;
+        timestamp?: string;
+    }>;
+    userId?: string;
+    sessionId?: string;
+    project?: string;
+}
+interface IngestParams {
+    url: string;
+    name?: string;
+    token?: string;
+    project?: string;
+}
+type QueryInput = Omit<QueryParams, "query"> & {
+    query?: string;
+    q?: string;
+    userId?: string;
+};
 declare class WhisperClient {
     private readonly config;
     readonly diagnostics: {
@@ -1169,7 +1190,14 @@ declare class WhisperClient {
         project?: string;
         requireIdentity?: boolean;
     }): Promise<WhisperPreflightResult>;
-    query(params: QueryParams): Promise<QueryResult>;
+    query(params: QueryInput): Promise<QueryResult>;
+    remember(params: RememberParams): Promise<LearnResult>;
+    ingest(params: IngestParams): Promise<LearnResult>;
+    userProfile(userId: string): Promise<{
+        user_id: string;
+        memories: unknown[];
+        count: number;
+    }>;
     ingestSession(params: {
         project?: string;
         session_id: string;
@@ -2431,4 +2459,4 @@ declare class WhisperContext {
     };
 }
 
-export { type WhisperEnvironment as $, type AgentRunContext as A, type MemoryKind as B, type CanonicalSourceCreateParams as C, type MemoryLatencyBreakdown as D, type ExtractedMemory as E, type MemorySearchResponse as F, type MemoryWriteAck as G, type MemoryWriteResult as H, type Project as I, type QueryResult as J, type TurnInput as K, LangChainMemoryAdapter as L, type MemoryRouterConfig as M, type VideoSourceMetadata as N, Whisper as O, type PreparedTurn as P, type QueryParams as Q, type RunContext as R, type Source as S, type TurnCaptureResult as T, WhisperAgentMiddleware as U, type VideoIngestionStatus as V, type WhisperToolDefinition as W, type WithWhisperOptions, WhisperClient as X, type WhisperClientConfig as Y, type WhisperConfig as Z, WhisperContext as _, type WhisperToolsOptions as a, WhisperError as a0, type WhisperErrorCode as a1, type WhisperIdentityMode as a2, type WhisperPreflightCheck as a3, type WhisperPreflightResult as a4, type WhisperResolvedIdentity as a5, type WorkEvent as a6, type WorkEventKind as a7, type WorkEventSalience as a8, createAgentMiddleware as a9, createLangChainMemoryAdapter as aa, createLangGraphCheckpointAdapter as ab, memoryGraphToMermaid as ac, type MemoryRouterFallbackReason as b, type MemoryRouterResult as c, type MemoryRouterTrace as d, WhisperMemoryRouter as e, createMemoryRouter as f, type AgentRuntimeOptions as g, type AgentRuntimeRankWeights as h, type AgentRuntimeRetrievalOptions as i, type AgentRuntimeSourceActivityOptions as j, type AgentRuntimeStatus as k, type CanonicalSourceCreateResult as l, type CanonicalSourceType as m, LangGraphCheckpointAdapter as n, type LearnConversationInput as o, type LearnConversationResult as p, type LearnInput as q, type LearnResult as r, type LearnSourceInput as s, type LearnSourceResult as t, type LearnSourceType as u, type LearnTextInput as v, whisperTools as w, withWhisper, type LearnTextResult as x, type Memory as y, type MemoryExtractionResult as z };
+export { type WhisperClientConfig as $, type AgentRunContext as A, type MemoryKind as B, type CanonicalSourceCreateParams as C, type MemoryLatencyBreakdown as D, type ExtractedMemory as E, type MemorySearchResponse as F, type MemoryWriteAck as G, type MemoryWriteResult as H, type IngestParams as I, type Project as J, type QueryParams as K, LangChainMemoryAdapter as L, type MemoryRouterConfig as M, type QueryResult as N, type RunContext as O, type PreparedTurn as P, type QueryInput as Q, type RememberParams as R, type Source as S, type TurnCaptureResult as T, type TurnInput as U, type VideoIngestionStatus as V, type WhisperToolDefinition as W, type WithWhisperOptions, type VideoSourceMetadata as X, Whisper as Y, WhisperAgentMiddleware as Z, WhisperClient as _, type WhisperToolsOptions as a, type WhisperConfig as a0, WhisperContext as a1, type WhisperEnvironment as a2, WhisperError as a3, type WhisperErrorCode as a4, type WhisperIdentityMode as a5, type WhisperPreflightCheck as a6, type WhisperPreflightResult as a7, type WhisperResolvedIdentity as a8, type WorkEvent as a9, type WorkEventKind as aa, type WorkEventSalience as ab, createAgentMiddleware as ac, createLangChainMemoryAdapter as ad, createLangGraphCheckpointAdapter as ae, memoryGraphToMermaid as af, type MemoryRouterFallbackReason as b, type MemoryRouterResult as c, type MemoryRouterTrace as d, WhisperMemoryRouter as e, createMemoryRouter as f, type AgentRuntimeOptions as g, type AgentRuntimeRankWeights as h, type AgentRuntimeRetrievalOptions as i, type AgentRuntimeSourceActivityOptions as j, type AgentRuntimeStatus as k, type CanonicalSourceCreateResult as l, type CanonicalSourceType as m, LangGraphCheckpointAdapter as n, type LearnConversationInput as o, type LearnConversationResult as p, type LearnInput as q, type LearnResult as r, type LearnSourceInput as s, type LearnSourceResult as t, type LearnSourceType as u, type LearnTextInput as v, whisperTools as w, withWhisper, type LearnTextResult as x, type Memory as y, type MemoryExtractionResult as z };

package/adapters/ai-sdk.js

@@ -2272,6 +2272,16 @@ function classifyRuntimeErrorCode(error) {
   if (error.code === "PROJECT_NOT_FOUND" || error.code === "NOT_FOUND") return "PROJECT_NOT_FOUND";
   return "REQUEST_FAILED";
 }
+function detectSourceType(url) {
+  const ghMatch = url.match(/github\.com\/([^/?#]+)\/([^/?#]+)/);
+  if (ghMatch) {
+    const [, owner, repo] = ghMatch;
+    return { type: "github", owner, repo: repo.replace(/\.git$/, "") };
+  }
+  if (/youtube\.com|youtu\.be|loom\.com/.test(url)) return { type: "video" };
+  if (/\.pdf(\?|$)/.test(url)) return { type: "pdf" };
+  return { type: "web" };
+}
 var WhisperClient = class _WhisperClient {
   constructor(config) {
     this.config = config;
@@ -2798,7 +2808,14 @@ var WhisperClient = class _WhisperClient {
   }
   async query(params) {
     return this.runOrThrow(async () => {
-      const identityParams = await this.withIdentity(params);
+      const { q, userId, ...rest } = params;
+      const normalized = {
+        ...rest,
+        query: rest.query ?? q ?? "",
+        user_id: rest.user_id ?? userId,
+        include_memories: rest.include_memories ?? true
+      };
+      const identityParams = await this.withIdentity(normalized);
       const project = (await this.resolveProject(identityParams.project)).id;
       const response = await this.runtimeClient.request({
         endpoint: "/v1/context/query",
@@ -2813,6 +2830,40 @@ var WhisperClient = class _WhisperClient {
       return response.data;
     });
   }
+  async remember(params) {
+    if (!params.userId && !this.getIdentity) {
+      throw new WhisperError({
+        code: "AUTH_IDENTITY_REQUIRED",
+        message: "remember() requires userId or a getIdentity() resolver on the client.",
+        retryable: false,
+        hint: "Pass userId in the call or configure getIdentity() in WhisperClient."
+      });
+    }
+    const sessionId = params.sessionId ?? (typeof crypto !== "undefined" && typeof crypto.randomUUID === "function" ? crypto.randomUUID() : `session_${Math.random().toString(36).slice(2, 11)}`);
+    return this.learn({
+      mode: "conversation",
+      project: params.project,
+      user_id: params.userId,
+      session_id: sessionId,
+      messages: params.messages
+    });
+  }
+  async ingest(params) {
+    const detected = detectSourceType(params.url);
+    return this.learn({
+      mode: "source",
+      project: params.project,
+      type: detected.type,
+      url: params.url,
+      name: params.name,
+      token: params.token,
+      ...detected.owner ? { owner: detected.owner } : {},
+      ...detected.repo ? { repo: detected.repo } : {}
+    });
+  }
+  async userProfile(userId) {
+    return this.memory.getUserProfile({ user_id: userId });
+  }
   async ingestSession(params) {
     return this.runOrThrow(async () => {
       const identityParams = await this.withIdentity(params);

package/adapters/ai-sdk.mjs

@@ -2236,6 +2236,16 @@ function classifyRuntimeErrorCode(error) {
   if (error.code === "PROJECT_NOT_FOUND" || error.code === "NOT_FOUND") return "PROJECT_NOT_FOUND";
   return "REQUEST_FAILED";
 }
+function detectSourceType(url) {
+  const ghMatch = url.match(/github\.com\/([^/?#]+)\/([^/?#]+)/);
+  if (ghMatch) {
+    const [, owner, repo] = ghMatch;
+    return { type: "github", owner, repo: repo.replace(/\.git$/, "") };
+  }
+  if (/youtube\.com|youtu\.be|loom\.com/.test(url)) return { type: "video" };
+  if (/\.pdf(\?|$)/.test(url)) return { type: "pdf" };
+  return { type: "web" };
+}
 var WhisperClient = class _WhisperClient {
   constructor(config) {
     this.config = config;
@@ -2762,7 +2772,14 @@ var WhisperClient = class _WhisperClient {
   }
   async query(params) {
     return this.runOrThrow(async () => {
-      const identityParams = await this.withIdentity(params);
+      const { q, userId, ...rest } = params;
+      const normalized = {
+        ...rest,
+        query: rest.query ?? q ?? "",
+        user_id: rest.user_id ?? userId,
+        include_memories: rest.include_memories ?? true
+      };
+      const identityParams = await this.withIdentity(normalized);
       const project = (await this.resolveProject(identityParams.project)).id;
       const response = await this.runtimeClient.request({
         endpoint: "/v1/context/query",
@@ -2777,6 +2794,40 @@ var WhisperClient = class _WhisperClient {
       return response.data;
     });
   }
+  async remember(params) {
+    if (!params.userId && !this.getIdentity) {
+      throw new WhisperError({
+        code: "AUTH_IDENTITY_REQUIRED",
+        message: "remember() requires userId or a getIdentity() resolver on the client.",
+        retryable: false,
+        hint: "Pass userId in the call or configure getIdentity() in WhisperClient."
+      });
+    }
+    const sessionId = params.sessionId ?? (typeof crypto !== "undefined" && typeof crypto.randomUUID === "function" ? crypto.randomUUID() : `session_${Math.random().toString(36).slice(2, 11)}`);
+    return this.learn({
+      mode: "conversation",
+      project: params.project,
+      user_id: params.userId,
+      session_id: sessionId,
+      messages: params.messages
+    });
+  }
+  async ingest(params) {
+    const detected = detectSourceType(params.url);
+    return this.learn({
+      mode: "source",
+      project: params.project,
+      type: detected.type,
+      url: params.url,
+      name: params.name,
+      token: params.token,
+      ...detected.owner ? { owner: detected.owner } : {},
+      ...detected.repo ? { repo: detected.repo } : {}
+    });
+  }
+  async userProfile(userId) {
+    return this.memory.getUserProfile({ user_id: userId });
+  }
   async ingestSession(params) {
     return this.runOrThrow(async () => {
       const identityParams = await this.withIdentity(params);

package/adapters/tools.js

@@ -6313,6 +6313,16 @@ function classifyRuntimeErrorCode(error) {
   if (error.code === "PROJECT_NOT_FOUND" || error.code === "NOT_FOUND") return "PROJECT_NOT_FOUND";
   return "REQUEST_FAILED";
 }
+function detectSourceType(url) {
+  const ghMatch = url.match(/github\.com\/([^/?#]+)\/([^/?#]+)/);
+  if (ghMatch) {
+    const [, owner, repo] = ghMatch;
+    return { type: "github", owner, repo: repo.replace(/\.git$/, "") };
+  }
+  if (/youtube\.com|youtu\.be|loom\.com/.test(url)) return { type: "video" };
+  if (/\.pdf(\?|$)/.test(url)) return { type: "pdf" };
+  return { type: "web" };
+}
 var WhisperClient = class _WhisperClient {
   constructor(config) {
     this.config = config;
@@ -6839,7 +6849,14 @@ var WhisperClient = class _WhisperClient {
   }
   async query(params) {
     return this.runOrThrow(async () => {
-      const identityParams = await this.withIdentity(params);
+      const { q, userId, ...rest } = params;
+      const normalized = {
+        ...rest,
+        query: rest.query ?? q ?? "",
+        user_id: rest.user_id ?? userId,
+        include_memories: rest.include_memories ?? true
+      };
+      const identityParams = await this.withIdentity(normalized);
       const project = (await this.resolveProject(identityParams.project)).id;
       const response = await this.runtimeClient.request({
         endpoint: "/v1/context/query",
@@ -6854,6 +6871,40 @@ var WhisperClient = class _WhisperClient {
       return response.data;
     });
   }
+  async remember(params) {
+    if (!params.userId && !this.getIdentity) {
+      throw new WhisperError({
+        code: "AUTH_IDENTITY_REQUIRED",
+        message: "remember() requires userId or a getIdentity() resolver on the client.",
+        retryable: false,
+        hint: "Pass userId in the call or configure getIdentity() in WhisperClient."
+      });
+    }
+    const sessionId = params.sessionId ?? (typeof crypto !== "undefined" && typeof crypto.randomUUID === "function" ? crypto.randomUUID() : `session_${Math.random().toString(36).slice(2, 11)}`);
+    return this.learn({
+      mode: "conversation",
+      project: params.project,
+      user_id: params.userId,
+      session_id: sessionId,
+      messages: params.messages
+    });
+  }
+  async ingest(params) {
+    const detected = detectSourceType(params.url);
+    return this.learn({
+      mode: "source",
+      project: params.project,
+      type: detected.type,
+      url: params.url,
+      name: params.name,
+      token: params.token,
+      ...detected.owner ? { owner: detected.owner } : {},
+      ...detected.repo ? { repo: detected.repo } : {}
+    });
+  }
+  async userProfile(userId) {
+    return this.memory.getUserProfile({ user_id: userId });
+  }
   async ingestSession(params) {
     return this.runOrThrow(async () => {
       const identityParams = await this.withIdentity(params);

package/adapters/tools.mjs

@@ -6283,6 +6283,16 @@ function classifyRuntimeErrorCode(error) {
   if (error.code === "PROJECT_NOT_FOUND" || error.code === "NOT_FOUND") return "PROJECT_NOT_FOUND";
   return "REQUEST_FAILED";
 }
+function detectSourceType(url) {
+  const ghMatch = url.match(/github\.com\/([^/?#]+)\/([^/?#]+)/);
+  if (ghMatch) {
+    const [, owner, repo] = ghMatch;
+    return { type: "github", owner, repo: repo.replace(/\.git$/, "") };
+  }
+  if (/youtube\.com|youtu\.be|loom\.com/.test(url)) return { type: "video" };
+  if (/\.pdf(\?|$)/.test(url)) return { type: "pdf" };
+  return { type: "web" };
+}
 var WhisperClient = class _WhisperClient {
   constructor(config) {
     this.config = config;
@@ -6809,7 +6819,14 @@ var WhisperClient = class _WhisperClient {
   }
   async query(params) {
     return this.runOrThrow(async () => {
-      const identityParams = await this.withIdentity(params);
+      const { q, userId, ...rest } = params;
+      const normalized = {
+        ...rest,
+        query: rest.query ?? q ?? "",
+        user_id: rest.user_id ?? userId,
+        include_memories: rest.include_memories ?? true
+      };
+      const identityParams = await this.withIdentity(normalized);
       const project = (await this.resolveProject(identityParams.project)).id;
       const response = await this.runtimeClient.request({
         endpoint: "/v1/context/query",
@@ -6824,6 +6841,40 @@ var WhisperClient = class _WhisperClient {
       return response.data;
     });
   }
+  async remember(params) {
+    if (!params.userId && !this.getIdentity) {
+      throw new WhisperError({
+        code: "AUTH_IDENTITY_REQUIRED",
+        message: "remember() requires userId or a getIdentity() resolver on the client.",
+        retryable: false,
+        hint: "Pass userId in the call or configure getIdentity() in WhisperClient."
+      });
+    }
+    const sessionId = params.sessionId ?? (typeof crypto !== "undefined" && typeof crypto.randomUUID === "function" ? crypto.randomUUID() : `session_${Math.random().toString(36).slice(2, 11)}`);
+    return this.learn({
+      mode: "conversation",
+      project: params.project,
+      user_id: params.userId,
+      session_id: sessionId,
+      messages: params.messages
+    });
+  }
+  async ingest(params) {
+    const detected = detectSourceType(params.url);
+    return this.learn({
+      mode: "source",
+      project: params.project,
+      type: detected.type,
+      url: params.url,
+      name: params.name,
+      token: params.token,
+      ...detected.owner ? { owner: detected.owner } : {},
+      ...detected.repo ? { repo: detected.repo } : {}
+    });
+  }
+  async userProfile(userId) {
+    return this.memory.getUserProfile({ user_id: userId });
+  }
   async ingestSession(params) {
     return this.runOrThrow(async () => {
       const identityParams = await this.withIdentity(params);

package/index.d.mts

@@ -1,2 +1,2 @@
-export { A as AgentRunContext, g as AgentRuntimeOptions, h as AgentRuntimeRankWeights, i as AgentRuntimeRetrievalOptions, j as AgentRuntimeSourceActivityOptions, k as AgentRuntimeStatus, C as CanonicalSourceCreateParams, l as CanonicalSourceCreateResult, m as CanonicalSourceType, E as ExtractedMemory, L as LangChainMemoryAdapter, n as LangGraphCheckpointAdapter, o as LearnConversationInput, p as LearnConversationResult, q as LearnInput, r as LearnResult, s as LearnSourceInput, t as LearnSourceResult, u as LearnSourceType, v as LearnTextInput, x as LearnTextResult, y as Memory, z as MemoryExtractionResult, B as MemoryKind, D as MemoryLatencyBreakdown, M as MemoryRouterConfig, b as MemoryRouterFallbackReason, c as MemoryRouterResult, d as MemoryRouterTrace, F as MemorySearchResponse, G as MemoryWriteAck, H as MemoryWriteResult, P as PreparedTurn, I as Project, Q as QueryParams, J as QueryResult, R as RunContext, S as Source, T as TurnCaptureResult, K as TurnInput, V as VideoIngestionStatus, N as VideoSourceMetadata, O as Whisper, U as WhisperAgentMiddleware, X as WhisperClient, Y as WhisperClientConfig, Z as WhisperConfig, _ as WhisperContext, O as WhisperDefault, $ as WhisperEnvironment, a0 as WhisperError, a1 as WhisperErrorCode, a2 as WhisperIdentityMode, e as WhisperMemoryRouter, a3 as WhisperPreflightCheck, a4 as WhisperPreflightResult, a5 as WhisperResolvedIdentity, X as WhisperRuntimeClient, W as WhisperToolDefinition, a as WhisperToolsOptions, WithWhisperOptions, a6 as WorkEvent, a7 as WorkEventKind, a8 as WorkEventSalience, a9 as createAgentMiddleware, aa as createLangChainMemoryAdapter, ab as createLangGraphCheckpointAdapter, f as createMemoryRouter, _ as default, ac as memoryGraphToMermaid, w as whisperTools, withWhisper } from './adapters/ai-sdk.mjs';
+export { A as AgentRunContext, g as AgentRuntimeOptions, h as AgentRuntimeRankWeights, i as AgentRuntimeRetrievalOptions, j as AgentRuntimeSourceActivityOptions, k as AgentRuntimeStatus, C as CanonicalSourceCreateParams, l as CanonicalSourceCreateResult, m as CanonicalSourceType, E as ExtractedMemory, I as IngestParams, L as LangChainMemoryAdapter, n as LangGraphCheckpointAdapter, o as LearnConversationInput, p as LearnConversationResult, q as LearnInput, r as LearnResult, s as LearnSourceInput, t as LearnSourceResult, u as LearnSourceType, v as LearnTextInput, x as LearnTextResult, y as Memory, z as MemoryExtractionResult, B as MemoryKind, D as MemoryLatencyBreakdown, M as MemoryRouterConfig, b as MemoryRouterFallbackReason, c as MemoryRouterResult, d as MemoryRouterTrace, F as MemorySearchResponse, G as MemoryWriteAck, H as MemoryWriteResult, P as PreparedTurn, J as Project, Q as QueryInput, K as QueryParams, N as QueryResult, R as RememberParams, O as RunContext, S as Source, T as TurnCaptureResult, U as TurnInput, V as VideoIngestionStatus, X as VideoSourceMetadata, Y as Whisper, Z as WhisperAgentMiddleware, _ as WhisperClient, $ as WhisperClientConfig, a0 as WhisperConfig, a1 as WhisperContext, Y as WhisperDefault, a2 as WhisperEnvironment, a3 as WhisperError, a4 as WhisperErrorCode, a5 as WhisperIdentityMode, e as WhisperMemoryRouter, a6 as WhisperPreflightCheck, a7 as WhisperPreflightResult, a8 as WhisperResolvedIdentity, _ as WhisperRuntimeClient, W as WhisperToolDefinition, a as WhisperToolsOptions, WithWhisperOptions, a9 as WorkEvent, aa as WorkEventKind, ab as WorkEventSalience, ac as createAgentMiddleware, ad as createLangChainMemoryAdapter, ae as createLangGraphCheckpointAdapter, f as createMemoryRouter, a1 as default, af as memoryGraphToMermaid, w as whisperTools, withWhisper } from './adapters/ai-sdk.mjs';
 import 'zod';

package/index.d.ts

@@ -1,2 +1,2 @@
-export { A as AgentRunContext, g as AgentRuntimeOptions, h as AgentRuntimeRankWeights, i as AgentRuntimeRetrievalOptions, j as AgentRuntimeSourceActivityOptions, k as AgentRuntimeStatus, C as CanonicalSourceCreateParams, l as CanonicalSourceCreateResult, m as CanonicalSourceType, E as ExtractedMemory, L as LangChainMemoryAdapter, n as LangGraphCheckpointAdapter, o as LearnConversationInput, p as LearnConversationResult, q as LearnInput, r as LearnResult, s as LearnSourceInput, t as LearnSourceResult, u as LearnSourceType, v as LearnTextInput, x as LearnTextResult, y as Memory, z as MemoryExtractionResult, B as MemoryKind, D as MemoryLatencyBreakdown, M as MemoryRouterConfig, b as MemoryRouterFallbackReason, c as MemoryRouterResult, d as MemoryRouterTrace, F as MemorySearchResponse, G as MemoryWriteAck, H as MemoryWriteResult, P as PreparedTurn, I as Project, Q as QueryParams, J as QueryResult, R as RunContext, S as Source, T as TurnCaptureResult, K as TurnInput, V as VideoIngestionStatus, N as VideoSourceMetadata, O as Whisper, U as WhisperAgentMiddleware, X as WhisperClient, Y as WhisperClientConfig, Z as WhisperConfig, _ as WhisperContext, O as WhisperDefault, $ as WhisperEnvironment, a0 as WhisperError, a1 as WhisperErrorCode, a2 as WhisperIdentityMode, e as WhisperMemoryRouter, a3 as WhisperPreflightCheck, a4 as WhisperPreflightResult, a5 as WhisperResolvedIdentity, X as WhisperRuntimeClient, W as WhisperToolDefinition, a as WhisperToolsOptions, WithWhisperOptions, a6 as WorkEvent, a7 as WorkEventKind, a8 as WorkEventSalience, a9 as createAgentMiddleware, aa as createLangChainMemoryAdapter, ab as createLangGraphCheckpointAdapter, f as createMemoryRouter, _ as default, ac as memoryGraphToMermaid, w as whisperTools, withWhisper } from './adapters/ai-sdk.js';
+export { A as AgentRunContext, g as AgentRuntimeOptions, h as AgentRuntimeRankWeights, i as AgentRuntimeRetrievalOptions, j as AgentRuntimeSourceActivityOptions, k as AgentRuntimeStatus, C as CanonicalSourceCreateParams, l as CanonicalSourceCreateResult, m as CanonicalSourceType, E as ExtractedMemory, I as IngestParams, L as LangChainMemoryAdapter, n as LangGraphCheckpointAdapter, o as LearnConversationInput, p as LearnConversationResult, q as LearnInput, r as LearnResult, s as LearnSourceInput, t as LearnSourceResult, u as LearnSourceType, v as LearnTextInput, x as LearnTextResult, y as Memory, z as MemoryExtractionResult, B as MemoryKind, D as MemoryLatencyBreakdown, M as MemoryRouterConfig, b as MemoryRouterFallbackReason, c as MemoryRouterResult, d as MemoryRouterTrace, F as MemorySearchResponse, G as MemoryWriteAck, H as MemoryWriteResult, P as PreparedTurn, J as Project, Q as QueryInput, K as QueryParams, N as QueryResult, R as RememberParams, O as RunContext, S as Source, T as TurnCaptureResult, U as TurnInput, V as VideoIngestionStatus, X as VideoSourceMetadata, Y as Whisper, Z as WhisperAgentMiddleware, _ as WhisperClient, $ as WhisperClientConfig, a0 as WhisperConfig, a1 as WhisperContext, Y as WhisperDefault, a2 as WhisperEnvironment, a3 as WhisperError, a4 as WhisperErrorCode, a5 as WhisperIdentityMode, e as WhisperMemoryRouter, a6 as WhisperPreflightCheck, a7 as WhisperPreflightResult, a8 as WhisperResolvedIdentity, _ as WhisperRuntimeClient, W as WhisperToolDefinition, a as WhisperToolsOptions, WithWhisperOptions, a9 as WorkEvent, aa as WorkEventKind, ab as WorkEventSalience, ac as createAgentMiddleware, ad as createLangChainMemoryAdapter, ae as createLangGraphCheckpointAdapter, f as createMemoryRouter, a1 as default, af as memoryGraphToMermaid, w as whisperTools, withWhisper } from './adapters/ai-sdk.js';
 import 'zod';

package/index.js

@@ -2289,6 +2289,16 @@ function classifyRuntimeErrorCode(error) {
   if (error.code === "PROJECT_NOT_FOUND" || error.code === "NOT_FOUND") return "PROJECT_NOT_FOUND";
   return "REQUEST_FAILED";
 }
+function detectSourceType(url) {
+  const ghMatch = url.match(/github\.com\/([^/?#]+)\/([^/?#]+)/);
+  if (ghMatch) {
+    const [, owner, repo] = ghMatch;
+    return { type: "github", owner, repo: repo.replace(/\.git$/, "") };
+  }
+  if (/youtube\.com|youtu\.be|loom\.com/.test(url)) return { type: "video" };
+  if (/\.pdf(\?|$)/.test(url)) return { type: "pdf" };
+  return { type: "web" };
+}
 var WhisperClient = class _WhisperClient {
   constructor(config) {
     this.config = config;
@@ -2815,7 +2825,14 @@ var WhisperClient = class _WhisperClient {
   }
   async query(params) {
     return this.runOrThrow(async () => {
-      const identityParams = await this.withIdentity(params);
+      const { q, userId, ...rest } = params;
+      const normalized = {
+        ...rest,
+        query: rest.query ?? q ?? "",
+        user_id: rest.user_id ?? userId,
+        include_memories: rest.include_memories ?? true
+      };
+      const identityParams = await this.withIdentity(normalized);
       const project = (await this.resolveProject(identityParams.project)).id;
       const response = await this.runtimeClient.request({
         endpoint: "/v1/context/query",
@@ -2830,6 +2847,40 @@ var WhisperClient = class _WhisperClient {
       return response.data;
     });
   }
+  async remember(params) {
+    if (!params.userId && !this.getIdentity) {
+      throw new WhisperError({
+        code: "AUTH_IDENTITY_REQUIRED",
+        message: "remember() requires userId or a getIdentity() resolver on the client.",
+        retryable: false,
+        hint: "Pass userId in the call or configure getIdentity() in WhisperClient."
+      });
+    }
+    const sessionId = params.sessionId ?? (typeof crypto !== "undefined" && typeof crypto.randomUUID === "function" ? crypto.randomUUID() : `session_${Math.random().toString(36).slice(2, 11)}`);
+    return this.learn({
+      mode: "conversation",
+      project: params.project,
+      user_id: params.userId,
+      session_id: sessionId,
+      messages: params.messages
+    });
+  }
+  async ingest(params) {
+    const detected = detectSourceType(params.url);
+    return this.learn({
+      mode: "source",
+      project: params.project,
+      type: detected.type,
+      url: params.url,
+      name: params.name,
+      token: params.token,
+      ...detected.owner ? { owner: detected.owner } : {},
+      ...detected.repo ? { repo: detected.repo } : {}
+    });
+  }
+  async userProfile(userId) {
+    return this.memory.getUserProfile({ user_id: userId });
+  }
   async ingestSession(params) {
     return this.runOrThrow(async () => {
       const identityParams = await this.withIdentity(params);

package/index.mjs

@@ -2242,6 +2242,16 @@ function classifyRuntimeErrorCode(error) {
   if (error.code === "PROJECT_NOT_FOUND" || error.code === "NOT_FOUND") return "PROJECT_NOT_FOUND";
   return "REQUEST_FAILED";
 }
+function detectSourceType(url) {
+  const ghMatch = url.match(/github\.com\/([^/?#]+)\/([^/?#]+)/);
+  if (ghMatch) {
+    const [, owner, repo] = ghMatch;
+    return { type: "github", owner, repo: repo.replace(/\.git$/, "") };
+  }
+  if (/youtube\.com|youtu\.be|loom\.com/.test(url)) return { type: "video" };
+  if (/\.pdf(\?|$)/.test(url)) return { type: "pdf" };
+  return { type: "web" };
+}
 var WhisperClient = class _WhisperClient {
   constructor(config) {
     this.config = config;
@@ -2768,7 +2778,14 @@ var WhisperClient = class _WhisperClient {
   }
   async query(params) {
     return this.runOrThrow(async () => {
-      const identityParams = await this.withIdentity(params);
+      const { q, userId, ...rest } = params;
+      const normalized = {
+        ...rest,
+        query: rest.query ?? q ?? "",
+        user_id: rest.user_id ?? userId,
+        include_memories: rest.include_memories ?? true
+      };
+      const identityParams = await this.withIdentity(normalized);
       const project = (await this.resolveProject(identityParams.project)).id;
       const response = await this.runtimeClient.request({
         endpoint: "/v1/context/query",
@@ -2783,6 +2800,40 @@ var WhisperClient = class _WhisperClient {
       return response.data;
     });
   }
+  async remember(params) {
+    if (!params.userId && !this.getIdentity) {
+      throw new WhisperError({
+        code: "AUTH_IDENTITY_REQUIRED",
+        message: "remember() requires userId or a getIdentity() resolver on the client.",
+        retryable: false,
+        hint: "Pass userId in the call or configure getIdentity() in WhisperClient."
+      });
+    }
+    const sessionId = params.sessionId ?? (typeof crypto !== "undefined" && typeof crypto.randomUUID === "function" ? crypto.randomUUID() : `session_${Math.random().toString(36).slice(2, 11)}`);
+    return this.learn({
+      mode: "conversation",
+      project: params.project,
+      user_id: params.userId,
+      session_id: sessionId,
+      messages: params.messages
+    });
+  }
+  async ingest(params) {
+    const detected = detectSourceType(params.url);
+    return this.learn({
+      mode: "source",
+      project: params.project,
+      type: detected.type,
+      url: params.url,
+      name: params.name,
+      token: params.token,
+      ...detected.owner ? { owner: detected.owner } : {},
+      ...detected.repo ? { repo: detected.repo } : {}
+    });
+  }
+  async userProfile(userId) {
+    return this.memory.getUserProfile({ user_id: userId });
+  }
   async ingestSession(params) {
     return this.runOrThrow(async () => {
       const identityParams = await this.withIdentity(params);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@usewhisper/sdk",
-  "version": "3.10.1",
+  "version": "3.11.0",
   "whisperContractVersion": "2026.03.11",
   "scripts": {
     "build": "tsup ../src/sdk/index.ts ../src/sdk/adapters/ai-sdk.ts ../src/sdk/adapters/tools.ts ../src/sdk/router/memory-router.ts --format esm,cjs --dts --splitting false --out-dir .",

package/router/memory-router.js

@@ -2273,6 +2273,16 @@ function classifyRuntimeErrorCode(error) {
   if (error.code === "PROJECT_NOT_FOUND" || error.code === "NOT_FOUND") return "PROJECT_NOT_FOUND";
   return "REQUEST_FAILED";
 }
+function detectSourceType(url) {
+  const ghMatch = url.match(/github\.com\/([^/?#]+)\/([^/?#]+)/);
+  if (ghMatch) {
+    const [, owner, repo] = ghMatch;
+    return { type: "github", owner, repo: repo.replace(/\.git$/, "") };
+  }
+  if (/youtube\.com|youtu\.be|loom\.com/.test(url)) return { type: "video" };
+  if (/\.pdf(\?|$)/.test(url)) return { type: "pdf" };
+  return { type: "web" };
+}
 var WhisperClient = class _WhisperClient {
   constructor(config) {
     this.config = config;
@@ -2799,7 +2809,14 @@ var WhisperClient = class _WhisperClient {
   }
   async query(params) {
     return this.runOrThrow(async () => {
-      const identityParams = await this.withIdentity(params);
+      const { q, userId, ...rest } = params;
+      const normalized = {
+        ...rest,
+        query: rest.query ?? q ?? "",
+        user_id: rest.user_id ?? userId,
+        include_memories: rest.include_memories ?? true
+      };
+      const identityParams = await this.withIdentity(normalized);
       const project = (await this.resolveProject(identityParams.project)).id;
       const response = await this.runtimeClient.request({
         endpoint: "/v1/context/query",
@@ -2814,6 +2831,40 @@ var WhisperClient = class _WhisperClient {
       return response.data;
     });
   }
+  async remember(params) {
+    if (!params.userId && !this.getIdentity) {
+      throw new WhisperError({
+        code: "AUTH_IDENTITY_REQUIRED",
+        message: "remember() requires userId or a getIdentity() resolver on the client.",
+        retryable: false,
+        hint: "Pass userId in the call or configure getIdentity() in WhisperClient."
+      });
+    }
+    const sessionId = params.sessionId ?? (typeof crypto !== "undefined" && typeof crypto.randomUUID === "function" ? crypto.randomUUID() : `session_${Math.random().toString(36).slice(2, 11)}`);
+    return this.learn({
+      mode: "conversation",
+      project: params.project,
+      user_id: params.userId,
+      session_id: sessionId,
+      messages: params.messages
+    });
+  }
+  async ingest(params) {
+    const detected = detectSourceType(params.url);
+    return this.learn({
+      mode: "source",
+      project: params.project,
+      type: detected.type,
+      url: params.url,
+      name: params.name,
+      token: params.token,
+      ...detected.owner ? { owner: detected.owner } : {},
+      ...detected.repo ? { repo: detected.repo } : {}
+    });
+  }
+  async userProfile(userId) {
+    return this.memory.getUserProfile({ user_id: userId });
+  }
   async ingestSession(params) {
     return this.runOrThrow(async () => {
       const identityParams = await this.withIdentity(params);