@xopcai/xopc 0.0.308 → 0.0.309

package/dist/src/gateway/hono/routes/sessions.js

@@ -2,7 +2,9 @@ import { deleteBrowserTabBinding } from "../../../storage/sqlite/browser-tab-bin
 import { conversationIdSchema } from "../../../../packages/gateway-contract/src/conversation-identity.js";
 import { SessionDiscoveryQuerySchema } from "../../../../packages/gateway-contract/src/session-identity.js";
 import { init_src } from "../../../../packages/gateway-contract/src/index.js";
+import "../../../session/types.js";
 import { deleteSessionRecord, init_session_repository } from "../../../storage/sqlite/session-repository.js";
+import { SidebarLayoutConflictError, getSidebarLayout, replaceSidebarLayout, sortBySidebarLayout } from "../../../storage/sqlite/sidebar-layout-repository.js";
 import { ConversationAlreadyExistsError, createConversation, init_conversation_repository } from "../../../storage/sqlite/conversation-repository.js";
 import { resolveProjectAgentId } from "../../../projects/project-agent.js";
 import "../../../projects/index.js";
@@ -48,6 +50,21 @@ function parseOffset(value) {
 	const parsed = value ? Number.parseInt(value, 10) : 0;
 	return Number.isFinite(parsed) ? Math.max(0, parsed) : 0;
 }
