@xopcai/xopc 0.0.321 → 0.0.324

package/dist/src/routing/resolve-route.d.ts

@@ -1,9 +1,9 @@
 /**
  * Route resolution
  *
- * Combines binding rules, identity links, and config to pick an agent and session keys.
+ * Combines catalog binding rules, identity links, and session config to pick an agent.
  */
-import type { BindingRule, RouteInput, RouteResult } from './bindings.js';
+import type { RouteInput, RouteResult } from './bindings.js';
 /**
  * Route context type (alias for RouteInput)
  */
@@ -43,25 +43,10 @@ export interface SessionConfig {
         maxEntries?: number;
     };
 }
-/**
- * Agent list and default id from config.
- */
-export interface AgentConfig {
-    /** Default agent id */
-    default?: string;
-    /** Registered agents */
-    list?: Array<{
-        id: string;
-        enabled?: boolean;
-        [key: string]: unknown;
-    }>;
-}
 /**
  * Subset of app config used for routing.
  */
 export interface RoutingConfig {
-    agents?: AgentConfig;
-    bindings?: BindingRule[] | any[];
     session?: SessionConfig;
 }
 /**
@@ -88,17 +73,15 @@ export interface ResolveRouteResult extends RouteResult {
  */
 export declare function applyIdentityLinks(peerId: string, channel: string, identityLinks?: IdentityLinks): string;
 /**
- * Default agent id from config (`agents.default`, `list[].default`, or `main`).
- */
-export declare function getDefaultAgentId(config: RoutingConfig): string;
-/**
- * Whether `agentId` appears in the enabled agent list (or list is absent).
+ * Default Agent id from the catalog.
  */
-export declare function agentExists(agentId: string, config: RoutingConfig): boolean;
+export declare function getDefaultAgentId(): string;
+/** Whether `agentId` is enabled and fully provisioned. */
+export declare function agentExists(agentId: string): boolean;
 /**
  * Return `agentId` if listed, otherwise the default agent id.
  */
-export declare function pickFirstExistingAgentId(agentId: string, config: RoutingConfig): string;
+export declare function pickFirstExistingAgentId(agentId: string): string;
 /**
  * Thin wrapper around `resolveConversationId` for route inputs.
  */

package/dist/src/routing/resolve-route.js

@@ -1,6 +1,6 @@
 import { __esmMin } from "../../_virtual/_rolldown/runtime.js";
 import { init_account_id, normalizeAccountId } from "./account-id.js";
-import { init_agent_scope, resolveDefaultAgentId } from "../agent/agent-scope.js";
+import { AgentCatalogRepository, init_repository } from "../agent-catalog/repository.js";
 import { getConversationRouting } from "../storage/sqlite/conversation-repository.js";
 import { init_agent_session_key, resolveAgentPeerConversationId } from "./agent-session-key.js";
 import { init_session_key, resolveConversationId } from "./session-key.js";
@@ -27,25 +27,23 @@ function applyIdentityLinks(peerId, channel, identityLinks) {
 	return normalizedPeerId;
 }
 /**
-* Default agent id from config (`agents.default`, `list[].default`, or `main`).
+* Default Agent id from the catalog.
 */
