@xopcai/xopc 0.0.234 → 0.0.238

package/dist/src/gateway/session-context-summary.d.ts

@@ -0,0 +1,5 @@
+import type { SessionContextSummary } from '@xopcai/gateway-contract';
+import type { Config } from '../config/schema.js';
+import { type GatewayScope } from './security/gateway-scopes.js';
+/** A bounded metadata-only query. It never prepares Note context or starts an agent. */
+export declare function getSessionContextSummary(config: Config, sessionKey: string, scopes: readonly GatewayScope[]): Promise<SessionContextSummary | null>;

package/dist/src/gateway/session-context-summary.js

@@ -0,0 +1,151 @@
+import { createLogger } from "../utils/logger/index.js";
+import { init_logger } from "../utils/logger.js";
+import { getSqliteDatabase } from "../storage/sqlite/transaction.js";
+import { hasGatewayScope } from "./security/gateway-scopes.js";
+import { getSessionMetadata } from "../storage/sqlite/session-repository.js";
+import { getSessionConfig } from "../storage/sqlite/config-repository.js";
+import { TaskRepository } from "../tasks/task-repository.js";
+import { TaskConversationRepository } from "../tasks/task-conversation-repository.js";
+import { getExecutionEnvironmentForSession } from "../execution-environments/subject.js";
+import { effectiveWorkspacePathForSession } from "../session/session-workspace.js";
+import { ProjectStore } from "../projects/project-store.js";
+import { runExec } from "../infra/exec.js";
+import { isSessionSourceBinding } from "../agent/source-context/types.js";
+import { realpath, stat } from "node:fs/promises";
+//#region src/gateway/session-context-summary.ts
+init_logger();
+const log = createLogger("SessionContextSummary");
+const SOURCE_LIMIT = 20;
+async function readEnvironment(config, sessionKey, projectId) {
+	const bound = getExecutionEnvironmentForSession(sessionKey);
+	const project = projectId ? new ProjectStore().get(projectId) : void 0;
+	const rootPath = bound?.rootPath ?? effectiveWorkspacePathForSession(config, sessionKey, getSessionConfig(sessionKey), project);
+	const available = (!bound || bound.status === "ready") && await stat(rootPath).then((info) => info.isDirectory(), () => false);
+	const environment = {
+		kind: bound?.kind ?? "local_checkout",
+		rootPath,
+		available
+	};
+	if (!available) return environment;
+	const git = (args) => runExec("git", args, {
+		cwd: rootPath,
+		timeoutMs: 2e3,
+		maxBuffer: 16384
+	}).then((result) => result.stdout.trim());
+	const [branch, head] = await Promise.allSettled([git([
+		"symbolic-ref",
+		"--quiet",
+		"--short",
+		"HEAD"
+	]), git([
+		"rev-parse",
+		"--verify",
+		"HEAD^{commit}"
+	])]);
+	if (branch.status === "fulfilled" && branch.value) environment.branch = branch.value;
+	if (head.status === "fulfilled" && head.value) {
+		environment.headSha = head.value;
+		environment.detached = branch.status === "rejected" && branch.reason?.code === 1;
+	}
+	if (bound?.kind === "managed_worktree") {
+		const repositoryRoot = await git(["rev-parse", "--show-toplevel"]).catch(() => void 0);
+		environment.available = Boolean(environment.headSha && repositoryRoot && repositoryRoot === await realpath(rootPath));
+		if (!environment.available) {
+			delete environment.branch;
+			delete environment.headSha;
+			delete environment.detached;
+		}
+	}
+	return environment;
+}
+/** A bounded metadata-only query. It never prepares Note context or starts an agent. */
+async function getSessionContextSummary(config, sessionKey, scopes) {
+	const metadata = getSessionMetadata(sessionKey);
+	if (!metadata) return null;
+	const summary = {
+		sessionKey,
+		observedAt: (/* @__PURE__ */ new Date()).toISOString(),
+		work: {},
+		sources: [],
+		sourcesHasMore: false,
+		unavailableSections: []
+	};
+	const canReadWorkspace = hasGatewayScope(scopes, "workspace.read");
+	const canReadTasks = hasGatewayScope(scopes, "tasks.read");
+	const unavailable = (section, err) => {
+		if (!summary.unavailableSections.includes(section)) summary.unavailableSections.push(section);
+		if (err) log.warn({
+			err,
+			sessionKey,
+			section
+		}, "Context summary section unavailable");
+	};
+	if (canReadWorkspace) try {
+		const project = metadata.projectId ? new ProjectStore().get(metadata.projectId) : void 0;
+		if (project) summary.work.project = {
+			id: project.id,
+			title: project.name.slice(0, 240)
+		};
+		else if (metadata.projectId) unavailable("work");
+	} catch (err) {
+		unavailable("work", err);
+	}
+	else unavailable("work");
+	if (canReadTasks) try {
+		const taskId = new TaskConversationRepository().resolveActiveExecutionSession(sessionKey)?.taskId;
+		const task = taskId ? new TaskRepository().get(taskId) : void 0;
+		if (task) summary.work.task = {
+			id: task.id,
+			title: task.title.slice(0, 240),
+			phase: task.phase
+		};
+		else if (taskId) unavailable("work");
+	} catch (err) {
+		unavailable("work", err);
+	}
+	else unavailable("work");
+	if (canReadWorkspace) {
+		try {
+			const binding = metadata.customData?.sourceBinding;
+			const source = isSessionSourceBinding(binding) ? binding : void 0;
+			const rows = getSqliteDatabase().prepare(`
+        WITH refs AS (
+          SELECT ? AS note_id, 1 AS from_session, 0 AS from_task WHERE ? IS NOT NULL
+          UNION ALL
+          SELECT target_id, 0, 1 FROM context_edges
+          WHERE owner_kind = 'task' AND owner_id = ? AND target_kind = 'note'
+        ), grouped AS (
+          SELECT note_id, MAX(from_session) AS from_session, MAX(from_task) AS from_task
+          FROM refs GROUP BY note_id
+        )
+        SELECT g.*, n.note_id AS found_id, substr(n.title, 1, 240) AS title
+        FROM grouped g LEFT JOIN notes n ON n.note_id = g.note_id AND n.status != 'trashed'
+        ORDER BY g.from_session DESC, g.note_id LIMIT ?
+      `).all(source?.sourceId ?? null, source?.sourceId ?? null, summary.work.task?.id ?? null, SOURCE_LIMIT + 1);
+			summary.sourcesHasMore = rows.length > SOURCE_LIMIT;
+			summary.sources = rows.slice(0, SOURCE_LIMIT).map((row) => ({
+				kind: "note",
+				id: row.note_id,
+				...row.found_id ? { title: row.title ?? void 0 } : { unavailable: true },
+				origins: [...row.from_session ? [{
+					kind: "session",
+					version: source?.version
+				}] : [], ...row.from_task ? [{ kind: "task" }] : []]
+			}));
+		} catch (err) {
+			unavailable("sources", err);
+		}
+		try {
+			summary.environment = await readEnvironment(config, sessionKey, metadata.projectId);
+		} catch (err) {
+			unavailable("environment", err);
+		}
+	} else {
+		unavailable("sources");
+		unavailable("environment");
+	}
+	summary.observedAt = (/* @__PURE__ */ new Date()).toISOString();
+	return summary;
+}
+//#endregion
+export { getSessionContextSummary };

