@usewhisper/sdk 3.3.0 → 3.5.0

package/index.js

@@ -1599,7 +1599,582 @@ var AnalyticsModule = class {
   }
 };
 
+// ../src/sdk/agent-runtime.ts
+function detectBrowserStorage() {
+  const maybeStorage = globalThis.localStorage;
+  if (!maybeStorage || typeof maybeStorage !== "object") return null;
+  const candidate = maybeStorage;
+  if (typeof candidate.getItem !== "function" || typeof candidate.setItem !== "function") {
+    return null;
+  }
+  return {
+    getItem: candidate.getItem,
+    setItem: candidate.setItem
+  };
+}
+function createBindingStore(filePath) {
+  const storage = detectBrowserStorage();
+  if (storage) {
+    const key = "whisper_agent_runtime_bindings";
+    return {
+      async load() {
+        const raw = storage.getItem(key);
+        if (!raw) return {};
+        try {
+          const parsed = JSON.parse(raw);
+          return parsed && typeof parsed === "object" ? parsed : {};
+        } catch {
+          return {};
+        }
+      },
+      async save(bindings) {
+        storage.setItem(key, JSON.stringify(bindings));
+      }
+    };
+  }
+  return {
+    async load() {
+      if (typeof process === "undefined") return {};
+      const fs = await import("fs/promises");
+      const path = filePath || `${process.env.USERPROFILE || process.env.HOME || "."}/.whisper/sdk/agent-bindings.json`;
+      try {
+        const raw = await fs.readFile(path, "utf8");
+        const parsed = JSON.parse(raw);
+        return parsed && typeof parsed === "object" ? parsed : {};
+      } catch {
+        return {};
+      }
+    },
+    async save(bindings) {
+      if (typeof process === "undefined") return;
+      const fs = await import("fs/promises");
+      const pathMod = await import("path");
+      const path = filePath || `${process.env.USERPROFILE || process.env.HOME || "."}/.whisper/sdk/agent-bindings.json`;
+      await fs.mkdir(pathMod.dirname(path), { recursive: true });
+      await fs.writeFile(path, JSON.stringify(bindings), "utf8");
+    }
+  };
+}
+function normalizeWorkspacePath(value) {
+  const trimmed = value?.trim();
+  if (!trimmed) return null;
+  return trimmed.replace(/\\/g, "/").replace(/\/+$/, "").toLowerCase();
+}
+function pathBase(value) {
+  const normalized = value.replace(/\\/g, "/");
+  const parts = normalized.split("/").filter(Boolean);
+  return parts[parts.length - 1] || normalized;
+}
+function defaultSalience(kind, success) {
+  if (kind === "decision" || kind === "constraint" || kind === "failure") return "high";
+  if (kind === "outcome" || kind === "task_update") return "medium";
+  if (kind === "tool_result" && success === false) return "high";
+  return "low";
+}
+function toMemoryType(kind) {
+  if (kind === "decision" || kind === "constraint") return "instruction";
+  return "event";
+}
+function summarizeLowSalience(events) {
+  const lines = events.slice(-10).map((event) => {
+    const fileSuffix = event.filePaths?.length ? ` [files: ${event.filePaths.join(", ")}]` : "";
+    const toolSuffix = event.toolName ? ` [tool: ${event.toolName}]` : "";
+    return `- ${event.kind}: ${event.summary}${fileSuffix}${toolSuffix}`;
+  });
+  return `Recent low-salience work:
+${lines.join("\n")}`;
+}
+function compactWhitespace(value) {
+  return value.replace(/\s+/g, " ").trim();
+}
+function withTimeout(promise, timeoutMs) {
+  return new Promise((resolve, reject) => {
+    const timeout = setTimeout(() => {
+      reject(new Error("timeout"));
+    }, timeoutMs);
+    promise.then(
+      (value) => {
+        clearTimeout(timeout);
+        resolve(value);
+      },
+      (error) => {
+        clearTimeout(timeout);
+        reject(error);
+      }
+    );
+  });
+}
+function extractTimestamp(metadata) {
+  const candidates = [
+    metadata?.updatedAt,
+    metadata?.createdAt,
+    metadata?.timestamp,
+    metadata?.event_date,
+    metadata?.eventDate
+  ];
+  for (const value of candidates) {
+    if (typeof value === "string") {
+      const parsed = Date.parse(value);
+      if (!Number.isNaN(parsed)) return parsed;
+    }
+  }
+  return 0;
+}
+function salienceBoost(metadata) {
+  const value = metadata?.salience;
+  if (value === "high") return 0.12;
+  if (value === "medium") return 0.06;
+  return 0;
+}
+var WhisperAgentRuntime = class {
+  constructor(args) {
+    this.args = args;
+    this.bindingStore = createBindingStore(args.options.bindingStorePath);
+    this.topK = args.options.topK ?? 6;
+    this.maxTokens = args.options.maxTokens ?? 4e3;
+    this.targetRetrievalMs = args.options.targetRetrievalMs ?? 2500;
+    this.hardRetrievalTimeoutMs = args.options.hardRetrievalTimeoutMs ?? 4e3;
+    this.recentWorkLimit = args.options.recentWorkLimit ?? 40;
+    this.baseContext = args.baseContext;
+    this.clientName = args.baseContext.clientName || "whisper-agent-runtime";
+  }
+  bindingStore;
+  topK;
+  maxTokens;
+  targetRetrievalMs;
+  hardRetrievalTimeoutMs;
+  recentWorkLimit;
+  baseContext;
+  clientName;
+  bindings = null;
+  touchedFiles = [];
+  recentWork = [];
+  bufferedLowSalience = [];
+  lastPreparedTurn = null;
+  mergedCount = 0;
+  droppedCount = 0;
+  lastScope = {};
+  async getBindings() {
+    if (!this.bindings) {
+      this.bindings = await this.bindingStore.load();
+    }
+    return this.bindings;
+  }
+  pushTouchedFiles(paths) {
+    if (!paths || paths.length === 0) return;
+    for (const path of paths) {
+      if (!path) continue;
+      this.touchedFiles = [...this.touchedFiles.filter((entry) => entry !== path), path].slice(-20);
+    }
+  }
+  pushWorkEvent(event) {
+    this.recentWork = [...this.recentWork, event].slice(-this.recentWorkLimit);
+  }
+  makeTaskFrameQuery(input) {
+    const task = compactWhitespace(input.taskSummary || "");
+    const salient = this.recentWork.filter((event) => event.salience === "high").slice(-3).map((event) => `${event.kind}: ${event.summary}`);
+    const files = [...input.touchedFiles || [], ...this.touchedFiles].slice(-3).map((file) => pathBase(file));
+    const parts = [
+      task ? `task ${task}` : "",
+      salient.length > 0 ? `recent ${salient.join(" ; ")}` : "",
+      files.length > 0 ? `files ${files.join(" ")}` : "",
+      input.toolContext ? `tool context ${compactWhitespace(input.toolContext)}` : ""
+    ].filter(Boolean);
+    if (parts.length === 0) return null;
+    return parts.join(" | ");
+  }
+  async resolveScope(overrides) {
+    const merged = {
+      ...this.baseContext,
+      ...overrides
+    };
+    const normalizedWorkspace = normalizeWorkspacePath(merged.workspacePath);
+    const bindings = await this.getBindings();
+    const workspaceProject = normalizedWorkspace ? bindings[normalizedWorkspace] : void 0;
+    const configuredProject = merged.project;
+    let projectRef = configuredProject;
+    let projectSource = overrides?.project ? "explicit" : "generated";
+    let warning;
+    if (workspaceProject) {
+      projectRef = workspaceProject;
+      projectSource = "workspace";
+      if (configuredProject && workspaceProject !== configuredProject) {
+        warning = `workspace mapping '${workspaceProject}' overrides configured project '${configuredProject}'`;
+      }
+    } else if (configuredProject) {
+      projectRef = configuredProject;
+      projectSource = overrides?.project ? "explicit" : "config";
+    }
+    const project = (await this.args.adapter.resolveProject(projectRef)).id;
+    if (normalizedWorkspace) {
+      bindings[normalizedWorkspace] = project;
+      await this.bindingStore.save(bindings);
+    }
+    const scope = {
+      ...merged,
+      project,
+      userId: merged.userId || `${this.clientName}-user`,
+      sessionId: merged.sessionId || `sess_${stableHash(`${this.clientName}_${normalizedWorkspace || "default"}`)}`
+    };
+    this.lastScope = {
+      project: scope.project,
+      userId: scope.userId,
+      sessionId: scope.sessionId,
+      source: projectSource,
+      warning
+    };
+    return { scope, projectSource, warning };
+  }
+  async runBranch(name, task) {
+    const startedAt = Date.now();
+    try {
+      const value = await withTimeout(task(), this.hardRetrievalTimeoutMs);
+      return {
+        name,
+        status: "ok",
+        durationMs: Date.now() - startedAt,
+        value
+      };
+    } catch (error) {
+      const durationMs = Date.now() - startedAt;
+      const reason = error instanceof Error ? error.message : String(error);
+      return {
+        name,
+        status: reason === "timeout" ? "timeout" : "error",
+        durationMs,
+        reason
+      };
+    }
+  }
+  contextItems(result, sourceQuery) {
+    return (result.results || []).map((item) => ({
+      id: item.id,
+      content: item.content,
+      type: "project",
+      score: item.score ?? 0,
+      sourceQuery,
+      metadata: item.metadata || {}
+    }));
+  }
+  memoryItems(result, sourceQuery) {
+    return (result.results || []).map((item, index) => ({
+      id: item.memory?.id || item.chunk?.id || `${sourceQuery}_memory_${index}`,
+      content: item.chunk?.content || item.memory?.content || "",
+      type: "memory",
+      score: item.similarity ?? 0,
+      sourceQuery,
+      metadata: {
+        ...item.chunk?.metadata || {},
+        ...item.memory?.temporal || {},
+        confidence: item.memory?.confidence
+      }
+    })).filter((item) => item.content);
+  }
+  rerank(items) {
+    const deduped = /* @__PURE__ */ new Map();
+    for (const item of items) {
+      const key = `${item.id}:${item.content.toLowerCase()}`;
+      const recency = extractTimestamp(item.metadata) > 0 ? 0.04 : 0;
+      const queryBonus = item.sourceQuery === "primary" ? 0.08 : item.sourceQuery === "task_frame" ? 0.04 : 0.03;
+      const next = {
+        ...item,
+        score: item.score + queryBonus + salienceBoost(item.metadata) + recency
+      };
+      const existing = deduped.get(key);
+      if (!existing || next.score > existing.score) {
+        deduped.set(key, next);
+      }
+    }
+    return [...deduped.values()].sort((left, right) => right.score - left.score);
+  }
+  buildContext(items) {
+    const maxChars = this.maxTokens * 4;
+    const lines = [];
+    let used = 0;
+    for (const item of items) {
+      const label = item.type === "memory" ? "memory" : "context";
+      const content = compactWhitespace(item.content);
+      if (!content) continue;
+      const line = `[${label}] ${content}`;
+      if (used + line.length > maxChars) break;
+      lines.push(line);
+      used += line.length;
+    }
+    if (lines.length === 0) return "";
+    return `Relevant context:
+${lines.join("\n")}`;
+  }
+  async bootstrap(context = {}) {
+    const { scope, warning } = await this.resolveScope(context);
+    const warnings = warning ? [warning] : [];
+    const startedAt = Date.now();
+    const branches = await Promise.all([
+      this.runBranch("session_recent", () => this.args.adapter.getSessionMemories({
+        project: scope.project,
+        session_id: scope.sessionId,
+        include_pending: true,
+        limit: 12
+      })),
+      this.runBranch("user_profile", () => scope.userId ? this.args.adapter.getUserProfile({
+        project: scope.project,
+        user_id: scope.userId,
+        include_pending: true,
+        memory_types: "preference,instruction,goal"
+      }) : Promise.resolve({ user_id: scope.userId, memories: [], count: 0 })),
+      this.runBranch("project_rules", () => this.args.adapter.query({
+        project: scope.project,
+        query: "project rules instructions constraints conventions open threads",
+        top_k: this.topK,
+        include_memories: false,
+        user_id: scope.userId,
+        session_id: scope.sessionId,
+        max_tokens: this.maxTokens,
+        compress: true,
+        compression_strategy: "adaptive"
+      }))
+    ]);
+    const items = [];
+    const branchStatus = {};
+    for (const branch of branches) {
+      branchStatus[branch.name] = branch.status;
+      if (branch.status !== "ok") {
+        if (branch.reason) warnings.push(`${branch.name}:${branch.reason}`);
+        continue;
+      }
+      if (branch.name === "project_rules") {
+        items.push(...this.contextItems(branch.value, "bootstrap"));
+        continue;
+      }
+      const records = branch.value.memories || [];
+      items.push(...records.map((memory, index) => ({
+        id: String(memory.id || `${branch.name}_${index}`),
+        content: String(memory.content || ""),
+        type: "memory",
+        score: 0.4,
+        sourceQuery: "bootstrap",
+        metadata: memory
+      })).filter((item) => item.content));
+    }
+    const ranked = this.rerank(items).slice(0, this.topK * 2);
+    const prepared = {
+      scope,
+      retrieval: {
+        primaryQuery: "bootstrap",
+        taskFrameQuery: null,
+        warnings,
+        degraded: warnings.length > 0,
+        degradedReason: warnings.length > 0 ? "partial_bootstrap" : void 0,
+        durationMs: Date.now() - startedAt,
+        targetBudgetMs: this.targetRetrievalMs,
+        hardTimeoutMs: this.hardRetrievalTimeoutMs,
+        branchStatus
+      },
+      context: this.buildContext(ranked),
+      items: ranked
+    };
+    this.lastPreparedTurn = prepared.retrieval;
+    return prepared;
+  }
+  async beforeTurn(input, context = {}) {
+    this.pushTouchedFiles(input.touchedFiles);
+    const { scope, warning } = await this.resolveScope(context);
+    const primaryQuery = compactWhitespace(input.userMessage);
+    const taskFrameQuery = this.makeTaskFrameQuery(input);
+    const warnings = warning ? [warning] : [];
+    const startedAt = Date.now();
+    const branches = await Promise.all([
+      this.runBranch("context_primary", () => this.args.adapter.query({
+        project: scope.project,
+        query: primaryQuery,
+        top_k: this.topK,
+        include_memories: false,
+        user_id: scope.userId,
+        session_id: scope.sessionId,
+        max_tokens: this.maxTokens,
+        compress: true,
+        compression_strategy: "adaptive"
+      })),
+      this.runBranch("memory_primary", () => this.args.adapter.searchMemories({
+        project: scope.project,
+        query: primaryQuery,
+        user_id: scope.userId,
+        session_id: scope.sessionId,
+        top_k: this.topK,
+        include_pending: true,
+        profile: "balanced"
+      })),
+      taskFrameQuery ? this.runBranch("context_task_frame", () => this.args.adapter.query({
+        project: scope.project,
+        query: taskFrameQuery,
+        top_k: this.topK,
+        include_memories: false,
+        user_id: scope.userId,
+        session_id: scope.sessionId,
+        max_tokens: this.maxTokens,
+        compress: true,
+        compression_strategy: "adaptive"
+      })) : Promise.resolve({
+        name: "context_task_frame",
+        status: "skipped",
+        durationMs: 0
+      }),
+      taskFrameQuery ? this.runBranch("memory_task_frame", () => this.args.adapter.searchMemories({
+        project: scope.project,
+        query: taskFrameQuery,
+        user_id: scope.userId,
+        session_id: scope.sessionId,
+        top_k: this.topK,
+        include_pending: true,
+        profile: "balanced"
+      })) : Promise.resolve({
+        name: "memory_task_frame",
+        status: "skipped",
+        durationMs: 0
+      })
+    ]);
+    const branchStatus = {};
+    const collected = [];
+    let okCount = 0;
+    for (const branch of branches) {
+      branchStatus[branch.name] = branch.status;
+      if (branch.status !== "ok") {
+        if (branch.status !== "skipped" && branch.reason) warnings.push(`${branch.name}:${branch.reason}`);
+        continue;
+      }
+      okCount += 1;
+      if (branch.name.startsWith("context")) {
+        collected.push(...this.contextItems(
+          branch.value,
+          branch.name.includes("task_frame") ? "task_frame" : "primary"
+        ));
+      } else {
+        collected.push(...this.memoryItems(
+          branch.value,
+          branch.name.includes("task_frame") ? "task_frame" : "primary"
+        ));
+      }
+    }
+    const ranked = this.rerank(collected).slice(0, this.topK * 2);
+    const prepared = {
+      scope,
+      retrieval: {
+        primaryQuery,
+        taskFrameQuery,
+        warnings,
+        degraded: okCount < branches.filter((branch) => branch.status !== "skipped").length,
+        degradedReason: okCount === 0 ? "all_retrieval_failed" : warnings.length > 0 ? "partial_retrieval_failed" : void 0,
+        durationMs: Date.now() - startedAt,
+        targetBudgetMs: this.targetRetrievalMs,
+        hardTimeoutMs: this.hardRetrievalTimeoutMs,
+        branchStatus
+      },
+      context: this.buildContext(ranked),
+      items: ranked
+    };
+    this.lastPreparedTurn = prepared.retrieval;
+    return prepared;
+  }
+  async recordWork(event, context = {}) {
+    const normalized = {
+      ...event,
+      salience: event.salience || defaultSalience(event.kind, event.success),
+      timestamp: event.timestamp || nowIso()
+    };
+    this.pushTouchedFiles(normalized.filePaths);
+    this.pushWorkEvent(normalized);
+    if (normalized.salience === "low") {
+      this.bufferedLowSalience = [...this.bufferedLowSalience, normalized].slice(-20);
+      return { success: true, buffered: true };
+    }
+    const { scope } = await this.resolveScope(context);
+    return this.args.adapter.addMemory({
+      project: scope.project,
+      user_id: scope.userId,
+      session_id: scope.sessionId,
+      content: `${normalized.kind}: ${normalized.summary}${normalized.details ? ` (${normalized.details})` : ""}`,
+      memory_type: toMemoryType(normalized.kind),
+      event_date: normalized.timestamp,
+      write_mode: "async",
+      metadata: {
+        runtime_auto: true,
+        client_name: this.clientName,
+        work_event_kind: normalized.kind,
+        salience: normalized.salience,
+        file_paths: normalized.filePaths || [],
+        tool_name: normalized.toolName,
+        success: normalized.success
+      }
+    });
+  }
+  async afterTurn(input, context = {}) {
+    this.pushTouchedFiles(input.touchedFiles);
+    const { scope } = await this.resolveScope(context);
+    const result = await this.args.adapter.ingestSession({
+      project: scope.project,
+      session_id: scope.sessionId,
+      user_id: scope.userId,
+      messages: [
+        { role: "user", content: input.userMessage, timestamp: nowIso() },
+        { role: "assistant", content: input.assistantMessage, timestamp: nowIso() }
+      ],
+      write_mode: "async"
+    });
+    this.mergedCount += result.memories_invalidated || 0;
+    return {
+      success: Boolean(result.success),
+      sessionIngested: true,
+      memoriesCreated: result.memories_created || 0,
+      relationsCreated: result.relations_created || 0,
+      invalidatedCount: result.memories_invalidated || 0,
+      mergedCount: result.memories_invalidated || 0,
+      droppedCount: 0,
+      warnings: result.errors || []
+    };
+  }
+  async flush(reason = "manual", context = {}) {
+    if (this.bufferedLowSalience.length > 0) {
+      const { scope } = await this.resolveScope(context);
+      const summary = summarizeLowSalience(this.bufferedLowSalience);
+      await this.args.adapter.addMemory({
+        project: scope.project,
+        user_id: scope.userId,
+        session_id: scope.sessionId,
+        content: summary,
+        memory_type: "event",
+        write_mode: "async",
+        metadata: {
+          runtime_auto: true,
+          client_name: this.clientName,
+          flush_reason: reason,
+          salience: "low",
+          summarized_count: this.bufferedLowSalience.length
+        }
+      });
+      this.bufferedLowSalience = [];
+    }
+    await this.args.adapter.flushQueue();
+    return this.status();
+  }
+  status() {
+    return {
+      clientName: this.clientName,
+      scope: this.lastScope,
+      queue: this.args.adapter.queueStatus(),
+      retrieval: this.lastPreparedTurn,
+      counters: {
+        mergedCount: this.mergedCount,
+        droppedCount: this.droppedCount,
+        bufferedLowSalience: this.bufferedLowSalience.length
+      }
+    };
+  }
+};
+
 // ../src/sdk/whisper.ts
