@ibgib/core-gib 0.1.57 → 0.1.58

package/dist/sync/sync-peer/sync-peer-types.d.mts

@@ -7,6 +7,7 @@ import { SyncSagaContextData_V1, SyncSagaContextIbGib_V1, SyncSagaContextRel8ns_
 import { Witness_V1 } from '../../witness/witness-types.mjs';
 import { IbGibSpaceAny } from '../../witness/space/space-base-v1.mjs';
 import { MetaspaceService } from '../../witness/space/metaspace/metaspace-types.mjs';
+import { KeystoneIbGib_V1, KeystonePoolConfig } from '../../keystone/keystone-types.mjs';
 /**
  * Data for the SyncPeer witness.
  */
@@ -30,12 +31,28 @@ export interface SyncPeerIbGib_V1 extends IbGib_V1<SyncPeerData_V1, SyncPeerRel8
  * opts used in `connect(opts)`
  */
 export interface ConnectSyncPeerOpts {
+    /**
+     * TODO: sagaId is now also on {@link InitializeSyncPeerOpts} since a peer
+     * is scoped to a single sync saga. Evaluate whether this duplicate is still
+     * needed when implementing the connect phase (Phase 2).
+     */
     sagaId: string;
 }
 /**
- * base initialization opts
+ * base initialization opts.
+ *
+ * A sync peer is scoped to exactly one sync saga. A new peer instance must be
+ * created for each `sync(...)` call. Reusing a peer across multiple sagas is
+ * not supported and would compromise the identity security model.
  */
 export interface InitializeSyncPeerOpts {
+    /**
+     * Unique id for the sync saga this peer is servicing.
+     * Generated by `SyncSagaCoordinator.sync()` and passed here so that
+     * `establishSessionIdentity` can derive the session secret via
+     * `KDF(senderSecret, sagaId)`.
+     */
+    sagaId?: string;
     /**
      * reference to the local metaspace
      */
@@ -55,6 +72,44 @@ export interface InitializeSyncPeerOpts {
      * received/created throughout the transaction until commit.
      */
     localTempSpace?: IbGibSpaceAny;
+    /**
+     * The sender's long-lived Domain Keystone (I) — Alice's identity.
+     * Optional; if omitted the sync runs without identity (anonymous).
+     * Must be the current tip frame of I's timeline.
+     *
+     * Both {@link senderIdentity} and {@link fnSenderSecret} must be provided
+     * together or omitted together.
+     */
+    senderIdentity?: KeystoneIbGib_V1;
+    /**
+     * Returns the plaintext secret corresponding to {@link senderIdentity}.
+     * Wrapped in a function to avoid holding the secret in memory longer than needed.
+     *
+     * Both {@link senderIdentity} and {@link fnSenderSecret} must be provided
+     * together or omitted together.
+     */
+    fnSenderSecret?: () => Promise<string>;
+    /**
+     * Pool config for the session keystone's transport connect handshake pool.
+     * Required when {@link senderIdentity} is provided.
+     *
+     * @see {@link POOL_ID_CONNECT}
+     */
+    sessionConnectPoolConfig?: KeystonePoolConfig;
+    /**
+     * Pool config for the session keystone's per-turn signing pool (`sync`).
+     * Required when {@link senderIdentity} is provided.
+     *
+     * @see {@link POOL_ID_SYNC}
+     */
+    sessionSyncPoolConfig?: KeystonePoolConfig;
+    /**
+     * Addresses of the synced domains (ibgibs).
+     * Used during `establishSessionIdentity` to bind the session keystone (S)
+     * strictly to these domains, preventing S from acting as a "blank check"
+     * for unauthorized domains.
+     */
+    targetAddrs?: string[];
 }
 /**
  * The interface for the SyncPeer witness class.
@@ -88,6 +143,19 @@ SyncPeerData_V1, SyncPeerRel8ns_V1> {
      * The handling code (e.g. SyncSagaCoordinator) will subscribe to this.
      */
     payloadIbGibsDomainReceived$: SubjectWitness<IbGib_V1>;
+    /**
+     * Pre-connect phase: creates the session keystone (S) locally, evolves
+     * `senderIdentity` (I → I1) with a `sync` claim targeting S, and posts
+     * both to the receiver's domain registry.
+     *
+     * Must be called before `connect()`. No-op if `senderIdentity` was not
+     * provided in {@link InitializeSyncPeerOpts}.
+     *
+     * @returns The session keystone genesis (S^Stjp). The coordinator holds
+     * this reference for the remainder of the saga. The name `newSenderIdentity`
+     * (I1) is intentionally scoped only within this method to avoid confusion.
+     */
+    establishSessionIdentity(): Promise<KeystoneIbGib_V1 | undefined>;
     /**
      * Establishes the connection context.
      *

package/dist/sync/sync-peer/sync-peer-types.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"sync-peer-types.d.mts","sourceRoot":"","sources":["../../../src/sync/sync-peer/sync-peer-types.mts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,iCAAiC,CAAC;AAEzF,OAAO,EAAE,cAAc,EAAE,MAAM,+CAA+C,CAAC;AAC/E,OAAO,EAAE,sBAAsB,EAAE,uBAAuB,EAAE,wBAAwB,EAAE,MAAM,kDAAkD,CAAC;AAC7I,OAAO,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAC;AAC7D,OAAO,EAAE,aAAa,EAAE,MAAM,uCAAuC,CAAC;AACtE,OAAO,EAAE,gBAAgB,EAAE,MAAM,mDAAmD,CAAC;AAErF;;GAEG;AACH,MAAM,WAAW,eAAgB,SAAQ,YAAY;IACjD;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAkB,SAAQ,cAAc;CACxD;AAED;;GAEG;AACH,MAAM,WAAW,gBAAiB,SAAQ,QAAQ,CAAC,eAAe,EAAE,iBAAiB,CAAC;CAAI;AAG1F;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAChC,MAAM,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACnC;;OAEG;IACH,cAAc,EAAE,gBAAgB,CAAC;IACjC;;;;;OAKG;IACH,UAAU,EAAE,aAAa,CAAC;IAC1B;;;;;;OAMG;IACH,cAAc,CAAC,EAAE,aAAa,CAAC;CAClC;AAED;;;GAGG;AACH,MAAM,WAAW,eAAe,CAAC,eAAe,SAAS,sBAAsB,GAAG,sBAAsB,CAAE,SAAQ,UAAU,CACxH,sBAAsB,EACtB,wBAAwB,EACxB,uBAAuB,EAAE,QAAQ;AACjC,sBAAsB,EACtB,wBAAwB,EACxB,uBAAuB,EAAE,SAAS;AAClC,eAAe,EACf,iBAAiB,CACpB;IACG,IAAI,SAAS,IAAI,MAAM,CAAC;IAExB;;;;;;;;OAQG;IACH,IAAI,EAAE,eAAe,GAAG,SAAS,CAAC;IAElC;;;;;OAKG;IACH,eAAe,CAAC,GAAG,EAAE,OAAO,CAAC,eAAe,CAAC,GAAG,IAAI,CAAC;IAErD;;;;;OAKG;IACH,4BAA4B,EAAE,cAAc,CAAC,QAAQ,CAAC,CAAC;IAEvD;;;;;;OAMG;IACH,OAAO,CAAC,IAAI,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACtD"}
+{"version":3,"file":"sync-peer-types.d.mts","sourceRoot":"","sources":["../../../src/sync/sync-peer/sync-peer-types.mts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,iCAAiC,CAAC;AAEzF,OAAO,EAAE,cAAc,EAAE,MAAM,+CAA+C,CAAC;AAC/E,OAAO,EAAE,sBAAsB,EAAE,uBAAuB,EAAE,wBAAwB,EAAE,MAAM,kDAAkD,CAAC;AAC7I,OAAO,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAC;AAC7D,OAAO,EAAE,aAAa,EAAE,MAAM,uCAAuC,CAAC;AACtE,OAAO,EAAE,gBAAgB,EAAE,MAAM,mDAAmD,CAAC;AACrF,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,mCAAmC,CAAC;AAEzF;;GAEG;AACH,MAAM,WAAW,eAAgB,SAAQ,YAAY;IACjD;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAkB,SAAQ,cAAc;CACxD;AAED;;GAEG;AACH,MAAM,WAAW,gBAAiB,SAAQ,QAAQ,CAAC,eAAe,EAAE,iBAAiB,CAAC;CAAI;AAG1F;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAChC;;;;OAIG;IACH,MAAM,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,sBAAsB;IACnC;;;;;OAKG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;OAEG;IACH,cAAc,EAAE,gBAAgB,CAAC;IACjC;;;;;OAKG;IACH,UAAU,EAAE,aAAa,CAAC;IAC1B;;;;;;OAMG;IACH,cAAc,CAAC,EAAE,aAAa,CAAC;IAC/B;;;;;;;OAOG;IACH,cAAc,CAAC,EAAE,gBAAgB,CAAC;IAClC;;;;;;OAMG;IACH,cAAc,CAAC,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;IACvC;;;;;OAKG;IACH,wBAAwB,CAAC,EAAE,kBAAkB,CAAC;IAC9C;;;;;OAKG;IACH,qBAAqB,CAAC,EAAE,kBAAkB,CAAC;IAC3C;;;;;OAKG;IACH,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;CAC1B;AAED;;;GAGG;AACH,MAAM,WAAW,eAAe,CAAC,eAAe,SAAS,sBAAsB,GAAG,sBAAsB,CAAE,SAAQ,UAAU,CACxH,sBAAsB,EACtB,wBAAwB,EACxB,uBAAuB,EAAE,QAAQ;AACjC,sBAAsB,EACtB,wBAAwB,EACxB,uBAAuB,EAAE,SAAS;AAClC,eAAe,EACf,iBAAiB,CACpB;IACG,IAAI,SAAS,IAAI,MAAM,CAAC;IAExB;;;;;;;;OAQG;IACH,IAAI,EAAE,eAAe,GAAG,SAAS,CAAC;IAElC;;;;;OAKG;IACH,eAAe,CAAC,GAAG,EAAE,OAAO,CAAC,eAAe,CAAC,GAAG,IAAI,CAAC;IAErD;;;;;OAKG;IACH,4BAA4B,EAAE,cAAc,CAAC,QAAQ,CAAC,CAAC;IAEvD;;;;;;;;;;;OAWG;IACH,wBAAwB,IAAI,OAAO,CAAC,gBAAgB,GAAG,SAAS,CAAC,CAAC;IAElE;;;;;;OAMG;IACH,OAAO,CAAC,IAAI,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACtD"}

package/dist/sync/sync-peer/sync-peer-v1.d.mts

@@ -9,6 +9,7 @@ import { SyncSagaContextIbGib_V1 } from '../sync-saga-context/sync-saga-context-
 import { ConnectSyncPeerOpts, InitializeSyncPeerOpts, SyncPeerData_V1, SyncPeerRel8ns_V1, SyncPeerWitness } from './sync-peer-types.mjs';
 import { LightWitnessBase_V1 } from '../../witness/light-witness-base-v1.mjs';
 import { SyncSagaFrameDependencyGraph } from '../sync-types.mjs';
+import { KeystoneIbGib_V1 } from '../../keystone/keystone-types.mjs';
 /**
  * Abstract witness for talking to a Sync Peer (e.g. Remote Node or Local Simulator).
  *
@@ -51,6 +52,35 @@ export declare abstract class SyncPeer_V1<TConnectOpts extends ConnectSyncPeerOp
      * negotiation (e.g., WebSocket upgrade)
      */
     protected abstract connectImpl(opts: TConnectOpts): Promise<void>;
+    /**
+     * Pre-connect phase: establishes session identity.
+     *
+     * Shared base implementation:
+     * 1. Derives `sessionSecret = KDF(senderSecret, sagaId)`.
+     * 2. Creates session keystone genesis S (connect + sync pools) in `localSpace`.
+     * 3. Evolves `senderIdentity` → `newSenderIdentity` (I1) with a `sync`
+     *    claim targeting S^Stjp, stored in `localSpace`.
+     * 4. Delegates posting of both keystones to the receiver via the abstract
+     *    hook {@link postEstablishToReceiver} (peer-specific transport).
+     *
+     * Returns `undefined` (no-op) if no `senderIdentity` was provided in opts.
+     *
+     * @returns The session keystone genesis (S^Stjp) so the coordinator can
+     * hold a reference for subsequent per-turn signing. The name
+     * `newSenderIdentity` (I1) is scoped only within this method.
+     */
+    establishSessionIdentity(): Promise<KeystoneIbGib_V1 | undefined>;
+    /**
+     * Peer-specific hook: transmits `newSenderIdentity` (I1) and
+     * `sessionIdentity` (S) to the receiver's domain registry.
+     *
+     * - **Innerspace**: puts both into `receiverMetaspace` / `receiverSpace`.
+     * - **WebSocket**: HTTP POST to the domain provider's keystone endpoint.
+     */
+    protected abstract postEstablishToReceiver(opts: {
+        newSenderIdentity: KeystoneIbGib_V1;
+        sessionIdentity: KeystoneIbGib_V1;
+    }): Promise<void>;
     /**
      * base implementation just sets the opts property.
      *

package/dist/sync/sync-peer/sync-peer-v1.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"sync-peer-v1.d.mts","sourceRoot":"","sources":["../../../src/sync/sync-peer/sync-peer-v1.mts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,EAAE,QAAQ,EAAE,MAAM,iCAAiC,CAAC;AAM3D,OAAO,EAAE,cAAc,EAAE,MAAM,+CAA+C,CAAC;AAC/E,OAAO,EAAE,uBAAuB,EAAE,MAAM,kDAAkD,CAAC;AAC3F,OAAO,EACH,mBAAmB,EAAE,sBAAsB,EAAE,eAAe,EAC5D,iBAAiB,EAAE,eAAe,EACrC,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,mBAAmB,EAAE,MAAM,yCAAyC,CAAC;AAM9E,OAAO,EAAE,4BAA4B,EAAE,MAAM,mBAAmB,CAAC;AAOjE;;;;;;;;;GASG;AACH,8BAAsB,WAAW,CAC7B,YAAY,SAAS,mBAAmB,GAAG,mBAAmB,EAC9D,eAAe,SAAS,sBAAsB,GAAG,sBAAsB,CACzE,SAAQ,mBAAmB,CAAC,eAAe,EAAE,iBAAiB,CAC5D,YAAW,eAAe,CAAC,eAAe,CAAC;IAE3C,SAAS,CAAC,EAAE,EAAE,MAAM,CAA2B;IAExC,IAAI,EAAE,eAAe,GAAG,SAAS,CAAC;IAClC,4BAA4B,EAAG,cAAc,CAAC,QAAQ,CAAC,CAAC;IAE/D,IAAI,SAAS,IAAI,MAAM,CAItB;gBAEW,WAAW,EAAE,eAAe,EAAE,aAAa,CAAC,EAAE,iBAAiB;IAI9D,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAIxC;;;;;OAKG;IACU,OAAO,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAevD;;;;;;;;;OASG;IACH,SAAS,CAAC,QAAQ,CAAC,eAAe,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAErE;;;;;OAKG;IACH,SAAS,CAAC,QAAQ,CAAC,WAAW,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAEjE;;;;;;;OAOG;IACU,cAAc,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAa1D,eAAe,CAAC,GAAG,EAAE,OAAO,CAAC,eAAe,CAAC,GAAG,IAAI;cAsC3C,6BAA6B,CAAC,EAC1C,OAAO,EACP,eAAe,GAClB,EAAE;QACC,OAAO,EAAE,uBAAuB,CAAC;QACjC,eAAe,EAAE,4BAA4B,EAAE,CAAC;KACnD,GAAG,OAAO,CAAC,IAAI,CAAC;IAoCjB;;;;;;;;OAQG;IACY,OAAO,CAAC,OAAO,EAAE,uBAAuB,GAAG,OAAO,CAAC,uBAAuB,GAAG,SAAS,CAAC;IAkGtG;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACH,SAAS,CAAC,QAAQ,CAAC,kBAAkB,CAAC,OAAO,EAAE,uBAAuB,GAAG,OAAO,CAAC,uBAAuB,GAAG,SAAS,CAAC;IAErH;;;;;OAKG;cACa,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,GAAG,SAAS,CAAC;CAuB7E"}
+{"version":3,"file":"sync-peer-v1.d.mts","sourceRoot":"","sources":["../../../src/sync/sync-peer/sync-peer-v1.mts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,EAAE,QAAQ,EAAE,MAAM,iCAAiC,CAAC;AAM3D,OAAO,EAAE,cAAc,EAAE,MAAM,+CAA+C,CAAC;AAC/E,OAAO,EAAE,uBAAuB,EAAE,MAAM,kDAAkD,CAAC;AAC3F,OAAO,EACH,mBAAmB,EAAE,sBAAsB,EAAE,eAAe,EAC5D,iBAAiB,EAAE,eAAe,EACrC,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,mBAAmB,EAAE,MAAM,yCAAyC,CAAC;AAM9E,OAAO,EAAE,4BAA4B,EAAE,MAAM,mBAAmB,CAAC;AAEjE,OAAO,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AAQrE;;;;;;;;;GASG;AACH,8BAAsB,WAAW,CAC7B,YAAY,SAAS,mBAAmB,GAAG,mBAAmB,EAC9D,eAAe,SAAS,sBAAsB,GAAG,sBAAsB,CACzE,SAAQ,mBAAmB,CAAC,eAAe,EAAE,iBAAiB,CAC5D,YAAW,eAAe,CAAC,eAAe,CAAC;IAE3C,SAAS,CAAC,EAAE,EAAE,MAAM,CAA2B;IAExC,IAAI,EAAE,eAAe,GAAG,SAAS,CAAC;IAClC,4BAA4B,EAAG,cAAc,CAAC,QAAQ,CAAC,CAAC;IAE/D,IAAI,SAAS,IAAI,MAAM,CAItB;gBAEW,WAAW,EAAE,eAAe,EAAE,aAAa,CAAC,EAAE,iBAAiB;IAI9D,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAIxC;;;;;OAKG;IACU,OAAO,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAevD;;;;;;;;;OASG;IACH,SAAS,CAAC,QAAQ,CAAC,eAAe,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAErE;;;;;OAKG;IACH,SAAS,CAAC,QAAQ,CAAC,WAAW,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAEjE;;;;;;;;;;;;;;;;OAgBG;IACU,wBAAwB,IAAI,OAAO,CAAC,gBAAgB,GAAG,SAAS,CAAC;IA6D9E;;;;;;OAMG;IACH,SAAS,CAAC,QAAQ,CAAC,uBAAuB,CAAC,IAAI,EAAE;QAC7C,iBAAiB,EAAE,gBAAgB,CAAC;QACpC,eAAe,EAAE,gBAAgB,CAAC;KACrC,GAAG,OAAO,CAAC,IAAI,CAAC;IAEjB;;;;;;;OAOG;IACU,cAAc,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAa1D,eAAe,CAAC,GAAG,EAAE,OAAO,CAAC,eAAe,CAAC,GAAG,IAAI;cAsC3C,6BAA6B,CAAC,EAC1C,OAAO,EACP,eAAe,GAClB,EAAE;QACC,OAAO,EAAE,uBAAuB,CAAC;QACjC,eAAe,EAAE,4BAA4B,EAAE,CAAC;KACnD,GAAG,OAAO,CAAC,IAAI,CAAC;IAoCjB;;;;;;;;OAQG;IACY,OAAO,CAAC,OAAO,EAAE,uBAAuB,GAAG,OAAO,CAAC,uBAAuB,GAAG,SAAS,CAAC;IAkGtG;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACH,SAAS,CAAC,QAAQ,CAAC,kBAAkB,CAAC,OAAO,EAAE,uBAAuB,GAAG,OAAO,CAAC,uBAAuB,GAAG,SAAS,CAAC;IAErH;;;;;OAKG;cACa,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,GAAG,SAAS,CAAC;CAuB7E"}

package/dist/sync/sync-peer/sync-peer-v1.mjs

@@ -4,12 +4,15 @@
  * You are expected to implement concrete peer classes for concrete architecture.
  */
 import { extractErrorMsg } from '@ibgib/helper-gib/dist/helpers/utils-helper.mjs';
+import { getIbGibAddr } from '@ibgib/ts-gib/dist/helper.mjs';
 import { GLOBAL_LOG_A_LOT } from '../../core-constants.mjs';
 import { LightWitnessBase_V1 } from '../../witness/light-witness-base-v1.mjs';
 import { newupSubject } from '../../common/pubsub/subject/subject-helper.mjs';
 import { authenticateContext, authorizeContext, validateContextAndSagaFrame } from '../sync-saga-context/sync-saga-context-helpers.mjs';
 import { getFromSpace } from '../../witness/space/space-helper.mjs';
-import { getFullSyncSagaHistory } from '../sync-helpers.mjs';
+import { getFullSyncSagaHistory, deriveSessionSecret } from '../sync-helpers.mjs';
+import { KeystoneService_V1 } from '../../keystone/keystone-service-v1.mjs';
+import { KEYSTONE_VERB_SYNC } from '../../keystone/keystone-constants.mjs';
 const logalot = GLOBAL_LOG_A_LOT;
 const logalotControlDomain = false;
 const lcControlDomain = '[ControlDomain]';
@@ -67,6 +70,90 @@ export class SyncPeer_V1 extends LightWitnessBase_V1 {
             }
         }
     }