package/dist/src/i18n/response-language.d.ts

@@ -1,8 +1,8 @@
 import { z } from 'zod';
 export declare const ResponseLanguageSchema: z.ZodEnum<{
+    en: "en";
     auto: "auto";
     "zh-CN": "zh-CN";
-    en: "en";
 }>;
 export type ResponseLanguage = z.infer<typeof ResponseLanguageSchema>;
 export declare function resolveResponseLanguage(userPreference: ResponseLanguage, sessionPreference?: ResponseLanguage): ResponseLanguage;

package/dist/src/projects/index.js

@@ -1,14 +1,14 @@
 import { ProjectStore, slugifyProjectName } from "./project-store.js";
 import { getProjectForSession, getProjectWorkspacePathForSession, resolveProjectWorkspacePath } from "./workspace.js";
-import { bindSessionToProject, bindSessionsToProject, listProjectSessionKeys, moveSessionToProject, unbindSessionFromProject } from "./session-bind.js";
 import { ProjectWorkspaceConflictError, ProjectWorkspaceMissingError, canonicalWorkspacePath, ensureWorkspaceDirectory, inferProjectNameFromWorkspaceRoot, isPathSameOrInsideWorkspace, isSafeAutoCreateWorkspaceRoot, resolveWorkspaceProjectRoot, workspaceDirectoryExists } from "./workspace-project.js";
+import { inferProjectExecutionMode, inferProjectKind } from "./project-kind.js";
+import { bindSessionToProject, bindSessionsToProject, listProjectSessionKeys, moveSessionToProject, unbindSessionFromProject } from "./session-bind.js";
 import { ProjectService } from "./project-service.js";
 import { ProjectSkillError, ProjectSkillService } from "./project-skill-service.js";
 import { isValidProjectAgentId, normalizeProjectAgentId, resolveProjectAgentId } from "./project-agent.js";
-import { inferProjectKind } from "./project-kind.js";
 import { CODING_PROJECT_AGENT_ID, inferSuggestedProjectDefaultAgentId, suggestProjectDefaultAgentId } from "./project-agent-suggestion.js";
 import { buildProjectLoopOverview } from "./project-loop.js";
 import { bindWorkflowRunToProject } from "./workflow-bind.js";
 import { bindAutomationToProject } from "./automation-bind.js";
 import { bindMemoryRecordToProject } from "./memory-bind.js";
