@yaklabs-ai/plugin-sdk 0.53.0 → 0.54.1

package/dist/fs.d.ts

@@ -10,6 +10,9 @@ export declare const chmod: typeof nodeFsp.chmod;
 
 export declare const chown: typeof nodeFsp.chown;
 
+/** Receives the committed paths under the folder it subscribed to. */
+export declare type CommittedChangeListener = (paths: readonly string[]) => void;
+
 export { constants }
 
 export declare const copyFile: typeof nodeFsp.copyFile;
@@ -59,6 +62,21 @@ declare const _default: {
 };
 export default _default;
 
+/**
+ * Report paths whose writes have landed: created, replaced, moved or removed. A path is a source
+ * that changed, never a claim that anything is gone. Never throws: a subscriber's failure goes
+ * to its own `warn`, and a failing `warn` is ignored, because a report cannot undo the write.
+ */
+export declare function emitCommittedChanges(paths: readonly string[]): void;
+
+/**
+ * Run `work` after every task queued earlier under `key` in this process, and
+ * before every task queued later. Nothing touches the filesystem: `key` is an
+ * opaque string, and there is no cross-process lock. Use it when this process
+ * is the only writer and only same-process ordering matters.
+ */
+export declare function enqueueInProcess<T>(key: string, work: () => Promise<T>): Promise<T>;
+
 export { FileHandle }
 
 export declare const glob: typeof nodeFsp.glob;
@@ -124,6 +142,14 @@ export declare const stat: typeof nodeFsp.stat;
 
 export declare const statfs: typeof nodeFsp.statfs;
 
+/**
+ * Hear about writes any plugin in this process reports with {@link emitCommittedChanges} under
+ * `folder`. `listener` receives the absolute, deduplicated paths inside `folder` (the folder
+ * itself included), synchronously from the emit. A throw from `listener` goes to `warn`. Returns
+ * the function that stops delivery.
+ */
+export declare function subscribeCommittedChanges(folder: string, listener: CommittedChangeListener, warn: (error: unknown) => void): () => void;
+
 export declare const symlink: typeof nodeFsp.symlink;
 
 export declare const truncate: typeof nodeFsp.truncate;

package/dist/fs.js

@@ -2,7 +2,7 @@
 import { Buffer as Buffer3 } from "node:buffer";
 import { constants } from "node:fs";
 import * as nodeFsp from "node:fs/promises";
-import { basename, dirname, join, resolve as resolve2 } from "node:path";
+import { basename, dirname, join, resolve as resolve3 } from "node:path";
 
 // packages/plugin-sdk/dist/fs/handle.js
 import { Buffer as Buffer2 } from "node:buffer";
@@ -611,6 +611,50 @@ function currentKayFsBackend() {
   return globalThis[KAY_FS_BACKEND];
 }
 
+// packages/plugin-sdk/dist/fs/mutation-queue.js
+var mutationQueues = /* @__PURE__ */ new Map();
+async function enqueueInProcess(key, work) {
+  const previous = mutationQueues.get(key) ?? Promise.resolve();
+  const next = previous.catch(() => void 0).then(work);
+  mutationQueues.set(key, next);
+  try {
+    return await next;
+  } finally {
+    if (mutationQueues.get(key) === next)
+      mutationQueues.delete(key);
+  }
+}
+
+// packages/plugin-sdk/dist/fs/committed-changes.js
+import { isAbsolute, relative, resolve as resolve2 } from "node:path";
+var subscriptions = /* @__PURE__ */ new Set();
+function subscribeCommittedChanges(folder, listener, warn) {
+  const subscription = { folder: resolve2(folder), listener, warn };
+  subscriptions.add(subscription);
+  return () => {
+    subscriptions.delete(subscription);
+  };
+}
+function emitCommittedChanges(paths) {
+  const resolved = [...new Set(paths.map((path) => resolve2(path)))];
+  for (const subscription of subscriptions) {
+    const owned = resolved.filter((path) => {
+      const fromFolder = relative(subscription.folder, path);
+      return fromFolder === "" || !fromFolder.startsWith("..") && !isAbsolute(fromFolder);
+    });
+    if (owned.length === 0)
+      continue;
+    try {
+      subscription.listener(owned);
+    } catch (error) {
+      try {
+        subscription.warn(error);
+      } catch {
+      }
+    }
+  }
+}
+
 // packages/plugin-sdk/dist/fs/index.js
 function route(node, host) {
   return ((...args) => {
@@ -766,7 +810,7 @@ var glob2 = route(() => nodeFsp.glob, (backend, pattern, options) => {
       pattern,
       wire === void 0 ? {} : { ...wire, ...cwd === void 0 ? {} : { cwd: wirePath(cwd) } }
     ], {
-      paths: [cwd === void 0 ? resolve2(".") : keyPath(cwd)],
+      paths: [cwd === void 0 ? resolve3(".") : keyPath(cwd)],
       timeoutMs: timeoutOf(options),
       walksTree: true
     });
@@ -864,6 +908,8 @@ export {
   copyFile2 as copyFile,
   cp2 as cp,
   index_default as default,
+  emitCommittedChanges,
+  enqueueInProcess,
   glob2 as glob,
   lchmod2 as lchmod,
   lchown2 as lchown,
@@ -884,6 +930,7 @@ export {
   rmdir2 as rmdir,
   stat2 as stat,
   statfs2 as statfs,
+  subscribeCommittedChanges,
   symlink2 as symlink,
   truncate2 as truncate,
   unlink2 as unlink,