@continuum-dev/session 0.1.1 → 0.1.3

package/README.md

@@ -92,6 +92,7 @@ function hydrateOrCreate(options?: SessionOptions): Session;
 Persistence note:
 
 - When `options.persistence` is provided, snapshot writes are debounced by 200ms.
+- Pending writes are flushed on `beforeunload` so tab closes do not drop recent updates.
 - `SessionPersistenceOptions.maxBytes` enforces a payload size cap before writes.
 - `SessionPersistenceOptions.onError` receives `size_limit` and `storage_error` events.
 - Browser `storage` events are consumed for cross-tab session synchronization.
@@ -118,6 +119,8 @@ const stopIssues = session.onIssues((issues) => {
 });
 ```
 
+Snapshot listeners receive immutable top-level copies of `view` and `data`.
+
 ### 2) View and State Updates
 
 #### `session.pushView(view)`
@@ -148,6 +151,8 @@ session.recordIntent({
 });
 ```
 
+`recordIntent` clones incoming payload objects before storing them and deduplicates issues by `nodeId + code`.
+
 #### Viewport APIs
 
 ```typescript
@@ -240,15 +245,54 @@ const log = session.getEventLog();
 
 ### 6) Actions Registry
 
-Register local handlers for semantic intent ids and dispatch them with current session snapshot data.
+Register handlers for semantic intent ids and dispatch them with full session context.
+
+#### `session.registerAction(intentId, registration, handler)`
 
 ```typescript