+    /**
+     * Pre-connect phase: establishes session identity.
+     *
+     * Shared base implementation:
+     * 1. Derives `sessionSecret = KDF(senderSecret, sagaId)`.
+     * 2. Creates session keystone genesis S (connect + sync pools) in `localSpace`.
+     * 3. Evolves `senderIdentity` → `newSenderIdentity` (I1) with a `sync`
+     *    claim targeting S^Stjp, stored in `localSpace`.
+     * 4. Delegates posting of both keystones to the receiver via the abstract
+     *    hook {@link postEstablishToReceiver} (peer-specific transport).
+     *
+     * Returns `undefined` (no-op) if no `senderIdentity` was provided in opts.
+     *
+     * @returns The session keystone genesis (S^Stjp) so the coordinator can
+     * hold a reference for subsequent per-turn signing. The name
+     * `newSenderIdentity` (I1) is scoped only within this method.
+     */
+    async establishSessionIdentity() {
+        const lc = `${this.lc}[${this.establishSessionIdentity.name}]`;
+        try {
+            if (logalot) {
+                console.log(`${lc} starting... (I: f2a1b3c4d5e6f7a8b9c0d1e2f3a4b526)`);
+            }
+            if (!this.opts) {
+                throw new Error(`(UNEXPECTED) this.opts falsy? Call initializeOpts first. (E: a1b2c3d4e5f6a7b8c9d0e1f2a3b4c526)`);
+            }
+            const { senderIdentity, fnSenderSecret, sagaId, localMetaspace, localSpace } = this.opts;
+            // No identity provided — anonymous sync, nothing to establish.
+            if (!senderIdentity || !fnSenderSecret) {
+                if (logalot) {
+                    console.log(`${lc} no senderIdentity/fnSenderSecret — skipping establish (I: f29348a77d1542326d14043ea4b69126)`);
+                }
+                return undefined;
+            }
+            if (!sagaId) {
+                throw new Error(`(UNEXPECTED) sagaId falsy? Must be set in initializeOpts before calling establishSessionIdentity. (E: c6ba389d51b8af07d82458f875cf9826)`);
+            }
+            const senderSecret = await fnSenderSecret();
+            if (!senderSecret) {
+                throw new Error(`senderSecret falsy. senderSecret required. (E: 1a8b0298bf78cbdf284b7988983b9826)`);
+            }
+            const sessionSecret = await deriveSessionSecret({ senderSecret, sagaId });
+            const keystoneSvc = new KeystoneService_V1();
+            // Step 1: Create S genesis in localSpace.
+            // Pool configs must be provided via opts (set by coordinator before calling establish).
+            if (!this.opts.sessionConnectPoolConfig) {
+                throw new Error(`(UNEXPECTED) opts.sessionConnectPoolConfig falsy? (E: 3351fd566eb8bbd2f821bb08c4419826)`);
+            }
+            if (!this.opts.sessionSyncPoolConfig) {
+                throw new Error(`(UNEXPECTED) opts.sessionSyncPoolConfig falsy? (E: dbffa810d9e7ff6079088deb5b8e7826)`);
+            }
+            const sessionIdentity = await keystoneSvc.genesis({
+                masterSecret: sessionSecret,
+                configs: [this.opts.sessionConnectPoolConfig, this.opts.sessionSyncPoolConfig],
+                frameDetails: this.opts.targetAddrs ? { targetAddrs: this.opts.targetAddrs } : undefined,
+                metaspace: localMetaspace,
+                space: localSpace,
+            });
+            const sessionIdentityAddr = getIbGibAddr({ ibGib: sessionIdentity });
+            // Step 2: Evolve senderIdentity → newSenderIdentity (I1) with sync claim.
+            const newSenderIdentity = await keystoneSvc.sign({
+                latestKeystone: senderIdentity,
+                masterSecret: senderSecret,
+                claim: {
+                    verb: KEYSTONE_VERB_SYNC,
+                    target: sessionIdentityAddr,
+                },
+                metaspace: localMetaspace,
+                space: localSpace,
+            });
+            // Step 3: Post both to the receiver (peer-specific).
+            await this.postEstablishToReceiver({ newSenderIdentity, sessionIdentity });
+            return sessionIdentity;
+        }
+        catch (error) {
+            console.error(`${lc} ${extractErrorMsg(error)}`);
+            throw error;
+        }
+        finally {
+            if (logalot) {
+                console.log(`${lc} complete.`);
+            }
+        }
+    }
     /**
      * base implementation just sets the opts property.
      *

package/dist/sync/sync-peer/sync-peer-v1.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"sync-peer-v1.mjs","sourceRoot":"","sources":["../../../src/sync/sync-peer/sync-peer-v1.mts"],"names":[],"mappings":"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"}
+{"version":3,"file":"sync-peer-v1.mjs","sourceRoot":"","sources":["../../../src/sync/sync-peer/sync-peer-v1.mts"],"names":[],"mappings":"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"}

package/dist/sync/sync-peer/sync-peer-websocket-receiver/sync-peer-websocket-receiver-types.d.mts

@@ -0,0 +1,30 @@
+/**
+ * @module sync-peer-websocket-receiver-types
+ */
+import { IbGib_V1 } from '@ibgib/ts-gib/dist/V1/types.mjs';
+import { SyncPeerData_V1, SyncPeerRel8ns_V1, InitializeSyncPeerOpts, ConnectSyncPeerOpts } from '../sync-peer-types.mjs';
+import { SyncSagaCoordinator } from '../../sync-saga-coordinator.mjs';
+/**
+ * Data for the SyncPeerWebSocketReceiver witness.
+ */
+export interface SyncPeerWebSocketReceiverData_V1 extends SyncPeerData_V1 {
+}
+/**
+ * Relations for the SyncPeerWebSocketReceiver witness.
+ */
+export interface SyncPeerWebSocketReceiverRel8ns_V1 extends SyncPeerRel8ns_V1 {
+}
+/**
+ * The SyncPeerWebSocketReceiver witness IbGib.
+ */
+export interface SyncPeerWebSocketReceiverIbGib_V1 extends IbGib_V1<SyncPeerWebSocketReceiverData_V1, SyncPeerWebSocketReceiverRel8ns_V1> {
+}
+export interface ConnectSyncPeerWebSocketReceiverOpts extends ConnectSyncPeerOpts {
+}
+export interface InitializeSyncPeerWebSocketReceiverOpts extends InitializeSyncPeerOpts {
+    /**
+     * The local SyncSagaCoordinator instance running on the receiver/server.
+     */
+    localCoordinator: SyncSagaCoordinator;
+}
+//# sourceMappingURL=sync-peer-websocket-receiver-types.d.mts.map

