@xopcai/xopc 0.0.227 → 0.0.228

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 } from './store.js';
+export type { SessionStoreOptions, ForkSessionAtTurnOptions, ForkSessionResult, } 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

@@ -89,6 +89,7 @@ export declare class SessionIndex extends EventEmitter {
         sessionKey: string;
         rowCount: number;
     }>;
+    forkSessionAtTurn(sourceKey: string, options: import('./store.js').ForkSessionAtTurnOptions): Promise<import('./store.js').ForkSessionResult>;
     getStats(): Promise<GlobalSessionStats>;
     archiveOldSessions(olderThanDays: number): Promise<number>;
     onSessionCreated(callback: (metadata: SessionMetadata) => void): void;

package/dist/src/session/manager.js

@@ -171,6 +171,12 @@ var SessionIndex = class extends EventEmitter$1 {
 		if (metadata) this.emit("sessionCreated", metadata);
 		return result;
 	}
+	async forkSessionAtTurn(sourceKey, options) {
+		const result = await this.store.forkSessionAtTurn(sourceKey, options);
+		const metadata = await this.store.getMetadata(result.sessionKey);
+		if (metadata) this.emit("sessionCreated", metadata);
+		return result;
+	}
 	async getStats() {
 		return this.store.getStats();
 	}

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

@@ -27,6 +27,16 @@ export interface SessionCompactionHooks {
     }) => Promise<void> | void;
 }
 export type ModelFallbackPreparation = 'prompt' | 'resume' | 'unsafe';
+export interface ForkSessionAtTurnOptions {
+    targetKey: string;
+    lastTurnId: string;
+    targetMetadata: SessionMetadataSeed;
+}
+export interface ForkSessionResult {
+    sessionKey: string;
+    rowCount: number;
+    lastTurnId?: string;
+}
 export declare class SessionStore {
     private options;
     private window;
@@ -182,6 +192,11 @@ export declare class SessionStore {
         sessionKey: string;
         rowCount: number;
     }>;
+    /**
+     * Atomically copy a completed turn prefix into a new session, including the
+     * source session's per-session agent configuration.
+     */
+    forkSessionAtTurn(sourceKey: string, options: ForkSessionAtTurnOptions): Promise<ForkSessionResult>;
     getStats(): Promise<GlobalSessionStats>;
     archiveOld(olderThanDays: number): Promise<number>;
     estimateTokens(messages: AgentMessage[]): number;

package/dist/src/session/store.js

@@ -2,12 +2,14 @@ import { init_paths_state, resolveStateDir } from "../config/paths-state.js";
 import { createLogger } from "../utils/logger/index.js";
 import { init_logger } from "../utils/logger.js";
 import { requireXopcDatabase } from "../storage/sqlite/connection.js";
+import { runSqliteWriteTransaction } from "../storage/sqlite/transaction.js";
 import { buildSessionContextForLlm, buildSessionDisplayMessages, isRuntimeOnlyTranscriptMessage, isTranscriptCompactionEntry, mergeLlmMessagesPreservingContextRows, transcriptRowsFromJsonArray } from "./session-context-for-llm.js";
 import "./types.js";
 import { init_agent_session_key, resolveAgentIdFromSessionKey } from "../routing/agent-session-key.js";
 import { estimateTokensFromMessages } from "../storage/sqlite/row-mappers.js";
 import { deleteSessionRecord, ensureSessionRecord, findSessionKeyBySessionId, getGlobalSessionStats, getSessionMetadata, listSessionMetadata, listSessionsByAgent, patchSessionMetadata, resetSessionRecord } from "../storage/sqlite/session-repository.js";
 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 { resolveEffectiveAgentProfileForSession } from "../config/agent-profile.js";
 import { readPostCompactionContext } from "../agent/reply/post-compaction-context.js";
@@ -657,6 +659,62 @@ var SessionStore = class {
 			};
 		});
 	}
