@xopcai/xopc 0.0.320 → 0.0.323

package/dist/src/local-apps/types.d.ts

@@ -1,40 +1,7 @@
-export type LocalAppStatus = 'preview_ready' | 'installed' | 'degraded';
-export type LocalAppInstallationState = 'not_installed' | 'installed';
-export type LocalAppReleaseHealth = 'healthy' | 'failed';
-export interface LocalAppRelease {
-    id: string;
-    appId: string;
-    version: number;
-    sourceHash: string;
-    healthStatus: LocalAppReleaseHealth;
-    createdAt: number;
-    activatedAt?: number;
-    isActive: boolean;
-}
-export interface LocalApp {
-    id: string;
-    extensionId: string;
-    projectId: string;
-    name: string;
-    description?: string;
-    idea: string;
-    status: LocalAppStatus;
-    workspaceRoot: string;
-    draftVersion: number;
-    activeVersion?: number;
-    activeReleaseId?: string;
-    installationState: LocalAppInstallationState;
-    enabled: boolean;
-    createdAt: number;
-    updatedAt: number;
-    installedAt?: number;
-}
-export interface LocalAppDetail extends LocalApp {
-    previewUrl: string;
-    permissions: string[];
-    releases: LocalAppRelease[];
-    acceptanceRuns: LocalAppAcceptanceRun[];
-}
+import type { LocalAppAcceptanceInput, LocalAppAcceptanceRun, LocalAppAcceptanceScenarioSummary, LocalAppChangedFile, LocalAppDetail, LocalAppDiagnostic, LocalAppDiagnosticPhase, LocalAppFixGuidance, LocalAppFixGuidanceInput, LocalAppInstallationState, LocalAppRecord, LocalAppRelease, LocalAppReleaseHealth, LocalAppStatus, LocalAppValidationIssue, LocalAppValidationResult } from '@xopcai/gateway-contract';
+export type LocalApp = LocalAppRecord;
+export type RecordLocalAppAcceptanceInput = LocalAppAcceptanceInput;
+export type { LocalAppAcceptanceRun, LocalAppAcceptanceScenarioSummary, LocalAppChangedFile, LocalAppDetail, LocalAppDiagnostic, LocalAppDiagnosticPhase, LocalAppFixGuidance, LocalAppFixGuidanceInput, LocalAppInstallationState, LocalAppRelease, LocalAppReleaseHealth, LocalAppStatus, LocalAppValidationIssue, LocalAppValidationResult, };
 export interface LocalAppUiGrant {
     granted: boolean;
     extensionId: string;
@@ -43,56 +10,6 @@ export interface LocalAppUiGrant {
     permissions: string[];
     grantedAt?: number;
 }
-export interface LocalAppAcceptanceCheck {
-    id: 'document' | 'content' | 'interaction' | 'criteria';
-    status: 'passed' | 'failed' | 'skipped';
-    message: string;
-}
-export interface LocalAppAcceptanceRun {
-    id: string;
-    appId: string;
-    sourceHash: string;
-    status: 'passed' | 'failed';
-    checks: LocalAppAcceptanceCheck[];
-    interactiveCount: number;
-    createdAt: number;
-}
-export interface RecordLocalAppAcceptanceInput {
-    sourceHash: string;
-    status: 'passed' | 'failed';
-    checks: LocalAppAcceptanceCheck[];
-    interactiveCount: number;
-}
-export interface LocalAppValidationIssue {
-    code: string;
-    severity: 'error' | 'warning';
-    message: string;
-}
-export interface LocalAppChangedFile {
-    path: string;
-    status: 'added' | 'modified' | 'deleted';
-}
-export interface LocalAppAcceptanceScenarioSummary {
-    id: string;
-    name: string;
-    stepCount: number;
-}
-export interface LocalAppValidationResult {
-    status: 'healthy' | 'failed';
-    checkedAt: number;
-    sourceHash?: string;
-    hasDraftChanges: boolean;
-    changedFiles: LocalAppChangedFile[];
-    changedFileCount: number;
-    permissions: string[];
-    permissionDelta: {
-        added: string[];
-        removed: string[];
-    };
-    acceptanceScenarioCount: number;
-    acceptanceScenarios: LocalAppAcceptanceScenarioSummary[];
-    issues: LocalAppValidationIssue[];
-}
 export interface CreateLocalAppInput {
     name: string;
     idea: string;

package/dist/src/notes/service.js

@@ -7,9 +7,9 @@ import { parseNoteMarkdown } from "./note-markdown.js";
 import { listNoteProjectSummaries } from "../storage/sqlite/notes-repository.js";
 import { changedFieldsFromPatch, emitActivity, previewText, systemActivityActor, systemActivitySource } from "../activity/emitter.js";
 import { getDefaultModelSync, init_providers, resolveModel } from "../providers/index.js";
-import { completeWithResolvedCredentials } from "../providers/model-call.js";
 import { DomainOutboxDispatcher } from "../infra/domain-outbox-dispatcher.js";
 import { publishAutomationProductEvent } from "../automations/product-events.js";
+import { completeWithResolvedCredentials } from "../providers/model-call.js";
 import { partitionAttachmentsByReference } from "./note-attachment-sync.js";
 import { buildNoteAgentContextArtifact, getCachedNoteAgentContextArtifact } from "./agent-context.js";
 import { revokeNoteShareRecords } from "../share/note-share-revocation.js";

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-catalog-persistence.js

@@ -1,7 +1,7 @@
 import { __esmMin } from "../../_virtual/_rolldown/runtime.js";
 import { init_paths_state, resolveXopcCloudCatalogCachePath } from "../config/paths-state.js";
-import { ComputerProfileSchema, init_src } from "../../packages/computer-control-contract/src/index.js";
 import { init_write_file_atomic, writeTextAtomic } from "../infra/write-file-atomic.js";
+import { ComputerProfileSchema, init_src } from "../../packages/computer-control-contract/src/index.js";
 import { voiceManifestSchema } from "../../packages/realtime-protocol/src/voice-catalog.js";
 import { init_voice } from "../../packages/realtime-protocol/src/voice.js";
 import { readFileSync, rmSync } from "node:fs";

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";

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/client-history.d.ts

@@ -1,4 +1,4 @@
-import { type TurnOutcome } from '@xopcai/gateway-contract';
+import { type TurnOutcome, type UserTurnDocument } from '@xopcai/gateway-contract';
 import type { Message } from './types.js';
 import type { TranscriptStoredRow } from './session-context-for-llm.js';
 /** Transcript row for TUI and HTTP clients (flattened from persisted session messages). */
@@ -15,6 +15,7 @@ export interface ClientHistoryMessage {
     /** Whitelisted display metadata; never includes source snapshot text. */
     metadata?: {
         sourceContexts?: Array<{
+            refId?: string;
             kind: 'note' | 'task' | 'file' | 'session' | 'browser_tab' | 'browser_page' | 'mcp_resource';
             sourceId: string;
             version: string;
@@ -26,6 +27,7 @@ export interface ClientHistoryMessage {
             documentId?: string;
             fileKind?: 'file' | 'directory';
         }>;
+        userTurnDocument?: UserTurnDocument;
         turnOutcome?: TurnOutcome;
     };
     kind?: 'message' | 'compaction' | 'context' | 'bash' | 'custom' | 'branch';

package/dist/src/session/client-history.js

@@ -1,4 +1,5 @@
 import { parseTurnOutcome } from "../../packages/gateway-contract/src/turn-outcome.js";
+import { isUserTurnDocument } from "../../packages/gateway-contract/src/user-turn-document.js";
 import { init_src } from "../../packages/gateway-contract/src/index.js";
 import { stripRuntimeContextFromUserMessage } from "./user-message-display.js";
 import { buildTranscriptOutline } from "./transcript-outline.js";
@@ -6,13 +7,16 @@ import { buildTranscriptOutline } from "./transcript-outline.js";
 init_src();
 function sourceContextDisplayMetadata(metadata) {
 	if (!metadata || typeof metadata !== "object" || Array.isArray(metadata)) return void 0;
-	const rows = metadata.sourceContexts;
-	if (!Array.isArray(rows)) return void 0;
+	const record = metadata;
+	const rows = record.sourceContexts;
+	const userTurnDocument = isUserTurnDocument(record.userTurnDocument) ? record.userTurnDocument : void 0;
+	if (!Array.isArray(rows)) return userTurnDocument ? { userTurnDocument } : void 0;
 	const sourceContexts = rows.flatMap((value) => {
 		if (!value || typeof value !== "object" || Array.isArray(value)) return [];
 		const row = value;
 		if (row.kind !== "note" && row.kind !== "task" && row.kind !== "file" && row.kind !== "session" && row.kind !== "browser_tab" && row.kind !== "browser_page" && row.kind !== "mcp_resource" || typeof row.sourceId !== "string" || typeof row.version !== "string" || typeof row.title !== "string") return [];
 		return [{
+			...typeof row.refId === "string" ? { refId: row.refId } : {},
 			kind: row.kind,
 			sourceId: row.sourceId,
 			version: row.version,
@@ -25,7 +29,10 @@ function sourceContextDisplayMetadata(metadata) {
 			...row.kind === "file" && (row.fileKind === "file" || row.fileKind === "directory") ? { fileKind: row.fileKind } : {}
 		}];
 	});
-	return sourceContexts.length ? { sourceContexts } : void 0;
+	return sourceContexts.length || userTurnDocument ? {
+		...sourceContexts.length ? { sourceContexts } : {},
+		...userTurnDocument ? { userTurnDocument } : {}
+	} : void 0;
 }
 function flattenMessageContent(content) {
 	if (typeof content === "string") return content;

package/dist/src/session/index.d.ts

@@ -1,7 +1,7 @@
 export { SessionIndex, type SessionIndexConfig } from './manager.js';
 export { onSessionTranscriptUpdate, emitSessionTranscriptUpdate, type SessionTranscriptUpdate, } from './transcript-events.js';
 export { SessionStore } from './store.js';
-export type { SessionStoreOptions, ForkSessionAtTurnOptions, ForkSessionResult, } from './store.js';
+export type { SessionStoreOptions, ForkSessionAtTurnOptions, ForkSessionResult, CreateSessionFromRowsOptions, } from './store.js';
 export { SessionConfigStore, resolveThinkingLevel, resolveReasoningLevel, resolveVerboseLevel } from './config-store.js';
 export { DEFAULT_ACTIVITY_DETAIL_LEVEL, resolveConfiguredActivityDetailDefault, resolveEffectiveThinkingLevel, resolveEffectiveReasoningLevel, } from './thinking-resolve.js';
 export type { SessionAgentConfig } from './config-types.js';

package/dist/src/session/manager.d.ts

@@ -83,6 +83,10 @@ export declare class SessionIndex extends EventEmitter {
         conversationId: string;
         rowCount: number;
     }>;
+    createSessionFromRows(options: import('./store.js').CreateSessionFromRowsOptions): Promise<{
+        conversationId: string;
+        rowCount: number;
+    }>;
     forkSessionRows(sourceKey: string, targetKey: string, options?: {
         throughRow?: number;
     }): Promise<{

package/dist/src/session/manager.js

@@ -165,6 +165,12 @@ var SessionIndex = class extends EventEmitter$1 {
 		if (metadata) this.emit("sessionCreated", metadata);
 		return result;
 	}
+	async createSessionFromRows(options) {
+		const result = await this.store.createSessionFromRows(options);
+		const metadata = await this.store.getMetadata(result.conversationId);
+		if (metadata) this.emit("sessionCreated", metadata);
+		return result;
+	}
 	async forkSessionRows(sourceKey, targetKey, options = {}) {
 		const result = await this.store.forkSessionRows(sourceKey, targetKey, options);
 		const metadata = await this.store.getMetadata(result.conversationId);

package/dist/src/session/session-context-for-llm.d.ts

@@ -17,6 +17,16 @@ export interface XopcTranscriptContextEntry {
     data?: Record<string, unknown>;
     createdAt?: string;
 }
+/** Immutable hidden context captured when an ephemeral side chat becomes a session. */
+export interface XopcTranscriptSideChatOriginEntry {
+    type: 'side_chat_origin';
+    version: 1;
+    parentConversationId: string;
+    parentTranscriptId: string;
+    createdAt: string;
+    contentHash: string;
+    contextMessages: AgentMessage[];
+}
 /** Persisted-only row for replaying local shell executions in clients. */
 export interface XopcTranscriptBashExecutionEntry {
     role: 'bashExecution';
@@ -119,8 +129,9 @@ export interface XopcTranscriptSessionInfoEntry {
     name?: string;
     timestamp?: string | number;
 }
-export type TranscriptStoredRow = AgentMessage | XopcTranscriptContextEntry | XopcTranscriptBashExecutionEntry | XopcTranscriptCustomMessageEntry | XopcTranscriptCustomMessageFileEntry | XopcTranscriptCustomStateEntry | XopcTranscriptBranchSummaryEntry | XopcTranscriptCompactionSummaryEntry | XopcTranscriptCompactionEntry | XopcTranscriptLabelEntry | XopcTranscriptThinkingLevelChangeEntry | XopcTranscriptModelChangeEntry | XopcTranscriptSessionInfoEntry;
+export type TranscriptStoredRow = AgentMessage | XopcTranscriptContextEntry | XopcTranscriptSideChatOriginEntry | XopcTranscriptBashExecutionEntry | XopcTranscriptCustomMessageEntry | XopcTranscriptCustomMessageFileEntry | XopcTranscriptCustomStateEntry | XopcTranscriptBranchSummaryEntry | XopcTranscriptCompactionSummaryEntry | XopcTranscriptCompactionEntry | XopcTranscriptLabelEntry | XopcTranscriptThinkingLevelChangeEntry | XopcTranscriptModelChangeEntry | XopcTranscriptSessionInfoEntry;
 export declare function isTranscriptContextEntry(x: unknown): x is XopcTranscriptContextEntry;
+export declare function isTranscriptSideChatOriginEntry(x: unknown): x is XopcTranscriptSideChatOriginEntry;
 export declare function isTranscriptBashExecutionEntry(x: unknown): x is XopcTranscriptBashExecutionEntry;
 export declare function isTranscriptCustomMessageEntry(x: unknown): x is XopcTranscriptCustomMessageEntry | XopcTranscriptCustomMessageFileEntry;
 export declare function isTranscriptCustomStateEntry(x: unknown): x is XopcTranscriptCustomStateEntry;

package/dist/src/session/session-context-for-llm.js

@@ -6,6 +6,11 @@ function isTranscriptContextEntry(x) {
 	if (!x || typeof x !== "object") return false;
 	return x.kind === "context";
 }
+function isTranscriptSideChatOriginEntry(x) {
+	if (!x || typeof x !== "object") return false;
+	const row = x;
+	return row.type === "side_chat_origin" && row.version === 1 && typeof row.parentConversationId === "string" && typeof row.parentTranscriptId === "string" && typeof row.createdAt === "string" && typeof row.contentHash === "string" && Array.isArray(row.contextMessages) && row.contextMessages.every(isLikelyAgentMessage);
+}
 function isTranscriptBashExecutionEntry(x) {
 	if (!x || typeof x !== "object") return false;
 	return x.role === "bashExecution";
@@ -228,6 +233,10 @@ function sanitizeToolPairs(messages) {
 function transcriptRowsFromJsonArray(arr) {
 	const out = [];
 	for (const x of arr) {
+		if (isTranscriptSideChatOriginEntry(x)) {
+			out.push(x);
+			continue;
+		}
 		if (isTranscriptContextEntry(x)) {
 			out.push(x);
 			continue;
@@ -268,6 +277,11 @@ function transcriptRowsFromJsonArray(arr) {
 function buildSessionContextForLlm(rows) {
 	const out = [];
 	for (const r of rows) {
+		if (isTranscriptSideChatOriginEntry(r)) {
+			out.length = 0;
+			out.push(...r.contextMessages);
+			continue;
+		}
 		if (isTranscriptCompactionEntry(r)) {
 			out.length = 0;
 			out.push(...r.messages);
@@ -315,7 +329,7 @@ function buildSessionDisplayMessages(rows) {
 function mergeLlmMessagesPreservingContextRows(prevRows, llmMessages) {
 	let i = 0;
 	const out = [];
-	for (const r of prevRows) if (isTranscriptContextEntry(r) || isTranscriptBashExecutionEntry(r) || isTranscriptCustomMessageEntry(r) || isTranscriptCustomStateEntry(r) || isTranscriptSummaryMessageEntry(r) || isTranscriptLabelEntry(r) || isTranscriptMetadataEntry(r)) out.push(r);
+	for (const r of prevRows) if (isTranscriptContextEntry(r) || isTranscriptSideChatOriginEntry(r) || isTranscriptBashExecutionEntry(r) || isTranscriptCustomMessageEntry(r) || isTranscriptCustomStateEntry(r) || isTranscriptSummaryMessageEntry(r) || isTranscriptLabelEntry(r) || isTranscriptMetadataEntry(r)) out.push(r);
 	else if (i < llmMessages.length) {
 		out.push(llmMessages[i]);
 		i += 1;
@@ -340,4 +354,4 @@ var init_session_context_for_llm = __esmMin((() => {
 }));
 //#endregion
 init_session_context_for_llm();
-export { buildSessionContextForLlm, buildSessionDisplayMessages, init_session_context_for_llm, isRuntimeOnlyTranscriptMessage, isTranscriptBashExecutionEntry, isTranscriptCompactionEntry, isTranscriptContextEntry, isTranscriptCustomMessageEntry, isTranscriptCustomStateEntry, isTranscriptLabelEntry, isTranscriptMetadataEntry, isTranscriptSummaryMessageEntry, mergeLlmMessagesPreservingContextRows, transcriptRowsFromJsonArray };
+export { buildSessionContextForLlm, buildSessionDisplayMessages, init_session_context_for_llm, isRuntimeOnlyTranscriptMessage, isTranscriptBashExecutionEntry, isTranscriptCompactionEntry, isTranscriptContextEntry, isTranscriptCustomMessageEntry, isTranscriptCustomStateEntry, isTranscriptLabelEntry, isTranscriptMetadataEntry, isTranscriptSideChatOriginEntry, isTranscriptSummaryMessageEntry, mergeLlmMessagesPreservingContextRows, transcriptRowsFromJsonArray };

package/dist/src/session/store.d.ts

@@ -1,6 +1,7 @@
 import type { AgentMessage } from '@earendil-works/pi-agent-core';
 import type { Api, Model } from '@earendil-works/pi-ai/compat';
 import type { Config } from '../config/schema.js';
+import type { SessionAgentConfig } from './config-types.js';
 import { type CompactionConfig, type CompactionExecutionOptions, type CompactionResult } from '../agent/memory/compaction.js';
 import { type WindowConfig } from '../agent/memory/window.js';
 import { type SessionMetadataSeed } from '../storage/sqlite/index.js';
@@ -38,6 +39,15 @@ export interface ForkSessionResult {
     rowCount: number;
     lastTurnId?: string;
 }
+export interface CreateSessionFromRowsOptions {
+    targetKey: string;
+    cwd: string;
+    metadata: SessionMetadataSeed & {
+        agentId: string;
+    };
+    rows: TranscriptStoredRow[];
+    config?: SessionAgentConfig;
+}
 export declare class SessionStore {
     private options;
     private window;
@@ -193,6 +203,10 @@ export declare class SessionStore {
         conversationId: string;
         rowCount: number;
     }>;
+    createSessionFromRows(options: CreateSessionFromRowsOptions): Promise<{
+        conversationId: string;
+        rowCount: number;
+    }>;
     forkSessionRows(sourceKey: string, targetKey: string, options?: {
         throughRow?: number;
     }): Promise<{

package/dist/src/session/store.js

@@ -701,6 +701,23 @@ var SessionStore = class {
 	async forkSession(sourceKey, targetKey) {
 		return this.forkSessionRows(sourceKey, targetKey);
 	}
+	async createSessionFromRows(options) {
+		return this.runStoreMutation(async () => {
+			requireXopcDatabase();
+			if (!options.targetKey.trim()) throw new Error("Target session key is required");
+			if (options.rows.length === 0) throw new Error("Session transcript cannot be empty");
+			return runSqliteWriteTransaction(() => {
+				if (getSessionMetadata(options.targetKey)) throw new Error(`Target session already exists: ${options.targetKey}`);
+				ensureSessionRecord(options.targetKey, options.cwd, options.metadata);
+				replaceTranscriptRows(options.targetKey, options.rows);
+				if (options.config) setSessionConfig(options.targetKey, options.config, options.cwd);
+				return {
+					conversationId: options.targetKey,
+					rowCount: options.rows.length
+				};
+			});
+		});
+	}
 	async forkSessionRows(sourceKey, targetKey, options = {}) {
 		return this.runStoreMutation(async () => {
 			requireXopcDatabase();

package/dist/src/session/stored-rows-to-file-entries.js

@@ -1,5 +1,5 @@
 import { init_voice_transcript, voiceTranscriptMessage } from "./voice-transcript.js";
-import { init_session_context_for_llm, isTranscriptContextEntry, isTranscriptCustomMessageEntry, isTranscriptCustomStateEntry } from "./session-context-for-llm.js";
+import { init_session_context_for_llm, isTranscriptContextEntry, isTranscriptCustomMessageEntry, isTranscriptCustomStateEntry, isTranscriptSideChatOriginEntry } from "./session-context-for-llm.js";
 import { randomUUID } from "node:crypto";
 import { CURRENT_SESSION_VERSION } from "@earendil-works/pi-coding-agent";
 //#region src/session/stored-rows-to-file-entries.ts
@@ -88,6 +88,15 @@ function storedRowsToFileEntries(params) {
 	}];
 	let parentId = null;
 	for (const row of params.rows) {
+		if (isTranscriptSideChatOriginEntry(row)) {
+			for (const message of row.contextMessages) {
+				const entry = agentMessageToEntry(message, parentId, byId);
+				byId.add(entry.id);
+				entries.push(entry);
+				parentId = entry.id;
+			}
+			continue;
+		}
 		if (isTranscriptContextEntry(row)) {
 			const entry = contextRowToCustomEntry(row, parentId, byId);
 			byId.add(entry.id);

package/dist/src/session/transcript-outline.js

@@ -1,4 +1,4 @@
-import { init_session_context_for_llm, isTranscriptBashExecutionEntry, isTranscriptContextEntry, isTranscriptCustomMessageEntry, isTranscriptLabelEntry, isTranscriptMetadataEntry, isTranscriptSummaryMessageEntry } from "./session-context-for-llm.js";
+import { init_session_context_for_llm, isTranscriptBashExecutionEntry, isTranscriptContextEntry, isTranscriptCustomMessageEntry, isTranscriptLabelEntry, isTranscriptMetadataEntry, isTranscriptSideChatOriginEntry, isTranscriptSummaryMessageEntry } from "./session-context-for-llm.js";
 import { stripRuntimeContextFromUserMessage } from "./user-message-display.js";
 //#region src/session/transcript-outline.ts
 init_session_context_for_llm();
@@ -152,6 +152,7 @@ function messageLabel(row) {
 	return role;
 }
 function rowPreview(row) {
+	if (isTranscriptSideChatOriginEntry(row)) return "Side chat parent context";
 	if (isTranscriptContextEntry(row)) return truncateText(row.text ?? JSON.stringify(row.data ?? {}));
 	if (isTranscriptLabelEntry(row)) return truncateText(row.label ? `label: ${row.label}` : "label cleared");
 	if (isTranscriptMetadataEntry(row)) {
@@ -182,6 +183,7 @@ function rowPreview(row) {
 	return preview;
 }
 function rowContentText(row) {
+	if (isTranscriptSideChatOriginEntry(row)) return "Side chat parent context";
 	if (isTranscriptContextEntry(row)) return row.text;
 	if (isTranscriptLabelEntry(row)) return row.label;
 	if (isTranscriptMetadataEntry(row)) {
@@ -223,6 +225,7 @@ function titleForEntry(params) {
 	return params.label;
 }
 function isDisplayMessageRow(row) {
+	if (isTranscriptSideChatOriginEntry(row)) return false;
 	if (isTranscriptContextEntry(row)) return false;
 	if (isTranscriptLabelEntry(row)) return false;
 	if (isTranscriptMetadataEntry(row)) return false;
@@ -260,7 +263,7 @@ function displayIndexForRow(params) {
 function classifyRow(params) {
 	const { row, label, role, toolCall } = params;
 	const record = asRecord(row);
-	if (isTranscriptContextEntry(row) || isTranscriptLabelEntry(row) || isTranscriptMetadataEntry(row)) return {
+	if (isTranscriptSideChatOriginEntry(row) || isTranscriptContextEntry(row) || isTranscriptLabelEntry(row) || isTranscriptMetadataEntry(row)) return {
 		kind: "context",
 		files: []
 	};
@@ -310,7 +313,11 @@ function buildTranscriptOutline(rows) {
 		let role;
 		let toolCallPreview;
 		let toolCall;
-		if (isTranscriptContextEntry(row)) {
+		if (isTranscriptSideChatOriginEntry(row)) {
+			label = "side-chat-origin";
+			parentId = currentTurnId;
+			depth = currentTurnId ? 1 : 0;
+		} else if (isTranscriptContextEntry(row)) {
 			label = "context";
 			parentId = currentTurnId;
 			depth = currentTurnId ? 1 : 0;

package/dist/src/storage/sqlite/connection-wait-repository.js

@@ -247,7 +247,10 @@ function connectionBindings(conversationId) {
 		const account = getConnectorAccount(id);
 		return [{
 			key: `${connectorId}:${id}`,
-			connectorId,
+			target: {
+				type: "connector",
+				connectorId
+			},
 			accountId: id,
 			connectionId: account?.currentConnectionId,
 			label: account?.label ?? connectorId,
@@ -262,7 +265,10 @@ function connectionBindings(conversationId) {
     WHERE conversation_id = ? AND transcript_id = ? AND objective_id = ?`).all(conversationId, readCurrentTranscriptId(getSqliteDatabase(), conversationId) ?? "", wait?.objectiveId ?? input.id);
 	return (wait?.needs ?? stored.map((row) => ({
 		key: `${row.connector_id}:${row.account_id}`,
-		connectorId: row.connector_id,
+		target: {
+			type: "connector",
+			connectorId: row.connector_id
+		},
 		accountId: row.account_id,
 		label: getConnectorAccount(row.account_id)?.label ?? row.connector_id,
 		capabilities: []
@@ -299,7 +305,7 @@ function bindObjectiveAccount(conversationId, connectorId, accountId) {
     (conversation_id, transcript_id, objective_id, connector_id, account_id) VALUES (?, ?, ?, ?, ?)`).run(conversationId, readCurrentTranscriptId(db, conversationId) ?? "", wait?.objectiveId ?? input.id, connectorId, accountId);
 }
 function connectionBinding(conversationId, connectorId) {
-	const matches = connectionBindings(conversationId).filter((need) => need.connectorId === connectorId);
+	const matches = connectionBindings(conversationId).filter((need) => need.target.type === "connector" && need.target.connectorId === connectorId);
 	return matches.length === 1 ? matches[0].connectionId : void 0;
 }
 /** New input wins over an outstanding auto-resume intent, including an already queued resume. */

package/dist/src/storage/sqlite/migrations/202_chat_previews.sql

@@ -0,0 +1,26 @@
+CREATE TABLE chat_previews (
+  preview_id       TEXT PRIMARY KEY,
+  conversation_id  TEXT NOT NULL REFERENCES sessions(conversation_id) ON DELETE CASCADE,
+  title            TEXT NOT NULL,
+  preferred_height INTEGER NOT NULL CHECK (preferred_height BETWEEN 240 AND 720),
+  latest_revision  TEXT NOT NULL CHECK (length(latest_revision) = 64),
+  created_at       INTEGER NOT NULL,
+  updated_at       INTEGER NOT NULL
+);
+
+CREATE INDEX idx_chat_previews_conversation_updated
+  ON chat_previews(conversation_id, updated_at DESC);
+
+CREATE TABLE chat_preview_revisions (
+  preview_id  TEXT NOT NULL REFERENCES chat_previews(preview_id) ON DELETE CASCADE,
+  source_hash TEXT NOT NULL CHECK (length(source_hash) = 64),
+  markup      TEXT NOT NULL,
+  styles      TEXT NOT NULL,
+  script      TEXT NOT NULL,
+  promoted_app_id TEXT UNIQUE REFERENCES local_apps(app_id) ON DELETE SET NULL,
+  created_at  INTEGER NOT NULL,
+  PRIMARY KEY (preview_id, source_hash)
+);
+
+CREATE INDEX idx_chat_preview_revisions_created
+  ON chat_preview_revisions(preview_id, created_at DESC);

package/dist/src/storage/sqlite/migrations/runner.d.ts

@@ -3,7 +3,7 @@ import type { ApplyMigrationsOptions } from './types.js';
 /** Baseline schema version applied from schema.sql on first open. */
 export declare const XOPC_DB_BASELINE_SCHEMA_VERSION = 165;
 /** Latest schema version this release supports (increment when adding migrations). */
-export declare const XOPC_DB_SCHEMA_VERSION = 201;
+export declare const XOPC_DB_SCHEMA_VERSION = 202;
 export declare function resolveMigrationsDir(override?: string): string;
 /**
  * Apply sequential SQL migrations from (currentVersion + 1) through targetVersion.

package/dist/src/storage/sqlite/migrations/runner.js

@@ -57,7 +57,7 @@ function applySingleMigration(db, migration, discardOldScenes = false) {
 */
 function applyPendingMigrations(db, options = {}) {
 	db.function("xopc_operation_id", () => currentOperationId() ?? null);
-	const targetVersion = options.targetVersion ?? 201;
+	const targetVersion = options.targetVersion ?? 202;
 	let currentVersion = readSchemaVersion(db);
 	if (currentVersion > targetVersion) throw new DatabaseSchemaTooNewError(currentVersion, targetVersion);
 	if (!options.migrationsDir && currentVersion < 165) throw new DatabaseSchemaTooOldError(currentVersion, 165);
@@ -95,7 +95,7 @@ function applyPendingMigrations(db, options = {}) {
 }
 /** Inspect schema version without mutating the database. */
 function inspectSchemaMigrationStatus(db, options = {}) {
-	const appVersion = options.targetVersion ?? 201;
+	const appVersion = options.targetVersion ?? 202;
 	const dbVersion = readSchemaVersion(db);
 	if (dbVersion > appVersion) return {
 		dbVersion,
@@ -137,7 +137,7 @@ var init_runner = __esmMin((() => {
 	init_errors();
 	log = createLogger("Sqlite:Migrations");
 	XOPC_DB_BASELINE_SCHEMA_VERSION = 165;
-	XOPC_DB_SCHEMA_VERSION = 201;
+	XOPC_DB_SCHEMA_VERSION = 202;
 }));
 //#endregion
 init_runner();

package/dist/src/storage/sqlite/row-mappers.js

@@ -1,5 +1,5 @@
 import { __esmMin } from "../../../_virtual/_rolldown/runtime.js";
-import { init_session_context_for_llm, isTranscriptContextEntry } from "../../session/session-context-for-llm.js";
+import { init_session_context_for_llm, isTranscriptContextEntry, isTranscriptSideChatOriginEntry } from "../../session/session-context-for-llm.js";
 import "../../session/types.js";
 import { buildDefaultSessionMetadata, init_session_metadata } from "./session-metadata.js";
 //#region src/storage/sqlite/row-mappers.ts
@@ -121,6 +121,10 @@ function classifyStoredRow(row) {
 		entryKind: "context",
 		role: null
 	};
+	if (isTranscriptSideChatOriginEntry(row)) return {
+		entryKind: "context",
+		role: null
+	};
 	const record = row;
 	if (record.type === "compaction" || row.kind === "compaction") return {
 		entryKind: "compaction",
@@ -136,6 +140,7 @@ function extractFtsContent(row) {
 		const ctx = row;
 		return [ctx.text, ctx.id].filter(Boolean).join(" ");
 	}
+	if (isTranscriptSideChatOriginEntry(row)) return "";
 	return extractTextFromMessageContent(row.content);
 }
 function extractTextFromMessageContent(content) {

package/dist/src/storage/sqlite/schema.js

@@ -28,7 +28,7 @@ function ensureXopcDatabaseSchema(db, options = {}) {
 		currentVersion = 165;
 	}
 	applyPendingMigrations(db, {
-		targetVersion: 201,
+		targetVersion: 202,
 		databasePath: fresh ? void 0 : options.databasePath
 	});
 }

package/dist/src/tui/backends/embedded-backend.js

@@ -6,9 +6,9 @@ import { getSessionMetadata } from "../../storage/sqlite/session-read-repository
 import "../../storage/sqlite/index.js";
 import { getAgentDefaultModelRef, init_schema } from "../../config/schema.js";
 import { init_agent_scope, listAgentEntries, normalizeAgentId } from "../../agent/agent-scope.js";
-import { loadConfig, saveConfig } from "../../config/loader.js";
 import { createConversation, init_conversation_repository } from "../../storage/sqlite/conversation-repository.js";
 import { init_agent_session_key, resolveAgentIdFromConversationId } from "../../routing/agent-session-key.js";
+import { loadConfig, saveConfig } from "../../config/loader.js";
 import { effectiveWorkspacePathForSession } from "../../session/session-workspace.js";
 import { ProjectService } from "../../projects/project-service.js";
 import { inferSuggestedProjectDefaultAgentId } from "../../projects/project-agent-suggestion.js";

package/dist/src/tui/tui-commands.js

@@ -2,9 +2,9 @@ import { closeXopcDatabase, isXopcDatabaseOpen, openXopcDatabase } from "../stor
 import { TaskRepository } from "../tasks/task-repository.js";
 import { getSessionMetadata } from "../storage/sqlite/session-read-repository.js";
 import "../storage/sqlite/index.js";
+import { init_agent_session_key, isValidAgentId, normalizeAgentId } from "../routing/agent-session-key.js";
 import { resolveConfigPath } from "../config/paths.js";
 import { loadConfig } from "../config/loader.js";
-import { init_agent_session_key, isValidAgentId, normalizeAgentId } from "../routing/agent-session-key.js";
 import { init_providers, providerSupportsOAuth } from "../providers/index.js";
 import { ProjectService } from "../projects/project-service.js";
 import { isValidProjectAgentId, normalizeProjectAgentId } from "../projects/project-agent.js";