@botbotgo/agent-harness 0.0.311 → 0.0.313

package/dist/package-version.d.ts

@@ -1 +1 @@
-export declare const AGENT_HARNESS_VERSION = "0.0.310";
+export declare const AGENT_HARNESS_VERSION = "0.0.312";

package/dist/package-version.js

@@ -1 +1 @@
-export const AGENT_HARNESS_VERSION = "0.0.310";
+export const AGENT_HARNESS_VERSION = "0.0.312";

package/dist/resources/tools/_runtime_tool_helpers.mjs

@@ -100,6 +100,45 @@ export function truncateLines(lines, maxChars = 12000) {
   return truncateText(lines.join("\n"), maxChars);
 }
 
+export function shellQuote(value) {
+  return `'${String(value).replace(/'/g, `'\"'\"'`)}'`;
+}
+
+export async function tryExecuteShallowDirectoryListing(backend, targetPath) {
+  if (typeof backend?.execute !== "function" || process.platform === "win32") {
+    return undefined;
+  }
+
+  const quotedPath = shellQuote(targetPath);
+  const command = [
+    "set -f",
+    `dir=${quotedPath}`,
+    'if [ ! -d "$dir" ]; then exit 0; fi',
+    "count=0",
+    'for entry in "$dir"/* "$dir"/.[!.]* "$dir"/..?*; do',
+    '  [ -e "$entry" ] || continue',
+    '  if [ -d "$entry" ]; then',
+    '    printf \'%s (directory)\\n\' "$entry"',
+    "  else",
+    '    printf \'%s\\n\' "$entry"',
+    "  fi",
+    "  count=$((count + 1))",
+    '  if [ "$count" -ge 400 ]; then',
+    "    printf '...[truncated]\\n'",
+    "    break",
+    "  fi",
+    "done",
+  ].join("; ");
+
+  try {
+    const result = await backend.execute(command);
+    const output = typeof result?.output === "string" ? result.output.trim() : "";
+    return output.length > 0 ? output : undefined;
+  } catch {
+    return undefined;
+  }
+}
+
 export function formatHttpResponse(result) {
   if (result?.error) {
     return result.error;

package/dist/resources/tools/list_files.mjs

@@ -1,5 +1,5 @@
 import { tool } from "@botbotgo/agent-harness/tools";
-import { defineSchema, formatListEntries, getBackend, normalizeWorkspacePath, optionalString, truncateLines } from "./_runtime_tool_helpers.mjs";
+import { defineSchema, formatListEntries, getBackend, normalizeWorkspacePath, optionalString, tryExecuteShallowDirectoryListing } from "./_runtime_tool_helpers.mjs";
 
 export const list_files = tool({
   description: "List files in a workspace directory.",
@@ -9,6 +9,10 @@ export const list_files = tool({
   async invoke(input, context = {}) {
     const backend = getBackend(context);
     const targetPath = normalizeWorkspacePath(context, input.path, ".");
+    const shallowListing = await tryExecuteShallowDirectoryListing(backend, targetPath);
+    if (typeof shallowListing === "string") {
+      return shallowListing;
+    }
     const legacyInfos = typeof backend.lsInfo === "function" ? await backend.lsInfo(targetPath) : [];
     const infos = legacyInfos.length > 0
       ? legacyInfos

package/dist/runtime/adapter/tool/builtin-middleware-tools.js

@@ -36,6 +36,45 @@ function toDisplayContent(content) {
 function notAvailable(toolName, capability) {
     return `Error: ${toolName} is not available. This backend does not support ${capability}.`;
 }
+function shellQuote(value) {
+    return `'${value.replace(/'/g, `'\"'\"'`)}'`;
+}
+async function tryExecuteShallowDirectoryListing(backend, targetPath) {
+    if (typeof backend.execute !== "function" || process.platform === "win32") {
+        return undefined;
+    }
+    const quotedPath = shellQuote(targetPath);
+    const command = [
+        "set -f",
+        `dir=${quotedPath}`,
+        'if [ ! -d "$dir" ]; then exit 0; fi',
+        "count=0",
+        'for entry in "$dir"/* "$dir"/.[!.]* "$dir"/..?*; do',
+        '  [ -e "$entry" ] || continue',
+        '  if [ -d "$entry" ]; then',
+        '    printf \'%s (directory)\\n\' \"$entry\"',
+        "  else",
+        '    printf \'%s\\n\' \"$entry\"',
+        "  fi",
+        "  count=$((count + 1))",
+        '  if [ "$count" -ge 400 ]; then',
+        "    printf '...[truncated]\\n'",
+        "    break",
+        "  fi",
+        "done",
+    ].join("; ");
+    try {
+        const result = await Promise.resolve(backend.execute(command));
+        const output = typeof result?.output === "string" ? result.output.trim() : "";
+        if (!output) {
+            return undefined;
+        }
+        return output;
+    }
+    catch {
+        return undefined;
+    }
+}
 function resolveWorkspaceRoot(backend) {
     const typed = backend;
     if (typeof typed.rootDir === "string" && typed.rootDir.trim().length > 0) {
@@ -163,6 +202,10 @@ export async function createBuiltinMiddlewareTools(backend, options) {
         schema: z.object({ path: z.string().optional().default("/") }).passthrough(),
         invoke: async (input) => {
             const targetPath = normalizeWorkspacePathOrThrow(pathScopedBackend, isRecord(input) && typeof input.path === "string" ? input.path : "/");
+            const shallowListing = await tryExecuteShallowDirectoryListing(pathScopedBackend, targetPath);
+            if (typeof shallowListing === "string") {
+                return shallowListing.length > 0 ? shallowListing : `No files found in ${targetPath}`;
+            }
             const legacyInfos = (await Promise.resolve(backend.lsInfo?.(targetPath))) ?? [];
             const infos = legacyInfos.length > 0
                 ? legacyInfos

package/dist/utils/bundled-text.js

@@ -1,4 +1,5 @@
-import { readFileSync } from "node:fs";
+import { existsSync, readFileSync } from "node:fs";
+import { fileURLToPath } from "node:url";
 const bundledTextCache = new Map();
 export function readBundledText(relativePath) {
     const normalized = relativePath.replace(/^\.?\//, "");
@@ -6,10 +7,23 @@ export function readBundledText(relativePath) {
     if (cached !== undefined) {
         return cached;
     }
-    const value = readFileSync(new URL(`../../resources/${normalized}`, import.meta.url), "utf8");
+    const resourceUrl = resolveBundledResourceUrl(normalized);
+    const value = readFileSync(resourceUrl, "utf8");
     bundledTextCache.set(normalized, value);
     return value;
 }
+function resolveBundledResourceUrl(relativePath) {
+    const candidates = [
+        new URL(`../resources/${relativePath}`, import.meta.url),
+        new URL(`../../resources/${relativePath}`, import.meta.url),
+    ];
+    for (const candidate of candidates) {
+        if (existsSync(fileURLToPath(candidate))) {
+            return candidate;
+        }
+    }
+    return candidates[0];
+}
 export function renderTemplateText(template, values) {
     return template
         .replace(/\{\{([a-zA-Z0-9_]+)\}\}/g, (_match, key) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@botbotgo/agent-harness",
-  "version": "0.0.311",
+  "version": "0.0.313",
   "description": "Workspace runtime for multi-agent applications",
   "license": "MIT",
   "type": "module",