+	/**
+	* Atomically copy a completed turn prefix into a new session, including the
+	* source session's per-session agent configuration.
+	*/
+	async forkSessionAtTurn(sourceKey, options) {
+		requireXopcDatabase();
+		const targetKey = options.targetKey.trim();
+		const lastTurnId = options.lastTurnId.trim();
+		if (!targetKey) throw new Error("Target session key is required");
+		if (!lastTurnId) throw new Error("lastTurnId is required");
+		return runSqliteWriteTransaction(() => {
+			const sourceMetadata = getSessionMetadata(sourceKey);
+			if (!sourceMetadata) throw new Error(`Session not found: ${sourceKey}`);
+			if (getSessionMetadata(targetKey)) throw new Error(`Target session already exists: ${targetKey}`);
+			const rows = loadTranscriptHistoryRowsForSession(sourceKey);
+			let lastTurnRow = -1;
+			let hasAssistantOutput = false;
+			for (let index = 0; index < rows.length; index += 1) {
+				const row = rows[index];
+				if (row.turnId !== lastTurnId) continue;
+				lastTurnRow = index;
+				if (row.role === "assistant") hasAssistantOutput = true;
+			}
+			if (lastTurnRow < 0 || !hasAssistantOutput) throw new Error(`Completed turn not found: ${lastTurnId}`);
+			const selectedRows = rows.slice(0, lastTurnRow + 1);
+			const sourceLabel = sourceMetadata.name?.trim() || sourceKey;
+			const forkedAt = (/* @__PURE__ */ new Date()).toISOString();
+			const cwd = sourceMetadata.cwd?.trim() || this.resolveWorkspaceCwd(targetKey);
+			ensureSessionRecord(targetKey, cwd, {
+				...options.targetMetadata,
+				name: `Fork of ${sourceLabel}`,
+				tags: [...new Set([...sourceMetadata.tags ?? [], "fork"])],
+				projectId: sourceMetadata.projectId,
+				parentSessionKey: sourceKey,
+				hiddenFromSessionList: false,
+				customData: {
+					...sourceMetadata.customData ?? {},
+					...options.targetMetadata.customData ?? {},
+					genericNewChatShell: false,
+					forkedFromSessionKey: sourceKey,
+					forkedFromSessionId: sourceMetadata.sessionId,
+					forkedFromSessionName: sourceMetadata.name,
+					forkedFromTurnId: lastTurnId,
+					forkedAt
+				}
+			});
+			replaceTranscriptRows(targetKey, selectedRows);
+			const sourceConfig = getSessionConfig(sourceKey);
+			if (sourceConfig) setSessionConfig(targetKey, sourceConfig, cwd);
+			return {
+				sessionKey: targetKey,
+				rowCount: selectedRows.length,
+				lastTurnId
+			};
+		});
+	}
 	async getStats() {
 		requireXopcDatabase();
 		return getGlobalSessionStats();

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

@@ -11,7 +11,7 @@ export { finishContextConsolidationRun, getContextConsolidationRun, listContextC
 export { summarizeUnderstandingFeedback, summarizeUserUnderstandingQuality, type UnderstandingFeedbackSummary, type UserUnderstandingQualityMetrics, } from './user-context-quality-repository.js';
 export { createCollaborationRule, createContextEvidence, createUnderstanding, closeUnderstandingValidity, consumeContextConsent, deleteCollaborationRule, deleteUnderstanding, decideContextConsent, ensureContextConsent, getCollaborationRule, getTurnPersonalization, getUnderstanding, getUserProfile, hasContextConsent, isUnderstandingSuppressed, listCollaborationRules, listUnderstandingEvidence, listUnderstandings, linkUnderstandingEvidence, recordContextFeedback, recordContextRun, rejectUnderstanding, reviseCollaborationRule, reviseUnderstanding, searchActiveUnderstandings, setCollaborationRuleStatus, setUnderstandingStatus, updateUserProfile, type CreateUnderstandingInput, } from './user-context-repository.js';
 export { getUserPerson, getUserPeopleIndexState, listUserPeople, mergeUserPeople, replaceUserPeopleIndex, summarizeUserPeople, updateUserPerson, } from './user-people-repository.js';
-export { cancelQueuedSessionInput, claimNextSessionInput, findSessionInput, finishSessionInputRun, getSessionInputState, getSessionInputById, insertSessionInput, mutateQueuedSessionInput, recoverSessionInputState, setSessionInputStatus, type SessionInput, type SessionInputDelivery, type SessionInputState, type SessionInputStatus, } from './session-input-repository.js';
+export { cancelQueuedSessionInput, claimNextSessionInput, findSessionInput, finishSessionInputRun, getSessionInputState, getSessionInputById, insertSessionInput, listActiveSessionInputRuns, mutateQueuedSessionInput, recoverSessionInputState, setSessionInputStatus, type SessionInput, type SessionInputDelivery, type SessionInputState, type SessionInputStatus, } from './session-input-repository.js';
 export { replaceLatestSessionTurnAndQueueInput, validateLatestSessionTurnTarget, type ReplaceLatestSessionTurnInput, type ReplaceLatestSessionTurnResult, } from './session-turn-replace-repository.js';
 export { acknowledgeHomeAttention, isHomeAttentionAcknowledged, type HomeAttentionSubjectKind, } from './home-attention-repository.js';
 export { claimNextConnectorLearningJob, enqueueConnectorLearningJob, listConnectorLearningJobs, recoverStaleConnectorLearningJobs, setConnectorLearningPaused, updateConnectorLearningJob, type ConnectorLearningJob, type ConnectorLearningMode, type ConnectorLearningPhase, type ConnectorLearningStatus, } from './connector-learning-repository.js';

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

@@ -12,7 +12,7 @@ import { finishContextConsolidationRun, getContextConsolidationRun, listContextC
 import { summarizeUnderstandingFeedback, summarizeUserUnderstandingQuality } from "./user-context-quality-repository.js";
 import { closeUnderstandingValidity, consumeContextConsent, createCollaborationRule, createContextEvidence, createUnderstanding, decideContextConsent, deleteCollaborationRule, deleteUnderstanding, ensureContextConsent, getCollaborationRule, getTurnPersonalization, getUnderstanding, getUserProfile, hasContextConsent, isUnderstandingSuppressed, linkUnderstandingEvidence, listCollaborationRules, listUnderstandingEvidence, listUnderstandings, recordContextFeedback, recordContextRun, rejectUnderstanding, reviseCollaborationRule, reviseUnderstanding, searchActiveUnderstandings, setCollaborationRuleStatus, setUnderstandingStatus, updateUserProfile } from "./user-context-repository.js";
 import { getUserPeopleIndexState, getUserPerson, listUserPeople, mergeUserPeople, replaceUserPeopleIndex, summarizeUserPeople, updateUserPerson } from "./user-people-repository.js";
-import { cancelQueuedSessionInput, claimNextSessionInput, findSessionInput, finishSessionInputRun, getSessionInputById, getSessionInputState, insertSessionInput, mutateQueuedSessionInput, recoverSessionInputState, setSessionInputStatus } from "./session-input-repository.js";
+import { cancelQueuedSessionInput, claimNextSessionInput, findSessionInput, finishSessionInputRun, getSessionInputById, getSessionInputState, insertSessionInput, listActiveSessionInputRuns, mutateQueuedSessionInput, recoverSessionInputState, setSessionInputStatus } from "./session-input-repository.js";
 import { buildDefaultSessionMetadata } from "./session-metadata.js";
 import { buildGlobalSessionStats, classifyStoredRow, estimateTokensFromMessages, extractFtsContent, metadataToSessionInsert, sessionConfigRowToConfig, sessionRowToMetadata, transcriptEntryRowToStoredRow } from "./row-mappers.js";
 import { replaceLatestSessionTurnAndQueueInput, validateLatestSessionTurnTarget } from "./session-turn-replace-repository.js";
@@ -36,4 +36,4 @@ import { appendConnectorExecutionAudit, claimConnectorWebhookDelivery, completeC
 import { getConnectorAccount, listConnectorAccounts, reconcileConnectorAccount, refreshConnectorAccountCurrent } from "./connector-account-repository.js";
 import { getConnectorSyncPolicy, getConnectorSyncPolicyForConnection, listConnectorSyncPolicies, upsertConnectorSyncPolicy } from "./connector-sync-policy-repository.js";
 import { getUserTrustPolicy, setUserTrustPolicy } from "./user-trust-repository.js";
-export { COMPOSER_INPUT_HISTORY_LIMIT, DatabaseSchemaMigrationGapError, DatabaseSchemaTooNewError, SCHEMA_META_SCHEMA_VERSION_KEY, XOPC_DB_BASELINE_SCHEMA_VERSION, XOPC_DB_FILENAME, XOPC_DB_SCHEMA_VERSION, acknowledgeHomeAttention, appendCompactionBoundaryIfUnchanged, appendComposerInputHistory, appendConnectorExecutionAudit, appendMemorySignal, appendMemoryTraceEvent, appendTranscriptEntry, applyPendingMigrations, attachMemoryEvidence, bindEndpointPrincipal, buildDefaultSessionMetadata, buildGlobalSessionStats, buildRelationshipPrompt, cancelQueuedSessionInput, claimConnectorWebhookDelivery, claimContextExtractionRun, claimKnowledgeSourceItems, claimNextConnectorLearningJob, claimNextSessionInput, classifyStoredRow, clearComposerInputHistory, closeTemporalAssertions, closeUnderstandingValidity, closeXopcDatabase, completeConnectorWebhookDelivery, completeKnowledgeSourceItemSynthesis, consumeConnectorApproval, consumeContextConsent, countKnowledgeSourceItems, countMemoryRecordsBySourceInstanceId, createCollaborationRule, createConnectorApproval, createContextEvidence, createEndpointPrincipal, createObjectLinkRecord, createTemporalAssertion, createUnderstanding, decideConnectorApproval, decideContextConsent, deleteCollaborationRule, deleteConnectorConnection, deleteConnectorInstallation, deleteKnowledgeSourceItems, deleteMemoryEvidenceForRecord, deleteMemoryRecord, deleteMemoryRecordsBySourceInstanceId, deleteNoteAgentContextRecord, deleteNoteRecord, deleteObjectLinkRecord, deleteSessionConfig, deleteSessionRecord, deleteUnderstanding, discoverSqlMigrations, enqueueConnectorLearningJob, ensureContextConsent, ensureSessionRecord, ensureXopcDatabaseSchema, estimateTokensFromMessages, extractFtsContent, findSessionInput, findSessionKeyBySessionId, finishContextConsolidationRun, finishContextExtractionRun, finishEndpointToolInvocationAudit, finishKnowledgeSyncRun, finishSessionInputRun, getActivityEventRecord, getCachedConnectorCatalogEntry, getCollaborationRule, getConnectorAccount, getConnectorApproval, getConnectorConnection, getConnectorInstallation, getConnectorSyncPolicy, getConnectorSyncPolicyForConnection, getContextConsolidationRun, getContextExtractionRun, getCurrentSessionId, getEndpointPrincipal, getGlobalSessionStats, getInteractionState, getKnowledgeConsumerWatermark, getKnowledgeSourceCursor, getKnowledgeSourceItem, getMemoryProviderState, getMemoryRecord, getMemoryTurnFeedback, getNoteAgentContextRecord, getNoteRecord, getRelationshipSettings, getSessionConfig, getSessionInputById, getSessionInputState, getSessionMetadata, getSessionPersistedLevels, getSessionTaskPlan, getSqliteDatabase, getTurnPersonalization, getUnderstanding, getUserPeopleIndexState, getUserPerson, getUserProfile, getUserTrustPolicy, getXopcDatabase, hasContextConsent, hasIndependentExtractionOutput, hasSessionConfig, hasUnresolvedMemoryConflict, incrementSessionStatsOnAppend, insertSessionInput, inspectSchemaMigrationStatus, isHomeAttentionAcknowledged, isProactiveSupportAllowed, isUnderstandingSuppressed, isXopcDatabaseOpen, linkContextObjects, linkUnderstandingEvidence, listActivityRecords, listCachedConnectorCatalogEntries, listCollaborationRules, listCompactionBoundaries, listComposerInputHistory, listConnectorAccounts, listConnectorActionMetadata, listConnectorApprovals, listConnectorConnections, listConnectorExecutionAudit, listConnectorInstallations, listConnectorLearningJobs, listConnectorSyncPolicies, listContextConsolidationDecisions, listContextConsolidationRuns, listContextExtractionOutputs, listContextExtractionRuns, listContextObjectRelations, listEndpointPrincipals, listEndpointToolInvocationAudits, listKnowledgeSourceChanges, listKnowledgeSourceItems, listKnowledgeSyncRuns, listMemoryEvidence, listMemoryRecords, listMemorySignals, listMemoryTraceEvents, listNoteRecords, listObjectActivityRecords, listObjectLinkRecords, listProjectActivityRecords, listRegisteredMigrationTargets, listSessionMetadata, listSessionsByAgent, listTemporalAssertions, listUnderstandingEvidence, listUnderstandings, listUserPeople, loadCompactionSourceSnapshot, loadLlmMessagesForSession, loadTranscriptHistoryRowsForSession, loadTranscriptRows, loadTranscriptRowsForSession, markMemoryRecordsConflicted, mergeUserPeople, metadataToSessionInsert, mutateQueuedSessionInput, openXopcDatabase, paginateTranscriptMessages, patchSessionMetadata, pruneBoundedKnowledgeSourceItems, readSchemaVersion, readSchemaVersionForTest, reconcileConnectorAccount, recordActivityEvent, recordContextConsolidationDecision, recordContextFeedback, recordContextRun, recoverSessionInputState, recoverStaleConnectorLearningJobs, refreshConnectorAccountCurrent, rejectUnderstanding, releaseConnectorWebhookDelivery, replaceConnectorCatalogEntries, replaceLatestSessionTurnAndQueueInput, replaceTranscriptRows, replaceUserPeopleIndex, requireXopcDatabase, resetSessionRecord, resetXopcDatabaseSingletonForTest, resolveMigrationsDir, resolveSessionAgentId, resolveXopcDatabasePath, restoreBeforeCompactionBoundary, reviseCollaborationRule, reviseUnderstanding, revokeEndpointPrincipal, runSqliteWriteTransaction, searchActiveUnderstandings, searchMemoryRecords, searchSessionTranscript, sessionConfigRowToConfig, sessionRowToMetadata, setCollaborationRuleStatus, setConnectorLearningPaused, setInteractionState, setKnowledgeConsumerWatermark, setKnowledgeSourceCursor, setKnowledgeSourceItemSynthesisStatus, setMemoryProviderState, setMemoryRecordStatus, setMemoryTurnFeedback, setSessionConfig, setSessionInputStatus, setSessionTaskPlan, setUnderstandingStatus, setUserTrustPolicy, startContextConsolidationRun, startEndpointToolInvocationAudit, startKnowledgeSyncRun, summarizeMemoryRecallFeedback, summarizeUnderstandingFeedback, summarizeUserPeople, summarizeUserUnderstandingQuality, touchEndpointPrincipal, transcriptEntryRowToStoredRow, updateConnectorLearningJob, updateInteractionStateFromMessage, updateRelationshipSettings, updateSessionConfig, updateSessionStats, updateUserPerson, updateUserProfile, upsertConnectorActionMetadata, upsertConnectorCatalogEntry, upsertConnectorConnection, upsertConnectorInstallation, upsertConnectorSyncPolicy, upsertKnowledgeSourceItems, upsertMemoryRecord, upsertNoteAgentContextRecord, upsertNoteRecord, validateLatestSessionTurnTarget };
+export { COMPOSER_INPUT_HISTORY_LIMIT, DatabaseSchemaMigrationGapError, DatabaseSchemaTooNewError, SCHEMA_META_SCHEMA_VERSION_KEY, XOPC_DB_BASELINE_SCHEMA_VERSION, XOPC_DB_FILENAME, XOPC_DB_SCHEMA_VERSION, acknowledgeHomeAttention, appendCompactionBoundaryIfUnchanged, appendComposerInputHistory, appendConnectorExecutionAudit, appendMemorySignal, appendMemoryTraceEvent, appendTranscriptEntry, applyPendingMigrations, attachMemoryEvidence, bindEndpointPrincipal, buildDefaultSessionMetadata, buildGlobalSessionStats, buildRelationshipPrompt, cancelQueuedSessionInput, claimConnectorWebhookDelivery, claimContextExtractionRun, claimKnowledgeSourceItems, claimNextConnectorLearningJob, claimNextSessionInput, classifyStoredRow, clearComposerInputHistory, closeTemporalAssertions, closeUnderstandingValidity, closeXopcDatabase, completeConnectorWebhookDelivery, completeKnowledgeSourceItemSynthesis, consumeConnectorApproval, consumeContextConsent, countKnowledgeSourceItems, countMemoryRecordsBySourceInstanceId, createCollaborationRule, createConnectorApproval, createContextEvidence, createEndpointPrincipal, createObjectLinkRecord, createTemporalAssertion, createUnderstanding, decideConnectorApproval, decideContextConsent, deleteCollaborationRule, deleteConnectorConnection, deleteConnectorInstallation, deleteKnowledgeSourceItems, deleteMemoryEvidenceForRecord, deleteMemoryRecord, deleteMemoryRecordsBySourceInstanceId, deleteNoteAgentContextRecord, deleteNoteRecord, deleteObjectLinkRecord, deleteSessionConfig, deleteSessionRecord, deleteUnderstanding, discoverSqlMigrations, enqueueConnectorLearningJob, ensureContextConsent, ensureSessionRecord, ensureXopcDatabaseSchema, estimateTokensFromMessages, extractFtsContent, findSessionInput, findSessionKeyBySessionId, finishContextConsolidationRun, finishContextExtractionRun, finishEndpointToolInvocationAudit, finishKnowledgeSyncRun, finishSessionInputRun, getActivityEventRecord, getCachedConnectorCatalogEntry, getCollaborationRule, getConnectorAccount, getConnectorApproval, getConnectorConnection, getConnectorInstallation, getConnectorSyncPolicy, getConnectorSyncPolicyForConnection, getContextConsolidationRun, getContextExtractionRun, getCurrentSessionId, getEndpointPrincipal, getGlobalSessionStats, getInteractionState, getKnowledgeConsumerWatermark, getKnowledgeSourceCursor, getKnowledgeSourceItem, getMemoryProviderState, getMemoryRecord, getMemoryTurnFeedback, getNoteAgentContextRecord, getNoteRecord, getRelationshipSettings, getSessionConfig, getSessionInputById, getSessionInputState, getSessionMetadata, getSessionPersistedLevels, getSessionTaskPlan, getSqliteDatabase, getTurnPersonalization, getUnderstanding, getUserPeopleIndexState, getUserPerson, getUserProfile, getUserTrustPolicy, getXopcDatabase, hasContextConsent, hasIndependentExtractionOutput, hasSessionConfig, hasUnresolvedMemoryConflict, incrementSessionStatsOnAppend, insertSessionInput, inspectSchemaMigrationStatus, isHomeAttentionAcknowledged, isProactiveSupportAllowed, isUnderstandingSuppressed, isXopcDatabaseOpen, linkContextObjects, linkUnderstandingEvidence, listActiveSessionInputRuns, listActivityRecords, listCachedConnectorCatalogEntries, listCollaborationRules, listCompactionBoundaries, listComposerInputHistory, listConnectorAccounts, listConnectorActionMetadata, listConnectorApprovals, listConnectorConnections, listConnectorExecutionAudit, listConnectorInstallations, listConnectorLearningJobs, listConnectorSyncPolicies, listContextConsolidationDecisions, listContextConsolidationRuns, listContextExtractionOutputs, listContextExtractionRuns, listContextObjectRelations, listEndpointPrincipals, listEndpointToolInvocationAudits, listKnowledgeSourceChanges, listKnowledgeSourceItems, listKnowledgeSyncRuns, listMemoryEvidence, listMemoryRecords, listMemorySignals, listMemoryTraceEvents, listNoteRecords, listObjectActivityRecords, listObjectLinkRecords, listProjectActivityRecords, listRegisteredMigrationTargets, listSessionMetadata, listSessionsByAgent, listTemporalAssertions, listUnderstandingEvidence, listUnderstandings, listUserPeople, loadCompactionSourceSnapshot, loadLlmMessagesForSession, loadTranscriptHistoryRowsForSession, loadTranscriptRows, loadTranscriptRowsForSession, markMemoryRecordsConflicted, mergeUserPeople, metadataToSessionInsert, mutateQueuedSessionInput, openXopcDatabase, paginateTranscriptMessages, patchSessionMetadata, pruneBoundedKnowledgeSourceItems, readSchemaVersion, readSchemaVersionForTest, reconcileConnectorAccount, recordActivityEvent, recordContextConsolidationDecision, recordContextFeedback, recordContextRun, recoverSessionInputState, recoverStaleConnectorLearningJobs, refreshConnectorAccountCurrent, rejectUnderstanding, releaseConnectorWebhookDelivery, replaceConnectorCatalogEntries, replaceLatestSessionTurnAndQueueInput, replaceTranscriptRows, replaceUserPeopleIndex, requireXopcDatabase, resetSessionRecord, resetXopcDatabaseSingletonForTest, resolveMigrationsDir, resolveSessionAgentId, resolveXopcDatabasePath, restoreBeforeCompactionBoundary, reviseCollaborationRule, reviseUnderstanding, revokeEndpointPrincipal, runSqliteWriteTransaction, searchActiveUnderstandings, searchMemoryRecords, searchSessionTranscript, sessionConfigRowToConfig, sessionRowToMetadata, setCollaborationRuleStatus, setConnectorLearningPaused, setInteractionState, setKnowledgeConsumerWatermark, setKnowledgeSourceCursor, setKnowledgeSourceItemSynthesisStatus, setMemoryProviderState, setMemoryRecordStatus, setMemoryTurnFeedback, setSessionConfig, setSessionInputStatus, setSessionTaskPlan, setUnderstandingStatus, setUserTrustPolicy, startContextConsolidationRun, startEndpointToolInvocationAudit, startKnowledgeSyncRun, summarizeMemoryRecallFeedback, summarizeUnderstandingFeedback, summarizeUserPeople, summarizeUserUnderstandingQuality, touchEndpointPrincipal, transcriptEntryRowToStoredRow, updateConnectorLearningJob, updateInteractionStateFromMessage, updateRelationshipSettings, updateSessionConfig, updateSessionStats, updateUserPerson, updateUserProfile, upsertConnectorActionMetadata, upsertConnectorCatalogEntry, upsertConnectorConnection, upsertConnectorInstallation, upsertConnectorSyncPolicy, upsertKnowledgeSourceItems, upsertMemoryRecord, upsertNoteAgentContextRecord, upsertNoteRecord, validateLatestSessionTurnTarget };

package/dist/src/storage/sqlite/migrations/136_product_notifications.sql

@@ -0,0 +1,79 @@
+CREATE TABLE notification_devices (
+  device_id             TEXT PRIMARY KEY,
+  platform              TEXT NOT NULL CHECK (platform IN ('ios', 'android')),
+  push_token            TEXT NOT NULL,
+  push_provider         TEXT NOT NULL DEFAULT 'expo',
+  enabled               INTEGER NOT NULL DEFAULT 1 CHECK (enabled IN (0, 1)),
+  permissions           TEXT NOT NULL DEFAULT 'unknown' CHECK (permissions IN ('granted', 'denied', 'unknown')),
+  preferences_json      TEXT NOT NULL DEFAULT '{}',
+  locale                TEXT NOT NULL DEFAULT 'en' CHECK (locale IN ('en', 'zh')),
+  app_version           TEXT,
+  lease_expires_at      INTEGER NOT NULL,
+  last_seen_at          INTEGER NOT NULL,
+  created_at            INTEGER NOT NULL,
+  updated_at            INTEGER NOT NULL
+);
+
+INSERT INTO notification_devices (
+  device_id, platform, push_token, push_provider, enabled, permissions,
+  preferences_json, locale, app_version, lease_expires_at,
+  last_seen_at, created_at, updated_at
+)
+SELECT
+  device_id, platform, push_token, push_provider, enabled, permissions,
+  preferences_json, 'en', app_version,
+  (unixepoch() * 1000) + 604800000,
+  last_seen_at, created_at, updated_at
+FROM mobile_devices;
+
+CREATE UNIQUE INDEX idx_notification_devices_push_token
+  ON notification_devices(push_provider, push_token);
+CREATE INDEX idx_notification_devices_delivery
+  ON notification_devices(enabled, permissions, lease_expires_at);
+
+CREATE TABLE notification_events (
+  event_id              TEXT PRIMARY KEY,
+  dedupe_key            TEXT NOT NULL UNIQUE,
+  event_type            TEXT NOT NULL,
+  target_json           TEXT NOT NULL,
+  priority              TEXT NOT NULL CHECK (priority IN ('normal', 'high')),
+  title_en              TEXT NOT NULL,
+  title_zh              TEXT NOT NULL,
+  body_en               TEXT,
+  body_zh               TEXT,
+  payload_json          TEXT NOT NULL DEFAULT '{}',
+  created_at            INTEGER NOT NULL
+);
+
+CREATE INDEX idx_notification_events_created
+  ON notification_events(created_at, event_id);
+
+CREATE TABLE notification_deliveries (
+  event_id              TEXT NOT NULL,
+  device_id             TEXT NOT NULL,
+  status                TEXT NOT NULL CHECK (status IN ('pending', 'accepted', 'delivered', 'dead')),
+  attempts              INTEGER NOT NULL DEFAULT 0,
+  next_attempt_at       INTEGER NOT NULL,
+  provider_ticket_id    TEXT,
+  last_error            TEXT,
+  updated_at            INTEGER NOT NULL,
+  PRIMARY KEY (event_id, device_id),
+  FOREIGN KEY (event_id) REFERENCES notification_events(event_id) ON DELETE CASCADE,
+  FOREIGN KEY (device_id) REFERENCES notification_devices(device_id) ON DELETE CASCADE
+);
+
+CREATE INDEX idx_notification_deliveries_due
+  ON notification_deliveries(status, next_attempt_at);
+
+CREATE TABLE notification_acknowledgements (
+  event_id              TEXT NOT NULL,
+  consumer_id           TEXT NOT NULL,
+  surface               TEXT NOT NULL CHECK (surface IN ('web', 'electron', 'mobile')),
+  acknowledged_at       INTEGER NOT NULL,
+  PRIMARY KEY (event_id, consumer_id),
+  FOREIGN KEY (event_id) REFERENCES notification_events(event_id) ON DELETE CASCADE
+);
+
+DROP TABLE mobile_activity_acknowledgements;
+DROP TABLE mobile_activity_events;
+DROP TABLE mobile_devices;

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 = 11;
 /** Latest schema version this release supports (increment when adding migrations). */
-export declare const XOPC_DB_SCHEMA_VERSION = 135;
+export declare const XOPC_DB_SCHEMA_VERSION = 136;
 export declare function resolveMigrationsDir(override?: string): string;
 /**
  * Apply sequential SQL migrations from (currentVersion + 1) through targetVersion.

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

@@ -12,7 +12,7 @@ const log = createLogger("Sqlite:Migrations");
 /** Baseline schema version applied from schema.sql on first open. */
 const XOPC_DB_BASELINE_SCHEMA_VERSION = 11;
 /** Latest schema version this release supports (increment when adding migrations). */
-const XOPC_DB_SCHEMA_VERSION = 135;
+const XOPC_DB_SCHEMA_VERSION = 136;
 const MODULE_DIR = dirname(fileURLToPath(import.meta.url));
 function backupBeforeTaskCutover(db, databasePath) {
 	db.exec("PRAGMA wal_checkpoint(FULL)");
@@ -57,7 +57,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 ?? 135;
+	const targetVersion = options.targetVersion ?? 136;
 	let currentVersion = readSchemaVersion(db);
 	if (currentVersion > targetVersion) throw new DatabaseSchemaTooNewError(currentVersion, targetVersion);
 	if (currentVersion >= targetVersion) return currentVersion;
@@ -94,7 +94,7 @@ function applyPendingMigrations(db, options = {}) {
 }
 /** Inspect schema version without mutating the database. */
 function inspectSchemaMigrationStatus(db, options = {}) {
-	const appVersion = options.targetVersion ?? 135;
+	const appVersion = options.targetVersion ?? 136;
 	const dbVersion = readSchemaVersion(db);
 	if (dbVersion > appVersion) return {
 		dbVersion,

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

@@ -19,7 +19,7 @@ const log = createLogger('Sqlite:Migrations');
 export const XOPC_DB_BASELINE_SCHEMA_VERSION = 11;
 
 /** Latest schema version this release supports (increment when adding migrations). */
-export const XOPC_DB_SCHEMA_VERSION = 135;
+export const XOPC_DB_SCHEMA_VERSION = 136;
 
 const MODULE_DIR = dirname(fileURLToPath(import.meta.url));
 

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

@@ -32,7 +32,7 @@ function ensureXopcDatabaseSchema(db, options = {}) {
 		currentVersion = 11;
 	}
 	applyPendingMigrations(db, {
-		targetVersion: 135,
+		targetVersion: 136,
 		databasePath: options.databasePath
 	});
 }

package/dist/src/storage/sqlite/session-input-repository.d.ts

@@ -31,6 +31,11 @@ export type SessionInputState = {
     inputs: SessionInput[];
 };
 export declare function getSessionInputState(sessionKey: string): SessionInputState;
+/** Durable active webchat runs claimed by the session-input coordinator. */
+export declare function listActiveSessionInputRuns(): Array<{
+    sessionKey: string;
+    runId: string;
+}>;
 export declare function findSessionInput(sessionKey: string, clientMessageId: string): SessionInput | undefined;
 export declare function getSessionInputById(sessionKey: string, id: string): SessionInput | undefined;
 export declare function insertSessionInput(input: {

package/dist/src/storage/sqlite/session-input-repository.js

@@ -56,6 +56,14 @@ function getSessionInputState(sessionKey) {
 		})
 	};
 }
+/** Durable active webchat runs claimed by the session-input coordinator. */
+function listActiveSessionInputRuns() {
+	return getSqliteDatabase().prepare(`SELECT session_key, active_run_id
+    FROM session_input_runtime WHERE active_run_id IS NOT NULL`).all().map((row) => ({
+		sessionKey: row.session_key,
+		runId: row.active_run_id
+	}));
+}
 function findSessionInput(sessionKey, clientMessageId) {
 	const row = getSqliteDatabase().prepare(`${SELECT_INPUTS} WHERE session_key = ? AND client_message_id = ?`).get(sessionKey, clientMessageId);
 	return row ? mapInput(row) : void 0;
@@ -158,4 +166,4 @@ function recoverSessionInputState() {
 	});
 }
 //#endregion
-export { cancelQueuedSessionInput, claimNextSessionInput, findSessionInput, finishSessionInputRun, getSessionInputById, getSessionInputState, insertSessionInput, mutateQueuedSessionInput, recoverSessionInputState, setSessionInputStatus };
+export { cancelQueuedSessionInput, claimNextSessionInput, findSessionInput, finishSessionInputRun, getSessionInputById, getSessionInputState, insertSessionInput, listActiveSessionInputRuns, mutateQueuedSessionInput, recoverSessionInputState, setSessionInputStatus };

package/dist/src/tasks/index.js

@@ -1,12 +1,12 @@
 import { TaskRepository } from "./task-repository.js";
 import { TaskConversationConflictError, TaskConversationRepository } from "./task-conversation-repository.js";
+import { enqueueTaskAttentionRequiredEvent, enqueueTaskChanged, enqueueTaskChangedEvent } from "./task-change-events.js";
 import { TaskRunRepository } from "./task-run-repository.js";
 import { TaskReadModelProjector } from "./task-read-model-projector.js";
 import { resolveExecutionContext } from "./execution-context.js";
 import { AttentionGovernor } from "./attention-governor.js";
 import { HomeQueryService, buildHomeWorkbench, decisionFromTask } from "./home-query-service.js";
 import { TaskContextRepository } from "./task-context-repository.js";
-import { enqueueTaskChanged, enqueueTaskChangedEvent } from "./task-change-events.js";
 import { TaskDependencyError, TaskDependencyService } from "./task-dependency-service.js";
 import { TaskApplicationService } from "./task-application-service.js";
 import { TaskWorkflowCoordinator } from "./task-workflow-coordinator.js";
@@ -22,4 +22,4 @@ import { TaskDeletionService } from "./task-deletion-service.js";
 import { TaskOutboxDispatcher } from "./task-outbox-dispatcher.js";
 import { TaskRunDispatcher } from "./task-run-dispatcher.js";
 import { TaskSignalService } from "./task-signal-service.js";
-export { AttentionGovernor, HomeQueryService, ModelTaskContractPlanner, ProjectMonitoringService, ProjectOperatingViewService, TaskApplicationService, TaskContextRepository, TaskConversationConflictError, TaskConversationRepository, TaskDeletionService, TaskDependencyError, TaskDependencyService, TaskHandoffService, TaskOutboxDispatcher, TaskReadModelProjector, TaskRepository, TaskRunCoordinator, TaskRunDispatcher, TaskRunRepository, TaskSignalService, TaskValueMetricsService, TaskWorkflowCoordinator, assembleTaskContext, buildHomeWorkbench, buildTaskExecutionDirective, decideProactiveDisposition, decisionFromTask, defineTaskContract, enqueueTaskChanged, enqueueTaskChangedEvent, getTaskContextManifest, getTaskExecutionBrief, isInQuietHours, nextQuietHoursEnd, parseTaskContractResponse, proactiveDispositionReason, resolveExecutionContext, summarizeProjectOperatingView };
+export { AttentionGovernor, HomeQueryService, ModelTaskContractPlanner, ProjectMonitoringService, ProjectOperatingViewService, TaskApplicationService, TaskContextRepository, TaskConversationConflictError, TaskConversationRepository, TaskDeletionService, TaskDependencyError, TaskDependencyService, TaskHandoffService, TaskOutboxDispatcher, TaskReadModelProjector, TaskRepository, TaskRunCoordinator, TaskRunDispatcher, TaskRunRepository, TaskSignalService, TaskValueMetricsService, TaskWorkflowCoordinator, assembleTaskContext, buildHomeWorkbench, buildTaskExecutionDirective, decideProactiveDisposition, decisionFromTask, defineTaskContract, enqueueTaskAttentionRequiredEvent, enqueueTaskChanged, enqueueTaskChangedEvent, getTaskContextManifest, getTaskExecutionBrief, isInQuietHours, nextQuietHoursEnd, parseTaskContractResponse, proactiveDispositionReason, resolveExecutionContext, summarizeProjectOperatingView };

package/dist/src/tasks/task-application-service.js

@@ -1,9 +1,9 @@
 import { getSqliteDatabase, runSqliteWriteTransaction } from "../storage/sqlite/transaction.js";
 import { TaskRepository } from "./task-repository.js";
+import { enqueueTaskAttentionRequiredEvent, enqueueTaskChangedEvent } from "./task-change-events.js";
 import { TaskRunRepository } from "./task-run-repository.js";
 import { TaskReadModelProjector } from "./task-read-model-projector.js";
 import { TaskContextRepository } from "./task-context-repository.js";
-import { enqueueTaskChangedEvent } from "./task-change-events.js";
 import { TaskDependencyService } from "./task-dependency-service.js";
 import { createHash, randomUUID } from "node:crypto";
 //#region src/tasks/task-application-service.ts
@@ -153,6 +153,15 @@ var TaskApplicationService = class {
 				],
 				actor
 			});
+			else if (started.ok === false && started.reason === "blocked") {
+				if (!this.#runs.listActiveWaits(current.id).some((wait) => wait.kind === "approval" || wait.kind === "user_input")) enqueueTaskAttentionRequiredEvent(db, {
+					taskId: current.id,
+					taskTitle: current.title,
+					...current.projectId ? { projectId: current.projectId } : {},
+					reason: "blocked",
+					correlationId: input.idempotencyKey
+				});
+			}
 			return started;
 		});
 	}
