@githolon/runtime 0.112.0 → 0.112.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@githolon/runtime",
-  "version": "0.112.0",
+  "version": "0.112.1",
   "type": "module",
   "description": "The portable Nomos application runtime, reception contracts, and Node/browser runners.",
   "license": "SEE LICENSE IN LICENSE.md",

package/runner/node-entry.mjs

@@ -7290,7 +7290,7 @@ function runtimeKernelPort(engine) {
             case: "resolveRef",
             value: create(ResolveRefRequestSchema, {
               repo: workspaceRepositoryPath(workspace),
-              reference: `refs/heads/${branch}`
+              reference: branch.startsWith("refs/") ? branch : `refs/heads/${branch}`
             })
           }
         })
@@ -8272,7 +8272,6 @@ function gitCustodyDesk(kernel, fetchImpl = fetch, observe, phaseStarted) {
       return acquired;
     },
     deepenMain(workspace, ledger) {
-      if (ledger.operatorCustody !== true) return Promise.resolve({ changed: false, complete: true });
       return acquiring(workspace, ledger, "deepen-main", async () => {
         if (resolveRef(workspace, branchRef("main")) === void 0) {
           const acquired = await acquireMain(workspace, ledger);
@@ -13601,6 +13600,7 @@ var PeerPlatformShell = class {
       // one constitutional genesis offer. WorkspaceAccessDesk decides whether
       // that exact request may proceed against the unborn kernel mount.
       async openCustody(workspace) {
+        if (physical.openLocalCustody) return physical.openLocalCustody(workspace);
         await custody.acquireMain(workspace, await ledgerFor(workspace));
         return {};
       },
@@ -13616,7 +13616,12 @@ var PeerPlatformShell = class {
       },
       persistBornCustody: (effect) => physical.persistBornCustody(effect),
       retainFrontier: (effect) => physical.retainFrontier(effect),
-      ...physical.completeHistoryInLocalCustody ? {
+      ...physical.advanceHistory ? {
+        advanceHistory: (workspace, capability) => {
+          const credential = capability ? this.#credentials.authToken(capability) : authToken;
+          return physical.advanceHistory(workspace, credential && new TextDecoder().decode(credential));
+        }
+      } : physical.completeHistoryInLocalCustody ? {
         // The kernel mounts a shallow working copy; the peer's own Git custody is deep.
         // One bounded slice per call; the Peer Office decides whether and when to take the next.
         async advanceHistory(workspace) {
@@ -22969,10 +22974,11 @@ var LiveCorrespondenceDesk = class {
       failures: 0,
       origin: origin2,
       publisher: !binding.cloudBound,
-      published: !binding.cloudBound ? head : void 0
+      published: !binding.cloudBound ? head : void 0,
+      wasResident: this.kernel.isResident(binding.workspace) !== false
     };
     this.#links.set(binding.workspace, link);
-    this.#open(link);
+    if (link.wasResident) this.#open(link);
   }
   changed(workspace) {
     const link = this.#links.get(workspace);
@@ -23129,9 +23135,11 @@ var LiveCorrespondenceDesk = class {
     let wake;
     for (const link of this.#links.values()) {
       if (this.kernel.isResident(link.binding.workspace) === false) {
-        this.disconnect(link.binding.workspace);
+        if (link.wasResident) this.disconnect(link.binding.workspace);
+        else wake = wake === void 0 || wake > 250n ? 250n : wake;
         continue;
       }
+      link.wasResident = true;
       if (link.state === "opening" && now >= link.due) {
         this.#effect(link, { case: "close", value: true });
         link.state = "closed";
@@ -30812,7 +30820,7 @@ var executeGitPushEffect = async (effect, fetchImpl) => {
     });
   }
 };
-async function drivePeerFrame(runner, initialFrame, fetchImpl = globalThis.fetch, custody, bornCustody, credentialRefresh, yieldWakeToCaller = false, deviceIdentity, lawPackage, yieldLocalReadToCaller = false, yieldHistoryToCaller = false) {
+async function drivePeerFrame(runner, initialFrame, fetchImpl = globalThis.fetch, custody, bornCustody, credentialRefresh, yieldWakeToCaller = false, deviceIdentity, lawPackage, yieldLocalReadToCaller = false, yieldHistoryToCaller = false, performExternalEffect) {
   const persistBornCustody = bornCustody ?? (custody?.persistBornCustody ? (effect) => custody.persistBornCustody(effect) : void 0);
   let responseFrame = runner.handleFrame(initialFrame);
   const satisfied = /* @__PURE__ */ new Set();
@@ -30948,12 +30956,10 @@ async function drivePeerFrame(runner, initialFrame, fetchImpl = globalThis.fetch
     if (pending.effect.case === "historyAcquisition" && (yieldHistoryToCaller || !custody?.advanceHistory)) {
       return responseFrame;
     }
-    if (pending.effect.case === "refreshCredential" && credentialRefresh === externalPeerEffect) return responseFrame;
-    if (pending.effect.case === "deviceIdentity" && deviceIdentity === externalPeerEffect) return responseFrame;
-    if (pending.effect.case === "lawPackage" && lawPackage === externalPeerEffect) return responseFrame;
     if (pending.effect.case === "wake" && yieldWakeToCaller) return responseFrame;
-    if (pending.effect.case === "consoleEnrolment") return responseFrame;
-    const receipt = pending.effect.case === "http" ? await executeHttpEffect(pending.effect.value, fetchImpl) : pending.effect.case === "gitFetch" ? await executeGitFetchWithAlongside(pending.effect.value, fetchImpl) : pending.effect.case === "gitPush" ? await executeGitPushEffect(pending.effect.value, fetchImpl) : pending.effect.case === "persistBornCustody" ? create(PeerEffectReceiptSchema, {
+    const external = pending.effect.case === "refreshCredential" && credentialRefresh === externalPeerEffect || pending.effect.case === "deviceIdentity" && deviceIdentity === externalPeerEffect || pending.effect.case === "lawPackage" && lawPackage === externalPeerEffect || pending.effect.case === "consoleEnrolment";
+    if (external && !performExternalEffect) return responseFrame;
+    const receipt = external ? await performExternalEffect(pending) : pending.effect.case === "http" ? await executeHttpEffect(pending.effect.value, fetchImpl) : pending.effect.case === "gitFetch" ? await executeGitFetchWithAlongside(pending.effect.value, fetchImpl) : pending.effect.case === "gitPush" ? await executeGitPushEffect(pending.effect.value, fetchImpl) : pending.effect.case === "persistBornCustody" ? create(PeerEffectReceiptSchema, {
       effectId: pending.effect.value.effectId,
       outcome: {
         case: "bornCustodyPersisted",
@@ -30981,7 +30987,7 @@ async function drivePeerFrame(runner, initialFrame, fetchImpl = globalThis.fetch
 async function executeHistoryAcquisitionEffect(effect, custody) {
   try {
     if (!custody.advanceHistory) throw new Error("platform shell has no history acquisition capability");
-    const progress = await custody.advanceHistory(effect.workspace);
+    const progress = await custody.advanceHistory(effect.workspace, effect.credentialCapability);
     return create(PeerEffectReceiptSchema, {
       effectId: effect.effectId,
       outcome: {
@@ -31212,7 +31218,7 @@ var targetOf = (frame) => {
   };
 };
 function openPeerOfficeHost(kernel, shell, fetchImpl = globalThis.fetch, maintenanceSettled, postEvent2 = () => {
-}, credentialRefresh, yieldWakeToCaller = false, deviceIdentity, lawPackage) {
+}, credentialRefresh, yieldWakeToCaller = false, deviceIdentity, lawPackage, performExternalEffect) {
   let runner;
   const configuredOrigins = new Set((shell.providerOrigins?.() ?? []).map((provider) => originOf(provider)).filter((origin2) => origin2 !== void 0));
   const permittedSocket = (url) => {
@@ -31221,10 +31227,10 @@ function openPeerOfficeHost(kernel, shell, fetchImpl = globalThis.fetch, mainten
     return origin2 !== void 0 && configuredOrigins.has(origin2);
   };
   const sockets = socketEffects(
-    (frame) => drivePeerFrame(runner, frame, fetchImpl, shell.custodyPort(), void 0, void 0, false, deviceIdentity, lawPackage),
+    (frame) => drivePeerFrame(runner, frame, fetchImpl, shell.custodyPort(), void 0, void 0, false, deviceIdentity, lawPackage, false, false, performExternalEffect),
     permittedSocket
   );
-  const credentials = credentialEffects((frame) => drivePeerFrame(runner, frame, fetchImpl, shell.custodyPort(), void 0, credentialRefresh, false, deviceIdentity, lawPackage), credentialRefresh);
+  const credentials = credentialEffects((frame) => drivePeerFrame(runner, frame, fetchImpl, shell.custodyPort(), void 0, credentialRefresh, false, deviceIdentity, lawPackage, false, false, performExternalEffect), credentialRefresh);
   runner = createPeerOfficeFrameRunner(
     kernel,
     shell.credentials(),
@@ -31249,7 +31255,10 @@ function openPeerOfficeHost(kernel, shell, fetchImpl = globalThis.fetch, mainten
         credentialRefresh,
         false,
         deviceIdentity,
-        lawPackage
+        lawPackage,
+        false,
+        false,
+        performExternalEffect
       );
     },
     shell.peerDeskStore()
@@ -31301,7 +31310,10 @@ function openPeerOfficeHost(kernel, shell, fetchImpl = globalThis.fetch, mainten
         credentialRefresh,
         yieldWakeToCaller,
         deviceIdentity,
-        lawPackage
+        lawPackage,
+        false,
+        false,
+        performExternalEffect
       );
     },
     settleRetention: (withinMillis) => runner.settleRetention(withinMillis),