@steventsao/agent-session-core 0.1.1 → 0.1.2

package/dist/index.d.ts

@@ -6,4 +6,5 @@
  */
 export * from './socket-events';
 export * from './types';
+export * from './session-config';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,cAAc,iBAAiB,CAAC;AAChC,cAAc,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,cAAc,iBAAiB,CAAC;AAChC,cAAc,SAAS,CAAC;AACxB,cAAc,kBAAkB,CAAC"}

package/dist/index.js

@@ -6,4 +6,5 @@
  */
 export * from './socket-events';
 export * from './types';
+export * from './session-config';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,cAAc,iBAAiB,CAAC;AAChC,cAAc,SAAS,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,cAAc,iBAAiB,CAAC;AAChC,cAAc,SAAS,CAAC;AACxB,cAAc,kBAAkB,CAAC"}

package/dist/session-config.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Session Refresh Configuration
+ *
+ * Defines how the client should behave when the sessionId changes.
+ * This is critical for document isolation in multi-document applications.
+ */
+/**
+ * Refresh strategies for session changes
+ *
+ * - 'reset': Clear all client state and connect fresh (recommended for document isolation)
+ * - 'preserve': Attempt to reconnect to existing sandbox (for tab persistence scenarios)
+ */
+export type SessionRefreshStrategy = 'reset' | 'preserve';
+export interface SessionRefreshConfig {
+    /**
+     * What to do when sessionId changes:
+     *
+     * 'reset' (default, recommended):
+     *   - Clear sandboxId, sandboxUrl, messages, agentSessionId
+     *   - Disconnect from old socket
+     *   - Connect to new session with clean slate
+     *   - Use this when sessionId represents a document UUID
+     *
+     * 'preserve':
+     *   - Keep existing state during reconnection
+     *   - Useful for browser tab persistence where same user returns
+     *   - NOT recommended when switching between documents
+     */
+    onSessionChange: SessionRefreshStrategy;
+    /**
+     * Whether to clear chat messages when session changes (only applies to 'reset' strategy)
+     * Default: true
+     */
+    clearMessagesOnReset?: boolean;
+    /**
+     * Whether to clear agent session ID when session changes (only applies to 'reset' strategy)
+     * Default: true
+     */
+    clearAgentSessionOnReset?: boolean;
+}
+/**
+ * Default configuration - full reset on session change
+ * This is the safest option for document isolation
+ */
+export declare const DEFAULT_SESSION_REFRESH_CONFIG: SessionRefreshConfig;
+/**
+ * Preserve configuration - for tab persistence scenarios
+ * Use with caution - only when you know the user is returning to the same document
+ */
+export declare const PRESERVE_SESSION_CONFIG: SessionRefreshConfig;
+/**
+ * Helper to determine if state should be reset based on config
+ */
+export declare function shouldResetOnSessionChange(config: SessionRefreshConfig, oldSessionId: string | null, newSessionId: string | null): boolean;
+//# sourceMappingURL=session-config.d.ts.map

package/dist/session-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-config.d.ts","sourceRoot":"","sources":["../src/session-config.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;;GAKG;AACH,MAAM,MAAM,sBAAsB,GAAG,OAAO,GAAG,UAAU,CAAC;AAE1D,MAAM,WAAW,oBAAoB;IACnC;;;;;;;;;;;;;OAaG;IACH,eAAe,EAAE,sBAAsB,CAAC;IAExC;;;OAGG;IACH,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAE/B;;;OAGG;IACH,wBAAwB,CAAC,EAAE,OAAO,CAAC;CACpC;AAED;;;GAGG;AACH,eAAO,MAAM,8BAA8B,EAAE,oBAI5C,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,uBAAuB,EAAE,oBAIrC,CAAC;AAEF;;GAEG;AACH,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,oBAAoB,EAC5B,YAAY,EAAE,MAAM,GAAG,IAAI,EAC3B,YAAY,EAAE,MAAM,GAAG,IAAI,GAC1B,OAAO,CAOT"}

package/dist/session-config.js

@@ -0,0 +1,35 @@
+/**
+ * Session Refresh Configuration
+ *
+ * Defines how the client should behave when the sessionId changes.
+ * This is critical for document isolation in multi-document applications.
+ */
+/**
+ * Default configuration - full reset on session change
+ * This is the safest option for document isolation
+ */
+export const DEFAULT_SESSION_REFRESH_CONFIG = {
+    onSessionChange: 'reset',
+    clearMessagesOnReset: true,
+    clearAgentSessionOnReset: true,
+};
+/**
+ * Preserve configuration - for tab persistence scenarios
+ * Use with caution - only when you know the user is returning to the same document
+ */
+export const PRESERVE_SESSION_CONFIG = {
+    onSessionChange: 'preserve',
+    clearMessagesOnReset: false,
+    clearAgentSessionOnReset: false,
+};
+/**
+ * Helper to determine if state should be reset based on config
+ */
+export function shouldResetOnSessionChange(config, oldSessionId, newSessionId) {
+    if (config.onSessionChange === 'preserve') {
+        return false;
+    }
+    // Reset if sessions are different
+    return oldSessionId !== newSessionId && oldSessionId !== null && newSessionId !== null;
+}
+//# sourceMappingURL=session-config.js.map

package/dist/session-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-config.js","sourceRoot":"","sources":["../src/session-config.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAwCH;;;GAGG;AACH,MAAM,CAAC,MAAM,8BAA8B,GAAyB;IAClE,eAAe,EAAE,OAAO;IACxB,oBAAoB,EAAE,IAAI;IAC1B,wBAAwB,EAAE,IAAI;CAC/B,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAyB;IAC3D,eAAe,EAAE,UAAU;IAC3B,oBAAoB,EAAE,KAAK;IAC3B,wBAAwB,EAAE,KAAK;CAChC,CAAC;AAEF;;GAEG;AACH,MAAM,UAAU,0BAA0B,CACxC,MAA4B,EAC5B,YAA2B,EAC3B,YAA2B;IAE3B,IAAI,MAAM,CAAC,eAAe,KAAK,UAAU,EAAE,CAAC;QAC1C,OAAO,KAAK,CAAC;IACf,CAAC;IAED,kCAAkC;IAClC,OAAO,YAAY,KAAK,YAAY,IAAI,YAAY,KAAK,IAAI,IAAI,YAAY,KAAK,IAAI,CAAC;AACzF,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@steventsao/agent-session-core",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "description": "Shared types and protocol for agent-session",
   "type": "module",
   "main": "dist/index.js",
@@ -11,7 +11,9 @@
       "import": "./dist/index.js"
     }
   },
-  "files": ["dist"],
+  "files": [
+    "dist"
+  ],
   "scripts": {
     "build": "tsc",
     "dev": "tsc --watch"