@@ -275,11 +284,15 @@ var TaskApplicationService = class {
 				}
 			}
 			if (result.ok === false) {
-				if (result.reason === "blocked") this.enqueueEvent(db, "task.attention_required.v2", task.id, input.idempotencyKey, {
-					taskId: task.id,
-					reason: "blocked",
-					projectId: task.projectId
-				});
+				if (result.reason === "blocked") {
+					if (!this.#runs.listActiveWaits(task.id).some((wait) => wait.kind === "approval" || wait.kind === "user_input")) enqueueTaskAttentionRequiredEvent(db, {
+						taskId: task.id,
+						taskTitle: task.title,
+						...task.projectId ? { projectId: task.projectId } : {},
+						reason: "blocked",
+						correlationId: input.idempotencyKey
+					});
+				}
 				return result;
 			}
 			this.recordCommand(db, {
@@ -301,6 +314,10 @@ var TaskApplicationService = class {
 				runId: result.runId
 			});
 			if (result.model.task.phase !== task.phase) this.enqueueEvent(db, "task.phase_changed.v2", task.id, input.idempotencyKey, {
+				task: {
+					id: result.model.task.id,
+					title: result.model.task.title
+				},
 				taskId: task.id,
 				from: task.phase,
 				to: result.model.task.phase,
@@ -344,6 +361,14 @@ var TaskApplicationService = class {
 			const task = this.#tasks.require(run.taskId);
 			if (input.receipt.status !== "succeeded") {
 				const model = this.#projector.project(task);
+				enqueueTaskAttentionRequiredEvent(db, {
+					taskId: task.id,
+					taskTitle: task.title,
+					...task.projectId ? { projectId: task.projectId } : {},
+					reason: "failed",
+					detail: input.terminalMessage ?? input.receipt.summary,
+					correlationId: run.id
+				});
 				enqueueTaskChangedEvent(db, {
 					taskId: task.id,
 					projectId: task.projectId,
@@ -370,6 +395,17 @@ var TaskApplicationService = class {
 				...phase === "closed" ? { resolution: "done" } : {}
 			});
 			if (!updated) throw new Error("Task changed while its run was being finalized");
+			this.enqueueEvent(db, "task.phase_changed.v2", updated.id, run.id, {
+				task: {
+					id: updated.id,
+					title: updated.title
+				},
+				taskId: updated.id,
+				from: task.phase,
+				to: updated.phase,
+				resolution: updated.resolution,
+				projectId: updated.projectId
+			});
 			enqueueTaskChangedEvent(db, {
 				taskId: updated.id,
 				projectId: updated.projectId,

package/dist/src/tasks/task-change-events.d.ts

@@ -10,4 +10,13 @@ export type TaskChangeInput = {
     occurredAt?: number;
 };
 export declare function enqueueTaskChangedEvent(db: DatabaseSync, input: TaskChangeInput): void;
+export declare function enqueueTaskAttentionRequiredEvent(db: DatabaseSync, input: {
+    taskId: string;
+    taskTitle: string;
+    projectId?: string;
+    reason: 'blocked' | 'failed' | 'user_input' | 'approval';
+    detail?: string;
+    correlationId: string;
+    occurredAt?: number;
+}): void;
 export declare function enqueueTaskChanged(input: TaskChangeInput): void;

package/dist/src/tasks/task-change-events.js

@@ -22,8 +22,24 @@ function enqueueTaskChangedEvent(db, input) {
 		occurredAt
 	}), occurredAt);
 }
+function enqueueTaskAttentionRequiredEvent(db, input) {
+	const occurredAt = input.occurredAt ?? Date.now();
+	db.prepare(`INSERT INTO domain_outbox (
+      event_id, event_type, subject_kind, subject_id, correlation_id,
+      payload_json, created_at
+    ) VALUES (?, 'task.attention_required.v2', 'task', ?, ?, ?, ?)`).run(randomUUID(), input.taskId, input.correlationId, JSON.stringify({
+		task: {
+			id: input.taskId,
+			title: input.taskTitle
+		},
+		taskId: input.taskId,
+		reason: input.reason,
+		...input.detail ? { detail: input.detail } : {},
+		...input.projectId ? { projectId: input.projectId } : {}
+	}), occurredAt);
+}
 function enqueueTaskChanged(input) {
 	runSqliteWriteTransaction((db) => enqueueTaskChangedEvent(db, input));
 }
 //#endregion
-export { enqueueTaskChanged, enqueueTaskChangedEvent };
+export { enqueueTaskAttentionRequiredEvent, enqueueTaskChanged, enqueueTaskChangedEvent };

package/dist/src/tasks/task-outbox-dispatcher.js

@@ -10,10 +10,14 @@ var TaskOutboxDispatcher = class {
        ORDER BY created_at, event_id LIMIT ?`).all(Math.max(1, Math.min(500, Math.floor(limit))));
 		let published = 0;
 		for (const row of rows) try {
+			const payload = JSON.parse(row.payload_json);
 			this.publish({
 				type: row.event_type,
 				source: "tasks",
-				payload: JSON.parse(row.payload_json),
+				payload: {
+					...payload,
+					sourceEventId: row.event_id
+				},
 				occurredAtMs: row.created_at
 			});
 			runSqliteWriteTransaction((db) => {

package/dist/src/tasks/task-run-dispatcher.js

@@ -2,12 +2,14 @@ import { createLogger } from "../utils/logger/index.js";
 import { init_logger } from "../utils/logger.js";
 import { TaskRepository } from "./task-repository.js";
 import { TaskRunRepository } from "./task-run-repository.js";
+import { TaskApplicationService } from "./task-application-service.js";
 //#region src/tasks/task-run-dispatcher.ts
 init_logger();
 const log = createLogger("TaskRunDispatcher");
 var TaskRunDispatcher = class {
 	#runs = new TaskRunRepository();
 	#tasks = new TaskRepository();
+	#application = new TaskApplicationService();
 	#draining = /* @__PURE__ */ new Set();
 	constructor(deps) {
 		this.deps = deps;
@@ -49,9 +51,9 @@ var TaskRunDispatcher = class {
 						"running",
 						"waiting",
 						"verifying"
-					].includes(current.status)) this.#runs.finalize({
+					].includes(current.status)) this.#application.completeRun({
 						runId: current.id,
-						expectedVersion: current.version,
+						expectedRunVersion: current.version,
 						terminalCode: "dispatch_failed",
 						terminalMessage: error instanceof Error ? error.message : String(error),
 						receipt: {

package/dist/src/tasks/task-run-repository.js

@@ -1,4 +1,5 @@
 import { getSqliteDatabase, runSqliteWriteTransaction } from "../storage/sqlite/transaction.js";
+import { enqueueTaskAttentionRequiredEvent } from "./task-change-events.js";
 import { randomUUID } from "node:crypto";
 //#region src/tasks/task-run-repository.ts
 const ACTIVE_RUN_STATUSES = [
@@ -237,6 +238,18 @@ var TaskRunRepository = class {
 				reason: input.reason.trim(),
 				resumeAt: input.resumeAt
 			}, input.actor ?? { kind: "system" }, now);
+			if (input.kind === "user_input" || input.kind === "approval") {
+				const task = db.prepare("SELECT title, project_id FROM tasks WHERE task_id = ?").get(input.taskId);
+				if (task) enqueueTaskAttentionRequiredEvent(db, {
+					taskId: input.taskId,
+					taskTitle: task.title,
+					...task.project_id ? { projectId: task.project_id } : {},
+					reason: input.kind,
+					detail: input.reason.trim(),
+					correlationId: id,
+					occurredAt: now
+				});
+			}
 		});
 		return this.requireWait(id);
 	}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xopcai/xopc",
-  "version": "0.0.227",
+  "version": "0.0.228",
   "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",
@@ -158,8 +158,8 @@
     "vitest": "4.1.5",
     "vue": "^3.5.35",
     "@xopcai/endpoint-tools-protocol": "0.0.0",
-    "@xopcai/gateway-contract": "0.0.0",
     "@xopcai/realtime-protocol": "0.0.0",
+    "@xopcai/gateway-contract": "0.0.0",
     "@xopcai/realtime-client": "0.0.0"
   },
   "scripts": {