+function listAllSidebarProjects(service, options = {}) {
+	const items = [];
+	let offset = 0;
+	while (true) {
+		const page = service.projects.listWithSidebarSessions({
+			status: "active",
+			limit: 50,
+			offset,
+			...options
+		});
+		items.push(...page.items);
+		if (!page.hasMore || page.items.length === 0) return items;
+		offset += page.items.length;
+	}
+}
 function isHistoryCursor(value) {
 	if (!/^(0|[1-9]\d*)$/.test(value)) return false;
 	return Number.isSafeInteger(Number(value));
@@ -101,18 +118,25 @@ function registerSessionsRoutes(authenticated, deps) {
 		const staleDays = parsePositiveInt(c.req.query("staleDays"), DEFAULT_SIDEBAR_STALE_DAYS, 3650);
 		const updatedAfter = Date.now() - staleDays * 24 * 60 * 60 * 1e3;
 		const includeConversationId = c.req.query("includeConversationId")?.trim() || void 0;
-		const projects = service.projects.listWithSidebarSessions({
-			status: "active",
-			limit: projectLimit,
-			offset: projectOffset,
+		const allProjectItems = listAllSidebarProjects(service, {
 			updatedAfter,
 			includePinned: true,
 			includeConversationId
 		});
+		const projectLayout = getSidebarLayout("projects");
+		const orderedProjects = sortBySidebarLayout(allProjectItems, projectLayout, (project) => project.id);
+		const projects = {
+			items: orderedProjects.slice(projectOffset, projectOffset + projectLimit),
+			total: orderedProjects.length,
+			limit: projectLimit,
+			offset: projectOffset,
+			hasMore: projectOffset + projectLimit < orderedProjects.length
+		};
 		const projectItems = await Promise.all(projects.items.map(async (project) => {
-			const sessions = await service.sessions.listSessions({
+			const sessionLayout = getSidebarLayout(`project:${project.id}`);
+			const allSessions = await service.sessions.listSessions({
 				projectId: project.id,
-				limit: sessionPreviewLimit,
+				limit: 5e3,
 				offset: 0,
 				updatedAfter,
 				includePinned: true,
@@ -122,21 +146,47 @@ function registerSessionsRoutes(authenticated, deps) {
 			});
 			return {
 				project,
-				sessions: sessions.items,
-				sessionTotal: sessions.total,
-				sessionHasMore: sessions.hasMore
+				sessions: sortBySidebarLayout(allSessions.items, sessionLayout, (session) => session.key).slice(0, sessionPreviewLimit),
+				sessionTotal: allSessions.total,
+				sessionHasMore: sessionPreviewLimit < allSessions.total
 			};
 		}));
-		const inbox = await service.sessions.listSessions({
+		const inboxLayout = getSidebarLayout("inbox");
+		const allInbox = await service.sessions.listSessions({
 			unassigned: true,
-			limit: inboxLimit,
-			offset: inboxOffset,
+			limit: 5e3,
+			offset: 0,
 			updatedAfter,
 			includePinned: true,
 			includeConversationId,
 			sortBy: "updatedAt",
 			sortOrder: "desc"
 		});
+		const orderedInbox = sortBySidebarLayout(allInbox.items, inboxLayout, (session) => session.key);
+		const inbox = {
+			...allInbox,
+			items: orderedInbox.slice(inboxOffset, inboxOffset + inboxLimit),
+			limit: inboxLimit,
+			offset: inboxOffset,
+			hasMore: inboxOffset + inboxLimit < allInbox.total
+		};
+		const pinnedLayout = getSidebarLayout("pinned");
+		const pinned = sortBySidebarLayout((await service.sessions.listSessions({
+			status: "pinned",
+			limit: 5e3,
+			offset: 0,
+			sortBy: "updatedAt",
+			sortOrder: "desc"
+		})).items, pinnedLayout, (session) => session.key);
+		const layouts = Object.fromEntries([
+			projectLayout,
+			inboxLayout,
+			pinnedLayout,
+			...projects.items.map((project) => getSidebarLayout(`project:${project.id}`))
+		].map((layout) => [layout.containerId, {
+			itemIds: layout.itemIds,
+			revision: layout.revision
+		}]));
 		return c.json({
 			ok: true,
 			projects: {
@@ -146,9 +196,87 @@ function registerSessionsRoutes(authenticated, deps) {
 				offset: projects.offset,
 				hasMore: projects.hasMore
 			},
-			inbox
+			inbox,
+			pinned,
+			layouts
 		});
 	});
+	authenticated.put("/api/sidebar/layouts/:containerId", async (c) => {
+		const blocked = ensureGatewayReadyForSessions(c, service, "sessions.list");
+		if (blocked) return blocked;
+		const containerId = decodeURIComponent(c.req.param("containerId"));
+		if (containerId !== "projects" && containerId !== "pinned" && containerId !== "inbox" && !containerId.startsWith("project:")) return c.json({
+			ok: false,
+			error: "Invalid sidebar container"
+		}, 400);
+		const body = await c.req.json().catch(() => ({}));
+		if (!Array.isArray(body.itemIds) || body.itemIds.length > 5e3 || body.itemIds.some((id) => typeof id !== "string" || !id.trim())) return c.json({
+			ok: false,
+			error: "itemIds must be an array of non-empty strings"
+		}, 400);
+		if (!Number.isInteger(body.expectedRevision) || body.expectedRevision < 0) return c.json({
+			ok: false,
+			error: "expectedRevision must be a non-negative integer"
+		}, 400);
+		const itemIds = [...new Set(body.itemIds)];
+		if (itemIds.length !== body.itemIds.length) return c.json({
+			ok: false,
+			error: "itemIds must be unique"
+		}, 400);
+		let completeItemIds = itemIds;
+		if (containerId === "projects") {
+			if (itemIds.some((id) => !service.projects.get(id))) return c.json({
+				ok: false,
+				error: "Project not found"
+			}, 404);
+			const allIds = listAllSidebarProjects(service).map((project) => project.id);
+			completeItemIds = [...itemIds, ...allIds.filter((id) => !itemIds.includes(id))];
+		} else {
+			const projectId = containerId.startsWith("project:") ? containerId.slice(8) : void 0;
+			if (projectId && !service.projects.get(projectId)) return c.json({
+				ok: false,
+				error: "Project not found"
+			}, 404);
+			if ((await Promise.all(itemIds.map((id) => service.sessions.getSession(id)))).some((session) => {
+				if (!session || session.status === "archived") return true;
+				if (containerId === "pinned") return session.status !== "pinned";
+				if (session.status === "pinned") return true;
+				if (containerId === "inbox") return Boolean(session.projectId);
+				return session.projectId !== projectId;
+			})) return c.json({
+				ok: false,
+				error: "Sidebar item does not belong to the container"
+			}, 409);
+			const eligibleIds = (await service.sessions.listSessions({
+				...containerId === "pinned" ? { status: "pinned" } : containerId === "inbox" ? {
+					unassigned: true,
+					excludeArchived: true
+				} : {
+					projectId,
+					excludeArchived: true
+				},
+				limit: 5e3,
+				offset: 0,
+				sortBy: "updatedAt",
+				sortOrder: "desc"
+			})).items.filter((session) => containerId === "pinned" || session.status !== "pinned").map((session) => session.key);
+			completeItemIds = [...itemIds, ...eligibleIds.filter((id) => !itemIds.includes(id))];
+		}
+		try {
+			const layout = replaceSidebarLayout(containerId, completeItemIds, body.expectedRevision);
+			return c.json({
+				ok: true,
+				layout
+			});
+		} catch (error) {
+			if (error instanceof SidebarLayoutConflictError) return c.json({
+				ok: false,
+				error: error.message,
+				layout: error.current
+			}, 409);
+			throw error;
+		}
+	});
 	authenticated.post("/api/sessions", async (c) => {
 		const body = await c.req.json().catch(() => ({}));
 		if (body.conversationId !== void 0 && !conversationIdSchema.safeParse(body.conversationId).success) return c.json({

package/dist/src/heartbeat/index.js

@@ -1,6 +1,6 @@
 import { DEFAULT_ACK_MAX_CHARS, HEARTBEAT_OK, NO_REPLY, shouldSilence, stripHeartbeatToken } from "./tokens.js";
+import { appendCronEventLines } from "./event-prompt.js";
 import { isWithinActiveHours } from "./active-hours.js";
 import { isHeartbeatContentEmpty } from "./content-check.js";
-import { appendCronEventLines } from "./event-prompt.js";
 import { createHeartbeatWake } from "./wake.js";
 export { DEFAULT_ACK_MAX_CHARS, HEARTBEAT_OK, NO_REPLY, appendCronEventLines, createHeartbeatWake, isHeartbeatContentEmpty, isWithinActiveHours, shouldSilence, stripHeartbeatToken };

package/dist/src/storage/sqlite/index.d.ts

@@ -29,6 +29,7 @@ export { buildRelationshipPrompt, getRelationshipSettings, isProactiveSupportAll
 export { buildDefaultSessionMetadata, type SessionMetadataSeed, } from './session-metadata.js';
 export { buildGlobalSessionStats, classifyStoredRow, estimateTokensFromMessages, extractFtsContent, metadataToSessionInsert, sessionConfigRowToConfig, sessionRowToMetadata, transcriptEntryRowToStoredRow, type SessionConfigRow, type SessionRow, type TranscriptEntryRow, } from './row-mappers.js';
 export { deleteSessionRecord, ensureSessionRecord, getCurrentTranscriptId, getGlobalSessionStats, findConversationIdByTranscriptId, getSessionPersistedLevels, getSessionMetadata, incrementSessionStatsOnAppend, listSessionMetadata, listSessionsByAgent, patchSessionMetadata, resetSessionRecord, resolveSessionAgentId, updateSessionStats, } from './session-repository.js';
+export { getSidebarLayout, replaceSidebarLayout, sortBySidebarLayout, SidebarLayoutConflictError, type SidebarLayout, } from './sidebar-layout-repository.js';
 export { appendCompactionBoundaryIfUnchanged, appendMediaToAssistantTranscriptEntry, appendTranscriptEntry, findLatestAssistantTranscriptEntryId, listCompactionBoundaries, loadLlmMessagesForSession, loadTranscriptHistoryRowsForSession, loadTranscriptRows, loadTranscriptRowsForSession, loadCompactionSourceSnapshot, paginateTranscriptMessages, replaceTranscriptRows, restoreBeforeCompactionBoundary, searchSessionTranscript, type CompactionSourceSnapshot, type SessionTranscriptRecallMatch, type TranscriptSourceEntry, } from './transcript-repository.js';
 export { deleteNoteRecord, getNoteRecord, listNoteRecords, upsertNoteRecord, } from './notes-repository.js';
 export { deleteNoteAgentContextRecord, getNoteAgentContextRecord, upsertNoteAgentContextRecord, type NoteAgentContextRecord, } from './note-agent-context-repository.js';

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

@@ -33,6 +33,7 @@ import { appendConnectorExecutionAudit, claimConnectorWebhookDelivery, completeC
 import { deleteSessionRecord, ensureSessionRecord, findConversationIdByTranscriptId, getCurrentTranscriptId, getGlobalSessionStats, getSessionMetadata, getSessionPersistedLevels, incrementSessionStatsOnAppend, init_session_repository, listSessionMetadata, listSessionsByAgent, patchSessionMetadata, resetSessionRecord, resolveSessionAgentId, updateSessionStats } from "./session-repository.js";
 import { getSessionTaskPlan, setSessionTaskPlan } from "./session-task-plan-repository.js";
 import { buildRelationshipPrompt, getRelationshipSettings, isProactiveSupportAllowed, updateRelationshipSettings } from "./relationship-settings-repository.js";
+import { SidebarLayoutConflictError, getSidebarLayout, replaceSidebarLayout, sortBySidebarLayout } from "./sidebar-layout-repository.js";
 import { appendCompactionBoundaryIfUnchanged, appendMediaToAssistantTranscriptEntry, appendTranscriptEntry, findLatestAssistantTranscriptEntryId, listCompactionBoundaries, loadCompactionSourceSnapshot, loadLlmMessagesForSession, loadTranscriptHistoryRowsForSession, loadTranscriptRows, loadTranscriptRowsForSession, paginateTranscriptMessages, replaceTranscriptRows, restoreBeforeCompactionBoundary, searchSessionTranscript } from "./transcript-repository.js";
 import { deleteNoteRecord, getNoteRecord, listNoteRecords, upsertNoteRecord } from "./notes-repository.js";
 import { deleteNoteAgentContextRecord, getNoteAgentContextRecord, upsertNoteAgentContextRecord } from "./note-agent-context-repository.js";
@@ -56,4 +57,4 @@ init_session_repository();
 init_connector_repository();
 init_connector_account_repository();
 //#endregion
-export { COMPOSER_INPUT_HISTORY_LIMIT, DatabaseSchemaMigrationGapError, DatabaseSchemaTooNewError, DatabaseSchemaTooOldError, SCHEMA_META_SCHEMA_VERSION_KEY, XOPC_DB_BASELINE_SCHEMA_VERSION, XOPC_DB_FILENAME, XOPC_DB_SCHEMA_VERSION, acknowledgeHomeAttention, appendCompactionBoundaryIfUnchanged, appendComposerInputHistory, appendConnectorExecutionAudit, appendMediaToAssistantTranscriptEntry, appendTranscriptEntry, applyPendingMigrations, authenticateDeviceAccessToken, bindEndpointPrincipal, buildDefaultSessionMetadata, buildGlobalSessionStats, buildRefreshProofMessage, buildRelationshipPrompt, cancelQueuedSessionInput, claimConnectorWebhookDelivery, claimContextExtractionRun, claimKnowledgeSourceItems, claimNextConnectorLearningJob, claimNextSessionInput, classifyStoredRow, clearComposerInputHistory, clearGatewayIdentityForTest, closeTemporalAssertions, closeXopcDatabase, completeConnectorWebhookDelivery, completeKnowledgeSourceItemSynthesis, consumeClarificationApproval, consumeClarificationResume, consumeConnectorApproval, countKnowledgeSourceItems, createClarificationWait, createCollaborationRule, createConnectorApproval, createContextEvidence, createDevice, createDevicePairingSetup, createEndpointPrincipal, createObjectLinkRecord, createTemporalAssertion, decideConnectorApproval, deleteBrowserTabBinding, deleteBrowserTabBindingsByEndpoint, deleteBrowserTabBindingsByPrincipal, deleteConnectorConnection, deleteConnectorInstallation, deleteEndpointSessionBinding, deleteEndpointSessionBindingsByPrincipal, deleteKnowledgeSourceItems, deleteNoteAgentContextRecord, deleteNoteRecord, deleteObjectLinkRecord, deleteSessionConfig, deleteSessionRecord, discoverSqlMigrations, enqueueConnectorLearningJob, ensureSessionRecord, ensureXopcDatabaseSchema, estimateTokensFromMessages, extractFtsContent, findConversationIdByTranscriptId, findLatestAssistantTranscriptEntryId, findSessionInput, finishContextExtractionRun, finishEndpointToolInvocationAudit, finishKnowledgeSyncRun, finishSessionInputRun, getActiveClarification, getActivityEventRecord, getBrowserTabBinding, getBrowserTabBindingById, getCachedConnectorCatalogEntry, getClarification, getClarificationResumeInput, getClarificationSnapshot, getCollaborationRule, getConnectorAccount, getConnectorApproval, getConnectorConnection, getConnectorInstallation, getConnectorSyncPolicy, getConnectorSyncPolicyForConnection, getContextExtractionRun, getCurrentTranscriptId, getDevice, getEndpointPrincipal, getEndpointSessionBinding, getGlobalSessionStats, getInteractionState, getKnowledgeConsumerWatermark, getKnowledgeSourceCursor, getKnowledgeSourceItem, getNoteAgentContextRecord, getNoteRecord, getOrCreateGatewayIdentity, getRelationshipSettings, getSessionConfig, getSessionInputById, getSessionInputState, getSessionMetadata, getSessionPersistedLevels, getSessionTaskPlan, getSqliteDatabase, getUserPeopleIndexState, getUserPerson, getUserTrustPolicy, getXopcDatabase, hasIndependentExtractionOutput, hasSessionConfig, incrementSessionStatsOnAppend, insertSessionInput, inspectSchemaMigrationStatus, isClarificationSuspended, isDevicePairingSetupActive, isHomeAttentionAcknowledged, isProactiveSupportAllowed, isXopcDatabaseOpen, issueDeviceTokenPair, linkContextObjects, listActiveSessionInputRuns, listActivityRecords, listCachedConnectorCatalogEntries, listCollaborationRules, listCompactionBoundaries, listComposerInputHistory, listConnectorAccounts, listConnectorActionMetadata, listConnectorApprovals, listConnectorConnections, listConnectorExecutionAudit, listConnectorInstallations, listConnectorLearningJobs, listConnectorSyncPolicies, listContextExtractionOutputs, listContextExtractionRuns, listContextObjectRelations, listDevices, listEndpointPrincipals, listEndpointToolInvocationAudits, listKnowledgeSourceChanges, listKnowledgeSourceItems, listKnowledgeSyncRuns, listNoteRecords, listObjectActivityRecords, listObjectLinkRecords, listProjectActivityRecords, listRegisteredMigrationTargets, listSessionMetadata, listSessionsByAgent, listTemporalAssertions, listUserPeople, loadCompactionSourceSnapshot, loadLlmMessagesForSession, loadTranscriptHistoryRowsForSession, loadTranscriptRows, loadTranscriptRowsForSession, mergeUserPeople, metadataToSessionInsert, mutateQueuedSessionInput, openXopcDatabase, paginateTranscriptMessages, patchSessionMetadata, pruneBoundedKnowledgeSourceItems, readSchemaVersion, readSchemaVersionForTest, reconcileConnectorAccount, recordActivityEvent, recoverSessionInputState, recoverStaleConnectorLearningJobs, refreshConnectorAccountCurrent, releaseConnectorWebhookDelivery, replaceConnectorCatalogEntries, replaceLatestSessionTurnAndQueueInput, replaceTranscriptRows, replaceUserPeopleIndex, requireXopcDatabase, resetSessionRecord, resetXopcDatabaseSingletonForTest, resolveClarification, resolveMigrationsDir, resolveSessionAgentId, resolveXopcDatabasePath, restoreBeforeCompactionBoundary, revokeDevice, revokeEndpointPrincipal, rotateDeviceRefreshToken, runSqliteWriteTransaction, searchSessionTranscript, sessionConfigRowToConfig, sessionRowToMetadata, setBrowserTabBinding, setCollaborationRuleStatus, setConnectorLearningPaused, setEndpointSessionBinding, setInteractionState, setKnowledgeConsumerWatermark, setKnowledgeSourceCursor, setKnowledgeSourceItemSynthesisStatus, setSessionConfig, setSessionInputStatus, setSessionTaskPlan, setUserTrustPolicy, signGatewayPayload, startEndpointToolInvocationAudit, startKnowledgeSyncRun, summarizeUserPeople, supersedeActiveClarification, touchEndpointPrincipal, transcriptEntryRowToStoredRow, updateConnectorLearningJob, updateInteractionStateFromMessage, updateRelationshipSettings, updateSessionConfig, updateSessionStats, updateUserPerson, upsertConnectorActionMetadata, upsertConnectorCatalogEntry, upsertConnectorConnection, upsertConnectorInstallation, upsertConnectorSyncPolicy, upsertKnowledgeSourceItems, upsertNoteAgentContextRecord, upsertNoteRecord, validateLatestSessionTurnTarget };
+export { COMPOSER_INPUT_HISTORY_LIMIT, DatabaseSchemaMigrationGapError, DatabaseSchemaTooNewError, DatabaseSchemaTooOldError, SCHEMA_META_SCHEMA_VERSION_KEY, SidebarLayoutConflictError, XOPC_DB_BASELINE_SCHEMA_VERSION, XOPC_DB_FILENAME, XOPC_DB_SCHEMA_VERSION, acknowledgeHomeAttention, appendCompactionBoundaryIfUnchanged, appendComposerInputHistory, appendConnectorExecutionAudit, appendMediaToAssistantTranscriptEntry, appendTranscriptEntry, applyPendingMigrations, authenticateDeviceAccessToken, bindEndpointPrincipal, buildDefaultSessionMetadata, buildGlobalSessionStats, buildRefreshProofMessage, buildRelationshipPrompt, cancelQueuedSessionInput, claimConnectorWebhookDelivery, claimContextExtractionRun, claimKnowledgeSourceItems, claimNextConnectorLearningJob, claimNextSessionInput, classifyStoredRow, clearComposerInputHistory, clearGatewayIdentityForTest, closeTemporalAssertions, closeXopcDatabase, completeConnectorWebhookDelivery, completeKnowledgeSourceItemSynthesis, consumeClarificationApproval, consumeClarificationResume, consumeConnectorApproval, countKnowledgeSourceItems, createClarificationWait, createCollaborationRule, createConnectorApproval, createContextEvidence, createDevice, createDevicePairingSetup, createEndpointPrincipal, createObjectLinkRecord, createTemporalAssertion, decideConnectorApproval, deleteBrowserTabBinding, deleteBrowserTabBindingsByEndpoint, deleteBrowserTabBindingsByPrincipal, deleteConnectorConnection, deleteConnectorInstallation, deleteEndpointSessionBinding, deleteEndpointSessionBindingsByPrincipal, deleteKnowledgeSourceItems, deleteNoteAgentContextRecord, deleteNoteRecord, deleteObjectLinkRecord, deleteSessionConfig, deleteSessionRecord, discoverSqlMigrations, enqueueConnectorLearningJob, ensureSessionRecord, ensureXopcDatabaseSchema, estimateTokensFromMessages, extractFtsContent, findConversationIdByTranscriptId, findLatestAssistantTranscriptEntryId, findSessionInput, finishContextExtractionRun, finishEndpointToolInvocationAudit, finishKnowledgeSyncRun, finishSessionInputRun, getActiveClarification, getActivityEventRecord, getBrowserTabBinding, getBrowserTabBindingById, getCachedConnectorCatalogEntry, getClarification, getClarificationResumeInput, getClarificationSnapshot, getCollaborationRule, getConnectorAccount, getConnectorApproval, getConnectorConnection, getConnectorInstallation, getConnectorSyncPolicy, getConnectorSyncPolicyForConnection, getContextExtractionRun, getCurrentTranscriptId, getDevice, getEndpointPrincipal, getEndpointSessionBinding, getGlobalSessionStats, getInteractionState, getKnowledgeConsumerWatermark, getKnowledgeSourceCursor, getKnowledgeSourceItem, getNoteAgentContextRecord, getNoteRecord, getOrCreateGatewayIdentity, getRelationshipSettings, getSessionConfig, getSessionInputById, getSessionInputState, getSessionMetadata, getSessionPersistedLevels, getSessionTaskPlan, getSidebarLayout, getSqliteDatabase, getUserPeopleIndexState, getUserPerson, getUserTrustPolicy, getXopcDatabase, hasIndependentExtractionOutput, hasSessionConfig, incrementSessionStatsOnAppend, insertSessionInput, inspectSchemaMigrationStatus, isClarificationSuspended, isDevicePairingSetupActive, isHomeAttentionAcknowledged, isProactiveSupportAllowed, isXopcDatabaseOpen, issueDeviceTokenPair, linkContextObjects, listActiveSessionInputRuns, listActivityRecords, listCachedConnectorCatalogEntries, listCollaborationRules, listCompactionBoundaries, listComposerInputHistory, listConnectorAccounts, listConnectorActionMetadata, listConnectorApprovals, listConnectorConnections, listConnectorExecutionAudit, listConnectorInstallations, listConnectorLearningJobs, listConnectorSyncPolicies, listContextExtractionOutputs, listContextExtractionRuns, listContextObjectRelations, listDevices, listEndpointPrincipals, listEndpointToolInvocationAudits, listKnowledgeSourceChanges, listKnowledgeSourceItems, listKnowledgeSyncRuns, listNoteRecords, listObjectActivityRecords, listObjectLinkRecords, listProjectActivityRecords, listRegisteredMigrationTargets, listSessionMetadata, listSessionsByAgent, listTemporalAssertions, listUserPeople, loadCompactionSourceSnapshot, loadLlmMessagesForSession, loadTranscriptHistoryRowsForSession, loadTranscriptRows, loadTranscriptRowsForSession, mergeUserPeople, metadataToSessionInsert, mutateQueuedSessionInput, openXopcDatabase, paginateTranscriptMessages, patchSessionMetadata, pruneBoundedKnowledgeSourceItems, readSchemaVersion, readSchemaVersionForTest, reconcileConnectorAccount, recordActivityEvent, recoverSessionInputState, recoverStaleConnectorLearningJobs, refreshConnectorAccountCurrent, releaseConnectorWebhookDelivery, replaceConnectorCatalogEntries, replaceLatestSessionTurnAndQueueInput, replaceSidebarLayout, replaceTranscriptRows, replaceUserPeopleIndex, requireXopcDatabase, resetSessionRecord, resetXopcDatabaseSingletonForTest, resolveClarification, resolveMigrationsDir, resolveSessionAgentId, resolveXopcDatabasePath, restoreBeforeCompactionBoundary, revokeDevice, revokeEndpointPrincipal, rotateDeviceRefreshToken, runSqliteWriteTransaction, searchSessionTranscript, sessionConfigRowToConfig, sessionRowToMetadata, setBrowserTabBinding, setCollaborationRuleStatus, setConnectorLearningPaused, setEndpointSessionBinding, setInteractionState, setKnowledgeConsumerWatermark, setKnowledgeSourceCursor, setKnowledgeSourceItemSynthesisStatus, setSessionConfig, setSessionInputStatus, setSessionTaskPlan, setUserTrustPolicy, signGatewayPayload, sortBySidebarLayout, startEndpointToolInvocationAudit, startKnowledgeSyncRun, summarizeUserPeople, supersedeActiveClarification, touchEndpointPrincipal, transcriptEntryRowToStoredRow, updateConnectorLearningJob, updateInteractionStateFromMessage, updateRelationshipSettings, updateSessionConfig, updateSessionStats, updateUserPerson, upsertConnectorActionMetadata, upsertConnectorCatalogEntry, upsertConnectorConnection, upsertConnectorInstallation, upsertConnectorSyncPolicy, upsertKnowledgeSourceItems, upsertNoteAgentContextRecord, upsertNoteRecord, validateLatestSessionTurnTarget };

package/dist/src/storage/sqlite/migrations/186_sidebar_layout.sql

@@ -0,0 +1,16 @@
+CREATE TABLE sidebar_layouts (
+  container_id TEXT PRIMARY KEY,
+  revision INTEGER NOT NULL DEFAULT 0,
+  updated_at INTEGER NOT NULL
+);
+
+CREATE TABLE sidebar_positions (
+  container_id TEXT NOT NULL REFERENCES sidebar_layouts(container_id) ON DELETE CASCADE,
+  item_id TEXT NOT NULL,
+  position INTEGER NOT NULL,
+  PRIMARY KEY (container_id, item_id),
+  UNIQUE (container_id, position)
+);
+
+CREATE INDEX idx_sidebar_positions_order
+  ON sidebar_positions(container_id, position);

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 = 185;
+export declare const XOPC_DB_SCHEMA_VERSION = 186;
 export declare function resolveMigrationsDir(override?: string): string;
 /**
  * Apply sequential SQL migrations from (currentVersion + 1) through targetVersion.

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

@@ -63,7 +63,7 @@ function applySingleMigration(db, migration) {
 * Each step runs in its own transaction and updates schema_meta on success.
 */
 function applyPendingMigrations(db, options = {}) {
-	const targetVersion = options.targetVersion ?? 185;
+	const targetVersion = options.targetVersion ?? 186;
 	let currentVersion = readSchemaVersion(db);
 	if (currentVersion > targetVersion) throw new DatabaseSchemaTooNewError(currentVersion, targetVersion);
 	if (!options.migrationsDir && currentVersion < 165) throw new DatabaseSchemaTooOldError(currentVersion, 165);
@@ -118,7 +118,7 @@ function applyPendingMigrations(db, options = {}) {
 }
 /** Inspect schema version without mutating the database. */
 function inspectSchemaMigrationStatus(db, options = {}) {
-	const appVersion = options.targetVersion ?? 185;
+	const appVersion = options.targetVersion ?? 186;
 	const dbVersion = readSchemaVersion(db);
 	if (dbVersion > appVersion) return {
 		dbVersion,
@@ -157,7 +157,7 @@ var init_runner = __esmMin((() => {
 	init_errors();
 	log = createLogger("Sqlite:Migrations");
 	XOPC_DB_BASELINE_SCHEMA_VERSION = 165;
-	XOPC_DB_SCHEMA_VERSION = 185;
+	XOPC_DB_SCHEMA_VERSION = 186;
 	MODULE_DIR = dirname(fileURLToPath(import.meta.url));
 }));
 //#endregion

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

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

package/dist/src/storage/sqlite/sidebar-layout-repository.d.ts

@@ -0,0 +1,12 @@
+export type SidebarLayout = {
+    containerId: string;
+    itemIds: string[];
+    revision: number;
+};
+export declare class SidebarLayoutConflictError extends Error {
+    readonly current: SidebarLayout;
+    constructor(current: SidebarLayout);
+}
+export declare function getSidebarLayout(containerId: string): SidebarLayout;
+export declare function replaceSidebarLayout(containerId: string, itemIds: string[], expectedRevision: number): SidebarLayout;
+export declare function sortBySidebarLayout<T>(items: T[], layout: SidebarLayout, idOf: (item: T) => string): T[];

package/dist/src/storage/sqlite/sidebar-layout-repository.js

@@ -0,0 +1,53 @@
+import { getSqliteDatabase, init_transaction, runSqliteWriteTransaction } from "./transaction.js";
+//#region src/storage/sqlite/sidebar-layout-repository.ts
+init_transaction();
+var SidebarLayoutConflictError = class extends Error {
+	constructor(current) {
+		super("Sidebar layout changed in another window");
+		this.current = current;
+		this.name = "SidebarLayoutConflictError";
+	}
+};
+function getSidebarLayout(containerId) {
+	const db = getSqliteDatabase();
+	const row = db.prepare("SELECT revision FROM sidebar_layouts WHERE container_id = ?").get(containerId);
+	return {
+		containerId,
+		itemIds: db.prepare("SELECT item_id FROM sidebar_positions WHERE container_id = ? ORDER BY position ASC").all(containerId).map((position) => position.item_id),
+		revision: row?.revision ?? 0
+	};
+}
+function replaceSidebarLayout(containerId, itemIds, expectedRevision) {
+	return runSqliteWriteTransaction((db) => {
+		const current = getSidebarLayout(containerId);
+		if (current.revision !== expectedRevision) throw new SidebarLayoutConflictError(current);
+		const uniqueItemIds = [...new Set(itemIds)];
+		const nextRevision = current.revision + 1;
+		db.prepare(`INSERT INTO sidebar_layouts (container_id, revision, updated_at) VALUES (?, ?, ?)
+       ON CONFLICT(container_id) DO UPDATE SET revision = excluded.revision, updated_at = excluded.updated_at`).run(containerId, nextRevision, Date.now());
+		db.prepare("DELETE FROM sidebar_positions WHERE container_id = ?").run(containerId);
+		const insert = db.prepare("INSERT INTO sidebar_positions (container_id, item_id, position) VALUES (?, ?, ?)");
+		uniqueItemIds.forEach((itemId, position) => insert.run(containerId, itemId, position));
+		return {
+			containerId,
+			itemIds: uniqueItemIds,
+			revision: nextRevision
+		};
+	});
+}
+function sortBySidebarLayout(items, layout, idOf) {
+	if (layout.itemIds.length === 0) return items;
+	const ranks = new Map(layout.itemIds.map((id, index) => [id, index]));
+	return items.map((item, index) => ({
+		item,
+		index,
+		rank: ranks.get(idOf(item))
+	})).sort((a, b) => {
+		if (a.rank !== void 0 && b.rank !== void 0) return a.rank - b.rank;
+		if (a.rank !== void 0) return 1;
+		if (b.rank !== void 0) return -1;
+		return a.index - b.index;
+	}).map(({ item }) => item);
+}
+//#endregion
+export { SidebarLayoutConflictError, getSidebarLayout, replaceSidebarLayout, sortBySidebarLayout };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xopcai/xopc",
-  "version": "0.0.308",
+  "version": "0.0.309",
   "description": "Local-first personal AI assistant with reviewable user understanding, durable tasks, workflows, automations, and local or cloud models.",
   "type": "module",
   "main": "dist/src/index.js",
@@ -171,8 +171,8 @@
     "@xopcai/endpoint-tools-client": "0.0.0",
     "@xopcai/endpoint-tools-protocol": "0.0.0",
     "@xopcai/gateway-contract": "0.0.0",
-    "@xopcai/realtime-protocol": "0.0.0",
-    "@xopcai/realtime-client": "0.0.0"
+    "@xopcai/realtime-client": "0.0.0",
+    "@xopcai/realtime-protocol": "0.0.0"
   },
   "scripts": {
     "assets:brand": "node scripts/generate-brand-assets.mjs",

package/dist/gateway/static/root/assets/api-DFOlahZv.js

@@ -1 +0,0 @@
-import{a as e,r as t}from"./locale-store-msTfRK8P.js";var n=n=>e(t(n)),r=(n,r,i)=>e(t(n),{method:r,headers:{"content-type":`application/json`},body:JSON.stringify(i)});export{r as n,n as t};

package/dist/gateway/static/root/assets/gateway-realtime-store-BLDgrJ30.js

@@ -1 +0,0 @@
-import{p as e}from"./locale-store-msTfRK8P.js";var t=e(()=>({connectionState:`idle`,error:null}));function n(e){t.setState(e)}export{t as n,n as t};