-session.registerAction('fetch_data', { label: 'Fetch Data' }, async ({ snapshot, nodeId }) => {
-  void snapshot;
-  void nodeId;
+session.registerAction('submit_form', { label: 'Submit' }, async (context) => {
+  const response = await fetch('/api/submit', {
+    method: 'POST',
+    body: JSON.stringify(context.snapshot.values),
+  });
+  const data = await response.json();
+  context.session.updateState('status', { value: 'submitted' });
+  return { success: true, data };
 });
+```
+
+Handlers receive an `ActionContext` with:
+
+- `intentId` -- the dispatched intent identifier
+- `snapshot` -- current `DataSnapshot` at dispatch time
+- `nodeId` -- the node that triggered the action
+- `session` -- an `ActionSessionRef` for post-action mutations (`pushView`, `updateState`, `getSnapshot`, `proposeValue`)
+
+#### `session.dispatchAction(intentId, nodeId)`
+
+Returns a `Promise<ActionResult>`. Catches handler errors automatically.
 
-await session.dispatchAction('fetch_data', 'btn_1');
+```typescript
+const result = await session.dispatchAction('submit_form', 'btn_submit');
+if (result.success) {
+  console.log('Submitted:', result.data);
+} else {
+  console.error('Failed:', result.error);
+}
+```
+
+If no handler is registered, a warning is logged and `{ success: false }` is returned.
+
+#### `session.executeIntent(intent)`
+
+Bridges the intent lifecycle and action dispatch in a single call: submits a pending intent, dispatches the registered action, and marks the intent as validated on success or cancelled on failure.
+
+```typescript
+const result = await session.executeIntent({
+  nodeId: 'btn_submit',
+  intentName: 'submit_form',
+  payload: { source: 'user' },
+});
 ```
 
 Also available:
@@ -271,6 +315,7 @@ Persistence behavior:
 
 - `serialize()` returns a JSON-safe payload with `formatVersion: 1`.
 - Automatic persistence writes are debounced (200ms) to reduce storage churn.
+- Pending writes are flushed on `beforeunload` to reduce data loss risk during tab close.
 - If `maxBytes` is exceeded, the write is skipped and `onError` is invoked.
 - Remote storage updates can rehydrate in-memory state for cross-tab continuity.
 

package/lib/session/checkpoint-manager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"checkpoint-manager.d.ts","sourceRoot":"","sources":["../../../../../packages/session/src/lib/session/checkpoint-manager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAOvD;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,CAAC,CAEtD;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,YAAY,GAAG,IAAI,CAqB3D;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,YAAY,GAAG,UAAU,CAezE;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,YAAY,EAAE,EAAE,EAAE,UAAU,GAAG,IAAI,CAalF;AAED;;;;;GAKG;AACH,wBAAgB,MAAM,CAAC,QAAQ,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,GAAG,IAAI,CAkBzE"}
+{"version":3,"file":"checkpoint-manager.d.ts","sourceRoot":"","sources":["../../../../../packages/session/src/lib/session/checkpoint-manager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAOvD;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,CAAC,CAEtD;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,YAAY,GAAG,IAAI,CAqB3D;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,YAAY,GAAG,UAAU,CAyBzE;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,YAAY,EAAE,EAAE,EAAE,UAAU,GAAG,IAAI,CAalF;AAED;;;;;GAKG;AACH,wBAAgB,MAAM,CAAC,QAAQ,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,GAAG,IAAI,CAkBzE"}

package/lib/session/checkpoint-manager.js

@@ -59,6 +59,16 @@ export function createManualCheckpoint(internal) {
         trigger: 'manual',
     };
     internal.checkpoints.push(checkpoint);
+    if (internal.checkpoints.length > internal.maxCheckpoints) {
+        const overflow = internal.checkpoints.length - internal.maxCheckpoints;
+        for (let index = 0; index < overflow; index += 1) {
+            const removableIndex = internal.checkpoints.findIndex((cp) => cp.trigger === 'manual');
+            if (removableIndex === -1) {
+                break;
+            }
+            internal.checkpoints.splice(removableIndex, 1);
+        }
+    }
     return checkpoint;
 }
 /**

package/lib/session/event-log.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"event-log.d.ts","sourceRoot":"","sources":["../../../../../packages/session/src/lib/session/event-log.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAY,WAAW,EAA2B,MAAM,qBAAqB,CAAC;AAE1F,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAsDvD;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAC1B,QAAQ,EAAE,YAAY,EACtB,OAAO,EAAE,IAAI,CAAC,WAAW,EAAE,eAAe,GAAG,WAAW,GAAG,WAAW,GAAG,aAAa,CAAC,GACtF,IAAI,CAiFN"}
+{"version":3,"file":"event-log.d.ts","sourceRoot":"","sources":["../../../../../packages/session/src/lib/session/event-log.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAY,WAAW,EAA2B,MAAM,qBAAqB,CAAC;AAE1F,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAoEvD;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAC1B,QAAQ,EAAE,YAAY,EACtB,OAAO,EAAE,IAAI,CAAC,WAAW,EAAE,eAAe,GAAG,WAAW,GAAG,WAAW,GAAG,aAAa,CAAC,GACtF,IAAI,CA+EN"}

package/lib/session/event-log.js

@@ -3,6 +3,16 @@ import { generateId } from './session-state.js';
 import { buildSnapshotFromCurrentState, notifySnapshotAndIssueListeners } from './listeners.js';
 import { cloneCheckpointSnapshot } from './checkpoint-manager.js';
 import { validateNodeValue } from '@continuum-dev/runtime';
+function dedupeIssues(existing, incoming) {
+    if (incoming.length === 0) {
+        return existing;
+    }
+    const nextKeys = new Set(incoming.map((issue) => `${issue.nodeId ?? ''}:${issue.code}`));
+    return [
+        ...existing.filter((issue) => !nextKeys.has(`${issue.nodeId ?? ''}:${issue.code}`)),
+        ...incoming,
+    ];
+}
 function collectNodesByCanonicalId(nodes) {
     const byId = new Map();
     const walk = (items, parentPath) => {
@@ -75,24 +85,22 @@ export function recordIntent(internal, partial) {
     }
     const resolvedEntry = resolveNodeLookupEntry(internal.currentView.nodes, partial.nodeId);
     if (!resolvedEntry) {
-        internal.issues = [
-            ...internal.issues,
-            {
+        internal.issues = dedupeIssues(internal.issues, [{
                 severity: ISSUE_SEVERITY.WARNING,
                 nodeId: partial.nodeId,
                 message: `Node ${partial.nodeId} not found in current view`,
                 code: ISSUE_CODES.UNKNOWN_NODE,
-            },
-        ];
+            }]);
         notifySnapshotAndIssueListeners(internal);
         return;
     }
     const { canonicalId, node } = resolvedEntry;
+    const payload = { ...partial.payload };
     internal.currentData = {
         ...internal.currentData,
         values: {
             ...internal.currentData.values,
-            [canonicalId]: partial.payload,
+            [canonicalId]: payload,
         },
         lineage: {
             ...internal.currentData.lineage,
@@ -108,9 +116,9 @@ export function recordIntent(internal, partial) {
         },
     };
     if (internal.validateOnUpdate) {
-        const validationIssues = validateNodeValue(node, partial.payload);
+        const validationIssues = validateNodeValue(node, payload);
         if (validationIssues.length > 0) {
-            internal.issues = [...internal.issues, ...validationIssues];
+            internal.issues = dedupeIssues(internal.issues, validationIssues);
         }
     }
     const lastAutoCheckpoint = [...internal.checkpoints]

package/lib/session/listeners.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"listeners.d.ts","sourceRoot":"","sources":["../../../../../packages/session/src/lib/session/listeners.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAC9D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAC9D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEvD;;;;;GAKG;AACH,wBAAgB,6BAA6B,CAAC,QAAQ,EAAE,YAAY,GAAG,kBAAkB,GAAG,IAAI,CAG/F;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,YAAY,GAAG,IAAI,CASpE;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,YAAY,GAAG,IAAI,CAQjE;AAED;;;;GAIG;AACH,wBAAgB,+BAA+B,CAAC,QAAQ,EAAE,YAAY,GAAG,IAAI,CAG5E;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,YAAY,EACtB,QAAQ,EAAE,CAAC,QAAQ,EAAE,kBAAkB,GAAG,IAAI,KAAK,IAAI,GACtD,MAAM,IAAI,CAGZ;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,YAAY,EACtB,QAAQ,EAAE,CAAC,MAAM,EAAE,mBAAmB,EAAE,KAAK,IAAI,GAChD,MAAM,IAAI,CAGZ"}
+{"version":3,"file":"listeners.d.ts","sourceRoot":"","sources":["../../../../../packages/session/src/lib/session/listeners.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAC9D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAC9D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEvD;;;;;GAKG;AACH,wBAAgB,6BAA6B,CAAC,QAAQ,EAAE,YAAY,GAAG,kBAAkB,GAAG,IAAI,CAS/F;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,YAAY,GAAG,IAAI,CASpE;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,YAAY,GAAG,IAAI,CAQjE;AAED;;;;GAIG;AACH,wBAAgB,+BAA+B,CAAC,QAAQ,EAAE,YAAY,GAAG,IAAI,CAG5E;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,YAAY,EACtB,QAAQ,EAAE,CAAC,QAAQ,EAAE,kBAAkB,GAAG,IAAI,KAAK,IAAI,GACtD,MAAM,IAAI,CAGZ;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,YAAY,EACtB,QAAQ,EAAE,CAAC,MAAM,EAAE,mBAAmB,EAAE,KAAK,IAAI,GAChD,MAAM,IAAI,CAGZ"}

package/lib/session/listeners.js

@@ -7,7 +7,13 @@
 export function buildSnapshotFromCurrentState(internal) {
     if (!internal.currentView || !internal.currentData)
         return null;
-    return { view: internal.currentView, data: internal.currentData };
+    const snapshot = {
+        view: { ...internal.currentView },
+        data: { ...internal.currentData },
+    };
+    Object.freeze(snapshot.view);
+    Object.freeze(snapshot.data);
+    return Object.freeze(snapshot);
 }
 /**
  * Notifies all snapshot listeners with the latest snapshot value.

package/lib/session/persistence.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"persistence.d.ts","sourceRoot":"","sources":["../../../../../packages/session/src/lib/session/persistence.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAIvD,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,aAAa,CAAC;AAkB7D;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,YAAY,EACtB,OAAO,EAAE,yBAAyB,GACjC,MAAM,IAAI,CAuEZ"}
+{"version":3,"file":"persistence.d.ts","sourceRoot":"","sources":["../../../../../packages/session/src/lib/session/persistence.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAIvD,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,aAAa,CAAC;AAkB7D;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,YAAY,EACtB,OAAO,EAAE,yBAAyB,GACjC,MAAM,IAAI,CAmFZ"}

package/lib/session/persistence.js

@@ -31,36 +31,43 @@ export function attachPersistence(internal, options) {
     let timeout;
     let isApplyingRemote = false;
     const encoder = new TextEncoder();
+    const flushNow = () => {
+        if (timeout) {
+            clearTimeout(timeout);
+            timeout = undefined;
+        }
+        try {
+            const payload = JSON.stringify(serializeSession(internal));
+            const attemptedBytes = encoder.encode(payload).byteLength;
+            if (typeof options.maxBytes === 'number'
+                && Number.isFinite(options.maxBytes)
+                && options.maxBytes >= 0
+                && attemptedBytes > options.maxBytes) {
+                options.onError?.({
+                    reason: 'size_limit',
+                    key,
+                    attemptedBytes,
+                    maxBytes: options.maxBytes,
+                });
+                return;
+            }
+            storage.setItem(key, payload);
+        }
+        catch (cause) {
+            options.onError?.({
+                reason: 'storage_error',
+                key,
+                cause,
+            });
+        }
+    };
     const unsubscribe = subscribeSnapshot(internal, () => {
         if (isApplyingRemote)
             return;
         if (timeout)
             clearTimeout(timeout);
         timeout = setTimeout(() => {
-            try {
-                const payload = JSON.stringify(serializeSession(internal));
-                const attemptedBytes = encoder.encode(payload).byteLength;
-                if (typeof options.maxBytes === 'number'
-                    && Number.isFinite(options.maxBytes)
-                    && options.maxBytes >= 0
-                    && attemptedBytes > options.maxBytes) {
-                    options.onError?.({
-                        reason: 'size_limit',
-                        key,
-                        attemptedBytes,
-                        maxBytes: options.maxBytes,
-                    });
-                    return;
-                }
-                storage.setItem(key, payload);
-            }
-            catch (cause) {
-                options.onError?.({
-                    reason: 'storage_error',
-                    key,
-                    cause,
-                });
-            }
+            flushNow();
         }, 200);
     });
     const onStorage = (event) => {
@@ -75,26 +82,29 @@ export function attachPersistence(internal, options) {
             });
             isApplyingRemote = true;
             replaceInternalState(internal, next);
+            isApplyingRemote = false;
             notifySnapshotAndIssueListeners(internal);
         }
         catch {
-            return;
-        }
-        finally {
             isApplyingRemote = false;
+            return;
         }
     };
     const maybeAdd = globalThis.addEventListener;
     const maybeRemove = globalThis.removeEventListener;
     if (maybeAdd) {
         maybeAdd('storage', onStorage);
+        maybeAdd('beforeunload', flushNow);
     }
     return () => {
-        if (timeout)
+        if (timeout) {
             clearTimeout(timeout);
+            timeout = undefined;
+        }
         unsubscribe();
         if (maybeRemove) {
             maybeRemove('storage', onStorage);
+            maybeRemove('beforeunload', flushNow);
         }
     };
 }

package/lib/session.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../../../packages/session/src/lib/session.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AA2M1E;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAqB/D;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAuB5E;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAWjE;AAED;;GAEG;AACH,eAAO,MAAM,cAAc,EAAE,cAA+C,CAAC"}
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../../../packages/session/src/lib/session.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AA4O1E;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAqB/D;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAuB5E;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAWjE;AAED;;GAEG;AACH,eAAO,MAAM,cAAc,EAAE,cAA+C,CAAC"}

package/lib/session.js

@@ -175,15 +175,49 @@ function assembleSessionFromInternalState(internal, cleanupPersistence) {
             }
             return result;
         },
-        dispatchAction(intentId, nodeId) {
+        async dispatchAction(intentId, nodeId) {
             assertNotDestroyed(internal);
             const entry = internal.actionRegistry.get(intentId);
-            if (!entry)
-                return;
+            if (!entry) {
+                console.warn(`[Continuum] dispatchAction: no handler registered for intentId "${intentId}"`);
+                return { success: false, error: `No handler registered for intentId "${intentId}"` };
+            }
             const snapshot = buildSnapshotFromCurrentState(internal);
-            if (!snapshot)
-                return;
-            return entry.handler({ intentId, snapshot: snapshot.data, nodeId });
+            if (!snapshot) {
+                return { success: false, error: 'No active snapshot' };
+            }
+            const sessionRef = {
+                pushView: (v) => session.pushView(v),
+                updateState: (id, p) => session.updateState(id, p),
+                getSnapshot: () => session.getSnapshot(),
+                proposeValue: (id, v, s) => session.proposeValue(id, v, s),
+            };
+            try {
+                const raw = await entry.handler({ intentId, snapshot: snapshot.data, nodeId, session: sessionRef });
+                return raw ?? { success: true };
+            }
+            catch (error) {
+                return { success: false, error };
+            }
+        },
+        async executeIntent(partial) {
+            assertNotDestroyed(internal);
+            submitIntent(internal, partial);
+            const intent = internal.pendingIntents[internal.pendingIntents.length - 1];
+            try {
+                const result = await session.dispatchAction(partial.intentName, partial.nodeId);
+                if (result.success) {
+                    validateIntent(internal, intent.intentId);
+                }
+                else {
+                    cancelIntent(internal, intent.intentId);
+                }
+                return result;
+            }
+            catch (error) {
+                cancelIntent(internal, intent.intentId);
+                return { success: false, error };
+            }
         },
     };
     return session;

package/lib/types.d.ts

@@ -1,4 +1,4 @@
-import type { ContinuitySnapshot, Interaction, DetachedValue, DetachedValuePolicy, ProposedValue, ViewportState, PendingIntent, Checkpoint, ViewDefinition, NodeValue, ActionRegistration, ActionHandler } from '@continuum-dev/contract';
+import type { ContinuitySnapshot, Interaction, DetachedValue, DetachedValuePolicy, ProposedValue, ViewportState, PendingIntent, Checkpoint, ViewDefinition, NodeValue, ActionRegistration, ActionHandler, ActionResult } from '@continuum-dev/contract';
 import type { ReconciliationIssue, ReconciliationOptions, ReconciliationResolution, StateDiff } from '@continuum-dev/runtime';
 /**
  * Minimal storage adapter used by session persistence.
@@ -246,8 +246,18 @@ export interface Session {
     getRegisteredActions(): Record<string, ActionRegistration>;
     /**
      * Dispatches a registered action handler with current snapshot context.
+     *
+     * Returns `{ success: false }` when no handler is registered or when no
+     * active snapshot exists.
+     */
+    dispatchAction(intentId: string, nodeId: string): Promise<ActionResult>;
+    /**
+     * Submits a pending intent, dispatches the registered action, and updates
+     * intent status based on the result (validated on success, cancelled on failure).
+     *
+     * Returns the same `ActionResult` shape as `dispatchAction`.
      */
-    dispatchAction(intentId: string, nodeId: string): void | Promise<void>;
+    executeIntent(intent: Omit<PendingIntent, 'intentId' | 'queuedAt' | 'status' | 'viewVersion'>): Promise<ActionResult>;
 }
 /**
  * Helper interface for dependency injection and test doubles.

package/lib/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../packages/session/src/lib/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../packages/session/src/lib/types.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@continuum-dev/session",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "publishConfig": {
     "access": "public"
   },
@@ -40,7 +40,7 @@
     "LICENSE*"
   ],
   "dependencies": {
-    "@continuum-dev/contract": "^0.1.1",
-    "@continuum-dev/runtime": "^0.1.1"
+    "@continuum-dev/contract": "^0.1.3",
+    "@continuum-dev/runtime": "^0.1.3"
   }
 }