@nuvin/session 0.1.1-rc.2 → 0.2.0-rc.10

package/dist/client/index.js

@@ -1,10 +1,10 @@
 import {
   createSessionViewState,
   reduceSessionEvent
-} from "../chunk-COVRYM64.js";
+} from "../chunk-KQHHBUVY.js";
 import {
   PROTOCOL_VERSION
-} from "../chunk-WB4FEWBI.js";
+} from "../chunk-3CVYVANJ.js";
 
 // src/client/endpoint.ts
 var TerminalEndpointError = class extends Error {
@@ -17,6 +17,13 @@ var TerminalEndpointError = class extends Error {
 };
 
 // src/client/http-data-client.ts
+var DataRpcClientError = class extends Error {
+  constructor(code, message) {
+    super(message);
+    this.code = code;
+    this.name = "DataRpcClientError";
+  }
+};
 function httpBaseFromWsUrl(wsUrl) {
   const u = new URL(wsUrl);
   const scheme = u.protocol === "wss:" ? "https:" : "http:";
@@ -46,6 +53,9 @@ async function throwFromResponse(response, fallback, terminal, onUnauthorized) {
       typeof body?.message === "string" ? body.message : mapped.message
     );
   }
+  if (body?.code === "invalid-history-cursor") {
+    throw new DataRpcClientError(body.code, body.message ?? fallback);
+  }
   throw new Error(
     typeof body?.message === "string" ? body.message : `${fallback} (HTTP ${response.status}).`
   );
@@ -54,6 +64,21 @@ function createHttpDataClient(options = {}) {
   const fetchImpl = options.fetchImpl ?? ((...args) => fetch(...args));
   const baseUrl = (options.baseUrl ?? "").replace(/\/+$/, "");
   const rows = /* @__PURE__ */ new Map();
+  let directoryResolve = null;
+  const directoryReady = new Promise((resolve) => {
+    directoryResolve = resolve;
+  });
+  const resolveDirectory = () => {
+    if (directoryResolve) {
+      directoryResolve();
+      directoryResolve = null;
+    }
+  };
+  const ensureDirectoryReady = async (id) => {
+    if (rows.has(id)) return;
+    if (baseUrl !== "") return;
+    await directoryReady;
+  };
   const resolveToken = async (id) => {
     const endpoint = rows.get(id)?.endpoint;
     if (endpoint) return endpoint.token;
@@ -64,6 +89,7 @@ function createHttpDataClient(options = {}) {
     return endpoint ? httpBaseFromWsUrl(endpoint.wsUrl) : baseUrl;
   };
   const daemonFetch = async (id, suffix, init = {}) => {
+    await ensureDirectoryReady(id);
     const token = await resolveToken(id);
     const response = await fetchImpl(
       `${resolveBase(id)}/api/daemons/${encodeURIComponent(id)}${suffix}`,
@@ -88,23 +114,27 @@ function createHttpDataClient(options = {}) {
   };
   return {
     async listDaemons() {
-      const token = options.getToken ? await options.getToken() : null;
-      const response = await fetchImpl(`${baseUrl}/api/daemons`, {
-        cache: "no-store",
-        headers: token !== null ? { Authorization: `Bearer ${token}` } : {}
-      });
-      if (response.status === 401) {
-        options.onUnauthorized?.();
-        throw new TerminalEndpointError("unauthorized", "Signed out \u2014 authentication required.");
+      try {
+        const token = options.getToken ? await options.getToken() : null;
+        const response = await fetchImpl(`${baseUrl}/api/daemons`, {
+          cache: "no-store",
+          headers: token !== null ? { Authorization: `Bearer ${token}` } : {}
+        });
+        if (response.status === 401) {
+          options.onUnauthorized?.();
+          throw new TerminalEndpointError("unauthorized", "Signed out \u2014 authentication required.");
+        }
+        if (!response.ok) await throwFromResponse(response, "Failed to fetch the daemon list");
+        const body = await response.json();
+        rows.clear();
+        for (const row of body.daemons) rows.set(row.id, row);
+        return {
+          daemons: body.daemons,
+          ...body.defaultSessionId !== void 0 ? { defaultSessionId: body.defaultSessionId } : {}
+        };
+      } finally {
+        resolveDirectory();
       }
-      if (!response.ok) await throwFromResponse(response, "Failed to fetch the daemon list");
-      const body = await response.json();
-      rows.clear();
-      for (const row of body.daemons) rows.set(row.id, row);
-      return {
-        daemons: body.daemons,
-        ...body.defaultSessionId !== void 0 ? { defaultSessionId: body.defaultSessionId } : {}
-      };
     },
     async acquireEndpoint(daemonId) {
       const endpoint = rows.get(daemonId)?.endpoint;
@@ -153,10 +183,10 @@ function createHttpDataClient(options = {}) {
       const body = await response.json();
       return { url: body.wsUrl, credential: { grant: body.grant } };
     },
-    async fetchTranscript(daemonId, historyId, opts) {
-      const suffix = `/transcript/${encodeURIComponent(historyId)}${queryString({
-        workspace: opts?.workspace,
-        profile: opts?.profile
+    async fetchTranscript(daemonId, identity) {
+      const suffix = `/transcript/${encodeURIComponent(identity.sessionId)}${queryString({
+        workspace: identity.workspace,
+        profile: identity.profile
       })}`;
       const response = await daemonFetch(daemonId, suffix);
       if (response.status === 404) {
@@ -173,7 +203,8 @@ function createHttpDataClient(options = {}) {
         profile: opts?.profile,
         cwd: opts?.cwd,
         limit: opts?.limit,
-        cursor: opts?.cursor
+        cursor: opts?.cursor,
+        includeExtraction: opts?.includeExtraction === true ? "true" : void 0
       })}`;
       const response = await daemonFetch(daemonId, suffix);
       if (!response.ok)
@@ -182,6 +213,37 @@ function createHttpDataClient(options = {}) {
         });
       return await response.json();
     },
+    async listHistoryWorkspaces(daemonId, opts) {
+      const suffix = `/history/workspaces${queryString({
+        profile: opts?.profile,
+        currentCwd: opts?.currentCwd,
+        query: opts?.query,
+        includeExtraction: opts?.includeExtraction === true ? "true" : void 0
+      })}`;
+      const response = await daemonFetch(daemonId, suffix, { signal: opts?.signal });
+      if (!response.ok)
+        await throwFromResponse(response, "Failed to load history workspaces", {
+          404: { reason: "daemon-revoked", message: "This daemon is no longer registered." }
+        });
+      return await response.json();
+    },
+    async listWorkspaceHistory(daemonId, opts) {
+      const suffix = `/history/workspace${queryString({
+        profile: opts?.profile,
+        workspace: opts?.workspace,
+        cwd: opts?.cwd,
+        query: opts?.query,
+        limit: opts?.limit,
+        cursor: opts?.cursor,
+        includeExtraction: opts?.includeExtraction === true ? "true" : void 0
+      })}`;
+      const response = await daemonFetch(daemonId, suffix, { signal: opts?.signal });
+      if (!response.ok)
+        await throwFromResponse(response, "Failed to load workspace history", {
+          404: { reason: "daemon-revoked", message: "This daemon is no longer registered." }
+        });
+      return await response.json();
+    },
     async listWorkspaces(daemonId, opts) {
       const suffix = `/workspaces${queryString({ profile: opts?.profile })}`;
       const response = await daemonFetch(daemonId, suffix);
@@ -204,10 +266,10 @@ function createHttpDataClient(options = {}) {
       if (!response.ok) await throwFromResponse(response, "Failed to create the workspace");
       return await response.json();
     },
-    async deleteSession(daemonId, historyId, opts) {
-      const suffix = `/sessions/${encodeURIComponent(historyId)}${queryString({
-        workspace: opts?.workspace,
-        profile: opts?.profile
+    async deleteSession(daemonId, identity) {
+      const suffix = `/sessions/${encodeURIComponent(identity.sessionId)}${queryString({
+        workspace: identity.workspace,
+        profile: identity.profile
       })}`;
       const response = await daemonFetch(daemonId, suffix, { method: "DELETE" });
       if (response.status === 404) {
@@ -306,11 +368,23 @@ function createHttpDataClient(options = {}) {
 }
 
 // src/client/session-client.ts
+var SessionCommandError = class extends Error {
+  constructor(code, message) {
+    super(message);
+    this.code = code;
+    this.name = "SessionCommandError";
+  }
+};
 var EMPTY_MODEL_COMPLETION = {
   providers: [],
   perProvider: {},
   recentModels: []
 };
+var EMPTY_THINKING_COMPLETION = {
+  modelIdentity: "",
+  canDisable: false,
+  options: []
+};
 function toModelCompletion(result) {
   if (typeof result !== "object" || result === null || Array.isArray(result)) {
     return EMPTY_MODEL_COMPLETION;
@@ -340,6 +414,100 @@ function toModelCompletion(result) {
   }) : [];
   return { providers, perProvider, recentModels };
 }
+function optionalString(record, key) {
+  const value = record[key];
+  return typeof value === "string" ? value : void 0;
+}
+function toThinkingCompletion(result) {
+  if (typeof result !== "object" || result === null || Array.isArray(result)) {
+    return EMPTY_THINKING_COMPLETION;
+  }
+  const record = result;
+  if (typeof record.modelIdentity !== "string" || typeof record.canDisable !== "boolean" || !Array.isArray(record.options)) {
+    return EMPTY_THINKING_COMPLETION;
+  }
+  const options = record.options.flatMap((entry) => {
+    if (typeof entry !== "object" || entry === null || Array.isArray(entry)) return [];
+    const option = entry;
+    if (typeof option.id !== "string" || option.id.length === 0) return [];
+    return [
+      typeof option.description === "string" ? { id: option.id, description: option.description } : { id: option.id }
+    ];
+  });
+  const effectiveOption = optionalString(record, "effectiveOption");
+  const defaultOption = optionalString(record, "defaultOption");
+  const selectedOption = optionalString(record, "selectedOption");
+  return {
+    modelIdentity: record.modelIdentity,
+    ...effectiveOption !== void 0 ? { effectiveOption } : {},
+    ...defaultOption !== void 0 ? { defaultOption } : {},
+    ...selectedOption !== void 0 ? { selectedOption } : {},
+    canDisable: record.canDisable,
+    options
+  };
+}
+function toPersistBashPermissionResult(result) {
+  if (typeof result !== "object" || result === null || Array.isArray(result)) {
+    throw new SessionCommandError("invalid-result", "Invalid persistent Bash permission response.");
+  }
+  const record = result;
+  if (record.status === "approved") {
+    return { status: "approved" };
+  }
+  if (record.status !== "validation-error" || typeof record.message !== "string" || typeof record.fieldErrors !== "object" || record.fieldErrors === null || Array.isArray(record.fieldErrors)) {
+    throw new SessionCommandError("invalid-result", "Invalid persistent Bash permission response.");
+  }
+  const fieldErrors = {};
+  for (const [key, value] of Object.entries(record.fieldErrors)) {
+    if (typeof value !== "string") {
+      throw new SessionCommandError(
+        "invalid-result",
+        "Invalid persistent Bash permission field error."
+      );
+    }
+    fieldErrors[key] = value;
+  }
+  return {
+    status: "validation-error",
+    message: record.message,
+    fieldErrors
+  };
+}
+function toMemoryDecisionOutcome(result) {
+  if (typeof result !== "object" || result === null || Array.isArray(result)) {
+    throw new SessionCommandError("invalid-result", "Invalid memory decision response.");
+  }
+  const record = result;
+  if (record.status === "approved" || record.status === "rejected") {
+    if (typeof record.id !== "string" || typeof record.slug !== "string") {
+      throw new SessionCommandError("invalid-result", "Invalid memory decision response.");
+    }
+    return { status: record.status, id: record.id, slug: record.slug };
+  }
+  if (record.status === "conflict") {
+    if (typeof record.id !== "string" || typeof record.slug !== "string" || typeof record.reason !== "string") {
+      throw new SessionCommandError("invalid-result", "Invalid memory decision response.");
+    }
+    return { status: "conflict", id: record.id, slug: record.slug, reason: record.reason };
+  }
+  if (record.status === "failed") {
+    if (typeof record.id !== "string" || typeof record.reason !== "string") {
+      throw new SessionCommandError("invalid-result", "Invalid memory decision response.");
+    }
+    return typeof record.slug === "string" ? { status: "failed", id: record.id, slug: record.slug, reason: record.reason } : { status: "failed", id: record.id, reason: record.reason };
+  }
+  throw new SessionCommandError("invalid-result", "Invalid memory decision response.");
+}
+function toMemoryRemovalResult(result) {
+  if (typeof result !== "object" || result === null || Array.isArray(result)) {
+    throw new SessionCommandError("invalid-result", "Invalid memory removal response.");
+  }
+  const record = result;
+  if (typeof record.removed !== "boolean" || typeof record.slug !== "string") {
+    throw new SessionCommandError("invalid-result", "Invalid memory removal response.");
+  }
+  return { removed: record.removed, slug: record.slug };
+}
 function createSessionClient(transport) {
   let state = createSessionViewState();
   let seq = 0;
@@ -386,7 +554,12 @@ function createSessionClient(transport) {
       if (frame.ok) {
         entry.resolve(frame.result);
       } else {
-        entry.reject(new Error(frame.error?.message ?? "Command failed."));
+        entry.reject(
+          new SessionCommandError(
+            frame.error?.code ?? "command-failed",
+            frame.error?.message ?? "Command failed."
+          )
+        );
       }
       return;
     }
@@ -444,17 +617,27 @@ function createSessionClient(transport) {
       })).then(() => {
       });
     },
-    decideApproval(toolCallId, decision, comment, grantDir) {
+    decideApproval(toolCallId, decision, comment, grantDir, parentToolCallId) {
       return sendCommand((id) => ({
         id,
         type: "decide-approval",
         toolCallId,
         decision,
         ...comment !== void 0 ? { comment } : {},
-        ...grantDir !== void 0 ? { grantDir } : {}
+        ...grantDir !== void 0 ? { grantDir } : {},
+        ...parentToolCallId !== void 0 ? { parentToolCallId } : {}
       })).then(() => {
       });
     },
+    persistBashPermission(toolCallId, request, parentToolCallId) {
+      return sendCommand((id) => ({
+        id,
+        type: "persist-bash-permission",
+        toolCallId,
+        ...parentToolCallId !== void 0 ? { parentToolCallId } : {},
+        request
+      })).then(toPersistBashPermissionResult);
+    },
     answerQuestion(questionId, answers) {
       return sendCommand((id) => ({ id, type: "answer-question", questionId, answers })).then(
         () => {
@@ -497,6 +680,9 @@ function createSessionClient(transport) {
     completeModels() {
       return sendCommand((id) => ({ id, type: "complete-models" })).then(toModelCompletion);
     },
+    completeThinking() {
+      return sendCommand((id) => ({ id, type: "complete-thinking" })).then(toThinkingCompletion);
+    },
     setConfig(patches) {
       return sendCommand((id) => ({ id, type: "set-config", patches })).then(
         (result) => result
@@ -532,6 +718,41 @@ function createSessionClient(transport) {
         (result) => Array.isArray(result) ? result : []
       );
     },
+    listPendingMemories() {
+      return sendCommand((id) => ({ id, type: "list-pending-memories" })).then(
+        (result) => Array.isArray(result) ? result : []
+      );
+    },
+    getPendingMemory(pendingId) {
+      return sendCommand((id) => ({ id, type: "get-pending-memory", pendingId })).then(
+        (result) => result
+      );
+    },
+    approvePendingMemory(pendingId) {
+      return sendCommand((id) => ({ id, type: "approve-pending-memory", pendingId })).then(
+        toMemoryDecisionOutcome
+      );
+    },
+    rejectPendingMemory(pendingId) {
+      return sendCommand((id) => ({ id, type: "reject-pending-memory", pendingId })).then(
+        toMemoryDecisionOutcome
+      );
+    },
+    listWorkspaceMemories() {
+      return sendCommand((id) => ({ id, type: "list-workspace-memories" })).then(
+        (result) => Array.isArray(result) ? result : []
+      );
+    },
+    getWorkspaceMemory(slug) {
+      return sendCommand((id) => ({ id, type: "get-workspace-memory", memorySlug: slug })).then(
+        (result) => result
+      );
+    },
+    removeWorkspaceMemory(slug) {
+      return sendCommand((id) => ({ id, type: "remove-workspace-memory", memorySlug: slug })).then(
+        toMemoryRemovalResult
+      );
+    },
     capabilities() {
       return transport.capabilities?.() ?? [];
     },
@@ -776,7 +997,7 @@ function createWebSocketTransport(options) {
       deliver(message);
       return;
     }
-    if (message.type === "welcome" || message.type === "replay" || message.type === "session-list" || message.type === "session-created") {
+    if (message.type === "welcome" || message.type === "replay" || message.type === "session-list" || message.type === "session-list-update" || message.type === "session-created") {
       return;
     }
     lastSeq = message.seq;
@@ -887,11 +1108,13 @@ function throwCollectedErrors(errors, message) {
 }
 function bindDaemonDataClient(client, daemonId) {
   return {
-    fetchTranscript: (historyId, opts) => client.fetchTranscript(daemonId, historyId, opts),
+    fetchTranscript: (identity) => client.fetchTranscript(daemonId, identity),
     fetchHistory: (opts) => client.fetchHistory(daemonId, opts),
+    listHistoryWorkspaces: (opts) => client.listHistoryWorkspaces(daemonId, opts),
+    listWorkspaceHistory: (opts) => client.listWorkspaceHistory(daemonId, opts),
     listWorkspaces: (opts) => client.listWorkspaces(daemonId, opts),
     createWorkspace: (opts) => client.createWorkspace(daemonId, opts),
-    deleteSession: (historyId, opts) => client.deleteSession(daemonId, historyId, opts),
+    deleteSession: (identity) => client.deleteSession(daemonId, identity),
     listProfiles: () => client.listProfiles(daemonId),
     listProviders: (opts) => client.listProviders(daemonId, opts),
     addProvider: (input) => client.addProvider(daemonId, input),
@@ -1091,6 +1314,24 @@ function createDaemonClient(target, deps = {}) {
 }
 
 // src/client/directory.ts
+var DAEMON_REQUEST_ERROR_CODES = /* @__PURE__ */ new Set([
+  "transcript-unavailable",
+  "transcript-corrupt",
+  "history-state-conflict",
+  "ambiguous-session-identity"
+]);
+var DaemonRequestError = class extends Error {
+  code;
+  identity;
+  constructor(message, options) {
+    super(message);
+    this.name = "DaemonRequestError";
+    if (options?.code && DAEMON_REQUEST_ERROR_CODES.has(options.code)) {
+      this.code = options.code;
+    }
+    this.identity = options?.identity;
+  }
+};
 var toText2 = (data) => {
   if (typeof data === "string") return data;
   if (data instanceof Buffer) return data.toString("utf8");
@@ -1162,6 +1403,13 @@ function createServerDirectory(options) {
     link.pending.set(id, { kind: "list" });
     link.socket.send(JSON.stringify({ id, type: "list-sessions" }));
   };
+  const subscribeToSessionList = (link) => {
+    if (!link.ready || link.socket === null) return;
+    link.commandCounter += 1;
+    link.socket.send(
+      JSON.stringify({ id: `dir-${link.commandCounter}`, type: "subscribe-session-list" })
+    );
+  };
   const handleMessage = (link, message) => {
     if (message.type === "rejected") {
       markOffline(
@@ -1175,6 +1423,13 @@ function createServerDirectory(options) {
       clearTimer(link);
       rebuildView();
       sendList(link);
+      subscribeToSessionList(link);
+      return;
+    }
+    if (message.type === "session-list-update") {
+      if (!link.ready) return;
+      link.status = { state: "online", sessions: message.sessions };
+      rebuildView();
       return;
     }
     if (message.type === "session-list") {
@@ -1202,7 +1457,12 @@ function createServerDirectory(options) {
       if (!entry || entry.kind === "list") return;
       link.pending.delete(message.id);
       if (!message.ok) {
-        entry.reject(new Error(message.error?.message ?? "Command failed."));
+        entry.reject(
+          new DaemonRequestError(message.error?.message ?? "Command failed.", {
+            ...message.error?.code ? { code: message.error.code } : {},
+            ...message.error?.identity ? { identity: message.error.identity } : {}
+          })
+        );
         return;
       }
       if (entry.kind === "kill") {
@@ -1403,7 +1663,7 @@ function createServerDirectory(options) {
         );
       });
     },
-    resumeSession(server, historyId, resumeOptions) {
+    resumeSession(server, identity) {
       return new Promise((resolve, reject) => {
         const link = linkFor(server);
         if (link instanceof Error) {
@@ -1417,11 +1677,7 @@ function createServerDirectory(options) {
           JSON.stringify({
             id,
             type: "resume-session",
-            historyId,
-            cwd: resumeOptions.cwd,
-            ...resumeOptions.name !== void 0 ? { name: resumeOptions.name } : {},
-            ...resumeOptions.workspace !== void 0 ? { workspace: resumeOptions.workspace } : {},
-            ...resumeOptions.profile !== void 0 ? { profile: resumeOptions.profile } : {}
+            identity
           })
         );
       });
@@ -1469,6 +1725,9 @@ function createServerDirectory(options) {
   };
 }
 export {
+  DaemonRequestError,
+  DataRpcClientError,
+  SessionCommandError,
   TerminalEndpointError,
   adaptWhatwgSocket,
   bindDaemonDataClient,

package/dist/client/session-client.d.ts

@@ -1,5 +1,5 @@
 import type { AgentInput, AskUserAnswers } from "@nuvin/agent-core/shared";
-import type { AgentCatalogEntry, AgentDetail, ChatGptCredentialInput, CommandDetail, ConfigPatch, CustomProviderInput, GrantCapability, McpAction, McpActionResult, McpServerInfo, ModelCompletion, ServerEvent, SessionViewState, SetConfigResult, SkillCatalogEntry, SkillDetail, SlashCommandDescriptor } from "../protocol/types.ts";
+import type { AgentCatalogEntry, AgentDetail, ChatGptCredentialInput, CommandDetail, ConfigPatch, CustomProviderInput, GrantCapability, McpAction, McpActionResult, McpServerInfo, MemoryDecisionOutcome, ModelCompletion, PendingMemoryDetail, PendingMemorySummary, PersistBashPermissionRequest, PersistBashPermissionResult, ServerEvent, SessionViewState, SetConfigResult, SkillCatalogEntry, SkillDetail, SlashCommandDescriptor, ThinkingCompletion, WorkspaceMemoryDetail, WorkspaceMemorySummary } from "../protocol/types.ts";
 import type { ClientTransport } from "./transport.ts";
 export type ClientSubmitOptions = {
     displayText: string;
@@ -18,7 +18,8 @@ export interface SessionClient {
     /** Raw frame hook for UI side-effects (e.g. close modals on state-reset). */
     onEvent(listener: (event: ServerEvent) => void): () => void;
     submit(input: AgentInput, opts: ClientSubmitOptions): Promise<void>;
-    decideApproval(toolCallId: string, decision: "a" | "n" | "y", comment?: string, grantDir?: string): Promise<void>;
+    decideApproval(toolCallId: string, decision: "a" | "n" | "y", comment?: string, grantDir?: string, parentToolCallId?: string): Promise<void>;
+    persistBashPermission(toolCallId: string, request: PersistBashPermissionRequest, parentToolCallId?: string): Promise<PersistBashPermissionResult>;
     answerQuestion(questionId: string, answers: AskUserAnswers): Promise<void>;
     abort(): Promise<void>;
     /** Cancel a queued (not-yet-running) message by its `turn-status.queued` id. */
@@ -52,11 +53,15 @@ export interface SessionClient {
      * completion when no host is attached / the daemon is unsupported.
      */
     completeModels(): Promise<ModelCompletion>;
+    /** Fetch model-specific `/thinking` options from the attached runtime. */
+    completeThinking(): Promise<ThinkingCompletion>;
     /**
      * Restricted config write (spec: Ctrl+P config panel §Writes). Sends the batch
      * to the attached host, which allowlists/validates/writes each patch and
-     * live-applies to this session. Resolves with the {@link SetConfigResult}
-     * (empty `failures` ⇒ all applied); rejects when no host is attached.
+     * live-applies to this session. Resolves with the {@link SetConfigResult}; empty
+     * `failures` means every accepted patch was persisted, and empty
+     * `liveApplyFailures` means current-session live apply succeeded. Rejects when no
+     * host is attached.
      */
     setConfig(patches: ConfigPatch[]): Promise<SetConfigResult>;
     /** Full skill catalog (incl. disabled) for the Skills tab. */
@@ -71,6 +76,23 @@ export interface SessionClient {
     getCommand(name: string): Promise<CommandDetail>;
     /** MCP servers with live status + per-server tools for the MCP tab. */
     listMcpServers(): Promise<McpServerInfo[]>;
+    /** Pending extracted-memory candidates for the Memory tab. */
+    listPendingMemories(): Promise<PendingMemorySummary[]>;
+    /** Lazy-load one pending candidate's diff detail for the Memory tab. */
+    getPendingMemory(pendingId: string): Promise<PendingMemoryDetail>;
+    /** Approve one pending candidate (commit it to workspace memory). */
+    approvePendingMemory(pendingId: string): Promise<MemoryDecisionOutcome>;
+    /** Reject (discard) one pending candidate. */
+    rejectPendingMemory(pendingId: string): Promise<MemoryDecisionOutcome>;
+    /** Committed workspace memories for the Memory tab. */
+    listWorkspaceMemories(): Promise<WorkspaceMemorySummary[]>;
+    /** Lazy-load one committed memory's full content for the Memory tab. */
+    getWorkspaceMemory(slug: string): Promise<WorkspaceMemoryDetail>;
+    /** Delete one committed workspace memory. */
+    removeWorkspaceMemory(slug: string): Promise<{
+        removed: boolean;
+        slug: string;
+    }>;
     /**
      * Effective grant capabilities from the transport's latest welcome (UI hint).
      * Empty when the transport does not expose capabilities.
@@ -88,5 +110,9 @@ export interface SessionClient {
     addCustomProvider(provider: CustomProviderInput): Promise<void>;
     close(): void;
 }
+export declare class SessionCommandError extends Error {
+    readonly code: string;
+    constructor(code: string, message: string);
+}
 export declare function createSessionClient(transport: ClientTransport): SessionClient;
 //# sourceMappingURL=session-client.d.ts.map

package/dist/client/session-client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"session-client.d.ts","sourceRoot":"","sources":["../../src/client/session-client.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"session-client.d.ts","sourceRoot":"","sources":["../../src/client/session-client.ts"],"names":[],"mappings":"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"}

package/dist/client/websocket.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"websocket.d.ts","sourceRoot":"","sources":["../../src/client/websocket.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAGV,eAAe,EAEhB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAAE,KAAK,WAAW,EAAiD,MAAM,eAAe,CAAC;AAChG,OAAO,EAAwB,KAAK,eAAe,EAAE,MAAM,aAAa,CAAC;AACzE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEtD,YAAY,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEnD;;;;;GAKG;AACH,MAAM,MAAM,uBAAuB,GAAG,QAAQ,GAAG,WAAW,GAAG,cAAc,GAAG,WAAW,CAAC;AAE5F,MAAM,MAAM,yBAAyB,GAAG;IACtC,iHAAiH;IACjH,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,0GAA0G;IAC1G,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;;OAIG;IACH,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,gDAAgD;IAChD,SAAS,EAAE,MAAM,CAAC;IAClB,mGAAmG;IACnG,aAAa,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,eAAe,CAAC;IACjD,+CAA+C;IAC/C,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,gDAAgD;IAChD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,4CAA4C;IAC5C,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,4FAA4F;IAC5F,UAAU,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,KAAK,IAAI,CAAC;IAClD,qEAAqE;IACrE,UAAU,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;CACvC,CAAC;AAEF,MAAM,WAAW,wBAAyB,SAAQ,eAAe;IAC/D,eAAe,IAAI,uBAAuB,CAAC;IAC3C,iBAAiB,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,uBAAuB,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;IAClF,+FAA+F;IAC/F,YAAY,IAAI,SAAS,eAAe,EAAE,CAAC;IAC3C,oGAAoG;IACpG,eAAe,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC;CACnD;AAyBD;;;;;;;;;;GAUG;AACH,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,yBAAyB,GACjC,wBAAwB,CAgR1B"}
+{"version":3,"file":"websocket.d.ts","sourceRoot":"","sources":["../../src/client/websocket.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAGV,eAAe,EAEhB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAAE,KAAK,WAAW,EAAiD,MAAM,eAAe,CAAC;AAChG,OAAO,EAAwB,KAAK,eAAe,EAAE,MAAM,aAAa,CAAC;AACzE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEtD,YAAY,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEnD;;;;;GAKG;AACH,MAAM,MAAM,uBAAuB,GAAG,QAAQ,GAAG,WAAW,GAAG,cAAc,GAAG,WAAW,CAAC;AAE5F,MAAM,MAAM,yBAAyB,GAAG;IACtC,iHAAiH;IACjH,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,0GAA0G;IAC1G,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;;OAIG;IACH,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,gDAAgD;IAChD,SAAS,EAAE,MAAM,CAAC;IAClB,mGAAmG;IACnG,aAAa,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,eAAe,CAAC;IACjD,+CAA+C;IAC/C,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,gDAAgD;IAChD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,4CAA4C;IAC5C,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,4FAA4F;IAC5F,UAAU,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,KAAK,IAAI,CAAC;IAClD,qEAAqE;IACrE,UAAU,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;CACvC,CAAC;AAEF,MAAM,WAAW,wBAAyB,SAAQ,eAAe;IAC/D,eAAe,IAAI,uBAAuB,CAAC;IAC3C,iBAAiB,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,uBAAuB,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;IAClF,+FAA+F;IAC/F,YAAY,IAAI,SAAS,eAAe,EAAE,CAAC;IAC3C,oGAAoG;IACpG,eAAe,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC;CACnD;AAyBD;;;;;;;;;;GAUG;AACH,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,yBAAyB,GACjC,wBAAwB,CAiR1B"}

package/dist/controller/agent-channel.d.ts

@@ -1,7 +1,7 @@
-import type { AgentEvent, AskUserAnswers, AskUserQuestionRequest, Message, ToolRuntimeDispatchDecision, ToolUseBlock } from "@nuvin/agent-core/shared";
-import type { DirAccessRequest } from "../protocol/types.ts";
+import type { AgentEvent, AskUserAnswers, AskUserQuestionRequest, Message, ToolPermissionClass, ToolRuntimeDispatchDecision, ToolUseBlock } from "@nuvin/agent-core/shared";
+import type { BashPolicyApprovalDiagnostics, DirAccessRequest, PersistBashPermissionHandlerResult, PersistBashPermissionRequest, WorkflowBashPolicySummary } from "../protocol/types.ts";
 import type { TuiMessage } from "../state/messages.ts";
-/** Structural mirror of the CLI session store's LoadedSession. */
+/** UI-safe transcript projection of runtime LoadedSession. */
 export type SessionLoadedPayload = {
     agentMessages: Message[];
     id: string;
@@ -23,15 +23,20 @@ export type AgentEventPayload = {
 };
 export type ToolCallRequest = {
     agentId: string;
+    approvalKey?: string;
+    bashPolicy?: BashPolicyApprovalDiagnostics;
     /** Set by the runtime pre-check when the call's path is outside allowedDirs. */
     dirAccess?: DirAccessRequest;
     parentToolCallId?: string;
+    permissionClass?: ToolPermissionClass;
+    persistBashPermission?: (request: PersistBashPermissionRequest) => Promise<PersistBashPermissionHandlerResult>;
     toolCall: ToolUseBlock;
+    workflowBashPolicy?: WorkflowBashPolicySummary;
 };
 export type AgentEventListener = (payload: AgentEventPayload) => void;
 export type SessionLoadedListener = (loaded: SessionLoadedPayload) => void;
 export type ToolCallDecider = (request: ToolCallRequest) => Promise<ToolRuntimeDispatchDecision> | ToolRuntimeDispatchDecision;
-export type UserQuestionHandler = (request: AskUserQuestionRequest) => Promise<AskUserAnswers> | AskUserAnswers;
+export type UserQuestionHandler = (request: AskUserQuestionRequest, scope?: DelegationScope) => Promise<AskUserAnswers> | AskUserAnswers;
 /**
  * In-process channel between the Agent (constructed in `main()`) and the
  * React UI (`<App />`). Two distinct shapes:
@@ -49,7 +54,7 @@ export declare class AgentChannel {
     publishEvent(event: AgentEvent, scope?: DelegationScope): void;
     publishSessionLoaded(loaded: SessionLoadedPayload): void;
     requestToolDecision(request: ToolCallRequest): Promise<ToolRuntimeDispatchDecision> | ToolRuntimeDispatchDecision;
-    requestUserQuestion(request: AskUserQuestionRequest): Promise<AskUserAnswers>;
+    requestUserQuestion(request: AskUserQuestionRequest, scope?: DelegationScope): Promise<AskUserAnswers>;
     onEvent(listener: AgentEventListener): () => void;
     onSessionLoaded(listener: SessionLoadedListener): () => void;
     setToolDecider(decider: ToolCallDecider | null): void;