-export { CODING_PROJECT_AGENT_ID, ProjectService, ProjectSkillError, ProjectSkillService, ProjectStore, ProjectWorkspaceConflictError, ProjectWorkspaceMissingError, bindAutomationToProject, bindMemoryRecordToProject, bindSessionToProject, bindSessionsToProject, bindWorkflowRunToProject, buildProjectLoopOverview, canonicalWorkspacePath, ensureWorkspaceDirectory, getProjectForSession, getProjectWorkspacePathForSession, inferProjectKind, inferProjectNameFromWorkspaceRoot, inferSuggestedProjectDefaultAgentId, isPathSameOrInsideWorkspace, isSafeAutoCreateWorkspaceRoot, isValidProjectAgentId, listProjectSessionKeys, moveSessionToProject, normalizeProjectAgentId, resolveProjectAgentId, resolveProjectWorkspacePath, resolveWorkspaceProjectRoot, slugifyProjectName, suggestProjectDefaultAgentId, unbindSessionFromProject, workspaceDirectoryExists };
+export { CODING_PROJECT_AGENT_ID, ProjectService, ProjectSkillError, ProjectSkillService, ProjectStore, ProjectWorkspaceConflictError, ProjectWorkspaceMissingError, bindAutomationToProject, bindMemoryRecordToProject, bindSessionToProject, bindSessionsToProject, bindWorkflowRunToProject, buildProjectLoopOverview, canonicalWorkspacePath, ensureWorkspaceDirectory, getProjectForSession, getProjectWorkspacePathForSession, inferProjectExecutionMode, inferProjectKind, inferProjectNameFromWorkspaceRoot, inferSuggestedProjectDefaultAgentId, isPathSameOrInsideWorkspace, isSafeAutoCreateWorkspaceRoot, isValidProjectAgentId, listProjectSessionKeys, moveSessionToProject, normalizeProjectAgentId, resolveProjectAgentId, resolveProjectWorkspacePath, resolveWorkspaceProjectRoot, slugifyProjectName, suggestProjectDefaultAgentId, unbindSessionFromProject, workspaceDirectoryExists };

package/dist/src/projects/project-kind.d.ts

@@ -1,3 +1,4 @@
+import type { ProjectExecutionMode } from './types.js';
 export type ProjectKind = 'coding' | 'general' | 'unknown';
 export type ProjectKindOverride = 'auto' | 'coding' | 'general';
 export type ProjectKindInference = {
@@ -11,3 +12,9 @@ export declare function inferProjectKind(input: {
     workspaceRoot?: string | null;
     projectKind?: string | null;
 }): ProjectKindInference;
+export declare function inferProjectExecutionMode(input: {
+    name?: string | null;
+    description?: string | null;
+    workspaceRoot?: string | null;
+    projectKind?: string | null;
+}): ProjectExecutionMode;

package/dist/src/projects/project-kind.js

@@ -140,5 +140,10 @@ function inferProjectKind(input) {
 		reasons
 	};
 }
+function inferProjectExecutionMode(input) {
+	const workspaceRoot = canonicalWorkspacePath(input.workspaceRoot);
+	if (!workspaceRoot || !existsSync(join(workspaceRoot, ".git"))) return "local_checkout";
+	return inferProjectKind(input).kind === "coding" ? "managed_worktree" : "local_checkout";
+}
 //#endregion
-export { inferProjectKind };
+export { inferProjectExecutionMode, inferProjectKind };

package/dist/src/projects/project-service.js

@@ -3,8 +3,9 @@ import { getSessionMetadata } from "../storage/sqlite/session-repository.js";
 import "../storage/sqlite/index.js";
 import { changedFieldsFromPatch, emitActivity, systemActivityActor, systemActivitySource } from "../activity/emitter.js";
 import { ProjectStore } from "./project-store.js";
-import { bindSessionToProject, listProjectSessionKeys, unbindSessionFromProject } from "./session-bind.js";
 import { ProjectWorkspaceConflictError, ProjectWorkspaceMissingError, canonicalWorkspacePath, ensureWorkspaceDirectory, inferProjectNameFromWorkspaceRoot, isPathSameOrInsideWorkspace, isSafeAutoCreateWorkspaceRoot, resolveWorkspaceProjectRoot, workspaceDirectoryExists } from "./workspace-project.js";
