@dexto/tools-filesystem 1.5.8 → 1.6.0

package/dist/directory-approval.cjs

@@ -0,0 +1,94 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var directory_approval_exports = {};
+__export(directory_approval_exports, {
+  createDirectoryAccessApprovalHandlers: () => createDirectoryAccessApprovalHandlers,
+  resolveFilePath: () => resolveFilePath
+});
+module.exports = __toCommonJS(directory_approval_exports);
+var path = __toESM(require("node:path"), 1);
+var import_core = require("@dexto/core");
+function resolveFilePath(workingDirectory, filePath) {
+  const resolvedPath = path.isAbsolute(filePath) ? path.resolve(filePath) : path.resolve(workingDirectory, filePath);
+  return { path: resolvedPath, parentDir: path.dirname(resolvedPath) };
+}
+function createDirectoryAccessApprovalHandlers(options) {
+  return {
+    async getApprovalOverride(input, context) {
+      const resolvedFileSystemService = await options.getFileSystemService(context);
+      const paths = options.resolvePaths(input, resolvedFileSystemService);
+      const isAllowed = await resolvedFileSystemService.isPathWithinConfigAllowed(paths.path);
+      if (isAllowed) {
+        return null;
+      }
+      const approvalManager = context.services?.approval;
+      if (!approvalManager) {
+        throw import_core.ToolError.configInvalid(
+          `${options.toolName} requires ToolExecutionContext.services.approval`
+        );
+      }
+      if (approvalManager.isDirectorySessionApproved(paths.path)) {
+        return null;
+      }
+      return {
+        type: import_core.ApprovalType.DIRECTORY_ACCESS,
+        metadata: {
+          path: paths.path,
+          parentDir: paths.parentDir,
+          operation: options.operation,
+          toolName: options.toolName
+        }
+      };
+    },
+    onApprovalGranted(response, context, approvalRequest) {
+      if (approvalRequest.type !== import_core.ApprovalType.DIRECTORY_ACCESS) {
+        return;
+      }
+      const metadata = approvalRequest.metadata;
+      const parentDir = typeof metadata?.parentDir === "string" ? metadata.parentDir : null;
+      if (!parentDir) {
+        return;
+      }
+      const data = response.data;
+      const rememberDirectory = data?.rememberDirectory ?? false;
+      const approvalManager = context.services?.approval;
+      if (!approvalManager) {
+        throw import_core.ToolError.configInvalid(
+          `${options.toolName} requires ToolExecutionContext.services.approval`
+        );
+      }
+      approvalManager.addApprovedDirectory(parentDir, rememberDirectory ? "session" : "once");
+    }
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  createDirectoryAccessApprovalHandlers,
+  resolveFilePath
+});

package/dist/directory-approval.d.cts

@@ -0,0 +1,22 @@
+import { ToolExecutionContext, ApprovalRequestDetails, ApprovalResponse } from '@dexto/core';
+import { FileSystemService } from './filesystem-service.cjs';
+import { FileSystemServiceGetter } from './file-tool-types.cjs';
+import './types.cjs';
+
+type DirectoryApprovalOperation = 'read' | 'write' | 'edit';
+type DirectoryApprovalPaths = {
+    path: string;
+    parentDir: string;
+};
+declare function resolveFilePath(workingDirectory: string, filePath: string): DirectoryApprovalPaths;
+declare function createDirectoryAccessApprovalHandlers<TInput>(options: {
+    toolName: string;
+    operation: DirectoryApprovalOperation;
+    getFileSystemService: FileSystemServiceGetter;
+    resolvePaths: (input: TInput, fileSystemService: FileSystemService) => DirectoryApprovalPaths;
+}): {
+    getApprovalOverride: (input: TInput, context: ToolExecutionContext) => Promise<ApprovalRequestDetails | null>;
+    onApprovalGranted: (response: ApprovalResponse, context: ToolExecutionContext, approvalRequest: ApprovalRequestDetails) => void;
+};
+
+export { createDirectoryAccessApprovalHandlers, resolveFilePath };

package/dist/directory-approval.d.ts

@@ -0,0 +1,20 @@
+import type { ApprovalRequestDetails, ApprovalResponse, ToolExecutionContext } from '@dexto/core';
+import type { FileSystemService } from './filesystem-service.js';
+import type { FileSystemServiceGetter } from './file-tool-types.js';
+type DirectoryApprovalOperation = 'read' | 'write' | 'edit';
+type DirectoryApprovalPaths = {
+    path: string;
+    parentDir: string;
+};
+export declare function resolveFilePath(workingDirectory: string, filePath: string): DirectoryApprovalPaths;
+export declare function createDirectoryAccessApprovalHandlers<TInput>(options: {
+    toolName: string;
+    operation: DirectoryApprovalOperation;
+    getFileSystemService: FileSystemServiceGetter;
+    resolvePaths: (input: TInput, fileSystemService: FileSystemService) => DirectoryApprovalPaths;
+}): {
+    getApprovalOverride: (input: TInput, context: ToolExecutionContext) => Promise<ApprovalRequestDetails | null>;
+    onApprovalGranted: (response: ApprovalResponse, context: ToolExecutionContext, approvalRequest: ApprovalRequestDetails) => void;
+};
+export {};
+//# sourceMappingURL=directory-approval.d.ts.map

package/dist/directory-approval.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"directory-approval.d.ts","sourceRoot":"","sources":["../src/directory-approval.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAClG,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AACjE,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAEpE,KAAK,0BAA0B,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,CAAC;AAE5D,KAAK,sBAAsB,GAAG;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,wBAAgB,eAAe,CAC3B,gBAAgB,EAAE,MAAM,EACxB,QAAQ,EAAE,MAAM,GACjB,sBAAsB,CAKxB;AAED,wBAAgB,qCAAqC,CAAC,MAAM,EAAE,OAAO,EAAE;IACnE,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,0BAA0B,CAAC;IACtC,oBAAoB,EAAE,uBAAuB,CAAC;IAC9C,YAAY,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,iBAAiB,EAAE,iBAAiB,KAAK,sBAAsB,CAAC;CACjG,GAAG;IACA,mBAAmB,EAAE,CACjB,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,oBAAoB,KAC5B,OAAO,CAAC,sBAAsB,GAAG,IAAI,CAAC,CAAC;IAC5C,iBAAiB,EAAE,CACf,QAAQ,EAAE,gBAAgB,EAC1B,OAAO,EAAE,oBAAoB,EAC7B,eAAe,EAAE,sBAAsB,KACtC,IAAI,CAAC;CACb,CA+DA"}