@botbotgo/agent-harness 0.0.313 → 0.0.314

package/dist/package-version.d.ts

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

package/dist/package-version.js

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

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/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.313",
+  "version": "0.0.314",
   "description": "Workspace runtime for multi-agent applications",
   "license": "MIT",
   "type": "module",