+import { inferProjectExecutionMode } from "./project-kind.js";
+import { bindSessionToProject, listProjectSessionKeys, unbindSessionFromProject } from "./session-bind.js";
 import { createHash } from "node:crypto";
 //#region src/projects/project-service.ts
 var ProjectService = class {
@@ -39,11 +40,18 @@ var ProjectService = class {
 		}
 		const name = input.name?.trim() || inferProjectNameFromWorkspaceRoot(workspaceRoot) || "";
 		const slug = input.slug?.trim() || this.store.generateSlug(name);
+		const executionMode = input.executionMode ?? inferProjectExecutionMode({
+			name,
+			description: input.description,
+			workspaceRoot,
+			projectKind: input.projectKind
+		});
 		const project = this.store.create({
 			...input,
 			name,
 			slug,
-			workspaceRoot
+			workspaceRoot,
+			executionMode
 		});
 		emitActivity({
 			type: "project.created",

package/dist/src/projects/project-store.d.ts

@@ -7,6 +7,7 @@ export type ProjectRow = {
     status: string;
     default_agent_id: string | null;
     workspace_root: string | null;
+    execution_mode: Project['executionMode'];
     brief: string | null;
     instructions: string | null;
     outcome: string | null;

package/dist/src/projects/project-store.js

@@ -19,6 +19,7 @@ function projectFromRow(row) {
 		status: row.status,
 		defaultAgentId: row.default_agent_id ?? void 0,
 		workspaceRoot: row.workspace_root ?? void 0,
+		executionMode: row.execution_mode,
 		brief: row.brief ?? void 0,
 		instructions: row.instructions ?? void 0,
 		outcome: row.outcome ?? void 0,
@@ -156,6 +157,7 @@ var ProjectStore = class {
 			status: "active",
 			defaultAgentId: trimOptional(input.defaultAgentId),
 			workspaceRoot: trimOptional(input.workspaceRoot),
+			executionMode: input.executionMode ?? "local_checkout",
 			brief: trimOptional(input.brief),
 			instructions: trimOptional(input.instructions),
 			outcome: trimOptional(input.outcome),
@@ -173,11 +175,11 @@ var ProjectStore = class {
 		};
 		runSqliteWriteTransaction((db) => {
 			db.prepare(`INSERT INTO projects (
-          project_id, name, slug, description, status, default_agent_id, workspace_root,
+          project_id, name, slug, description, status, default_agent_id, workspace_root, execution_mode,
           brief, instructions, outcome, success_criteria_json, scope_json, non_goals_json,
           health, owner_id, target_at, version,
           created_at, updated_at, last_active_at, pinned_at
-        ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`).run(project.id, project.name, project.slug, project.description ?? null, project.status, project.defaultAgentId ?? null, project.workspaceRoot ?? null, project.brief ?? null, project.instructions ?? null, project.outcome ?? null, JSON.stringify(project.successCriteria), JSON.stringify(project.scope), JSON.stringify(project.nonGoals), project.health, project.ownerId ?? null, project.targetAt ?? null, project.version, project.createdAt, project.updatedAt, project.lastActiveAt ?? null, project.pinnedAt ?? null);
+        ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`).run(project.id, project.name, project.slug, project.description ?? null, project.status, project.defaultAgentId ?? null, project.workspaceRoot ?? null, project.executionMode, project.brief ?? null, project.instructions ?? null, project.outcome ?? null, JSON.stringify(project.successCriteria), JSON.stringify(project.scope), JSON.stringify(project.nonGoals), project.health, project.ownerId ?? null, project.targetAt ?? null, project.version, project.createdAt, project.updatedAt, project.lastActiveAt ?? null, project.pinnedAt ?? null);
 			syncProjectFts(db, project);
 		});
 		return project;
@@ -249,7 +251,7 @@ var ProjectStore = class {
          JOIN sessions s ON s.project_id = p.project_id
          ${where}`).get(...params).total;
 		return {
-			items: db.prepare(`SELECT p.*, MAX(s.updated_at) AS latest_session_at
+			items: db.prepare(`SELECT p.*
          FROM projects p
          JOIN sessions s ON s.project_id = p.project_id
          ${where}
@@ -257,8 +259,8 @@ var ProjectStore = class {
          ORDER BY
            CASE WHEN p.pinned_at IS NULL THEN 1 ELSE 0 END ASC,
            p.pinned_at DESC,
-           latest_session_at DESC,
-           p.updated_at DESC
+           p.created_at DESC,
+           p.project_id ASC
          LIMIT ? OFFSET ?`).all(...params, limit, offset).map(projectFromRow),
 			total,
 			limit,
@@ -276,6 +278,7 @@ var ProjectStore = class {
 			...input.status !== void 0 ? { status: input.status } : {},
 			...input.defaultAgentId !== void 0 ? { defaultAgentId: nullableText(input.defaultAgentId) ?? void 0 } : {},
 			...input.workspaceRoot !== void 0 ? { workspaceRoot: nullableText(input.workspaceRoot) ?? void 0 } : {},
+			...input.executionMode !== void 0 ? { executionMode: input.executionMode } : {},
 			...input.brief !== void 0 ? { brief: nullableText(input.brief) ?? void 0 } : {},
 			...input.instructions !== void 0 ? { instructions: nullableText(input.instructions) ?? void 0 } : {},
 			...input.outcome !== void 0 ? { outcome: nullableText(input.outcome) ?? void 0 } : {},
@@ -291,10 +294,10 @@ var ProjectStore = class {
 		};
 		runSqliteWriteTransaction((db) => {
 			if (db.prepare(`UPDATE projects SET
-          name = ?, description = ?, status = ?, default_agent_id = ?, workspace_root = ?, brief = ?, instructions = ?,
+          name = ?, description = ?, status = ?, default_agent_id = ?, workspace_root = ?, execution_mode = ?, brief = ?, instructions = ?,
           outcome = ?, success_criteria_json = ?, scope_json = ?, non_goals_json = ?, health = ?, owner_id = ?, target_at = ?,
           pinned_at = ?, updated_at = ?, version = ?
-         WHERE project_id = ? AND version = ?`).run(next.name, next.description ?? null, next.status, next.defaultAgentId ?? null, next.workspaceRoot ?? null, next.brief ?? null, next.instructions ?? null, next.outcome ?? null, JSON.stringify(next.successCriteria), JSON.stringify(next.scope), JSON.stringify(next.nonGoals), next.health, next.ownerId ?? null, next.targetAt ?? null, next.pinnedAt ?? null, next.updatedAt, next.version, id, before.version).changes !== 1) throw new Error(`Project update conflict: ${id}`);
+         WHERE project_id = ? AND version = ?`).run(next.name, next.description ?? null, next.status, next.defaultAgentId ?? null, next.workspaceRoot ?? null, next.executionMode, next.brief ?? null, next.instructions ?? null, next.outcome ?? null, JSON.stringify(next.successCriteria), JSON.stringify(next.scope), JSON.stringify(next.nonGoals), next.health, next.ownerId ?? null, next.targetAt ?? null, next.pinnedAt ?? null, next.updatedAt, next.version, id, before.version).changes !== 1) throw new Error(`Project update conflict: ${id}`);
 			syncProjectFts(db, next);
 		});
 		return this.get(id);

package/dist/src/projects/types.d.ts

@@ -1,6 +1,7 @@
 import type { PaginatedResult } from '../session/types.js';
 export type ProjectStatus = 'planned' | 'active' | 'paused' | 'completed' | 'cancelled' | 'archived';
 export type ProjectHealth = 'unknown' | 'on_track' | 'at_risk' | 'off_track';
+export type ProjectExecutionMode = 'local_checkout' | 'managed_worktree';
 export interface Project {
     id: string;
     name: string;
@@ -11,6 +12,7 @@ export interface Project {
     workspaceRoot?: string;
     workspaceMode?: 'followAgent' | 'fixed';
     effectiveWorkspaceRoot?: string;
+    executionMode: ProjectExecutionMode;
     brief?: string;
     instructions?: string;
     outcome?: string;
@@ -69,6 +71,7 @@ export interface CreateProjectInput {
     workspaceRoot?: string;
     createWorkspaceRoot?: boolean;
     projectKind?: string;
+    executionMode?: ProjectExecutionMode;
     brief?: string;
     instructions?: string;
     outcome?: string;
@@ -86,6 +89,7 @@ export interface UpdateProjectInput {
     status?: ProjectStatus;
     workspaceRoot?: string | null;
     createWorkspaceRoot?: boolean;
+    executionMode?: ProjectExecutionMode;
     brief?: string | null;
     instructions?: string | null;
     pinnedAt?: number | null;

package/dist/src/providers/auth-runtime/resolve-auth.js

@@ -1,5 +1,5 @@
-import { getApiKeyFromEnv, init_env_keys } from "../env-keys.js";
 import { init_sync_provider_auth, resolveProviderApiKeyForAgentSync } from "../../auth/sync-provider-auth.js";
+import { getApiKeyFromEnv, init_env_keys } from "../env-keys.js";
 import { getDefaultAuthProfileStore } from "./auth-profile-store.js";
 //#region src/providers/auth-runtime/resolve-auth.ts
 init_env_keys();

package/dist/src/providers/index.js

@@ -1,11 +1,11 @@
 import { __esmMin, __exportAll } from "../../_virtual/_rolldown/runtime.js";
 import { getAgentDefaultModelRef, init_schema } from "../config/schema.js";
+import { getModelOAuthProviderIds, init_registry } from "../auth/oauth/registry.js";
+import { hasProviderAuthOnDiskSync, init_sync_provider_auth } from "../auth/sync-provider-auth.js";
 import { PROVIDER_ENV_MAP, getApiKeyFromEnv, init_env_keys } from "./env-keys.js";
 import { init_model_ref, splitProviderModelRef } from "./model-ref.js";
 import { ModelRegistry, getModelRegistry, init_model_registry, prewarmModelRegistry, resetModelRegistry } from "./model-registry.js";
-import { getModelOAuthProviderIds, init_registry } from "../auth/oauth/registry.js";
 import { CredentialResolver, hasCredentials, init_credentials } from "../auth/credentials.js";
-import { hasProviderAuthOnDiskSync, init_sync_provider_auth } from "../auth/sync-provider-auth.js";
 import { EXTENSION_PROVIDER_BASE_URL, init_constants } from "./constants.js";
 import { applyOfficialModelMetadataCorrections, getSupplementalModels, init_model_supplements } from "./model-supplements.js";
 import { getProviderRegistry, init_plugin_registry } from "./plugin-registry.js";

package/dist/src/providers/model-registry.js

@@ -1,8 +1,8 @@
 import { __esmMin } from "../../_virtual/_rolldown/runtime.js";
 import { createLogger } from "../utils/logger/index.js";
 import { init_logger } from "../utils/logger.js";
-import { init_resolve_config_value, resolveConfigValue, resolveHeaders } from "../config/resolve-config-value.js";
 import { resolveModelsJsonPath } from "../config/paths.js";
+import { init_resolve_config_value, resolveConfigValue, resolveHeaders } from "../config/resolve-config-value.js";
 import { getDefaultModelValues, init_models_json, validateModelsConfig } from "../config/models-json.js";
 import { getApiKeyFromEnv, init_env_keys } from "./env-keys.js";
 import { getModelCatalogStore, init_model_catalog_store } from "./model-catalog-store.js";
@@ -60,6 +60,7 @@ function applyModelOverride(model, override) {
 	const result = { ...model };
 	if (override.name !== void 0) result.name = override.name;
 	if (override.reasoning !== void 0) result.reasoning = override.reasoning;
+	if (override.thinkingLevelMap !== void 0) result.thinkingLevelMap = override.thinkingLevelMap;
 	if (override.input !== void 0) result.input = override.input;
 	if (override.contextWindow !== void 0) result.contextWindow = override.contextWindow;
 	if (override.maxTokens !== void 0) result.maxTokens = override.maxTokens;
@@ -368,6 +369,7 @@ var init_model_registry = __esmMin((() => {
 						provider: providerName,
 						baseUrl: providerConfig.baseUrl,
 						reasoning: modelDef.reasoning ?? false,
+						thinkingLevelMap: modelDef.thinkingLevelMap,
 						input: modelDef.input ?? defaults.input,
 						cost: modelDef.cost ?? defaults.cost,
 						contextWindow: modelDef.contextWindow ?? defaults.contextWindow,

package/dist/src/providers/model-thinking.d.ts

@@ -0,0 +1,4 @@
+import { type Api, type Model } from '@earendil-works/pi-ai';
+import type { ModelThinkingCapabilities } from '@xopcai/gateway-contract';
+/** Use the same capability metadata as the provider runtime. */
+export declare function getModelThinking(model: Model<Api>): ModelThinkingCapabilities;

package/dist/src/providers/model-thinking.js

@@ -0,0 +1,41 @@
+import { getSupportedThinkingLevels } from "@earendil-works/pi-ai";
+//#region src/providers/model-thinking.ts
+/** Use the same capability metadata as the provider runtime. */
+function getModelThinking(model) {
+	const base = { supportsAdaptive: false };
+	if (!model.reasoning) return {
+		...base,
+		mode: "none",
+		options: ["off"],
+		initialValue: "off"
+	};
+	const compat = model.compat;
+	const binaryFormat = [
+		"zai",
+		"qwen",
+		"qwen-chat-template",
+		"chat-template"
+	].includes(compat?.thinkingFormat ?? "");
+	const binaryProvider = model.provider === "zai" || model.provider === "z.ai";
+	if ((binaryFormat || binaryProvider) && compat?.supportsReasoningEffort !== true) return {
+		...base,
+		mode: "toggle",
+		options: ["off", "high"],
+		initialValue: "high"
+	};
+	if (compat?.supportsReasoningEffort === false) return {
+		...base,
+		mode: "unknown",
+		options: ["off"],
+		initialValue: "off"
+	};
+	const options = getSupportedThinkingLevels(model);
+	return {
+		...base,
+		mode: options.length > 1 ? "levels" : "none",
+		options,
+		initialValue: options.includes("medium") ? "medium" : options[0] ?? "off"
+	};
+}
+//#endregion
+export { getModelThinking };

package/dist/src/providers/register-runtime-providers.js

@@ -1,6 +1,6 @@
 import { __esmMin } from "../../_virtual/_rolldown/runtime.js";
-import { getModelCatalogStore, init_model_catalog_store } from "./model-catalog-store.js";
 import { getOAuthProviderDefinition, init_registry } from "../auth/oauth/registry.js";
+import { getModelCatalogStore, init_model_catalog_store } from "./model-catalog-store.js";
 import { XOPC_CLOUD_PROVIDER_ID, init_xopc_cloud_config, resolveXopcModelRouterUrl } from "./xopc-cloud-config.js";
 //#region src/providers/register-runtime-providers.ts
 function registerRuntimeProvider(modelRuntime, source) {

package/dist/src/session/config-types.d.ts

@@ -10,6 +10,7 @@ export interface SessionAgentConfig {
     verboseLevel?: VerboseLevel;
     elevatedMode?: ElevatedMode;
     modelOverride?: string;
+    fixedModel?: boolean;
     providerOverride?: string;
     workingDirectoryOverride?: string;
     responseLanguage?: ResponseLanguage;

package/dist/src/session/index.js

@@ -1,5 +1,5 @@
-import { buildSessionContextForLlm, isTranscriptContextEntry, mergeLlmMessagesPreservingContextRows, transcriptRowsFromJsonArray } from "./session-context-for-llm.js";
 import { SessionStatus } from "./types.js";
+import { buildSessionContextForLlm, isTranscriptContextEntry, mergeLlmMessagesPreservingContextRows, transcriptRowsFromJsonArray } from "./session-context-for-llm.js";
 import { effectiveWorkspacePathForSession, normalizeWorkingDirectoryInput, projectWorkspacePath } from "./session-workspace.js";
 import { emitSessionTranscriptUpdate, onSessionTranscriptUpdate } from "./transcript-events.js";
 import { fallbackTitleFromMessages, generateSessionTitleFromMessages, getSessionTitleSource, isWebchatSessionKey, maybeRefineSessionTitleWithLlm, maybeSetProvisionalSessionTitle, provisionalTitleFromUserText, sanitizeGeneratedSessionTitle, sanitizeSessionTitle, shouldAutoTitleSessionKey, shouldRefineSessionTitleWithLlm } from "./session-title.js";

package/dist/src/session/model-config-lock.d.ts

@@ -0,0 +1,2 @@
+/** Serialize configuration changes with input acceptance for one conversation. */
+export declare function withModelConfigLock<T>(sessionKey: string, operation: () => Promise<T>): Promise<T>;

package/dist/src/session/model-config-lock.js

@@ -0,0 +1,14 @@
+//#region src/session/model-config-lock.ts
+const pending = /* @__PURE__ */ new Map();
+/** Serialize configuration changes with input acceptance for one conversation. */
+async function withModelConfigLock(sessionKey, operation) {
+	const next = (pending.get(sessionKey) ?? Promise.resolve()).catch(() => void 0).then(operation);
+	pending.set(sessionKey, next);
+	try {
+		return await next;
+	} finally {
+		if (pending.get(sessionKey) === next) pending.delete(sessionKey);
+	}
+}
+//#endregion
+export { withModelConfigLock };

package/dist/src/session/session-workspace.d.ts

@@ -16,6 +16,7 @@ export declare function normalizeWorkingDirectoryInput(raw: string): {
 };
 export declare function projectWorkspacePath(project: Pick<Project, 'workspaceRoot'> | null | undefined): string | null;
 /**
- * Resolved markdown workspace for tools/shell: project workspace, session override, or merged agent profile default.
+ * Resolved workspace for tools/shell: bound execution environment, project workspace,
+ * session override, or merged agent profile default.
  */
 export declare function effectiveWorkspacePathForSession(cfg: Config, sessionKey: string, sessionAgentConfig: SessionAgentConfig | null | undefined, project?: Pick<Project, 'workspaceRoot'> | null): string;

package/dist/src/session/session-workspace.js

@@ -1,6 +1,7 @@
 import { init_workspace_path, normalizeWorkspaceDir } from "../config/workspace-path.js";
 import { init_agent_scope, resolveUserPath } from "../agent/agent-scope.js";
 import { resolveEffectiveAgentProfileForSession } from "../config/agent-profile.js";
+import { getExecutionEnvironmentForSession } from "../execution-environments/subject.js";
 //#region src/session/session-workspace.ts
 init_agent_scope();
 init_workspace_path();
@@ -29,10 +30,13 @@ function projectWorkspacePath(project) {
 	return normalizeWorkspaceDir(resolveUserPath(raw));
 }
 /**
-* Resolved markdown workspace for tools/shell: project workspace, session override, or merged agent profile default.
+* Resolved workspace for tools/shell: bound execution environment, project workspace,
+* session override, or merged agent profile default.
 */
 function effectiveWorkspacePathForSession(cfg, sessionKey, sessionAgentConfig, project) {
 	const base = resolveEffectiveAgentProfileForSession(cfg, sessionKey).resolvedWorkspacePath;
+	const environment = getExecutionEnvironmentForSession(sessionKey);
+	if (environment) return environment.rootPath;
 	const projectWorkspace = projectWorkspacePath(project);
 	if (projectWorkspace) return projectWorkspace;
 	const o = sessionAgentConfig?.workingDirectoryOverride?.trim();

package/dist/src/session/store.js

@@ -3,8 +3,8 @@ import { createLogger } from "../utils/logger/index.js";
 import { init_logger } from "../utils/logger.js";
 import { requireXopcDatabase } from "../storage/sqlite/connection.js";
 import { runSqliteWriteTransaction } from "../storage/sqlite/transaction.js";
-import { buildSessionContextForLlm, buildSessionDisplayMessages, isRuntimeOnlyTranscriptMessage, isTranscriptCompactionEntry, mergeLlmMessagesPreservingContextRows, transcriptRowsFromJsonArray } from "./session-context-for-llm.js";
 import "./types.js";
+import { buildSessionContextForLlm, buildSessionDisplayMessages, isRuntimeOnlyTranscriptMessage, isTranscriptCompactionEntry, mergeLlmMessagesPreservingContextRows, transcriptRowsFromJsonArray } from "./session-context-for-llm.js";
 import { init_agent_session_key, resolveAgentIdFromSessionKey } from "../routing/agent-session-key.js";
 import { estimateTokensFromMessages } from "../storage/sqlite/row-mappers.js";
 import { deleteSessionRecord, ensureSessionRecord, findSessionKeyBySessionId, getGlobalSessionStats, getSessionMetadata, listSessionMetadata, listSessionsByAgent, patchSessionMetadata, resetSessionRecord } from "../storage/sqlite/session-repository.js";

package/dist/src/session/turn-outcome-projector.js

@@ -1,4 +1,4 @@
-import { TurnOutcomeDeliverableSchema, fileResourceArtifactUri, parseTurnOutcome, turnOutcomeKindFromFileName, turnOutcomeMimeTypeFromFileName } from "../../packages/gateway-contract/src/turn-outcome.js";
+import { TurnOutcomeDeliverableSchema, fileResourceArtifactUri, mergeTurnOutcomeDeliverables, parseTurnOutcome, turnOutcomeKindFromFileName, turnOutcomeMimeTypeFromFileName } from "../../packages/gateway-contract/src/turn-outcome.js";
 import { parseProductDeliveryEnvelope } from "../../packages/gateway-contract/src/product-delivery.js";
 import { parseFileResourceId } from "../files/file-service.js";
 //#region src/session/turn-outcome-projector.ts
@@ -28,6 +28,7 @@ function fileDeliverable(reference, failed) {
 	const available = !failed && managedFile;
 	return {
 		artifactId: reference.id,
+		...managedFile ? { sourceFileId: reference.id } : {},
 		title: reference.title,
 		kind: turnOutcomeKindFromFileName(reference.title),
 		...mimeType ? { mimeType } : {},
@@ -124,8 +125,9 @@ function projectTurnOutcome(params) {
 		}
 	}
 	const evidenceItems = [...evidence.values()];
-	const artifactItems = [...deliverables.values()];
-	const partial = failedToolCount > 0 || evidenceItems.some((item) => item.status === "failed") || artifactItems.some((item) => item.availability !== "available");
+	const collectedArtifacts = [...deliverables.values()];
+	const artifactItems = mergeTurnOutcomeDeliverables(collectedArtifacts);
+	const partial = failedToolCount > 0 || evidenceItems.some((item) => item.status === "failed") || collectedArtifacts.some((item) => item.availability !== "available");
 	const diff = diffs.join("\n");
 	const diffTruncated = diff.length > MAX_OUTCOME_DIFF_CHARS;
 	const createdAt = new Date(createdAtMs || Date.now()).toISOString();
@@ -169,23 +171,21 @@ function backfillStructuredTurnOutcomes(rows) {
 		});
 		if (outcome.deliverables.length > 0) projected.set(turnId, outcome);
 	}
-	if (projected.size === 0) return [...rows];
+	if (projected.size === 0 && existing.size === 0) return [...rows];
 	const result = [];
 	for (const [index, source] of rows.entries()) {
 		const row = source;
 		if (row.type === "custom" && row.customType === "turn_outcome") {
 			const outcome = parseTurnOutcome(row.data);
 			const candidate = outcome ? projected.get(outcome.turnId) : void 0;
-			if (outcome && candidate) {
-				const merged = new Map(outcome.deliverables.map((item) => [item.artifactId, item]));
-				for (const item of candidate.deliverables) merged.set(item.artifactId, item);
-				const deliverables = [...merged.values()];
+			if (outcome) {
+				const deliverables = mergeTurnOutcomeDeliverables([...outcome.deliverables, ...candidate?.deliverables ?? []]);
 				result.push({
 					...row,
 					data: {
 						...outcome,
 						deliverables,
-						status: outcome.status === "failed" ? "failed" : deliverables.some((item) => item.availability !== "available") ? "partial" : outcome.status
+						status: outcome.status === "failed" ? "failed" : candidate?.status === "partial" || deliverables.some((item) => item.availability !== "available") ? "partial" : outcome.status
 					}
 				});
 				continue;

package/dist/src/share/hosted-session-share.js

@@ -1,6 +1,6 @@
 import { resolveStateDir } from "../config/paths-state.js";
-import { init_write_file_atomic, writeTextAtomic } from "../infra/write-file-atomic.js";
 import { init_paths } from "../config/paths.js";
+import { init_write_file_atomic, writeTextAtomic } from "../infra/write-file-atomic.js";
 import { CredentialResolver, init_credentials } from "../auth/credentials.js";
 import { resolveMediaReference } from "../media/media-reference.js";
 import { projectSessionShare } from "./session-share-projector.js";

package/dist/src/storage/sqlite/config-repository.d.ts

@@ -1,5 +1,10 @@
 import type { SessionAgentConfig } from '../../session/config-types.js';
 export declare function getSessionConfig(sessionKey: string): SessionAgentConfig | null;
+/** Persisted file locations must be discoverable before a session runs again. */
+export declare function listSessionWorkspaceOverrides(): Array<{
+    sessionKey: string;
+    workingDirectoryOverride: string;
+}>;
 export declare function setSessionConfig(sessionKey: string, config: SessionAgentConfig, cwd: string): SessionAgentConfig;
 export declare function updateSessionConfig(sessionKey: string, partial: Partial<SessionAgentConfig>, cwd: string): SessionAgentConfig;
 export declare function deleteSessionConfig(sessionKey: string): void;