-function getDefaultAgentId(config) {
-	return resolveDefaultAgentId(config);
+function getDefaultAgentId() {
+	return new AgentCatalogRepository().getSettings().defaultAgentId;
 }
-/**
-* Whether `agentId` appears in the enabled agent list (or list is absent).
-*/
-function agentExists(agentId, config) {
-	if (!config.agents?.list) return true;
-	return config.agents.list.some((agent) => agent.enabled !== false && agent.id.toLowerCase() === agentId.toLowerCase());
+/** Whether `agentId` is enabled and fully provisioned. */
+function agentExists(agentId) {
+	const agent = new AgentCatalogRepository().get(agentId);
+	return agent?.enabled !== false && agent?.provisioningState === "ready";
 }
 /**
 * Return `agentId` if listed, otherwise the default agent id.
 */
-function pickFirstExistingAgentId(agentId, config) {
-	if (!agentId) return getDefaultAgentId(config);
-	if (agentExists(agentId, config)) return agentId.toLowerCase();
-	return getDefaultAgentId(config);
+function pickFirstExistingAgentId(agentId) {
+	if (!agentId) return getDefaultAgentId();
+	if (agentExists(agentId)) return agentId.toLowerCase();
+	return getDefaultAgentId();
 }
 /**
 * Thin wrapper around `resolveConversationId` for route inputs.
@@ -67,12 +65,13 @@ function buildRouteConversationId(agentId, channel, accountId, peerKind, peerId,
 */
 function resolveRoute(input) {
 	const { config, threadId } = input;
+	const catalog = new AgentCatalogRepository().snapshot();
 	const channel = (input.channel ?? "").trim().toLowerCase() || "unknown";
 	const accountId = normalizeAccountId(input.accountId);
 	const peerKind = (input.peerKind ?? "dm").toLowerCase();
 	const rawPeerId = (input.peerId ?? "").trim();
 	const peerId = applyIdentityLinks(rawPeerId, channel, config.session?.identityLinks ?? {});
-	const rules = Array.isArray(config.bindings) ? parseBindingRules({ bindings: config.bindings }) : [];
+	const rules = parseBindingRules({ bindings: catalog.bindings });
 	const bindingResult = resolveRoute$1({
 		channel,
 		accountId,
@@ -81,8 +80,8 @@ function resolveRoute(input) {
 		guildId: input.guildId,
 		teamId: input.teamId,
 		memberRoleIds: input.memberRoleIds
-	}, rules, getDefaultAgentId(config));
-	const agentId = pickFirstExistingAgentId(bindingResult.agentId, config);
+	}, rules, catalog.defaultAgentId);
+	const agentId = catalog.agents.some((agent) => agent.enabled !== false && agent.id === bindingResult.agentId) ? bindingResult.agentId : catalog.defaultAgentId;
 	const dmScope = config.session?.dmScope ?? "main";
 	const conversationId = resolveAgentPeerConversationId({
 		agentId,
@@ -115,7 +114,7 @@ function resolveRouteFromConversationId(conversationId, _config) {
 	};
 }
 var init_resolve_route = __esmMin((() => {
-	init_agent_scope();
+	init_repository();
 	init_bindings();
 	init_session_key();
 	init_agent_session_key();

package/dist/src/routing/resolve-tui-session-key.d.ts

@@ -1,17 +1,14 @@
-import type { Config } from '../config/schema.js';
-export declare function resolveDefaultTuiAgentId(cfg: Config): string;
+export declare function resolveDefaultTuiAgentId(): string;
 export declare function resolveTuiConversationId(params: {
     raw?: string;
 }): string;
 export declare function resolveInitialTuiAgentId(params: {
-    cfg: Config;
     fallbackAgentId: string;
     explicitAgentId?: string;
     cwd?: string;
 }): string;
 /** Resolve TUI startup conversation identity and initial agent from CLI options and config. */
 export declare function resolveTuiStartupConversationId(params: {
-    cfg: Config;
     sessionOption?: string;
     agentOption?: string;
     cwd?: string;

package/dist/src/routing/resolve-tui-session-key.js

@@ -1,27 +1,29 @@
 import { validateConversationId } from "../../packages/gateway-contract/src/conversation-identity.js";
 import { init_src } from "../../packages/gateway-contract/src/index.js";
+import { AgentCatalogRepository, init_repository } from "../agent-catalog/repository.js";
 import { init_agent_scope, listAgentEntries, resolveAgentIdByWorkspacePath, resolveDefaultAgentId } from "../agent/agent-scope.js";
 import { init_agent_session_key, normalizeAgentId } from "./agent-session-key.js";
 import { randomUUID } from "node:crypto";
 //#region src/routing/resolve-tui-session-key.ts
 init_src();
+init_repository();
 init_agent_scope();
 init_agent_session_key();
-function agentExists(cfg, agentId) {
+function agentExists(agentId) {
 	const id = normalizeAgentId(agentId);
-	return listAgentEntries(cfg).some((entry) => entry.enabled !== false && normalizeAgentId(entry.id) === id);
+	return listAgentEntries().some((entry) => entry.enabled !== false && normalizeAgentId(entry.id) === id);
 }
-function resolveDefaultTuiAgentId(cfg) {
-	const configured = cfg.tui?.defaultAgent?.trim();
-	if (configured && agentExists(cfg, configured)) return normalizeAgentId(configured);
-	return resolveDefaultAgentId(cfg);
+function resolveDefaultTuiAgentId() {
+	const configured = new AgentCatalogRepository().snapshot().surfaceDefaults.tui?.trim();
+	if (configured && agentExists(configured)) return normalizeAgentId(configured);
+	return resolveDefaultAgentId();
 }
 function resolveTuiConversationId(params) {
 	return validateConversationId(params.raw?.trim() || randomUUID());
 }
 function resolveInitialTuiAgentId(params) {
 	if (params.explicitAgentId?.trim()) return normalizeAgentId(params.explicitAgentId);
-	const inferredFromWorkspace = resolveAgentIdByWorkspacePath(params.cfg, params.cwd ?? process.cwd());
+	const inferredFromWorkspace = resolveAgentIdByWorkspacePath(params.cwd ?? process.cwd());
 	if (inferredFromWorkspace) return inferredFromWorkspace;
 	return normalizeAgentId(params.fallbackAgentId);
 }
@@ -29,8 +31,7 @@ function resolveInitialTuiAgentId(params) {
 function resolveTuiStartupConversationId(params) {
 	const sessionOption = (params.sessionOption ?? "").trim();
 	const agentId = resolveInitialTuiAgentId({
-		cfg: params.cfg,
-		fallbackAgentId: resolveDefaultTuiAgentId(params.cfg),
+		fallbackAgentId: resolveDefaultTuiAgentId(),
 		explicitAgentId: params.agentOption,
 		cwd: params.cwd ?? process.cwd()
 	});

package/dist/src/scenes/execution.d.ts

@@ -5,8 +5,8 @@ export declare const readOnlyResultSchema: z.ZodObject<{
     kind: z.ZodEnum<{
         artifact: "artifact";
         decision: "decision";
-        no_change: "no_change";
         observation: "observation";
+        no_change: "no_change";
     }>;
     summary: z.ZodString;
     evidenceIds: z.ZodArray<z.ZodString>;

package/dist/src/scenes/model.js

@@ -4,7 +4,7 @@ import { resolveModelSelector } from "../config/agent-model-intents.js";
 init_agent_scope();
 /** Scene reasoning follows the existing agent model policy and falls back to chat. */
 function resolveSceneModelRef(config) {
-	return resolveModelSelector(config, resolveDefaultAgentId(config), "@reasoning");
+	return resolveModelSelector(config, resolveDefaultAgentId(), "@reasoning");
 }
 //#endregion
 export { resolveSceneModelRef };

package/dist/src/scenes/taskFollowUp/contracts.d.ts

@@ -29,7 +29,7 @@ export declare const taskFollowUpTemplate: {
             maxOutputTokens: number;
         };
     };
-    allowedOutcomeKinds: ("artifact" | "receipt" | "decision" | "no_change" | "observation" | "state_change" | "effect_proposal")[];
+    allowedOutcomeKinds: ("artifact" | "receipt" | "decision" | "observation" | "no_change" | "state_change" | "effect_proposal")[];
     allowedEffectHandlers: string[];
 };
 export declare const sourceReferenceSchema: z.ZodObject<{

package/dist/src/scenes/taskFollowUp/service.js

@@ -2,6 +2,7 @@ import { init_transaction, runSqliteWriteTransaction } from "../../storage/sqlit
 import { enqueueTaskAttentionRequiredEvent, init_task_change_events } from "../../tasks/task-change-events.js";
 import { TaskRepository, init_task_repository } from "../../tasks/task-repository.js";
 import { TaskRunRepository, init_task_run_repository } from "../../tasks/task-run-repository.js";
+import { AgentCatalogRepository, init_repository } from "../../agent-catalog/repository.js";
 import { init_agent_scope, resolveDefaultAgentId } from "../../agent/agent-scope.js";
 import { init_providers, isProviderConfiguredSync, resolveModel } from "../../providers/index.js";
 import { ExecutionEnvironmentStore } from "../../execution-environments/store.js";
@@ -24,6 +25,7 @@ import { TaskBranchInventory } from "./branchInventory.js";
 import { randomUUID } from "node:crypto";
 //#region src/scenes/taskFollowUp/service.ts
 init_agent_scope();
+init_repository();
 init_providers();
 init_transaction();
 init_task_repository();
@@ -58,7 +60,7 @@ var TaskFollowUpService = class {
 		this.scenes = new SceneRepository(db);
 		this.branches = new TaskBranchInventory(db);
 		this.scenes.installTemplate(taskFollowUpTemplate);
-		this.executor = deps.executor ?? new FollowUpAgentExecutor(() => resolveModel(resolveModelSelector(deps.config(), resolveDefaultAgentId(deps.config()), "@reasoning")), deps.config);
+		this.executor = deps.executor ?? new FollowUpAgentExecutor(() => resolveModel(resolveModelSelector(deps.config(), resolveDefaultAgentId(), "@reasoning")), deps.config);
 		this.sources = deps.sources;
 		this.resources = new TaskResources({
 			stateDir: deps.stateDir,
@@ -86,7 +88,7 @@ var TaskFollowUpService = class {
 		};
 	}
 	image() {
-		const isolation = this.deps.config().agents.defaults.runtime.commandIsolation;
+		const isolation = new AgentCatalogRepository().getSettings().defaults.runtime.commandIsolation;
 		return isolation?.mode === "docker" ? isolation.image : void 0;
 	}
 	parse(value) {
@@ -139,7 +141,7 @@ var TaskFollowUpService = class {
 			}
 		}
 		if (!this.deps.executor) try {
-			if (!isProviderConfiguredSync(resolveModel(resolveModelSelector(this.deps.config(), resolveDefaultAgentId(this.deps.config()), "@reasoning")).provider)) missing.push("model_credentials");
+			if (!isProviderConfiguredSync(resolveModel(resolveModelSelector(this.deps.config(), resolveDefaultAgentId(), "@reasoning")).provider)) missing.push("model_credentials");
 		} catch {
 			missing.push("model_configuration");
 		}
@@ -383,7 +385,7 @@ var TaskFollowUpService = class {
 				type: "start",
 				executor: {
 					kind: "agent",
-					agentId: resolveDefaultAgentId(this.deps.config())
+					agentId: resolveDefaultAgentId()
 				}
 			},
 			actor: {

package/dist/src/scenes/templates.d.ts

@@ -27,7 +27,7 @@ export declare const mailFollowUpTemplate: {
             maxOutputTokens: number;
         };
     };
-    allowedOutcomeKinds: ("artifact" | "receipt" | "decision" | "no_change" | "observation" | "state_change" | "effect_proposal")[];
+    allowedOutcomeKinds: ("artifact" | "receipt" | "decision" | "observation" | "no_change" | "state_change" | "effect_proposal")[];
     allowedEffectHandlers: string[];
 };
 export declare const familyPlanTemplate: {
@@ -59,6 +59,6 @@ export declare const familyPlanTemplate: {
             maxOutputTokens: number;
         };
     };
-    allowedOutcomeKinds: ("artifact" | "receipt" | "decision" | "no_change" | "observation" | "state_change" | "effect_proposal")[];
+    allowedOutcomeKinds: ("artifact" | "receipt" | "decision" | "observation" | "no_change" | "state_change" | "effect_proposal")[];
     allowedEffectHandlers: string[];
 };

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/config-store.js

@@ -2,8 +2,9 @@ import { createLogger } from "../utils/logger/index.js";
 import { init_logger } from "../utils/logger.js";
 import { requireXopcDatabase } from "../storage/sqlite/connection.js";
 import { deleteSessionConfig, getSessionConfig, hasSessionConfig, setSessionConfig, updateSessionConfig } from "../storage/sqlite/config-repository.js";
-import "../storage/sqlite/index.js";
+import { init_sqlite } from "../storage/sqlite/index.js";
 //#region src/session/config-store.ts
+init_sqlite();
 init_logger();
 const log = createLogger("SessionConfigStore");
 var SessionConfigStore = class {

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/init-session-turn.js

@@ -1,7 +1,7 @@
 import { createLogger } from "../utils/logger/index.js";
 import { init_logger } from "../utils/logger.js";
 import { requireXopcDatabase } from "../storage/sqlite/connection.js";
-import "../storage/sqlite/index.js";
+import { init_sqlite } from "../storage/sqlite/index.js";
 import { SessionConfigSchema, init_schema } from "../config/schema.js";
 import { evaluateSessionFreshness, resolveSessionResetPolicy } from "./reset-policy.js";
 import { resolveChannelResetConfig, resolveSessionResetType } from "./reset-type.js";
@@ -12,6 +12,7 @@ import { randomUUID } from "node:crypto";
 //#region src/session/init-session-turn.ts
 init_schema();
 init_logger();
+init_sqlite();
 const log = createLogger("InitSessionTurn");
 async function initSessionTurn(opts) {
 	requireXopcDatabase();

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/resolve-session.js

@@ -3,7 +3,7 @@ import { init_logger } from "../utils/logger.js";
 import { requireXopcDatabase } from "../storage/sqlite/connection.js";
 import { getSessionMetadata } from "../storage/sqlite/session-read-repository.js";
 import { findConversationIdByTranscriptId, getSessionPersistedLevels } from "../storage/sqlite/session-repository.js";
-import "../storage/sqlite/index.js";
+import { init_sqlite } from "../storage/sqlite/index.js";
 import { SessionConfigSchema, init_schema } from "../config/schema.js";
 import { normalizeThinkLevel, normalizeVerboseLevel } from "../agent/transcript/thinking-types.js";
 import { evaluateSessionFreshness, resolveSessionResetPolicy } from "./reset-policy.js";
@@ -13,6 +13,7 @@ import { randomUUID } from "node:crypto";
 //#region src/session/resolve-session.ts
 init_schema();
 init_logger();
+init_sqlite();
 const log = createLogger("ResolveSession");
 async function resolveConversationIdForRequest(opts) {
 	requireXopcDatabase();

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/session-workspace.js

@@ -34,7 +34,7 @@ function projectWorkspacePath(project) {
 * session override, or merged agent profile default.
 */
 function effectiveWorkspacePathForSession(cfg, conversationId, sessionAgentConfig, project) {
-	const base = resolveEffectiveAgentProfileForSession(cfg, conversationId).resolvedWorkspacePath;
+	const base = resolveEffectiveAgentProfileForSession(conversationId).resolvedWorkspacePath;
 	const environment = getExecutionEnvironmentForSession(conversationId);
 	if (environment) return environment.rootPath;
 	const projectWorkspace = projectWorkspacePath(project);

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

@@ -10,7 +10,7 @@ import { getSessionMetadata } from "../storage/sqlite/session-read-repository.js
 import { deleteSessionRecord, ensureSessionRecord, findConversationIdByTranscriptId, getGlobalSessionStats, listSessionMetadata, listSessionsByAgent, patchSessionMetadata, resetSessionRecord } from "../storage/sqlite/session-repository.js";
 import { appendCompactionBoundaryIfUnchanged, appendTranscriptEntry, listCompactionBoundaries, loadCompactionSourceSnapshot, loadLlmMessagesForSession, loadTranscriptHistoryRowsForSession, loadTranscriptRowsForSession, paginateTranscriptMessages, replaceTranscriptRows, restoreBeforeCompactionBoundary, searchSessionTranscript } from "../storage/sqlite/transcript-repository.js";
 import { getSessionConfig, setSessionConfig } from "../storage/sqlite/config-repository.js";
-import "../storage/sqlite/index.js";
+import { init_sqlite } from "../storage/sqlite/index.js";
 import { init_agent_session_key, resolveAgentIdFromConversationId } from "../routing/agent-session-key.js";
 import { resolveEffectiveAgentProfile } from "../config/agent-profile.js";
 import { DurableState } from "../storage/sqlite/durable-state.js";
@@ -29,6 +29,7 @@ import { findSessionMessages } from "./session-find.js";
 init_paths_state();
 init_agent_session_key();
 init_logger();
+init_sqlite();
 init_session_context_for_llm();
 const log = createLogger("SessionStore");
 const INDEX_VERSION = "1.0";
@@ -105,7 +106,7 @@ var SessionStore = class {
 	resolveWorkspaceCwd(conversationId, seed) {
 		const agentId = getSessionMetadata(conversationId)?.agentId ?? seed?.agentId ?? seed?.routing?.agentId;
 		if (!agentId) throw new Error(`Conversation not found: ${conversationId}`);
-		return resolveEffectiveAgentProfile(this.options.config, agentId).resolvedWorkspacePath;
+		return resolveEffectiveAgentProfile(agentId).resolvedWorkspacePath;
 	}
 	async runStoreMutation(fn) {
 		return fn();
@@ -701,6 +702,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();