+var PROJECT_CACHE_TTL_MS = 3e4;
+function isLikelyProjectId(projectRef) {
+  return /^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i.test(projectRef);
+}
 var WhisperClient = class _WhisperClient {
   constructor(config) {
     this.config = config;
@@ -1619,7 +2194,7 @@ var WhisperClient = class _WhisperClient {
       config.cache?.ttlMs ?? 7e3,
       config.cache?.capacity ?? 500
     );
-    const queueStore = config.queue?.persistence === "storage" ? createStorageQueueStore() : config.queue?.persistence === "file" && config.queue.filePath ? createFileQueueStore(config.queue.filePath) : new InMemoryQueueStore();
+    const queueStore = this.createQueueStore(config);
     this.writeQueue = new WriteQueue({
       store: queueStore,
       maxBatchSize: config.queue?.maxBatchSize ?? 50,
@@ -1752,6 +2327,9 @@ var WhisperClient = class _WhisperClient {
   sessionModule;
   profileModule;
   analyticsModule;
+  projectRefToId = /* @__PURE__ */ new Map();
+  projectCache = [];
+  projectCacheExpiresAt = 0;
   static fromEnv(overrides = {}) {
     const env = typeof process !== "undefined" ? process.env : {};
     const apiKey = overrides.apiKey || env.WHISPER_API_KEY || env.USEWHISPER_API_KEY || env.API_KEY;
@@ -1765,6 +2343,172 @@ var WhisperClient = class _WhisperClient {
       ...overrides
     });
   }
+  createQueueStore(config) {
+    const persistence = config.queue?.persistence || this.defaultQueuePersistence();
+    if (persistence === "storage") {
+      return createStorageQueueStore();
+    }
+    if (persistence === "file") {
+      const filePath = config.queue?.filePath || this.defaultQueueFilePath();
+      if (filePath) {
+        return createFileQueueStore(filePath);
+      }
+    }
+    return new InMemoryQueueStore();
+  }
+  defaultQueuePersistence() {
+    const maybeWindow = globalThis.window;
+    if (maybeWindow && typeof maybeWindow === "object") {
+      const maybeStorage = globalThis.localStorage;
+      return maybeStorage && typeof maybeStorage === "object" ? "storage" : "memory";
+    }
+    return "file";
+  }
+  defaultQueueFilePath() {
+    if (typeof process === "undefined") return void 0;
+    const path = process.env.WHISPER_QUEUE_FILE_PATH;
+    if (path) return path;
+    const home = process.env.USERPROFILE || process.env.HOME;
+    if (!home) return void 0;
+    const normalizedHome = home.replace(/[\\\/]+$/, "");
+    return `${normalizedHome}/.whisper/sdk/queue.json`;
+  }
+  getRequiredProject(project) {
+    const resolved = project || this.config.project;
+    if (!resolved) {
+      throw new RuntimeClientError({
+        code: "MISSING_PROJECT",
+        message: "Project is required",
+        retryable: false
+      });
+    }
+    return resolved;
+  }
+  async refreshProjectCache(force = false) {
+    if (!force && Date.now() < this.projectCacheExpiresAt && this.projectCache.length > 0) {
+      return this.projectCache;
+    }
+    const response = await this.runtimeClient.request({
+      endpoint: "/v1/projects",
+      method: "GET",
+      operation: "get",
+      idempotent: true
+    });
+    this.projectRefToId.clear();
+    this.projectCache = response.data?.projects || [];
+    for (const project of this.projectCache) {
+      this.projectRefToId.set(project.id, project.id);
+      this.projectRefToId.set(project.slug, project.id);
+      this.projectRefToId.set(project.name, project.id);
+    }
+    this.projectCacheExpiresAt = Date.now() + PROJECT_CACHE_TTL_MS;
+    return this.projectCache;
+  }
+  async fetchResolvedProject(projectRef) {
+    try {
+      const response = await this.runtimeClient.request({
+        endpoint: `/v1/projects/resolve?project=${encodeURIComponent(projectRef)}`,
+        method: "GET",
+        operation: "get",
+        idempotent: true
+      });
+      return response.data?.resolved || null;
+    } catch (error) {
+      if (error instanceof RuntimeClientError && error.status === 404) {
+        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 RuntimeClientError({
+      code: "PROJECT_NOT_FOUND",
+      message: `Project '${resolvedRef}' not found`,
+      retryable: false
+    });
+  }
+  async query(params) {
+    const project = (await this.resolveProject(params.project)).id;
+    const response = await this.runtimeClient.request({
+      endpoint: "/v1/context/query",
+      method: "POST",
+      operation: "search",
+      body: {
+        ...params,
+        project
+      },
+      idempotent: true
+    });
+    return response.data;
+  }
+  async ingestSession(params) {
+    const project = (await this.resolveProject(params.project)).id;
+    const response = await this.runtimeClient.request({
+      endpoint: "/v1/memory/ingest/session",
+      method: "POST",
+      operation: "session",
+      body: {
+        ...params,
+        project
+      }
+    });
+    return response.data;
+  }
+  createAgentRuntime(options = {}) {
+    const baseContext = {
+      workspacePath: options.workspacePath,
+      project: options.project || this.config.project,
+      userId: options.userId,
+      sessionId: options.sessionId,
+      traceId: options.traceId,
+      clientName: options.clientName
+    };
+    return new WhisperAgentRuntime({
+      baseContext,
+      options,
+      adapter: {
+        resolveProject: (project) => this.resolveProject(project),
+        query: (params) => this.query(params),
+        ingestSession: (params) => this.ingestSession(params),
+        getSessionMemories: (params) => this.memory.getSessionMemories(params),
+        getUserProfile: (params) => this.memory.getUserProfile(params),
+        searchMemories: (params) => this.memory.search(params),
+        addMemory: (params) => this.memory.add(params),
+        queueStatus: () => this.queue.status(),
+        flushQueue: () => this.queue.flush()
+      }
+    });
+  }
   withRunContext(context) {
     const base = this;
     return {
@@ -2306,7 +3050,7 @@ var DEFAULT_MAX_ATTEMPTS = 3;
 var DEFAULT_BASE_DELAY_MS = 250;
 var DEFAULT_MAX_DELAY_MS = 2e3;
 var DEFAULT_TIMEOUT_MS = 15e3;
-var PROJECT_CACHE_TTL_MS = 3e4;
+var PROJECT_CACHE_TTL_MS2 = 3e4;
 var DEPRECATION_WARNINGS2 = /* @__PURE__ */ new Set();
 function warnDeprecatedOnce2(key, message) {
   if (DEPRECATION_WARNINGS2.has(key)) return;
@@ -2315,7 +3059,7 @@ function warnDeprecatedOnce2(key, message) {
     console.warn(message);
   }
 }
-function isLikelyProjectId(projectRef) {
+function isLikelyProjectId2(projectRef) {
   return /^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i.test(projectRef);
 }
 function normalizeBaseUrl2(url) {
@@ -2437,7 +3181,7 @@ var WhisperContext = class _WhisperContext {
         }
       }
     }
-    this.projectCacheExpiresAt = Date.now() + PROJECT_CACHE_TTL_MS;
+    this.projectCacheExpiresAt = Date.now() + PROJECT_CACHE_TTL_MS2;
     return this.projectCache;
   }
   async fetchResolvedProject(projectRef) {
@@ -2470,10 +3214,10 @@ var WhisperContext = class _WhisperContext {
         ...this.projectCache.filter((project) => project.id !== resolvedProject.id),
         resolvedProject
       ];
-      this.projectCacheExpiresAt = Date.now() + PROJECT_CACHE_TTL_MS;
+      this.projectCacheExpiresAt = Date.now() + PROJECT_CACHE_TTL_MS2;
       return resolvedProject;
     }
-    if (isLikelyProjectId(resolvedRef)) {
+    if (isLikelyProjectId2(resolvedRef)) {
       return {
         id: resolvedRef,
         orgId: "",
@@ -2505,7 +3249,7 @@ var WhisperContext = class _WhisperContext {
         message: `Project reference '${projectRef}' matched multiple projects. Use project id instead.`
       });
     }
-    if (isLikelyProjectId(projectRef)) {
+    if (isLikelyProjectId2(projectRef)) {
       return projectRef;
     }
     const resolvedProject = await this.fetchResolvedProject(projectRef);
@@ -2517,7 +3261,7 @@ var WhisperContext = class _WhisperContext {
         ...this.projectCache.filter((project) => project.id !== resolvedProject.id),
         resolvedProject
       ];
-      this.projectCacheExpiresAt = Date.now() + PROJECT_CACHE_TTL_MS;
+      this.projectCacheExpiresAt = Date.now() + PROJECT_CACHE_TTL_MS2;
       return resolvedProject.id;
     }
     throw new WhisperError({
@@ -2534,7 +3278,7 @@ var WhisperContext = class _WhisperContext {
         candidates.add(match.id);
         candidates.add(match.slug);
         candidates.add(match.name);
-      } else if (isLikelyProjectId(projectRef)) {
+      } else if (isLikelyProjectId2(projectRef)) {
         const byId = projects.find((p) => p.id === projectRef);
         if (byId) {
           candidates.add(byId.slug);
@@ -2695,7 +3439,7 @@ var WhisperContext = class _WhisperContext {
       ...this.projectCache.filter((p) => p.id !== project.id),
       project
     ];
-    this.projectCacheExpiresAt = Date.now() + PROJECT_CACHE_TTL_MS;
+    this.projectCacheExpiresAt = Date.now() + PROJECT_CACHE_TTL_MS2;
     return project;
   }
   async listProjects() {
@@ -2706,7 +3450,7 @@ var WhisperContext = class _WhisperContext {
       this.projectRefToId.set(p.slug, p.id);
       this.projectRefToId.set(p.name, p.id);
     }
-    this.projectCacheExpiresAt = Date.now() + PROJECT_CACHE_TTL_MS;
+    this.projectCacheExpiresAt = Date.now() + PROJECT_CACHE_TTL_MS2;
     return projects;
   }
   async getProject(id) {