@yanlinglabs/winter-agent-sdk 0.0.8 → 0.0.10

package/dist/{index-9e98bg1r.js → index-qst9rwbb.js}

@@ -236,6 +236,19 @@ function acquireLease(lockPath) {
   writeLeaseInfoReplacing(lockPath, fresh);
   return fresh;
 }
+function releaseLease(lockPath) {
+  const existing = readLeaseInfo(lockPath);
+  if (existing === null || existing.pid !== process.pid)
+    return false;
+  try {
+    unlinkSync(lockPath);
+  } catch (err) {
+    if (err.code === "ENOENT")
+      return false;
+    throw err;
+  }
+  return true;
+}
 
 // src/store/session-store.ts
 import {
@@ -702,6 +715,10 @@ class WinterCompatibilitySessionStore2 {
     acquireLease(lockPath);
     chmodSync(lockPath, 384);
   }
+  async releaseSessionLease(key) {
+    const lockPath = `${sessionStem(this.winterHome, key.projectKey, key.sessionId)}.lock`;
+    return releaseLease(lockPath);
+  }
 }
 
 export { BRAND_TOKEN_RE2, FIRST_PARTY_ORIGINATORS2, WINTER_BRAND2, resolveBrand2, envName2, mcpToolName2, userAgent2, isUnset2, resolveWinterHome2, resolveKeychainServiceForProfile2, WinterStoreError2, WinterStoreLeaseError2, DIALECT_RECORD_ENTRY_TYPE2, PROVIDER_STATE_FILE_SUFFIX2, WinterCompatibilitySessionStore2 };

package/dist/index.js

@@ -14,7 +14,7 @@ import {
   DIALECT_RECORD_ENTRY_TYPE2,
   PROVIDER_STATE_FILE_SUFFIX2,
   WinterCompatibilitySessionStore2
-} from "./index-9e98bg1r.js";
+} from "./index-qst9rwbb.js";
 import {
   deliveryUncertain2,
   refused2,
@@ -961,7 +961,7 @@ function query(args) {
   return gen;
 }
 // src/version.ts
-var SDK_VERSION = "0.0.8";
+var SDK_VERSION = "0.0.10";
 // src/paths/project-key.ts
 var TRANSCRIPT_PROJECT_KEY_MAX_LENGTH = 64;
 var VENDOR_PROJECT_KEY_PATTERN = /^[A-Za-z0-9_-]{1,64}$/;

package/dist/store/leases.d.ts

@@ -13,3 +13,15 @@ export declare function isPidAlive(pid: number): boolean;
 export declare function writeAllSync(fd: number, buf: Buffer): void;
 export declare function readLeaseInfo(lockPath: string): LeaseInfo | null;
 export declare function acquireLease(lockPath: string): LeaseInfo;
+/**
+ * Releases the lease at `lockPath` -- but ONLY when THIS process currently holds it. Returns `true`
+ * when it did (and the lock file is now gone), `false` for every other case: no lease file at all,
+ * an unparseable one, or one a genuinely different pid holds. Idempotent -- a second call after a
+ * successful release finds nothing to release and returns `false`, never throws.
+ *
+ * Deliberately NOT "release whatever is there": a caller that raced with someone else's fresh
+ * acquire (this pid died and was stolen from, however unlikely between two calls in the same
+ * process) must never delete the NEW holder's lease out from under it. The pid check is the whole
+ * safety property.
+ */
+export declare function releaseLease(lockPath: string): boolean;

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

@@ -108,4 +108,27 @@ export declare class WinterCompatibilitySessionStore implements SessionStore {
         projectKey: string;
         sessionId: string;
     }): Promise<void>;
+    /**
+     * Phase 10b Lane S, S8 (W18-5): releases the writer lease `acquireSessionLease`/`append`'s own
+     * opening sequence took, but ONLY when THIS pid holds it -- `leases.ts`'s own `releaseLease` is
+     * the entire safety property, reproduced here just for the routing: same-pid, idempotent, never
+     * another pid's lease. The router calls this for a WINTER destination, after its own write-ahead
+     * producer record lands and BEFORE `confirmInit` -- so the daemon's pid writes NOTHING to the
+     * canonical transcript once the winter child holds the lease (W18-5's own ordering constraint).
+     *
+     * Deliberately NOT part of the exported `SessionStore` type (same posture as
+     * `acquireSessionLease` immediately above) -- lives only on this concrete class.
+     *
+     * Fix round 1 (reviewer #2, minor): the OTHER half of `append`'s own load-bearing invariant
+     * (see that method's own header comment). This method's body is synchronous too (`releaseLease`
+     * is a single plain fs call, no `await`), so a `releaseSessionLease` call and a same-process
+     * `append` call can never interleave mid-way -- whichever one the event loop runs next, it runs
+     * to completion before the other can start. That is what makes "release between two appends"
+     * safe without any lock object anywhere in this class: JS's run-to-completion is the lock, for as
+     * long as neither method's synchronous stretch grows an `await`.
+     */
+    releaseSessionLease(key: {
+        projectKey: string;
+        sessionId: string;
+    }): Promise<boolean>;
 }

package/dist/tools/index.js

@@ -8,7 +8,7 @@ import {
 import {
   resolveWinterHome2,
   WinterCompatibilitySessionStore2
-} from "../index-9e98bg1r.js";
+} from "../index-qst9rwbb.js";
 
 // src/tools/schemas.ts
 var SEND_MESSAGE_TO_MAX = 300;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yanlinglabs/winter-agent-sdk",
-  "version": "0.0.8",
+  "version": "0.0.10",
   "license": "MIT",
   "type": "module",
   "engines": {
@@ -45,15 +45,15 @@
     }
   },
   "dependencies": {
-    "@yanlinglabs/winter-provider-catalog": "0.0.8"
+    "@yanlinglabs/winter-provider-catalog": "0.0.10"
   },
   "optionalDependencies": {
-    "@yanlinglabs/winter-agent-sdk-darwin-arm64": "0.0.8"
+    "@yanlinglabs/winter-agent-sdk-darwin-arm64": "0.0.10"
   },
   "devDependencies": {
     "@types/node": "^26.4.0",
-    "@yanlinglabs/winter-conformance": "0.0.8",
-    "winter-agent-runtime": "0.0.8"
+    "@yanlinglabs/winter-conformance": "0.0.10",
+    "winter-agent-runtime": "0.0.10"
   },
   "scripts": {}
 }