@botbotgo/agent-harness 0.0.312 → 0.0.314

package/dist/package-version.d.ts

@@ -1 +1 @@
-export declare const AGENT_HARNESS_VERSION = "0.0.311";
+export declare const AGENT_HARNESS_VERSION = "0.0.313";

package/dist/package-version.js

@@ -1 +1 @@
-export const AGENT_HARNESS_VERSION = "0.0.311";
+export const AGENT_HARNESS_VERSION = "0.0.313";

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/direct-builtin-utility.d.ts

@@ -1 +1,5 @@
 export declare function summarizeAssistantText(text: string): string;
+export declare function shouldDirectlyListWorkspaceFiles(input: string | Array<{
+    type?: unknown;
+    text?: unknown;
+}>): boolean;

package/dist/runtime/adapter/direct-builtin-utility.js

@@ -1,3 +1,15 @@
+const DIRECT_LISTING_PATTERNS = [
+    /^ls$/iu,
+    /^list files$/iu,
+    /^list the files$/iu,
+    /^list files in (?:the )?(?:current )?directory$/iu,
+    /^show files$/iu,
+    /^show me the files$/iu,
+    /^show the files$/iu,
+    /^列出文件$/u,
+    /^列出当前目录(?:下)?文件$/u,
+    /^查看文件列表$/u,
+];
 const GENERIC_ASSISTANT_SUMMARY_MAX_CHARS = 180;
 const GENERIC_ASSISTANT_SUMMARY_MAX_LINES = 6;
 function parseListingEntry(line) {
@@ -88,3 +100,26 @@ export function summarizeAssistantText(text) {
     }
     return summarizeGenericAssistantResponse(normalized);
 }
+function extractPlainTextInput(input) {
+    if (typeof input === "string") {
+        const normalized = input.trim();
+        return normalized.length > 0 ? normalized : undefined;
+    }
+    if (!Array.isArray(input)) {
+        return undefined;
+    }
+    const text = input
+        .filter((part) => part?.type === "text" && typeof part.text === "string")
+        .map((part) => part.text.trim())
+        .filter((part) => part.length > 0)
+        .join("\n")
+        .trim();
+    return text.length > 0 ? text : undefined;
+}
+export function shouldDirectlyListWorkspaceFiles(input) {
+    const normalized = extractPlainTextInput(input);
+    if (!normalized) {
+        return false;
+    }
+    return DIRECT_LISTING_PATTERNS.some((pattern) => pattern.test(normalized));
+}

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/runtime/agent-runtime-adapter.d.ts

@@ -32,6 +32,7 @@ export declare class AgentRuntimeAdapter {
     private resolveFilesystemRootDir;
     private resolveBuiltinMiddlewareBackend;
     private buildFunctionToolRuntimeContext;
+    private tryHandleDirectWorkspaceListing;
     private createDeclaredMiddlewareResolverOptions;
     private createAssemblyResolvers;
     private invokeBuiltinTaskTool;

package/dist/runtime/agent-runtime-adapter.js

@@ -11,6 +11,7 @@ import { applyToolRecoveryInstruction as applyToolRecoveryInstructionHelper, app
 import { invokeBuiltinTaskTool as invokeBuiltinTaskToolHelper, materializeAutomaticSummarizationMiddleware as materializeAutomaticSummarizationMiddlewareHelper, resolveBuiltinMiddlewareBackend as resolveBuiltinMiddlewareBackendHelper, resolveBuiltinMiddlewareTools as resolveBuiltinMiddlewareToolsHelper, resolveLangChainRuntimeExtensionMiddleware as resolveLangChainRuntimeExtensionMiddlewareHelper, resolveMiddleware as resolveMiddlewareHelper, resolveSubagents as resolveSubagentsHelper, } from "./adapter/middleware-assembly.js";
 import { resolveBindingTimeout, resolveStreamIdleTimeout, } from "./adapter/resilience.js";
 import { createResolvedModel } from "./adapter/model/model-providers.js";
+import { shouldDirectlyListWorkspaceFiles } from "./adapter/direct-builtin-utility.js";
 import { resolveAdapterTools } from "./adapter/tool-resolution.js";
 import { resolveRuntimeStreamExecutionContext, } from "./adapter/flow/execution-context.js";
 import { isRetryableProviderError } from "./adapter/resilience.js";
@@ -173,6 +174,30 @@ export class AgentRuntimeAdapter {
             },
         };
     }
+    async tryHandleDirectWorkspaceListing(binding, input, options = {}) {
+        if (!shouldDirectlyListWorkspaceFiles(input)) {
+            return undefined;
+        }
+        const builtinTools = await this.resolveBuiltinMiddlewareTools(binding, {
+            context: options.context,
+            state: options.state,
+            files: options.files,
+            sessionId: options.sessionId,
+            requestId: options.requestId,
+        });
+        const listTool = builtinTools.get("list_files") ?? builtinTools.get("ls");
+        if (!listTool) {
+            return undefined;
+        }
+        const output = await listTool.invoke({ path: "." });
+        if (typeof output !== "string" || output.trim().length === 0) {
+            return undefined;
+        }
+        return {
+            toolName: listTool.name,
+            output,
+        };
+    }
     createDeclaredMiddlewareResolverOptions(binding, options = {}) {
         return {
             resolveModel: (model) => this.resolveModel(model),
@@ -398,6 +423,30 @@ export class AgentRuntimeAdapter {
         }
     }
     async invoke(binding, input, sessionId, requestId, resumePayload, history = [], options = {}) {
+        const directListing = await this.tryHandleDirectWorkspaceListing(binding, input, {
+            ...options,
+            sessionId,
+            requestId,
+        });
+        if (directListing) {
+            return {
+                sessionId,
+                requestId,
+                agentId: binding.agent.id,
+                state: "completed",
+                output: directListing.output,
+                finalMessageText: directListing.output,
+                metadata: {
+                    executedToolResults: [{
+                            toolName: directListing.toolName,
+                            output: directListing.output,
+                        }],
+                    upstreamResult: {
+                        directUtility: directListing.toolName,
+                    },
+                },
+            };
+        }
         const callRuntime = async (activeBinding, activeRequest) => {
             return this.invokeWithProviderRetry(activeBinding, async () => {
                 const runnable = await this.create(activeBinding, { sessionId });
@@ -444,6 +493,23 @@ export class AgentRuntimeAdapter {
         }));
     }
     async *stream(binding, input, sessionId, history = [], options = {}) {
+        const directListing = await this.tryHandleDirectWorkspaceListing(binding, input, {
+            ...options,
+            sessionId,
+            requestId: options.requestId,
+        });
+        if (directListing) {
+            yield {
+                kind: "tool-result",
+                toolName: directListing.toolName,
+                output: directListing.output,
+            };
+            yield {
+                kind: "content",
+                content: directListing.output,
+            };
+            return;
+        }
         const invokeTimeoutMs = resolveBindingTimeout(binding);
         const streamIdleTimeoutMs = resolveStreamIdleTimeout(binding);
         const streamDeadlineAt = invokeTimeoutMs ? Date.now() + invokeTimeoutMs : undefined;

package/package.json

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