@xopcai/xopc 0.0.302 → 0.0.306

package/dist/src/tui/tui.js

@@ -21,7 +21,7 @@ import { copyTextToClipboard } from "./clipboard-text.js";
 import { createXopcTuiKeybindingsManager } from "./tui-keybindings-file.js";
 import { isActiveRunStreamStale, markActiveRunStalled, markRunRecovering, markRunRecoveryComplete, markRunSending } from "./tui-run-state.js";
 import { clearSeenStreamEvents, clearSeenStreamEventsForRun, dispatchAgentEvent } from "./tui-agent-events.js";
-import { countPendingChatInputs } from "./tui-backend.js";
+import { acceptChatInputState, createEmptyChatInputState, findLastEditableChatInput } from "./tui-chat-input-state.js";
 import { transcriptTreeEntryIdToRowNumber } from "./tui-transcript-tree.js";
 import { formatTuiCompactionResult, formatTuiShareResult } from "./tui-command-formatters.js";
 import { formatTuiStartupText } from "./tui-startup-text.js";
@@ -50,6 +50,8 @@ import { GatewayRealtimeBackend } from "./backends/gateway-realtime-backend.js";
 import { ChatLog } from "./components/chat-log.js";
 import { CustomEditor } from "./components/custom-editor.js";
 import { TuiBottomBar } from "./components/tui-bottom-bar.js";
+import { PendingInputPreview } from "./components/pending-input-preview.js";
+import { TranscriptOverlay } from "./components/transcript-overlay.js";
 import { TuiHeader } from "./components/tui-header.js";
 import { loadExtensionsForTuiLocalMode } from "./extension-host/load-extensions.js";
 import { createTuiExtensionRuntime } from "./extension-host/runtime.js";
@@ -263,6 +265,7 @@ async function runTui(opts) {
 	}), keybindings);
 	const statusContainer = new Container();
 	const bottomBar = new TuiBottomBar(() => state, () => opts.thinking);
+	const pendingInputPreview = new PendingInputPreview(() => state.chatInputState, keybindings);
 	const chatLog = new ChatLog(keybindings);
 	chatLog.setViewportRowsProvider(() => Math.max(8, tui.terminal.rows - 8));
 	let startupResources;
@@ -372,6 +375,7 @@ async function runTui(opts) {
 	root.addChild(header);
 	root.addChild(chatLog);
 	root.addChild(statusContainer);
+	root.addChild(pendingInputPreview);
 	root.addChild(editorContainer);
 	root.addChild(bottomBar);
 	tui.addChild(root);
@@ -1458,6 +1462,20 @@ async function runTui(opts) {
 		})();
 	};
 	const isAgentBusy = () => state.activeRunId != null || state.isCompacting || busyStates.has(state.activityStatus);
+	let editingQueuedInput;
+	const applyChatInputState = (incoming) => {
+		if (incoming.conversationId !== state.currentConversationId) return;
+		const next = acceptChatInputState(state.chatInputState, incoming);
+		if (next === state.chatInputState) return;
+		state.chatInputState = next;
+		if (editingQueuedInput) {
+			const edited = next.inputs.find((input) => input.id === editingQueuedInput?.id);
+			if (!edited || edited.version !== editingQueuedInput.version) editingQueuedInput = void 0;
+		}
+		pendingInputPreview.invalidate();
+		bottomBar.invalidate();
+		tui.requestRender();
+	};
 	const sendSteeringToActiveRun = (text) => {
 		touchStreamingActivity();
 		tui.requestRender();
@@ -1465,15 +1483,12 @@ async function runTui(opts) {
 			conversationId: state.currentConversationId,
 			message: text,
 			delivery: "steer"
-		}).then(({ ok, effectiveDelivery }) => {
+		}).then(({ ok, state: inputState }) => {
 			if (!ok) {
 				if (!editor.getText().trim()) editor.setText(text);
 				chatLog.addSystem(theme.dim(formatSteerUnavailableHint(keybindings)));
-			} else {
-				chatLog.addUser(text);
-				chatLog.addSystem(theme.dim(effectiveDelivery === "steer" ? "Added to this reply." : "Queued as the next message."));
-				refreshPendingInputCount();
-			}
+			} else if (inputState) applyChatInputState(inputState);
+			else refreshChatInputState();
 			tui.requestRender();
 		}).catch((error) => {
 			if (!editor.getText().trim()) editor.setText(text);
@@ -1831,15 +1846,10 @@ async function runTui(opts) {
 			applyComposerHistory(await client.getComposerInputHistory());
 		} catch {}
 	};
-	const refreshPendingInputCount = async (conversationId = state.currentConversationId) => {
+	const refreshChatInputState = async (conversationId = state.currentConversationId) => {
 		try {
-			const inputState = await client.getChatInputState(conversationId);
-			if (state.currentConversationId === conversationId) state.pendingInputCount = countPendingChatInputs(inputState.inputs);
-		} catch {
-			if (state.currentConversationId === conversationId) state.pendingInputCount = 0;
-		}
-		bottomBar.invalidate();
-		tui.requestRender();
+			applyChatInputState(await client.getChatInputState(conversationId));
+		} catch {}
 	};
 	const recordChatHistory = (value) => {
 		const text = value.trim();
@@ -1879,10 +1889,37 @@ async function runTui(opts) {
 		}),
 		enabled: shouldEnableWindowsGitBashPasteFallback()
 	});