package/dist/sync/sync-peer/sync-peer-websocket-receiver/sync-peer-websocket-receiver-types.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-peer-websocket-receiver-types.d.mts","sourceRoot":"","sources":["../../../../src/sync/sync-peer/sync-peer-websocket-receiver/sync-peer-websocket-receiver-types.mts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,QAAQ,EAAE,MAAM,iCAAiC,CAAC;AAC3D,OAAO,EACH,eAAe,EAAE,iBAAiB,EAClC,sBAAsB,EAAE,mBAAmB,EAC9C,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAC;AAEtE;;GAEG;AACH,MAAM,WAAW,gCAAiC,SAAQ,eAAe;CACxE;AAED;;GAEG;AACH,MAAM,WAAW,kCAAmC,SAAQ,iBAAiB;CAC5E;AAED;;GAEG;AACH,MAAM,WAAW,iCAAkC,SAAQ,QAAQ,CAAC,gCAAgC,EAAE,kCAAkC,CAAC;CAAI;AAE7I,MAAM,WAAW,oCAAqC,SAAQ,mBAAmB;CAChF;AAED,MAAM,WAAW,uCAAwC,SAAQ,sBAAsB;IACnF;;OAEG;IACH,gBAAgB,EAAE,mBAAmB,CAAC;CACzC"}

