@rivus/agent-kit-collab 0.0.0 → 0.3.0

package/dist/process-lock.d.ts

@@ -0,0 +1,58 @@
+import { Result } from "@rivus/agent-kit/catalog";
+import { Platform } from "@rivus/agent-kit/platform";
+//#region src/process-lock/application/ports.d.ts
+/**
+ * The part of Platform a process lock uses. With `sqlite` the lock is an exclusive SQLite lock; without it, a lock
+ * file. `process` supplies the identity recorded for diagnostics and, for lock files, judged for liveness; it throws
+ * on win32, which the lock does not support.
+ */
+type ProcessLockPlatform = Pick<Platform, "fs" | "process" | "clock" | "sqlite">;
+//#endregion
+//#region src/process-lock/application/holder.d.ts
+/** Who holds or held a process lock, as recorded when it was acquired; it may be stale. */
+interface ProcessLockHolder {
+  readonly host: string;
+  readonly bootId: string;
+  readonly pid: number;
+  readonly startTime: number;
+  /** Wall-clock milliseconds. */
+  readonly acquiredAt: number;
+}
+//#endregion
+//#region src/process-lock/application/acquire-process-lock.d.ts
+interface ProcessLockOptions {
+  /** Keep trying while another process holds the lock, instead of returning `ProcessLockHeld` at once. */
+  readonly wait?: boolean;
+  /** How often a waiting call tries again, in milliseconds; 50 by default. */
+  readonly retryMs?: number;
+  /** Aborting stops waiting and rejects with `signal.reason`; a lock taken after the abort is released first. */
+  readonly signal?: AbortSignal;
+}
+/** A held process lock. Releasing it is the caller's job; the lock also ends when the process exits. */
+interface ProcessLock {
+  readonly path: string;
+  /** `sqlite` when the platform has SQLite; `file` is the weaker fallback (see `acquireProcessLock`). */
+  readonly mechanism: "sqlite" | "file";
+  readonly holder: ProcessLockHolder;
+  /** Releases the lock; later calls do nothing. */
+  release(): Promise<void>;
+}
+/** Another process, or another acquisition in this one, holds the lock. */
+interface ProcessLockHeld {
+  readonly _tag: "ProcessLockHeld";
+  readonly path: string;
+  /** What the holder recorded for diagnostics; it may be stale, and is absent when nothing readable was recorded. */
+  readonly holder: ProcessLockHolder | undefined;
+}
+/**
+ * A single-instance lock on `path`, which must be in an existing local directory (not NFS). With `platform.sqlite`,
+ * `path` is a SQLite database held with `locking_mode=EXCLUSIVE`: the kernel releases it when the process exits or
+ * crashes, at once, and nothing is ever reclaimed. The holder's identity goes into `<path>.holder` for diagnostics
+ * only. Without SQLite, `path` is a lock file that holds the identity itself; a lock file whose holder died is
+ * reclaimed on the next attempt, which needs the holder on this host (see `tryFileLock` for the remaining gaps).
+ *
+ * Supports darwin and linux, where the platform can identify processes.
+ */
+export declare function acquireProcessLock(platform: ProcessLockPlatform, path: string, options?: ProcessLockOptions): Promise<Result<ProcessLock, ProcessLockHeld>>;
+//#endregion
+export type { ProcessLock, ProcessLockHeld, ProcessLockHolder, ProcessLockOptions, ProcessLockPlatform };

package/dist/process-lock.js

@@ -0,0 +1,2 @@
+import { t as acquireProcessLock } from "./acquire-process-lock-A0oYDN9m.js";
+export { acquireProcessLock };

package/package.json

@@ -1,16 +1,76 @@
 {
   "name": "@rivus/agent-kit-collab",
-  "version": "0.0.0",
-  "description": "Placeholder; usable releases are published by GitHub Actions.",
+  "version": "0.3.0",
+  "description": "Collaboration primitives between coding agents: fenced leases, single-instance process locks and keyed scheduling lanes.",
   "license": "MIT",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/PerfectPan/agent-kit.git",
     "directory": "packages/agent-kit-collab"
   },
+  "type": "module",
+  "sideEffects": false,
+  "exports": {
+    "./lease": {
+      "types": "./dist/lease.d.ts",
+      "default": "./dist/lease.js"
+    },
+    "./lanes": {
+      "types": "./dist/lanes.d.ts",
+      "default": "./dist/lanes.js"
+    },
+    "./process-lock": {
+      "types": "./dist/process-lock.d.ts",
+      "default": "./dist/process-lock.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist"
+  ],
+  "engines": {
+    "node": ">=22.13"
+  },
   "publishConfig": {
-    "access": "public",
-    "registry": "https://registry.npmjs.org/"
+    "access": "public"
+  },
+  "dependencies": {
+    "zod": "^4.6.5"
+  },
+  "devDependencies": {
+    "@arethetypeswrong/cli": "0.18.5",
+    "@effect/vitest": "4.0.1",
+    "@perfectpan/lint-config": "github:PerfectPan/lint-config#v0.3.2",
+    "@rivus/agent-kit": "0.3.0",
+    "@size-limit/preset-small-lib": "14.1.0",
+    "@types/node": "24.19.1",
+    "effect": "4.0.1",
+    "oxc-parser": "0.153.0",
+    "oxfmt": "0.71.0",
+    "oxlint": "1.86.0",
+    "oxlint-tsgolint": "7.0.2003",
+    "publint": "0.3.25",
+    "size-limit": "14.1.0",
+    "tsdown": "0.23.0",
+    "typescript": "7.0.2",
+    "vitest": "5.0.3"
+  },
+  "peerDependencies": {
+    "@rivus/agent-kit": "^0.3.0",
+    "effect": "4.0.1"
+  },
+  "peerDependenciesMeta": {
+    "effect": {
+      "optional": true
+    }
   },
-  "files": []
-}
+  "scripts": {
+    "build": "tsdown",
+    "check:package": "publint --strict --pack npm && attw --pack . --profile esm-only && size-limit 2>&1 && node scripts/check-dist.ts",
+    "lint": "oxlint",
+    "typecheck": "tsc -p src/tsconfig.json && tsc -p test/tsconfig.json && tsc -p tsconfig.json",
+    "test": "vitest run",
+    "format": "oxfmt -c node_modules/@perfectpan/lint-config/oxfmt.json . '!CHANGELOG.*'",
+    "format:check": "oxfmt -c node_modules/@perfectpan/lint-config/oxfmt.json --check . '!CHANGELOG.*'"
+  }
+}