-	defaultEditor.onSubmit = submitBurst;
+	const saveEditedQueuedInput = (text) => {
+		const target = editingQueuedInput;
+		if (!target) return false;
+		const content = text.trim();
+		if (!content) return true;
+		const conversationId = state.currentConversationId;
+		client.updateChatInput({
+			conversationId,
+			inputId: target.id,
+			version: target.version,
+			content
+		}).then(({ ok, state: inputState }) => {
+			if (inputState) applyChatInputState(inputState);
+			if (!ok) throw new Error("Queued input changed; refreshed latest state");
+			editingQueuedInput = void 0;
+			if (state.currentConversationId === conversationId && editor.getText().trim() === content) editor.setText("");
+			recordChatHistory(content);
+			tui.requestRender();
+		}).catch((error) => {
+			chatLog.addSystem(theme.dim(`Edit failed: ${error instanceof Error ? error.message : String(error)}`));
+			tui.requestRender();
+		});
+		return true;
+	};
+	defaultEditor.onSubmit = (text) => {
+		if (!saveEditedQueuedInput(text)) submitBurst(text);
+	};
 	const handleFollowUp = () => {
 		const text = editor.getText().trim();
 		if (!text && pendingImageAttachments.length === 0) return;
+		if (saveEditedQueuedInput(text)) return;
 		if (isAgentBusy()) {
 			if (pendingImageAttachments.length > 0) {
 				chatLog.addSystem(theme.dim("Image attachments cannot be queued while the agent is busy. Wait for this reply to finish, then send."));
@@ -1894,12 +1931,12 @@ async function runTui(opts) {
 				conversationId,
 				message: text,
 				delivery: "next"
-			}).then(async ({ ok }) => {
+			}).then(({ ok, state: inputState }) => {
 				if (!ok) throw new Error("Gateway did not accept the message");
 				recordChatHistory(text);
 				if (state.currentConversationId === conversationId && editor.getText().trim() === text) editor.setText("");
-				chatLog.addSystem(theme.dim("Queued as the next message."));
-				await refreshPendingInputCount(conversationId);
+				if (inputState) applyChatInputState(inputState);
+				else refreshChatInputState(conversationId);
 			}).catch((error) => {
 				const errorMessage = error instanceof Error ? error.message : String(error);
 				chatLog.addSystem(theme.dim(`Queue failed: ${errorMessage}`));
@@ -1911,8 +1948,9 @@ async function runTui(opts) {
 	};
 	const setConversationId = (key) => {
 		state.currentConversationId = resolveConversationId(key);
-		state.pendingInputCount = 0;
-		refreshPendingInputCount(state.currentConversationId);
+		state.chatInputState = createEmptyChatInputState(state.currentConversationId);
+		editingQueuedInput = void 0;
+		refreshChatInputState(state.currentConversationId);
 		updateAgentFromPicker(key);
 	};
 	const updateAgentFromPicker = (key) => {
@@ -2105,6 +2143,66 @@ async function runTui(opts) {
 		})();
 	};
 	defaultEditor.onAction("app.message.followUp", handleFollowUp);
+	defaultEditor.onAction("app.message.editQueued", () => {
+		if (editor.getText().length > 0) return false;
+		const target = findLastEditableChatInput(state.chatInputState);
+		if (!target) return false;
+		editingQueuedInput = {
+			id: target.id,
+			version: target.version
+		};
+		editor.setText(target.content);
+		tui.requestRender();
+		return true;
+	});
+	defaultEditor.onAction("app.message.deleteQueued", () => {
+		const target = findLastEditableChatInput(state.chatInputState);
+		if (!target) return false;
+		const conversationId = state.currentConversationId;
+		client.removeChatInput({
+			conversationId,
+			inputId: target.id,
+			version: target.version
+		}).then(({ ok, state: inputState }) => {
+			if (inputState) applyChatInputState(inputState);
+			if (!ok) throw new Error("Queued input changed; refreshed latest state");
+			if (editingQueuedInput?.id === target.id) editingQueuedInput = void 0;
+			tui.requestRender();
+		}).catch((error) => {
+			chatLog.addSystem(theme.dim(`Delete failed: ${error instanceof Error ? error.message : String(error)}`));
+			tui.requestRender();
+		});
+		return true;
+	});
+	const openTranscriptOverlay = (initialMode) => {
+		if (!client.loadHistoryWindow) {
+			chatLog.addSystem("Transcript paging is unavailable for this backend.");
+			tui.requestRender();
+			return;
+		}
+		let close = () => {};
+		const overlay = new TranscriptOverlay({
+			keybindings,
+			initialMode,
+			viewportRows: () => tui.terminal.rows,
+			onClose: () => close(),
+			onRender: () => tui.requestRender(),
+			loadWindow: (rowNumber) => client.loadHistoryWindow({
+				conversationId: state.currentConversationId,
+				rowNumber,
+				before: 120,
+				after: 0
+			})
+		});
+		close = openEditorSelector(overlay, overlay);
+		overlay.initialize().catch((error) => {
+			close();
+			chatLog.addSystem(`Transcript failed: ${error instanceof Error ? error.message : String(error)}`);
+			tui.requestRender();
+		});
+	};
+	defaultEditor.onAction("app.transcript.open", () => openTranscriptOverlay("transcript"));
+	defaultEditor.onAction("app.transcript.raw", () => openTranscriptOverlay("raw"));
 	streamWatchdogId = setInterval(() => {
 		const now = Date.now();
 		if (!isActiveRunStreamStale(state, now, 3e4)) return;
@@ -2141,11 +2239,7 @@ async function runTui(opts) {
 	client.onEvent = (evt) => {
 		const data = evt.data ?? {};
 		if (evt.event === "session.input-state") {
-			if (data.conversationId === state.currentConversationId && Array.isArray(data.inputs)) {
-				state.pendingInputCount = countPendingChatInputs(data.inputs);
-				bottomBar.invalidate();
-				tui.requestRender();
-			}
+			if (data.conversationId === state.currentConversationId && Array.isArray(data.inputs) && typeof data.revision === "number") applyChatInputState(data);
 			return;
 		}
 		if (evt.event === "composer-history.appended") {
@@ -2216,10 +2310,8 @@ async function runTui(opts) {
 			await refreshSessionInfoWithBorder();
 			persistCurrentNewSessionContext();
 			try {
-				state.pendingInputCount = countPendingChatInputs((await client.getChatInputState(state.currentConversationId)).inputs);
-			} catch {
-				state.pendingInputCount = 0;
-			}
+				applyChatInputState(await client.getChatInputState(state.currentConversationId));
+			} catch {}
 			await refreshModelChoices();
 			await loadSessionHistory({ merge: true });
 			cleanupAbandonedTuiSessions(client, state.currentConversationId).catch(() => {});

package/dist/src/tui/xopc-tui-keybindings.d.ts

@@ -1,5 +1,5 @@
 /** App-level bindings wired by xopc TUI (subset of pi coding-agent). */
-export type XopcTuiAppKeybinding = 'app.interrupt' | 'app.clear' | 'app.exit' | 'app.suspend' | 'app.thinking.cycle' | 'app.model.cycleForward' | 'app.model.cycleBackward' | 'app.model.select' | 'app.tools.expand' | 'app.thinking.toggle' | 'app.session.resume' | 'app.session.tree' | 'app.session.fork' | 'app.session.togglePath' | 'app.session.toggleSort' | 'app.session.toggleNamedFilter' | 'app.session.rename' | 'app.session.delete' | 'app.session.deleteNoninvasive' | 'app.tree.foldOrUp' | 'app.tree.unfoldOrDown' | 'app.tree.filter.default' | 'app.tree.filter.noTools' | 'app.tree.filter.userOnly' | 'app.tree.filter.labeledOnly' | 'app.tree.filter.all' | 'app.tree.filter.cycleForward' | 'app.tree.filter.cycleBackward' | 'app.tree.editLabel' | 'app.tree.toggleLabelTimestamp' | 'app.editor.external' | 'app.clipboard.pasteImage' | 'app.message.followUp' | 'app.models.save' | 'app.models.enableAll' | 'app.models.clearAll' | 'app.models.toggleProvider' | 'app.models.reorderUp' | 'app.models.reorderDown';
+export type XopcTuiAppKeybinding = 'app.interrupt' | 'app.clear' | 'app.exit' | 'app.suspend' | 'app.thinking.cycle' | 'app.model.cycleForward' | 'app.model.cycleBackward' | 'app.model.select' | 'app.tools.expand' | 'app.thinking.toggle' | 'app.transcript.open' | 'app.transcript.raw' | 'app.session.resume' | 'app.session.tree' | 'app.session.fork' | 'app.session.togglePath' | 'app.session.toggleSort' | 'app.session.toggleNamedFilter' | 'app.session.rename' | 'app.session.delete' | 'app.session.deleteNoninvasive' | 'app.tree.foldOrUp' | 'app.tree.unfoldOrDown' | 'app.tree.filter.default' | 'app.tree.filter.noTools' | 'app.tree.filter.userOnly' | 'app.tree.filter.labeledOnly' | 'app.tree.filter.all' | 'app.tree.filter.cycleForward' | 'app.tree.filter.cycleBackward' | 'app.tree.editLabel' | 'app.tree.toggleLabelTimestamp' | 'app.editor.external' | 'app.clipboard.pasteImage' | 'app.message.followUp' | 'app.message.editQueued' | 'app.message.deleteQueued' | 'app.models.save' | 'app.models.enableAll' | 'app.models.clearAll' | 'app.models.toggleProvider' | 'app.models.reorderUp' | 'app.models.reorderDown';
 declare module '@earendil-works/pi-tui' {
     interface Keybindings {
         'app.interrupt': true;
@@ -12,6 +12,8 @@ declare module '@earendil-works/pi-tui' {
         'app.model.select': true;
         'app.tools.expand': true;
         'app.thinking.toggle': true;
+        'app.transcript.open': true;
+        'app.transcript.raw': true;
         'app.session.resume': true;
         'app.session.tree': true;
         'app.session.fork': true;
@@ -35,6 +37,8 @@ declare module '@earendil-works/pi-tui' {
         'app.editor.external': true;
         'app.clipboard.pasteImage': true;
         'app.message.followUp': true;
+        'app.message.editQueued': true;
+        'app.message.deleteQueued': true;
         'app.models.save': true;
         'app.models.enableAll': true;
         'app.models.clearAll': true;
@@ -81,9 +85,17 @@ export declare const XOPC_TUI_KEYBINDINGS: {
         readonly description: "Toggle tool output";
     };
     readonly 'app.thinking.toggle': {
-        readonly defaultKeys: "ctrl+t";
+        readonly defaultKeys: [];
         readonly description: "Toggle thinking block display";
     };
+    readonly 'app.transcript.open': {
+        readonly defaultKeys: "ctrl+t";
+        readonly description: "Open transcript view";
+    };
+    readonly 'app.transcript.raw': {
+        readonly defaultKeys: "alt+r";
+        readonly description: "Open raw transcript view";
+    };
     readonly 'app.session.resume': {
         readonly defaultKeys: "ctrl+shift+p";
         readonly description: "Session picker";
@@ -173,9 +185,17 @@ export declare const XOPC_TUI_KEYBINDINGS: {
         readonly description: "Paste image from clipboard";
     };
     readonly 'app.message.followUp': {
-        readonly defaultKeys: "alt+enter";
+        readonly defaultKeys: "tab";
         readonly description: "Queue message while busy (or submit when idle)";
     };
+    readonly 'app.message.editQueued': {
+        readonly defaultKeys: "up";
+        readonly description: "Edit the last queued message when the composer is empty";
+    };
+    readonly 'app.message.deleteQueued': {
+        readonly defaultKeys: "ctrl+x";
+        readonly description: "Delete the last queued message";
+    };
     readonly 'app.models.save': {
         readonly defaultKeys: "ctrl+s";
         readonly description: "Save scoped model selection";

package/dist/src/tui/xopc-tui-keybindings.js

@@ -39,9 +39,17 @@ const XOPC_TUI_KEYBINDINGS = {
 		description: "Toggle tool output"
 	},
 	"app.thinking.toggle": {
-		defaultKeys: "ctrl+t",
+		defaultKeys: [],
 		description: "Toggle thinking block display"
 	},
+	"app.transcript.open": {
+		defaultKeys: "ctrl+t",
+		description: "Open transcript view"
+	},
+	"app.transcript.raw": {
+		defaultKeys: "alt+r",
+		description: "Open raw transcript view"
+	},
 	"app.session.resume": {
 		defaultKeys: "ctrl+shift+p",
 		description: "Session picker"
@@ -131,9 +139,17 @@ const XOPC_TUI_KEYBINDINGS = {
 		description: "Paste image from clipboard"
 	},
 	"app.message.followUp": {
-		defaultKeys: "alt+enter",
+		defaultKeys: "tab",
 		description: "Queue message while busy (or submit when idle)"
 	},
+	"app.message.editQueued": {
+		defaultKeys: "up",
+		description: "Edit the last queued message when the composer is empty"
+	},
+	"app.message.deleteQueued": {
+		defaultKeys: "ctrl+x",
+		description: "Delete the last queued message"
+	},
 	"app.models.save": {
 		defaultKeys: "ctrl+s",
 		description: "Save scoped model selection"
@@ -191,9 +207,13 @@ const XOPC_TUI_HOTKEY_ORDER = [
 	"app.tree.toggleLabelTimestamp",
 	"app.tools.expand",
 	"app.thinking.toggle",
+	"app.transcript.open",
+	"app.transcript.raw",
 	"app.editor.external",
 	"app.clipboard.pasteImage",
 	"app.message.followUp",
+	"app.message.editQueued",
+	"app.message.deleteQueued",
 	"app.models.save",
 	"app.models.enableAll",
 	"app.models.clearAll",

package/dist/src/user-context/access-policy.d.ts

@@ -1,11 +1,11 @@
 import type { Config } from '../config/schema.js';
-import type { KnowledgeSource } from '../knowledge-memory/index.js';
+import type { KnowledgeReadPolicy } from '../knowledge-memory/index.js';
 export interface UserContextSessionAccess {
     enabled: boolean;
     userModel: boolean;
     knowledge: boolean;
     crossSessionHistory: boolean;
-    knowledgeSources: readonly KnowledgeSource[];
+    knowledgePolicy: KnowledgeReadPolicy;
 }
 /** One policy boundary for every shared-context read and write path. */
 export declare function resolveUserContextSessionAccess(config: Config | undefined, conversationId: string | undefined): UserContextSessionAccess;

package/dist/src/user-context/access-policy.js

@@ -1,7 +1,9 @@
 import { getSessionConfig } from "../storage/sqlite/config-repository.js";
+import { init_config, resolveKnowledgeReadPolicy } from "./config.js";
 import { getConversationRouting } from "../storage/sqlite/conversation-repository.js";
 import { init_session_key } from "../routing/session-key.js";
 //#region src/user-context/access-policy.ts
+init_config();
 init_session_key();
 /** One policy boundary for every shared-context read and write path. */
 function resolveUserContextSessionAccess(config, conversationId) {
@@ -10,7 +12,10 @@ function resolveUserContextSessionAccess(config, conversationId) {
 		userModel: false,
 		knowledge: false,
 		crossSessionHistory: false,
-		knowledgeSources: []
+		knowledgePolicy: {
+			scopes: [],
+			contentSources: []
+		}
 	};
 	const session = getConversationRouting(conversationId);
 	const mode = getSessionConfig(conversationId)?.userContextMode ?? "enabled";
@@ -20,7 +25,10 @@ function resolveUserContextSessionAccess(config, conversationId) {
 		userModel: enabled && config.userContext.userModel.enabled,
 		knowledge: enabled && config.userContext.knowledgeMemory.enabled,
 		crossSessionHistory: enabled,
-		knowledgeSources: enabled && config.userContext.knowledgeMemory.enabled ? config.userContext.knowledgeMemory.sources : []
+		knowledgePolicy: enabled && config.userContext.knowledgeMemory.enabled ? resolveKnowledgeReadPolicy(config.userContext.knowledgeMemory) : {
+			scopes: [],
+			contentSources: []
+		}
 	};
 }
 //#endregion

package/dist/src/user-context/config.d.ts

@@ -1,4 +1,5 @@
 import { z } from 'zod';
+import type { KnowledgeReadPolicy } from '../knowledge-memory/domain.js';
 export declare const DEFAULT_CONTEXT_COMPACTION_POLICY: {
     enabled: boolean;
     triggerThreshold: number;
@@ -75,18 +76,25 @@ export declare const UserModelConfigSchema: z.ZodDefault<z.ZodObject<{
         staleRetentionDays: z.ZodDefault<z.ZodNumber>;
     }, z.core.$strict>>;
 }, z.core.$strict>>;
-export declare const KnowledgeMemoryConfigSchema: z.ZodDefault<z.ZodObject<{
+export declare function normalizeKnowledgeMemoryConfigInput(input: unknown): unknown;
+export declare const KnowledgeMemoryConfigSchema: z.ZodDefault<z.ZodPreprocess<z.ZodObject<{
     enabled: z.ZodDefault<z.ZodBoolean>;
     writePolicy: z.ZodDefault<z.ZodEnum<{
         allow: "allow";
         confirm: "confirm";
         deny: "deny";
     }>>;
-    sources: z.ZodDefault<z.ZodArray<z.ZodEnum<{
+    readScopes: z.ZodDefault<z.ZodArray<z.ZodEnum<{
         project: "project";
         session: "session";
+        agent: "agent";
         workspace: "workspace";
+        global: "global";
+    }>>>;
+    contentSources: z.ZodDefault<z.ZodArray<z.ZodEnum<{
+        memory: "memory";
         connector: "connector";
+        local_import: "local_import";
     }>>>;
     searchStrategy: z.ZodDefault<z.ZodEnum<{
         "local-first": "local-first";
@@ -95,6 +103,7 @@ export declare const KnowledgeMemoryConfigSchema: z.ZodDefault<z.ZodObject<{
         "local-only": "local-only";
         "external-only": "external-only";
     }>>;
+    searchTimeoutMs: z.ZodDefault<z.ZodNumber>;
     writeStrategy: z.ZodDefault<z.ZodEnum<{
         "local-first": "local-first";
         "external-first": "external-first";
@@ -105,7 +114,7 @@ export declare const KnowledgeMemoryConfigSchema: z.ZodDefault<z.ZodObject<{
     allowExternalWrites: z.ZodDefault<z.ZodBoolean>;
     allowedProviderIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
     autoWriteKinds: z.ZodOptional<z.ZodArray<z.ZodString>>;
-}, z.core.$strict>>;
+}, z.core.$strict>>>;
 export declare const ContextPlanningConfigSchema: z.ZodDefault<z.ZodObject<{
     enabled: z.ZodDefault<z.ZodBoolean>;
     maxAssertions: z.ZodDefault<z.ZodNumber>;
@@ -180,18 +189,24 @@ export declare const UserContextConfigSchema: z.ZodDefault<z.ZodObject<{
             staleRetentionDays: z.ZodDefault<z.ZodNumber>;
         }, z.core.$strict>>;
     }, z.core.$strict>>;
-    knowledgeMemory: z.ZodDefault<z.ZodObject<{
+    knowledgeMemory: z.ZodDefault<z.ZodPreprocess<z.ZodObject<{
         enabled: z.ZodDefault<z.ZodBoolean>;
         writePolicy: z.ZodDefault<z.ZodEnum<{
             allow: "allow";
             confirm: "confirm";
             deny: "deny";
         }>>;
-        sources: z.ZodDefault<z.ZodArray<z.ZodEnum<{
+        readScopes: z.ZodDefault<z.ZodArray<z.ZodEnum<{
             project: "project";
             session: "session";
+            agent: "agent";
             workspace: "workspace";
+            global: "global";
+        }>>>;
+        contentSources: z.ZodDefault<z.ZodArray<z.ZodEnum<{
+            memory: "memory";
             connector: "connector";
+            local_import: "local_import";
         }>>>;
         searchStrategy: z.ZodDefault<z.ZodEnum<{
             "local-first": "local-first";
@@ -200,6 +215,7 @@ export declare const UserContextConfigSchema: z.ZodDefault<z.ZodObject<{
             "local-only": "local-only";
             "external-only": "external-only";
         }>>;
+        searchTimeoutMs: z.ZodDefault<z.ZodNumber>;
         writeStrategy: z.ZodDefault<z.ZodEnum<{
             "local-first": "local-first";
             "external-first": "external-first";
@@ -210,7 +226,7 @@ export declare const UserContextConfigSchema: z.ZodDefault<z.ZodObject<{
         allowExternalWrites: z.ZodDefault<z.ZodBoolean>;
         allowedProviderIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
         autoWriteKinds: z.ZodOptional<z.ZodArray<z.ZodString>>;
-    }, z.core.$strict>>;
+    }, z.core.$strict>>>;
     contextPlanning: z.ZodDefault<z.ZodObject<{
         enabled: z.ZodDefault<z.ZodBoolean>;
         maxAssertions: z.ZodDefault<z.ZodNumber>;
@@ -240,3 +256,4 @@ export type UserContextConfig = z.infer<typeof UserContextConfigSchema>;
 export type UserModelConfig = z.infer<typeof UserModelConfigSchema>;
 export type KnowledgeMemoryConfig = z.infer<typeof KnowledgeMemoryConfigSchema>;
 export type ContextPlanningConfig = z.infer<typeof ContextPlanningConfigSchema>;
+export declare function resolveKnowledgeReadPolicy(config: KnowledgeMemoryConfig): KnowledgeReadPolicy;

package/dist/src/user-context/config.js

@@ -10,6 +10,32 @@ function isValidTimeZone(value) {
 		return false;
 	}
 }
+function normalizeKnowledgeMemoryConfigInput(input) {
+	if (!input || typeof input !== "object" || Array.isArray(input)) return input;
+	const memory = input;
+	if (!Array.isArray(memory.sources)) return input;
+	const oldSources = memory.sources.filter((source) => typeof source === "string");
+	const visibilityScopes = new Set([
+		"session",
+		"workspace",
+		"project"
+	]);
+	const normalized = { ...memory };
+	if (!Array.isArray(normalized.readScopes)) normalized.readScopes = oldSources.filter((source) => visibilityScopes.has(source));
+	if (!Array.isArray(normalized.contentSources)) normalized.contentSources = [
+		...oldSources.some((source) => visibilityScopes.has(source)) ? ["memory"] : [],
+		...oldSources.includes("workspace") ? ["local_import"] : [],
+		...oldSources.includes("connector") ? ["connector"] : []
+	];
+	delete normalized.sources;
+	return normalized;
+}
+function resolveKnowledgeReadPolicy(config) {
+	return {
+		scopes: config.readScopes,
+		contentSources: config.contentSources
+	};
+}
 var DEFAULT_CONTEXT_COMPACTION_POLICY, ContextCompactionPolicySchema, WritePolicySchema, MaintenanceTimeSchema, UserModelConfigSchema, KnowledgeMemoryConfigSchema, ContextPlanningConfigSchema, UserContextConfigSchema;
 var init_config = __esmMin((() => {
 	init_response_language();
@@ -117,15 +143,27 @@ var init_config = __esmMin((() => {
 			staleRetentionDays: 30
 		}
 	});
-	KnowledgeMemoryConfigSchema = z.object({
+	KnowledgeMemoryConfigSchema = z.preprocess(normalizeKnowledgeMemoryConfigInput, z.object({
 		enabled: z.boolean().default(true),
 		writePolicy: WritePolicySchema.default("confirm"),
-		sources: z.array(z.enum([
-			"session",
+		readScopes: z.array(z.enum([
+			"global",
+			"agent",
 			"workspace",
 			"project",
+			"session"
+		])).default([
+			"global",
+			"agent",
+			"workspace",
+			"project",
+			"session"
+		]),
+		contentSources: z.array(z.enum([
+			"memory",
+			"local_import",
 			"connector"
-		])).default(["session", "workspace"]),
+		])).default(["memory", "local_import"]),
 		searchStrategy: z.enum([
 			"local-first",
 			"external-first",
@@ -133,6 +171,7 @@ var init_config = __esmMin((() => {
 			"local-only",
 			"external-only"
 		]).default("fanout"),
+		searchTimeoutMs: z.number().int().min(100).max(3e4).default(2e3),
 		writeStrategy: z.enum([
 			"local-first",
 			"external-first",
@@ -143,11 +182,19 @@ var init_config = __esmMin((() => {
 		allowExternalWrites: z.boolean().default(false),
 		allowedProviderIds: z.array(z.string().min(1)).optional(),
 		autoWriteKinds: z.array(z.string().min(1)).optional()
-	}).strict().default({
+	}).strict()).default({
 		enabled: true,
 		writePolicy: "confirm",
-		sources: ["session", "workspace"],
+		readScopes: [
+			"global",
+			"agent",
+			"workspace",
+			"project",
+			"session"
+		],
+		contentSources: ["memory", "local_import"],
 		searchStrategy: "fanout",
+		searchTimeoutMs: 2e3,
 		writeStrategy: "local-first",
 		allowExternalWrites: false
 	});
@@ -180,4 +227,4 @@ var init_config = __esmMin((() => {
 }));
 //#endregion
 init_config();
-export { ContextCompactionPolicySchema, ContextPlanningConfigSchema, DEFAULT_CONTEXT_COMPACTION_POLICY, KnowledgeMemoryConfigSchema, UserContextConfigSchema, UserModelConfigSchema, init_config };
+export { ContextCompactionPolicySchema, ContextPlanningConfigSchema, DEFAULT_CONTEXT_COMPACTION_POLICY, KnowledgeMemoryConfigSchema, UserContextConfigSchema, UserModelConfigSchema, init_config, normalizeKnowledgeMemoryConfigInput, resolveKnowledgeReadPolicy };

package/dist/src/voice/platform-streams.js

@@ -46,6 +46,12 @@ function connect(url, token, signal, onEvent, onFailure) {
 		socket,
 		close,
 		fail,
+		pause: () => {
+			if (!ended && socket.readyState === WebSocket.OPEN) socket.pause();
+		},
+		resume: () => {
+			if (!ended && socket.readyState === WebSocket.OPEN) socket.resume();
+		},
 		send: (value) => {
 			if (ended || socket.readyState !== WebSocket.OPEN) throw new Error("Platform voice is not connected");
 			if (socket.bufferedAmount > MAX_BUFFERED_BYTES) throw new Error("Platform voice backpressure limit exceeded");
@@ -180,6 +186,9 @@ async function openPlatformTts(request) {
 		start(value) {
 			controller = value;
 		},
+		pull(value) {
+			if ((value.desiredSize ?? 0) > 0) connection.resume();
+		},
 		cancel() {
 			ended = true;
 			clearTimeout(timer);
@@ -206,8 +215,9 @@ async function openPlatformTts(request) {
 		} else if (event.type === "response.audio.delta") {
 			if (!ready || typeof event.delta !== "string" || !/^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=)?$/.test(event.delta)) throw new Error("Invalid platform audio");
 			const bytes = Buffer.from(event.delta, "base64");
-			if (bytes.length % 2 || (controller.desiredSize ?? 0) < bytes.length) throw new Error("Platform TTS audio buffer exceeded");
+			if (bytes.length % 2 || bytes.length > MAX_BUFFERED_BYTES) throw new Error("Invalid platform audio");
 			controller.enqueue(bytes);
+			if ((controller.desiredSize ?? 0) <= 0) connection.pause();
 		} else if (event.type === "session.finished") {
 			ended = true;
 			clearTimeout(timer);