@particle-academy/agent-integrations 0.40.0 → 0.41.0

package/dist/index.cjs

@@ -2800,6 +2800,13 @@ function registerGitBridge(host, options) {
 // src/bridges/files.ts
 var DEFAULT_AGENT10 = { id: "agent", name: "Agent", color: "#a855f7" };
 var MAX_SNAPSHOT_DEPTH = 8;
+function invalidFolderName(name) {
+  const trimmed = name.trim();
+  if (trimmed === "") return "A folder name is required.";
+  if (trimmed.includes("/") || trimmed.includes("\\")) return "A folder name may not contain a path separator.";
+  if (trimmed === "." || trimmed === "..") return "That folder name is reserved.";
+  return null;
+}
 function assertPathWithinRoot(root, path) {
   const segments = path.replace(/[\\/]+/g, "/").split("/");
   if (segments.includes("..")) {
@@ -2829,6 +2836,7 @@ var asPaths = (v) => {
 function registerFilesBridge(host, options) {
   const { adapter } = options;
   const agent = { ...DEFAULT_AGENT10, ...options.agent ?? {} };
+  const pendingMode = options.pendingMode ?? true;
   const disposers = [];
   const guard = (path) => {
     if (options.root !== void 0) assertPathWithinRoot(options.root, path);
@@ -2995,6 +3003,42 @@ function registerFilesBridge(host, options) {
     },
     fTarget
   );
+  if (adapter.createFolder) {
+    reg(
+      "files_create_folder",
+      "Create a folder inside `parentPath`. Staged for human confirmation unless the host disabled pendingMode.",
+      {
+        parentPath: { type: "string", description: "Directory to create in; defaults to the current directory." },
+        name: { type: "string", description: "The new folder's name. A leaf name \u2014 no separators." },
+        confirm: { type: "boolean", description: "Acknowledge a staged write when the host wired no confirm hook." }
+      },
+      ["name"],
+      async (args) => {
+        const parentPath = guard(args.parentPath !== void 0 ? str3(args.parentPath) : adapter.getPath());
+        const name = str3(args.name).trim();
+        const invalid = invalidFolderName(name);
+        if (invalid) return errorResult(invalid);
+        const label = `${parentPath}/${name}`;
+        if (pendingMode) {
+          if (options.confirm) {
+            const ok = await options.confirm({ action: "files_create_folder", path: label, label });
+            if (!ok) return errorResult(`Declined: create folder ${label} (human did not confirm).`);
+          } else if (args.confirm !== true) {
+            return errorResult(
+              `Staged: create folder ${label}. Re-call with confirm:true to proceed.`
+            );
+          }
+        }
+        try {
+          await adapter.createFolder({ parentPath, name });
+        } catch (e) {
+          return errorResult(e instanceof Error ? e.message : String(e));
+        }
+        return textResult(`Created folder ${label}.`, { parentPath, name, path: label });
+      },
+      (args) => ({ kind: "directory", path: `${str3(args.parentPath)}/${str3(args.name)}`, label: str3(args.name) })
+    );
+  }
   reg(
     "files_request_snapshot",
     "Request a fresh snapshot subtree rooted at `path` (snapshot mode) \u2014 e.g. to pull a remote machine's current tree. Requires the host to wire requestSnapshot.",