@chatcode/chatcode-cli 3.0.4-rc.1 → 3.0.4-rc.3

package/runtime/node_modules/@deepseek-ai/dsh-api-session-controller/lib/index.js

@@ -177,6 +177,7 @@ async function inspectApiSession(ctx, sessionId, signal) {
 /** Owns every operation that may create, resume, or configure a Web Agent. */
 var ApiSessionAgentController = class {
 	ctx;
+	owned = /* @__PURE__ */ new Map();
 	resumes = /* @__PURE__ */ new Map();
 	creations = /* @__PURE__ */ new Map();
 	selections = /* @__PURE__ */ new WeakMap();
@@ -184,6 +185,18 @@ var ApiSessionAgentController = class {
 	/** @param ctx - Host context carrying Agent, model, persistence, and Typert services. */
 	constructor(ctx) {
 		this.ctx = ctx;
+		ctx.on("session/delete-release", async ({ sessionIds }) => {
+			for (const id of sessionIds) {
+				const handle = this.owned.get(id);
+				if (handle?.agent.status === "idle") await handle.dispose();
+			}
+		});
+		ctx.on("agent/disposed", ({ agent }) => {
+			if (this.owned.get(agent.session.id)?.agent === agent) this.owned.delete(agent.session.id);
+		});
+		ctx.effect(() => async () => {
+			await Promise.all([...this.owned.values()].map((handle) => handle.dispose()));
+		}, "api-session.ownedAgents");
 		ctx.typert.lookups.configure("agent", async (sessionId) => {
 			const found = await this.resolveAgent(sessionId);
 			if ("error" in found) throw found.error;
@@ -287,6 +300,7 @@ var ApiSessionAgentController = class {
 		const defaultModel = this.ctx.agentDefaultModel;
 		const selection = {
 			get current() {
+				if (defaultModel.usesSharedPreference()) return defaultModel.currentSelection();
 				if (picked !== void 0) return picked;
 				const loggedHeader = agent.session.requestHeader();
 				if (loggedHeader === void 0) return defaultModel.currentSelection();
@@ -403,11 +417,11 @@ var ApiSessionAgentController = class {
 		const published = this.ctx.sessions.get(sessionId);
 		const live = this.ctx.agents.get(sessionId);
 		if (published !== void 0 && hasApiSessionSubagentOwner(this.ctx, published, live)) throw new ApiSessionSubagentOwnership(sessionId);
-		return (await this.ctx.agents.resume({
+		return (await this.remember(this.ctx.agents.resume({
 			resumeSessionId: sessionId,
 			agentOptions: this.agentOptions(),
 			setup: composition.setup
-		})).agent;
+		}))).agent;
 	}
 	async createOrAdopt(sessionId, cwd, checkPersistedIdentity, presetId) {
 		const attached = this.ctx.sessions.get(sessionId);
@@ -427,11 +441,11 @@ var ApiSessionAgentController = class {
 				const storedPreset = this.presetForObservation(observation);
 				this.assertPresetUnchanged(sessionId, presetId, storedPreset);
 				const composition = await this.composeAgent(storedPreset);
-				return (await this.ctx.agents.resume({
+				return (await this.remember(this.ctx.agents.resume({
 					resumeSessionId: sessionId,
 					agentOptions: this.agentOptions(),
 					setup: composition.setup
-				})).agent;
+				}))).agent;
 			} catch (e_3) {
 				env_3.error = e_3;
 				env_3.hasError = true;
@@ -447,7 +461,7 @@ var ApiSessionAgentController = class {
 			throw new Error(`failed to ensure project directory "${cwd}": ${String(error)}`, { cause: error });
 		}
 		const composition = await this.composeAgent(presetId);
-		return (await this.ctx.agents.create({
+		return (await this.remember(this.ctx.agents.create({
 			sessionId,
 			agentOptions: this.agentOptions(),
 			meta: {
@@ -455,7 +469,20 @@ var ApiSessionAgentController = class {
 				...composition.agentPreset === void 0 ? {} : { agentPreset: composition.agentPreset }
 			},
 			setup: composition.setup
-		})).agent;
+		}))).agent;
+	}
+	/**
+	* Create a Web-owned Agent whose idle handle can be released before permanent deletion.
+	* @param options - Agent creation input shared by new Sessions and ordinary forks.
+	* @returns the owned Agent handle.
+	*/
+	createOwned(options) {
+		return this.remember(this.ctx.agents.create(options));
+	}
+	async remember(pending) {
+		const handle = await pending;
+		this.owned.set(handle.agent.session.id, handle);
+		return handle;
 	}
 	agentOptions() {
 		const { provider, model } = this.ctx.agentDefaultModel.currentSelection();
@@ -543,8 +570,10 @@ async function buildModelCatalog(ctx, defaultSelection = ctx.agentDefaultModel.c
 	}));
 	const groups = catalog.flatMap((item) => item.kind === "group" ? [item.group] : []).filter((group) => group.models.length > 0);
 	const savedDisplayName = ctx.agentDefaultModel.sharedDisplayName();
+	const processSelection = ctx.agentDefaultModel.usesSharedPreference();
 	return {
-		default: { ...defaultSelection },
+		default: { ...processSelection ? await ctx.agentDefaultModel.resolveSelection() : defaultSelection },
+		...processSelection ? { selectionScope: "process" } : {},
 		...savedDisplayName === void 0 ? {} : { savedDisplayName },
 		routableProviders: groups.map((group) => group.id),
 		groups,
@@ -718,9 +747,9 @@ var SessionCommandController = class {
 		};
 	}
 	/**
-	* Validate and install one Session-local model selection; save the default in the background.
+	* Validate, persist the default, and install one model selection before acknowledging success.
 	* @param request - Session identity and requested model selection.
-	* @returns the normalized selection installed for the Session, without waiting for default persistence.
+	* @returns the normalized selection after the shared save and Session selection succeed.
 	*/
 	async selectModel(request) {
 		const agent = await this.resolveAgent(request.sessionId);
@@ -737,10 +766,24 @@ var SessionCommandController = class {
 					model: resolved.model,
 					...resolved.reasoningEffort === void 0 ? {} : { reasoningEffort: resolved.reasoningEffort }
 				};
-				this.agents.selectForNextRequest(agent, selected);
-				this.ctx.agentDefaultModel.saveSelection(selected).catch((error) => {
-					this.ctx.logger.warn(`session-controller: model selection changed for the Session but the default was not saved: ${String(error)}`);
-				});
+				const info = await this.ctx.llm.resolveModelInfo(selected.provider, selected.model);
+				try {
+					await this.ctx.agentDefaultModel.saveSelection(selected, info.name);
+				} catch (error) {
+					throw new RemoteError("session/model-save-failed", `model selection was not changed because the default could not be saved: ${String(error)}`, {
+						provider: selected.provider,
+						model: selected.model
+					});
+				}
+				this.ctx.emit("api-session/model-updated");
+				try {
+					this.agents.selectForNextRequest(agent, selected);
+				} catch (error) {
+					throw new RemoteError("session/model-install-failed", `the default model was saved, but the Session selection could not be recorded: ${String(error)}`, {
+						provider: selected.provider,
+						model: selected.model
+					});
+				}
 				return { selected: { ...selected } };
 			} catch (error) {
 				if (remoteErrorOf(error) !== void 0) throw error;
@@ -812,7 +855,7 @@ var SessionCommandController = class {
 			const composition = await this.agents.composeAgent(this.agents.presetForObservation(source));
 			try {
 				const { provider, model } = this.ctx.agentDefaultModel.currentSelection();
-				await this.ctx.agents.create({
+				await this.agents.createOwned({
 					sessionId: childId,
 					seed,
 					inheritedEventCount: SessionLogOffset(boundary + 1),
@@ -872,6 +915,13 @@ var SessionCommandController = class {
 					hasError: false
 				};
 				try {
+					if (this.ctx.agentDefaultModel.usesSharedPreference()) {
+						const route = await this.ctx.agentDefaultModel.resolveSelection();
+						if (route.provider === "" || route.model === "") throw new RemoteError("session/model-unavailable", "the selected model is unavailable; select a model before sending a message", {
+							provider: route.provider,
+							model: route.model
+						});
+					}
 					if (hasImage) {
 						const current = this.agents.selectionFor(agent).current;
 						const model = await this.ctx.llm.resolveModelInfo(current.provider, current.model);
@@ -900,7 +950,7 @@ var SessionCommandController = class {
 			}
 			return { accepted: true };
 		};
-		return hasImage ? this.agents.serializeImageAdmission(agent, admit) : admit();
+		return hasImage || this.ctx.agentDefaultModel.usesSharedPreference() ? this.agents.serializeImageAdmission(agent, admit) : admit();
 	}
 	async requireModel(selection) {
 		if (!await modelAvailable(this.ctx, selection)) throw new RemoteError("session/model-unavailable", "Select an available model before sending a message.", {
@@ -1792,6 +1842,7 @@ const SEARCH_PROVIDER_CALL_LIMIT = 100;
 const SESSION_SEARCH_QUERY_MAX_CHARS = 500;
 const MESSAGE_TYPES = new Set(["user/message", "assistant/message"]);
 const sessionListMetadataSchema = z$1.object({
+	hasUserPrompt: z$1.boolean().default(false),
 	blank: z$1.boolean(),
 	lastPromptAt: z$1.number().nullable()
 });
@@ -1811,12 +1862,21 @@ const imageLimitsSchema = z$1.object({
 */
 function applySessionListMetadata(state, event) {
 	const blank = state.blank && event.type !== "turn/start";
+	const hasUserPrompt = state.hasUserPrompt === true || hasHumanInput(event);
 	const lastPromptAt = event.type === "user/message" && event.data.source.kind === "user" ? event.time : state.lastPromptAt;
-	return blank === state.blank && lastPromptAt === state.lastPromptAt ? state : {
+	return blank === state.blank && lastPromptAt === state.lastPromptAt && hasUserPrompt === state.hasUserPrompt ? state : {
 		blank,
-		lastPromptAt
+		lastPromptAt,
+		hasUserPrompt
 	};
 }
+/** User-origin text or media is conversation input; injected context is not. */
+function hasHumanInput(event) {
+	return (event.type === "user/message" ? [{
+		...event.data,
+		role: "user"
+	}] : event.type === "agent/inbox/spliced" ? event.data.inserted : []).some((message) => message.role === "user" && message.source.kind === "user" && message.content.some((block) => block.type !== "text" || block.text.trim() !== ""));
+}
 /**
 * Return the longest prefix containing at most `maximum` Unicode code points.
 * @param value - source text.
@@ -1836,6 +1896,10 @@ function truncateUnicodeCodePoints(value, maximum) {
 /** Owns list projection registration, bounded cold summaries, and authorized search. */
 var ApiSessionList = class {
 	ctx;
+	backfillAbort = new AbortController();
+	backfills = /* @__PURE__ */ new Set();
+	checkedRevisions = /* @__PURE__ */ new Map();
+	backfill = Promise.resolve();
 	/** @param ctx - Host context carrying Session, query, persistence, and projection services. */
 	constructor(ctx) {
 		this.ctx = ctx;
@@ -1844,14 +1908,22 @@ var ApiSessionList = class {
 			stateSchema: sessionListMetadataSchema,
 			init: () => ({
 				blank: true,
-				lastPromptAt: null
+				lastPromptAt: null,
+				hasUserPrompt: false
 			}),
 			apply: applySessionListMetadata,
 			wire: {
 				viewSchema: sessionListMetadataSchema,
 				view: (state) => state
 			},
-			stateVersion: 1
+			stateVersion: 2
+		});
+		ctx.effect(() => async () => {
+			this.backfillAbort.abort();
+			await this.backfill;
+		}, "session-list: stop summary backfill");
+		ctx.on("session/event", (session, event) => {
+			if (hasHumanInput(event)) ctx.emit("api-session/added", this.summaryFor(session));
 		});
 		ctx.inject(["attachments"], (attachmentCtx) => {
 			ctx.sessionProjections.register({
@@ -1893,6 +1965,8 @@ var ApiSessionList = class {
 	async list(signal) {
 		signal?.throwIfAborted();
 		const records = await this.ctx.sessionQuery.listSessions(signal);
+		const listedIds = new Set(records.map((record) => record.header.id));
+		for (const id of this.checkedRevisions.keys()) if (!listedIds.has(id)) this.checkedRevisions.delete(id);
 		signal?.throwIfAborted();
 		const items = [];
 		const cold = [];
@@ -1916,6 +1990,7 @@ var ApiSessionList = class {
 	async summarizeCold(header) {
 		const projections = await this.projectionsFor(header, void 0);
 		const metadata = projections?.values.sessionListMetadata;
+		if (metadata?.hasUserPrompt !== true) this.backfillCold(header.id);
 		return {
 			sessionId: header.id,
 			updatedAt: updatedAt(header, metadata),
@@ -1926,6 +2001,58 @@ var ApiSessionList = class {
 			...projections === void 0 ? {} : { projections }
 		};
 	}
+	/** Serialize missing summaries outside list latency; unreadable history stays unknown. */
+	backfillCold(sessionId) {
+		if (this.backfillAbort.signal.aborted || this.backfills.has(sessionId)) return;
+		const persistence = this.ctx.get("sessionPersistence");
+		const cache = this.ctx.get("sessionProjectionCache");
+		if (persistence === void 0 || cache === void 0) return;
+		this.backfills.add(sessionId);
+		this.backfill = this.backfill.then(async () => {
+			const signal = this.backfillAbort.signal;
+			signal.throwIfAborted();
+			const live = this.ctx.sessions.get(sessionId);
+			if (live !== void 0) {
+				this.ctx.emit("api-session/added", this.summaryFor(live));
+				return;
+			}
+			const before = await persistence.stat(sessionId, { signal });
+			if (before === void 0 || before.revision === this.checkedRevisions.get(sessionId)) return;
+			const handle = await persistence.open(sessionId, "read", { signal });
+			let snapshot;
+			try {
+				const read = await handle.read(SessionLogOffset(0), void 0, { signal });
+				signal.throwIfAborted();
+				const after = await persistence.stat(sessionId, { signal });
+				if (after?.revision !== before.revision || after.header.createdAt !== handle.header.createdAt) return;
+				snapshot = await cache.coldSnapshot(handle.header, handle.inheritedEventCount, read.events);
+				this.checkedRevisions.set(sessionId, before.revision);
+			} finally {
+				await handle.close();
+			}
+			signal.throwIfAborted();
+			const attached = this.ctx.sessions.get(sessionId);
+			if (attached !== void 0) {
+				this.ctx.emit("api-session/added", this.summaryFor(attached));
+				return;
+			}
+			if ((await persistence.stat(sessionId, { signal }))?.revision !== before.revision) return;
+			const projections = hintsOf("cached", snapshot);
+			this.ctx.emit("api-session/added", {
+				sessionId,
+				updatedAt: updatedAt(handle.header, snapshot.values.sessionListMetadata),
+				agentAvailable: false,
+				running: false,
+				blank: snapshot.values.sessionListMetadata?.blank ?? false,
+				...listFields(handle.header),
+				...projections === void 0 ? {} : { projections }
+			});
+		}).catch((error) => {
+			if (!this.backfillAbort.signal.aborted) this.ctx.logger.warn(`api-session.list: summary backfill for "${sessionId}" failed: ${String(error)}`);
+		}).finally(() => {
+			this.backfills.delete(sessionId);
+		});
+	}
 	/**
 	* Search current visible message content without activating any matching Session.
 	* @param query - literal message-content query.
@@ -2457,7 +2584,7 @@ const ArchivedSessionGate = {
 * @returns whether an archived Session owns the step.
 */
 function underArchivedSession(ctx, agent) {
-	const archived = ctx.workspaceRegistry.archivedSessionIds;
+	const archived = [...ctx.workspaceRegistry.archivedSessionIds, ...ctx.workspaceRegistry.deletedSessionIds];
 	let header = agent.session.header;
 	const visited = /* @__PURE__ */ new Set();
 	while (!visited.has(header.id)) {
@@ -2887,6 +3014,9 @@ let SessionController = (() => {
 			ctx.plugin(SessionMediaReferences);
 			ctx.plugin(SessionSkillCatalog);
 			ctx.plugin(ArchivedSessionGate);
+			ctx.on("session/deleted", (ids) => {
+				for (const id of ids) ctx.emit("api-session/removed", id);
+			});
 			ctx.on("session/created", (session) => {
 				ctx.emit("api-session/added", this.listState.summaryFor(session));
 			});
@@ -2985,22 +3115,24 @@ let SessionController = (() => {
 		* @param request - requested identity, location, and Agent preset.
 		* @returns the Session identity and resolved preset when configured.
 		*/
-		create(request) {
+		async create(request) {
+			if (request.sessionId !== void 0) await this.assertNotDeleted(request.sessionId);
 			return this.commands.create(request);
 		}
 		/**
-		* Select one Session-local model after explicitly resuming the Session; save the default in the background.
+		* Select a model after explicitly resuming the Session and awaiting default persistence.
 		* @param request - Session identity and requested model selection.
-		* @returns the normalized selection installed for the Session, without waiting for default persistence.
+		* @returns the normalized selection after the shared save and Session selection succeed.
 		*/
 		selectModel(request) {
-			return this.commands.selectModel(request);
+			return this.assertNotDeleted(request.sessionId).then(() => this.commands.selectModel(request));
 		}
 		/**
-		* Select the first available account model after login when no provider API key is configured.
+		* Initialize legacy account deployments without changing a product process's cached selection.
 		* @returns after saving the first available model or retaining the existing default.
 		*/
 		async initializeDefaultModel() {
+			if (this.ctx.agentDefaultModel.usesSharedPreference()) return;
 			const provider = "deepseek-account";
 			if (await hasProviderApiKey(this.ctx)) return;
 			const model = (await buildModelCatalog(this.ctx)).groups.find((group) => group.id === provider)?.models[0];
@@ -3010,7 +3142,8 @@ let SessionController = (() => {
 				model: model.id,
 				...model.reasoning?.defaultEffort === void 0 ? {} : { reasoningEffort: ReasoningEffortId(model.reasoning.defaultEffort) }
 			};
-			await this.ctx.agentDefaultModel.saveSelection(selection);
+			await this.ctx.agentDefaultModel.saveSelection(selection, model.name);
+			this.ctx.emit("api-session/model-updated");
 		}
 		/**
 		* Describe every currently routable model for Host-generation selectors.
@@ -3092,7 +3225,7 @@ let SessionController = (() => {
 		* @returns the accepted title and durable event sequence.
 		*/
 		rename(request) {
-			return this.commands.rename(request);
+			return this.assertNotDeleted(request.sessionId).then(() => this.commands.rename(request));
 		}
 		/**
 		* Fork one cold-readable exact event prefix into a new Session. An omitted
@@ -3102,7 +3235,7 @@ let SessionController = (() => {
 		* @returns the new Session identity.
 		*/
 		fork(request) {
-			return this.commands.fork(request);
+			return this.assertNotDeleted(request.sessionId).then(() => this.commands.fork(request));
 		}
 		/**
 		* Admit one prompt after explicitly resuming its Session.
@@ -3112,7 +3245,7 @@ let SessionController = (() => {
 		*/
 		prompt(request, signal) {
 			signal.throwIfAborted();
-			return this.commands.prompt(request);
+			return this.assertNotDeleted(request.sessionId).then(() => this.commands.prompt(request));
 		}
 		/**
 		* Read one image proven reachable from the addressed Session log.
@@ -3120,7 +3253,7 @@ let SessionController = (() => {
 		* @returns the durable attachment reference and base64-encoded bytes.
 		*/
 		attachment(request) {
-			return this.commands.attachment(request);
+			return this.assertNotDeleted(request.sessionId).then(() => this.commands.attachment(request));
 		}
 		/**
 		* Mutate one still-pending queue occurrence, resuming a cold Agent first.
@@ -3128,7 +3261,7 @@ let SessionController = (() => {
 		* @returns acknowledgement that the queue mutation was applied.
 		*/
 		updateQueue(request) {
-			return this.commands.updateQueue(request);
+			return this.assertNotDeleted(request.sessionId).then(() => this.commands.updateQueue(request));
 		}
 		/**
 		* Cancel one active Agent turn without dropping its pending inbox.
@@ -3145,7 +3278,7 @@ let SessionController = (() => {
 		* @returns one chronological page.
 		*/
 		page(request, signal) {
-			return this.history.page(request, signal);
+			return this.assertNotDeleted(request.address.kind === "session" ? request.address.sessionId : request.address.childSessionId).then(() => this.history.page(request, signal));
 		}
 		/**
 		* Follow one Session log from its opening or resume cursor.
@@ -3154,8 +3287,13 @@ let SessionController = (() => {
 		* @returns a complete opening snapshot followed by gap-free durable event
 		*   frames and optional cursorless assistant-stream frames.
 		*/
-		follow(request, signal) {
-			return this.history.follow(request, signal);
+		async *follow(request, signal) {
+			await this.assertNotDeleted(request.address.kind === "session" ? request.address.sessionId : request.address.childSessionId);
+			yield* this.history.follow(request, signal);
+		}
+		async assertNotDeleted(sessionId) {
+			await this.ctx.workspaceRegistry.refresh();
+			if (this.ctx.workspaceRegistry.deletedSessionIds.includes(sessionId)) throw new RemoteError("session/not-found", "Session has been permanently deleted", { sessionId });
 		}
 		/**
 		* Read all registered projections without activating an Agent.
@@ -3166,6 +3304,7 @@ let SessionController = (() => {
 		async projections(request, signal) {
 			const { sessionId } = request;
 			if (sessionId.length === 0) throw new RemoteError("gateway/bad-request", "sessionId must not be empty", {});
+			await this.assertNotDeleted(sessionId);
 			try {
 				const env_2 = {
 					stack: [],