package/dist/sync/sync-peer/sync-peer-websocket-receiver/sync-peer-websocket-receiver-types.mjs

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=sync-peer-websocket-receiver-types.mjs.map

package/dist/sync/sync-peer/sync-peer-websocket-receiver/sync-peer-websocket-receiver-types.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-peer-websocket-receiver-types.mjs","sourceRoot":"","sources":["../../../../src/sync/sync-peer/sync-peer-websocket-receiver/sync-peer-websocket-receiver-types.mts"],"names":[],"mappings":""}

package/dist/sync/sync-peer/sync-peer-websocket-receiver/sync-peer-websocket-receiver-v1.d.mts

@@ -0,0 +1,66 @@
+/**
+ * @module sync-peer-websocket-receiver-v1
+ */
+import { IbGib_V1 } from '@ibgib/ts-gib/dist/V1/types.mjs';
+import { SyncPeer_V1 } from '../sync-peer-v1.mjs';
+import { SyncSagaContextIbGib_V1 } from '../../sync-saga-context/sync-saga-context-types.mjs';
+import { IbGibSpaceAny } from '../../../witness/space/space-base-v1.mjs';
+import { ConnectSyncPeerWebSocketReceiverOpts, InitializeSyncPeerWebSocketReceiverOpts, SyncPeerWebSocketReceiverData_V1, SyncPeerWebSocketReceiverRel8ns_V1, SyncPeerWebSocketReceiverIbGib_V1 } from './sync-peer-websocket-receiver-types.mjs';
+import { KeystoneIbGib_V1 } from '../../../keystone/keystone-types.mjs';
+/**
+ * A platform-agnostic interface wrapping runtime-specific WebSocket stream operations.
+ */
+export interface IWebSocketWrapper {
+    send(data: string): void;
+    onMessage(callback: (data: string) => void): void;
+    onClose(callback: () => void): void;
+}
+/**
+ * Platform-agnostic WebSocket Receiver Peer.
+ *
+ * Fully encapsulates the multi-turn cryptographic challenge connect and runtime
+ * turn routing.
+ */
+export declare class SyncPeerWebSocketReceiver_V1 extends SyncPeer_V1<ConnectSyncPeerWebSocketReceiverOpts, InitializeSyncPeerWebSocketReceiverOpts> implements SyncPeerWebSocketReceiverIbGib_V1 {
+    protected lc: string;
+    get classname(): string;
+    data: SyncPeerWebSocketReceiverData_V1 | undefined;
+    rel8ns: SyncPeerWebSocketReceiverRel8ns_V1 | undefined;
+    protected socketWrapper?: IWebSocketWrapper;
+    protected isAuthenticated: boolean;
+    protected challengeUuid?: string;
+    protected demandedIds?: string[];
+    protected sessionS_tjpAddr?: string;
+    constructor(initialData: SyncPeerWebSocketReceiverData_V1, initialRel8ns?: SyncPeerWebSocketReceiverRel8ns_V1);
+    /**
+     * Wires the peer receiver to the platform-specific socket stream and
+     * triggers the connect.
+     */
+    bindSocket(socketWrapper: IWebSocketWrapper): Promise<void>;
+    protected preConnectCheck(opts: ConnectSyncPeerWebSocketReceiverOpts): Promise<void>;
+    protected connectImpl(opts: ConnectSyncPeerWebSocketReceiverOpts): Promise<void>;
+    protected postEstablishToReceiver(opts: {
+        newSenderIdentity: KeystoneIbGib_V1;
+        sessionIdentity: KeystoneIbGib_V1;
+    }): Promise<void>;
+    protected sendContextRequest(context: SyncSagaContextIbGib_V1): Promise<SyncSagaContextIbGib_V1 | undefined>;
+    /** Helper to load a Session Keystone from storage */
+    protected getSessionKeystone(sAddr: string): Promise<KeystoneIbGib_V1>;
+    protected ensureLocalTempSpace(): Promise<IbGibSpaceAny>;
+    /**
+     * Entry point for processing raw text frames received over the active WebSocket connection.
+     */
+    handleIncomingMessage(messageText: string): Promise<void>;
+    /**
+     * Handles the multi-turn cryptographic challenge connect messages.
+     */
+    protected handleConnectFrame(msg: any): Promise<void>;
+    /**
+     * Executes the transaction turn through the local SyncSagaCoordinator.
+     */
+    handleIncomingSyncRequest({ context, payloadIbGibsControl, }: {
+        context: SyncSagaContextIbGib_V1;
+        payloadIbGibsControl?: IbGib_V1[];
+    }): Promise<SyncSagaContextIbGib_V1 | undefined>;
+}
+//# sourceMappingURL=sync-peer-websocket-receiver-v1.d.mts.map

package/dist/sync/sync-peer/sync-peer-websocket-receiver/sync-peer-websocket-receiver-v1.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-peer-websocket-receiver-v1.d.mts","sourceRoot":"","sources":["../../../../src/sync/sync-peer/sync-peer-websocket-receiver/sync-peer-websocket-receiver-v1.mts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,EAAE,QAAQ,EAAE,MAAM,iCAAiC,CAAC;AAG3D,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAAE,uBAAuB,EAAE,MAAM,qDAAqD,CAAC;AAE9F,OAAO,EAAE,aAAa,EAAE,MAAM,0CAA0C,CAAC;AAEzE,OAAO,EACH,oCAAoC,EACpC,uCAAuC,EACvC,gCAAgC,EAAE,kCAAkC,EACpE,iCAAiC,EACpC,MAAM,0CAA0C,CAAC;AAClD,OAAO,EAAE,gBAAgB,EAAE,MAAM,sCAAsC,CAAC;AAKxE;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAC9B,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,SAAS,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI,CAAC;IAClD,OAAO,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,IAAI,CAAC;CACvC;AAED;;;;;GAKG;AACH,qBAAa,4BACT,SAAQ,WAAW,CAAC,oCAAoC,EAAE,uCAAuC,CACjG,YAAW,iCAAiC;IAE5C,UAAmB,EAAE,EAAE,MAAM,CAA4C;IAEzE,IAAa,SAAS,IAAI,MAAM,CAE/B;IAEO,IAAI,EAAE,gCAAgC,GAAG,SAAS,CAAC;IACnD,MAAM,EAAE,kCAAkC,GAAG,SAAS,CAAC;IAE/D,SAAS,CAAC,aAAa,CAAC,EAAE,iBAAiB,CAAC;IAG5C,SAAS,CAAC,eAAe,UAAS;IAClC,SAAS,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IACjC,SAAS,CAAC,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACjC,SAAS,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;gBAGhC,WAAW,EAAE,gCAAgC,EAC7C,aAAa,CAAC,EAAE,kCAAkC;IAKtD;;;OAGG;IACU,UAAU,CAAC,aAAa,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;cAqB/C,eAAe,CAAC,IAAI,EAAE,oCAAoC,GAAG,OAAO,CAAC,IAAI,CAAC;cAI1E,WAAW,CAAC,IAAI,EAAE,oCAAoC,GAAG,OAAO,CAAC,IAAI,CAAC;cAItE,uBAAuB,CAAC,IAAI,EAAE;QACnD,iBAAiB,EAAE,gBAAgB,CAAC;QACpC,eAAe,EAAE,gBAAgB,CAAC;KACrC,GAAG,OAAO,CAAC,IAAI,CAAC;cAIQ,kBAAkB,CAAC,OAAO,EAAE,uBAAuB,GAAG,OAAO,CAAC,uBAAuB,GAAG,SAAS,CAAC;IAI3H,qDAAqD;cACrC,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;cAU5D,oBAAoB,IAAI,OAAO,CAAC,aAAa,CAAC;IA8B9D;;OAEG;IACU,qBAAqB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAuDtE;;OAEG;cACa,kBAAkB,CAAC,GAAG,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC;IAmE3D;;OAEG;IACU,yBAAyB,CAAC,EACnC,OAAO,EACP,oBAAyB,GAC5B,EAAE;QACC,OAAO,EAAE,uBAAuB,CAAC;QACjC,oBAAoB,CAAC,EAAE,QAAQ,EAAE,CAAC;KACrC,GAAG,OAAO,CAAC,uBAAuB,GAAG,SAAS,CAAC;CA8CnD"}