@zhin.js/agent 1.1.31 → 1.1.33

package/lib/plugin-runtime/native-bash-tool.d.ts

@@ -17,6 +17,18 @@ export interface BashExecutionResult {
 export interface BashExecutionPort {
     execute(request: BashExecutionRequest): Promise<BashExecutionResult>;
 }
+export declare const BASH_TOOL_NAME = "bash";
+/**
+ * Whether a Turn policy authorizes shell execution at all. Only two shapes
+ * run: an isolated (container) shell over read-only/workspace-write files, or
+ * an explicitly unrestricted shell with danger-full-access. Anything else,
+ * including a missing `shell` policy, means bash must not be offered.
+ */
+export declare function turnPolicyAllowsShell(policy: Pick<ToolInvocationPolicy, 'shell' | 'filesystem'> | undefined): boolean;
+/** Drops bash from a tool or catalog list when the Turn policy cannot run it. */
+export declare function withoutForbiddenShell<T extends {
+    readonly name: string;
+}>(policy: Pick<ToolInvocationPolicy, 'shell' | 'filesystem'> | undefined, tools: readonly T[]): T[];
 /** Executes one policy-authorized command using the exact Turn isolation boundary. */
 export declare class SandboxBashExecutionPort implements BashExecutionPort {
     #private;

package/lib/plugin-runtime/native-bash-tool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"native-bash-tool.d.ts","sourceRoot":"","sources":["../../src/plugin-runtime/native-bash-tool.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,mBAAmB,EAExB,KAAK,oBAAoB,EAC1B,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAW,KAAK,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAErE,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,oBAAoB,CAAC;CACvC;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC;CACtE;AAED,sFAAsF;AACtF,qBAAa,wBAAyB,YAAW,iBAAiB;;gBAGpD,UAAU,GAAE,OAAO,CAAC,aAAa,CAAM;IAI7C,OAAO,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,mBAAmB,CAAC;CA6B3E;AAED,yDAAyD;AACzD,qBAAa,qBAAqB;;IAChC,QAAQ,CAAC,OAAO,8CAAiB;IACjC,QAAQ,CAAC,IAAI,UAAU;IACvB,QAAQ,CAAC,UAAU,EAAE,QAAQ,CAAC,mBAAmB,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC;gBAGxE,SAAS,GAAE,iBAAkD;YAkB3D,OAAO;CAqBtB"}
+{"version":3,"file":"native-bash-tool.d.ts","sourceRoot":"","sources":["../../src/plugin-runtime/native-bash-tool.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,mBAAmB,EAExB,KAAK,oBAAoB,EAC1B,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAW,KAAK,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAErE,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,oBAAoB,CAAC;CACvC;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC;CACtE;AAED,eAAO,MAAM,cAAc,SAAS,CAAC;AAErC;;;;;GAKG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,IAAI,CAAC,oBAAoB,EAAE,OAAO,GAAG,YAAY,CAAC,GAAG,SAAS,GACrE,OAAO,CAQT;AAED,iFAAiF;AACjF,wBAAgB,qBAAqB,CAAC,CAAC,SAAS;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,EACvE,MAAM,EAAE,IAAI,CAAC,oBAAoB,EAAE,OAAO,GAAG,YAAY,CAAC,GAAG,SAAS,EACtE,KAAK,EAAE,SAAS,CAAC,EAAE,GAClB,CAAC,EAAE,CAIL;AAED,sFAAsF;AACtF,qBAAa,wBAAyB,YAAW,iBAAiB;;gBAGpD,UAAU,GAAE,OAAO,CAAC,aAAa,CAAM;IAI7C,OAAO,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,mBAAmB,CAAC;CA8B3E;AAED,yDAAyD;AACzD,qBAAa,qBAAqB;;IAChC,QAAQ,CAAC,OAAO,8CAAiB;IACjC,QAAQ,CAAC,IAAI,UAAkB;IAC/B,QAAQ,CAAC,UAAU,EAAE,QAAQ,CAAC,mBAAmB,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC;gBAGxE,SAAS,GAAE,iBAAkD;YAkB3D,OAAO;CAqBtB"}

package/lib/plugin-runtime/native-bash-tool.js

@@ -1,6 +1,31 @@
 import { defineAgentTool, toolFeatureId, } from '@zhin.js/tool';
 import { classifyBashCommand } from '../security/file-policy.js';
 import { Sandbox } from '../security/sandbox.js';
+export const BASH_TOOL_NAME = 'bash';
+/**
+ * Whether a Turn policy authorizes shell execution at all. Only two shapes
+ * run: an isolated (container) shell over read-only/workspace-write files, or
+ * an explicitly unrestricted shell with danger-full-access. Anything else,
+ * including a missing `shell` policy, means bash must not be offered.
+ */
+export function turnPolicyAllowsShell(policy) {
+    const filesystem = policy?.filesystem;
+    const shell = policy?.shell;
+    if (!filesystem?.workspaceRoot || !shell || shell.security === 'deny')
+        return false;
+    const access = filesystem.access;
+    if (shell.isolation === 'required')
+        return access === 'read-only' || access === 'workspace-write';
+    if (shell.isolation === 'none')
+        return access === 'danger-full-access';
+    return false;
+}
+/** Drops bash from a tool or catalog list when the Turn policy cannot run it. */
+export function withoutForbiddenShell(policy, tools) {
+    return turnPolicyAllowsShell(policy)
+        ? [...tools]
+        : tools.filter(tool => tool.name !== BASH_TOOL_NAME);
+}
 /** Executes one policy-authorized command using the exact Turn isolation boundary. */
 export class SandboxBashExecutionPort {
     #baseConfig;
@@ -10,14 +35,13 @@ export class SandboxBashExecutionPort {
     async execute(request) {
         request.signal.throwIfAborted();
         const filesystem = request.policy.filesystem;
-        const access = filesystem?.access;
-        const isolation = request.policy.shell?.isolation;
-        const isolated = isolation === 'required'
-            && (access === 'read-only' || access === 'workspace-write');
-        const unrestricted = isolation === 'none' && access === 'danger-full-access';
-        if (!filesystem?.workspaceRoot || (!isolated && !unrestricted)) {
-            throw new Error('Bash execution requires an explicit Turn filesystem and isolation policy');
+        if (!filesystem || !turnPolicyAllowsShell(request.policy)) {
+            // Normally unreachable: the agent loop hides bash from turns that cannot run it.
+            throw new Error('Shell execution is disabled for this conversation by policy. Do not retry bash; '
+                + 'use the file tools instead or tell the user it is unavailable here.');
         }
+        const access = filesystem.access;
+        const unrestricted = request.policy.shell?.isolation === 'none';
         const sandbox = unrestricted
             ? new Sandbox({ ...this.#baseConfig, enabled: false })
             : new Sandbox({
@@ -39,7 +63,7 @@ export class SandboxBashExecutionPort {
 /** Native generation ToolFeature for shell execution. */
 export class NativeBashToolFeature {
     feature = toolFeatureId;
-    name = 'bash';
+    name = BASH_TOOL_NAME;
     definition;
     #execution;
     constructor(execution = new SandboxBashExecutionPort()) {

package/lib/plugin-runtime/native-bash-tool.js.map

@@ -1 +1 @@
-{"version":3,"file":"native-bash-tool.js","sourceRoot":"","sources":["../../src/plugin-runtime/native-bash-tool.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"native-bash-tool.js","sourceRoot":"","sources":["../../src/plugin-runtime/native-bash-tool.ts"],"names":[],"mappings":"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"}

package/lib/plugin-runtime/native-file-tools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"native-file-tools.d.ts","sourceRoot":"","sources":["../../src/plugin-runtime/native-file-tools.ts"],"names":[],"mappings":"AAEA,OAAO,EAEL,aAAa,EACb,KAAK,mBAAmB,EAIzB,MAAM,eAAe,CAAC;AAIvB,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,OAAO,EAAE,OAAO,aAAa,CAAC;IACvC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,UAAU,EAAE,QAAQ,CAAC,mBAAmB,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC;CACrF;AAED,2FAA2F;AAC3F,wBAAgB,4BAA4B,IAAI,SAAS,qBAAqB,EAAE,CA2D/E"}
+{"version":3,"file":"native-file-tools.d.ts","sourceRoot":"","sources":["../../src/plugin-runtime/native-file-tools.ts"],"names":[],"mappings":"AAEA,OAAO,EAEL,aAAa,EACb,KAAK,mBAAmB,EAIzB,MAAM,eAAe,CAAC;AAgBvB,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,OAAO,EAAE,OAAO,aAAa,CAAC;IACvC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,UAAU,EAAE,QAAQ,CAAC,mBAAmB,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC;CACrF;AAED,2FAA2F;AAC3F,wBAAgB,4BAA4B,IAAI,SAAS,qBAAqB,EAAE,CA8D/E"}

package/lib/plugin-runtime/native-file-tools.js

@@ -3,11 +3,22 @@ import * as path from 'node:path';
 import { defineAgentTool, toolFeatureId, } from '@zhin.js/tool';
 import { MAX_EDIT_FILE_SIZE, MAX_READ_FILE_SIZE, isFileStale } from '../security/file-policy.js';
 import { findActualStringInFile, preserveQuoteStyleInEdit } from './file-edit-quote-utils.js';
+import { walkWorkspaceFiles } from './file-search-scope.js';
+/** Output budgets keep one exploratory call from flooding the model context. */
+const MAX_READ_LINES = 2_000;
+const MAX_LINE_CHARS = 500;
+const MAX_LIST_ENTRIES = 500;
+const MAX_GLOB_FILES = 100;
+const DEFAULT_GREP_MATCHES = 50;
+const MAX_GREP_MATCHES = 200;
+const MAX_GREP_OUTPUT_BYTES = 24 * 1024;
+const MAX_GREP_FILE_BYTES = 2 * 1024 * 1024;
+const NARROW_HINT = 'narrow the pattern, path, or include filter to see more';
 /** Native ToolFeature definitions; no classic Tool, Message, or process cwd dependency. */
 export function createNativeFileToolFeatures() {
     return Object.freeze([
         feature('read_file', defineAgentTool({
-            description: 'Read a UTF-8 text file inside the authorized workspace with optional line slicing.',
+            description: `Read a UTF-8 text file inside the authorized workspace with optional line slicing (at most ${MAX_READ_LINES} lines per call).`,
             inputSchema: objectSchema({
                 file_path: { type: 'string', description: 'Path relative to the authorized workspace' },
                 offset: { type: 'number', description: 'Zero-based first line' },
@@ -36,13 +47,14 @@ export function createNativeFileToolFeatures() {
             execute: editFile,
         })),
         feature('list_dir', defineAgentTool({
-            description: 'List entries in a directory inside the authorized workspace.',
+            description: `List up to ${MAX_LIST_ENTRIES} entries in a directory inside the authorized workspace.`,
             inputSchema: objectSchema({ path: { type: 'string', description: 'Directory path' } }, ['path']),
             requiresApproval: 'never',
             execute: listDir,
         })),
         feature('glob', defineAgentTool({
-            description: 'Find up to 100 files matching a glob pattern inside the authorized workspace.',
+            description: `Find up to ${MAX_GLOB_FILES} files matching a glob pattern inside the authorized workspace. `
+                + 'Skips node_modules, .git, build output and .gitignore matches unless cwd points inside them.',
             inputSchema: objectSchema({
                 pattern: { type: 'string', description: 'Glob pattern such as **/*.ts' },
                 cwd: { type: 'string', description: 'Search directory inside the workspace' },
@@ -51,13 +63,15 @@ export function createNativeFileToolFeatures() {
             execute: globFiles,
         })),
         feature('grep', defineAgentTool({
-            description: 'Search UTF-8 files by regular expression inside the authorized workspace.',
+            description: 'Search UTF-8 files by a specific regular expression inside the authorized workspace. '
+                + 'Skips node_modules, .git, build output and .gitignore matches unless path points inside them. '
+                + 'To view a whole file use read_file; to find files use glob or list_dir.',
             inputSchema: objectSchema({
                 pattern: { type: 'string', description: 'Regular expression' },
                 path: { type: 'string', description: 'File or directory to search' },
                 include: { type: 'string', description: 'Optional file glob' },
                 ignore_case: { type: 'boolean' },
-                limit: { type: 'number', description: 'Maximum matching lines' },
+                limit: { type: 'number', description: `Maximum matching lines (default ${DEFAULT_GREP_MATCHES}, max ${MAX_GREP_MATCHES})` },
             }, ['pattern']),
             requiresApproval: 'never',
             execute: grepFiles,
@@ -80,10 +94,16 @@ async function readFile(input, context) {
     const content = await fs.readFile(target, { encoding: 'utf8', signal: context.signal });
     const lines = content.split('\n');
     const offset = nonNegativeInteger(input.offset, 0);
-    const limit = nonNegativeInteger(input.limit, lines.length);
-    const sliced = lines.slice(offset, offset + limit);
-    const numbered = sliced.map((line, index) => `${offset + index + 1} | ${line}`).join('\n');
-    return `File: ${target} (${lines.length} lines, showing ${offset + 1}-${Math.min(offset + limit, lines.length)})\n${numbered}`;
+    const limit = Math.min(nonNegativeInteger(input.limit, MAX_READ_LINES), MAX_READ_LINES);
+    const end = Math.min(offset + limit, lines.length);
+    const numbered = lines.slice(offset, end)
+        .map((line, index) => `${offset + index + 1} | ${clipLine(line)}`)
+        .join('\n');
+    const header = `File: ${target} (${lines.length} lines, showing ${offset + 1}-${end})`;
+    const more = end < lines.length
+        ? `\n[${lines.length - end} more lines; call read_file again with offset=${end} to continue]`
+        : '';
+    return `${header}\n${numbered}${more}`;
 }
 async function writeFile(input, context) {
     const target = authorizedAbsolutePath(input.file_path, context);
@@ -120,78 +140,125 @@ async function listDir(input, context) {
     const target = authorizedAbsolutePath(input.path, context);
     context.signal.throwIfAborted();
     const entries = await fs.readdir(target, { withFileTypes: true });
-    return entries.length === 0
-        ? `Directory ${target} is empty`
-        : entries.sort((left, right) => left.name.localeCompare(right.name))
-            .map((entry) => `${entry.isDirectory() ? '[DIR]  ' : '       '}${entry.name}`)
-            .join('\n');
+    if (entries.length === 0)
+        return `Directory ${target} is empty`;
+    const listed = entries.sort((left, right) => left.name.localeCompare(right.name))
+        .slice(0, MAX_LIST_ENTRIES)
+        .map((entry) => `${entry.isDirectory() ? '[DIR]  ' : '       '}${entry.name}`)
+        .join('\n');
+    return entries.length > MAX_LIST_ENTRIES
+        ? `${listed}\n[truncated: showing ${MAX_LIST_ENTRIES} of ${entries.length} entries; use glob with a narrower pattern]`
+        : listed;
 }
 async function globFiles(input, context) {
     const root = authorizedAbsolutePath(input.cwd, context);
     const pattern = requiredString(input.pattern, 'pattern');
     const matches = [];
     const matcher = globMatcher(pattern);
-    for await (const file of walkFiles(root, context.signal)) {
+    let truncated = false;
+    for await (const file of walkWorkspaceFiles(root, workspaceRootOf(context), context.signal)) {
         const relative = slash(path.relative(root, file));
-        if (matcher.test(relative))
-            matches.push(relative);
-        if (matches.length >= 100)
+        if (!matcher.test(relative))
+            continue;
+        if (matches.length >= MAX_GLOB_FILES) {
+            truncated = true;
             break;
+        }
+        matches.push(relative);
     }
-    return matches.length === 0
-        ? `No files matching '${pattern}'`
-        : `Found ${matches.length} files:\n${matches.join('\n')}`;
+    if (matches.length === 0)
+        return `No files matching '${pattern}'`;
+    const notice = truncated ? `\n[truncated at ${MAX_GLOB_FILES} files; ${NARROW_HINT}]` : '';
+    return `Found ${matches.length} files:\n${matches.join('\n')}${notice}`;
 }
 async function grepFiles(input, context) {
     const root = authorizedAbsolutePath(input.path, context);
     const pattern = requiredString(input.pattern, 'pattern');
     const expression = new RegExp(pattern, input.ignore_case === true ? 'i' : undefined);
+    assertSelectivePattern(pattern, expression);
     const include = typeof input.include === 'string' && input.include.trim()
         ? globMatcher(input.include)
         : undefined;
-    const limit = Math.max(1, nonNegativeInteger(input.limit, 50));
+    const limit = Math.min(Math.max(1, nonNegativeInteger(input.limit, DEFAULT_GREP_MATCHES)), MAX_GREP_MATCHES);
     const stat = await fs.stat(root);
-    const files = stat.isDirectory() ? walkFiles(root, context.signal) : singleFile(root);
+    const files = stat.isDirectory()
+        ? walkWorkspaceFiles(root, workspaceRootOf(context), context.signal)
+        : singleFile(root);
     const matches = [];
-    for await (const file of files) {
+    let bytes = 0;
+    let truncated;
+    search: for await (const file of files) {
         context.signal.throwIfAborted();
         if (include && !include.test(path.basename(file)))
             continue;
-        let content;
-        try {
-            content = await fs.readFile(file, { encoding: 'utf8', signal: context.signal });
-        }
-        catch {
+        const content = await readSearchableText(file, context.signal);
+        if (content === undefined)
             continue;
-        }
         const lines = content.split('\n');
         for (let index = 0; index < lines.length; index += 1) {
-            expression.lastIndex = 0;
-            if (expression.test(lines[index]))
-                matches.push(`${slash(path.relative(root, file) || path.basename(file))}:${index + 1}:${lines[index]}`);
-            if (matches.length >= limit)
-                break;
+            if (!expression.test(lines[index]))
+                continue;
+            const match = `${slash(path.relative(root, file) || path.basename(file))}:${index + 1}:${clipLine(lines[index])}`;
+            if (matches.length >= limit) {
+                truncated = `${limit} matches`;
+                break search;
+            }
+            bytes += Buffer.byteLength(match) + 1;
+            if (bytes > MAX_GREP_OUTPUT_BYTES) {
+                truncated = `${MAX_GREP_OUTPUT_BYTES} bytes`;
+                break search;
+            }
+            matches.push(match);
         }
-        if (matches.length >= limit)
-            break;
     }
-    return matches.length === 0 ? `No matches for '${pattern}'` : matches.join('\n');
-}
-async function* walkFiles(root, signal) {
-    const entries = await fs.readdir(root, { withFileTypes: true });
-    entries.sort((left, right) => left.name.localeCompare(right.name));
-    for (const entry of entries) {
-        signal.throwIfAborted();
-        const target = path.join(root, entry.name);
-        if (entry.isDirectory())
-            yield* walkFiles(target, signal);
-        else if (entry.isFile())
-            yield target;
+    if (matches.length === 0)
+        return `No matches for '${pattern}'`;
+    return truncated
+        ? `${matches.join('\n')}\n[truncated at ${truncated}; ${NARROW_HINT}]`
+        : matches.join('\n');
+}
+/**
+ * A pattern that matches the empty string matches every line of every file:
+ * it dumps whole trees into context instead of locating anything.
+ */
+function assertSelectivePattern(pattern, expression) {
+    if (!expression.test(''))
+        return;
+    throw new Error(`grep pattern '${pattern}' matches every line, so it cannot locate anything. `
+        + 'Use read_file to view a file, glob or list_dir to find files, '
+        + 'or give grep a specific text or regular expression to look for.');
+}
+/** Skip oversized and binary files: they are never useful grep context. */
+async function readSearchableText(file, signal) {
+    try {
+        const stat = await fs.stat(file);
+        if (stat.size > MAX_GREP_FILE_BYTES)
+            return undefined;
+        const buffer = await fs.readFile(file, { signal });
+        if (buffer.subarray(0, 8_192).includes(0))
+            return undefined;
+        return buffer.toString('utf8');
+    }
+    catch (error) {
+        if (signal.aborted)
+            throw error;
+        return undefined;
     }
 }
+function clipLine(line) {
+    return line.length > MAX_LINE_CHARS
+        ? `${line.slice(0, MAX_LINE_CHARS)}… [line truncated, ${line.length} chars]`
+        : line;
+}
 async function* singleFile(file) {
     yield file;
 }
+function workspaceRootOf(context) {
+    const workspaceRoot = context.policy.filesystem?.workspaceRoot;
+    if (!workspaceRoot)
+        throw new Error('File input was not authorized by TurnToolRuntime');
+    return workspaceRoot;
+}
 function authorizedAbsolutePath(value, context) {
     const target = requiredString(value ?? context.policy.filesystem?.workspaceRoot, 'path');
     const workspaceRoot = context.policy.filesystem?.workspaceRoot;
@@ -220,8 +287,10 @@ function globMatcher(pattern) {
     for (let index = 0; index < pattern.length; index += 1) {
         const character = pattern[index];
         if (character === '*' && pattern[index + 1] === '*') {
-            source += '.*';
-            index += 1;
+            // `**/` also matches zero directories, so `**/package.json` finds the root manifest.
+            const spansSeparator = pattern[index + 2] === '/';
+            source += spansSeparator ? '(?:.*/)?' : '.*';
+            index += spansSeparator ? 2 : 1;
         }
         else if (character === '*')
             source += '[^/]*';

package/lib/plugin-runtime/native-file-tools.js.map

@@ -1 +1 @@
-{"version":3,"file":"native-file-tools.js","sourceRoot":"","sources":["../../src/plugin-runtime/native-file-tools.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"native-file-tools.js","sourceRoot":"","sources":["../../src/plugin-runtime/native-file-tools.ts"],"names":[],"mappings":"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"}

package/lib/plugin-runtime/native-semantic-memory-tools.d.ts

@@ -1,17 +1,43 @@
-import { type MemoryEntryRecord, type MemoryEntryRepository, type MemoryEntrySearchInput, type MemoryEntryUpsertInput } from '@zhin.js/ai';
+import { type MemoryEntryListInput, type MemoryEntryLocator, type MemoryEntryRecord, type MemoryEntryRepository, type MemoryEntrySearchInput, type MemoryEntryUpsertInput } from '@zhin.js/ai';
 import { toolFeatureId, type AgentToolDefinition } from '@zhin.js/tool';
+import { type RecallResult, type RecallTurnView, type SemanticRecallOptions } from '../memory/semantic-recall.js';
 import { type NativeSearchDecisionResolver } from '../decision/retrieval.js';
 export interface NativeSemanticMemoryToolFeature {
     readonly feature: typeof toolFeatureId;
     readonly name: string;
     readonly definition: Readonly<AgentToolDefinition<Record<string, unknown>, string>>;
 }
+export interface SemanticMemoryRuntimeOptions {
+    /**
+     * Whether the task a `task_state` entry is bound to still exists. When it
+     * returns false the entry is hidden from recall (it also expires by TTL).
+     * Without a resolver, bound task state lives until its TTL.
+     */
+    readonly isTaskActive?: (taskId: string) => boolean;
+    /** Per-turn recall (#734); see `ai.memory.semantic.recall`. */
+    readonly recall?: SemanticRecallOptions;
+}
 /** Candidate-owned semantic-memory authority. It becomes ready during required DB activation. */
 export declare class SemanticMemoryRuntime {
     #private;
+    constructor(options?: SemanticMemoryRuntimeOptions);
     activate(repository: MemoryEntryRepository): void;
     dispose(): void;
     search(input: MemoryEntrySearchInput, signal: AbortSignal): Promise<MemoryEntryRecord[]>;
+    find(locator: MemoryEntryLocator, signal: AbortSignal): Promise<MemoryEntryRecord | null>;
+    /** Whether the database repository is active (recall is skipped otherwise). */
+    get active(): boolean;
+    /**
+     * BM25 top-k memory relevant to `query`, rendered within the recall budget.
+     * Returns null when recall is off, the runtime is inactive, or nothing matches.
+     */
+    recall(view: RecallTurnView, query: string, signal: AbortSignal): Promise<RecallResult | null>;
+    /** Live entries in one scope, newest first (management view). */
+    list(input: MemoryEntryListInput, signal: AbortSignal): Promise<MemoryEntryRecord[]>;
+    /** Deletes one entry; it is never recalled again. */
+    delete(id: string, signal: AbortSignal): Promise<boolean>;
+    /** Best-effort recall bookkeeping; never fails the search that triggered it. */
+    markUsed(ids: readonly string[]): Promise<void>;
     upsert(input: MemoryEntryUpsertInput, signal: AbortSignal): Promise<MemoryEntryRecord>;
 }
 export declare function createNativeSemanticMemoryToolFeatures(runtime: SemanticMemoryRuntime, resolveDecision?: NativeSearchDecisionResolver): readonly NativeSemanticMemoryToolFeature[];

package/lib/plugin-runtime/native-semantic-memory-tools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"native-semantic-memory-tools.d.ts","sourceRoot":"","sources":["../../src/plugin-runtime/native-semantic-memory-tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,iBAAiB,EACtB,KAAK,qBAAqB,EAE1B,KAAK,sBAAsB,EAC3B,KAAK,sBAAsB,EAC5B,MAAM,aAAa,CAAC;AACrB,OAAO,EAEL,aAAa,EACb,KAAK,mBAAmB,EAEzB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAgD,KAAK,4BAA4B,EAAE,MAAM,0BAA0B,CAAC;AAE3H,MAAM,WAAW,+BAA+B;IAC9C,QAAQ,CAAC,OAAO,EAAE,OAAO,aAAa,CAAC;IACvC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,UAAU,EAAE,QAAQ,CAAC,mBAAmB,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC;CACrF;AAED,iGAAiG;AACjG,qBAAa,qBAAqB;;IAGhC,QAAQ,CAAC,UAAU,EAAE,qBAAqB,GAAG,IAAI;IAKjD,OAAO,IAAI,IAAI;IAIT,MAAM,CAAC,KAAK,EAAE,sBAAsB,EAAE,MAAM,EAAE,WAAW;IAOzD,MAAM,CAAC,KAAK,EAAE,sBAAsB,EAAE,MAAM,EAAE,WAAW;CAWhE;AAED,wBAAgB,sCAAsC,CACpD,OAAO,EAAE,qBAAqB,EAC9B,eAAe,CAAC,EAAE,4BAA4B,GAC7C,SAAS,+BAA+B,EAAE,CAkC5C"}
+{"version":3,"file":"native-semantic-memory-tools.d.ts","sourceRoot":"","sources":["../../src/plugin-runtime/native-semantic-memory-tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAKL,KAAK,oBAAoB,EACzB,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACtB,KAAK,qBAAqB,EAE1B,KAAK,sBAAsB,EAC3B,KAAK,sBAAsB,EAC5B,MAAM,aAAa,CAAC;AACrB,OAAO,EAEL,aAAa,EACb,KAAK,mBAAmB,EAEzB,MAAM,eAAe,CAAC;AACvB,OAAO,EAEL,KAAK,YAAY,EACjB,KAAK,cAAc,EACnB,KAAK,qBAAqB,EAC3B,MAAM,8BAA8B,CAAC;AAGtC,OAAO,EAAgD,KAAK,4BAA4B,EAAE,MAAM,0BAA0B,CAAC;AAE3H,MAAM,WAAW,+BAA+B;IAC9C,QAAQ,CAAC,OAAO,EAAE,OAAO,aAAa,CAAC;IACvC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,UAAU,EAAE,QAAQ,CAAC,mBAAmB,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC;CACrF;AAED,MAAM,WAAW,4BAA4B;IAC3C;;;;OAIG;IACH,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC;IACpD,+DAA+D;IAC/D,QAAQ,CAAC,MAAM,CAAC,EAAE,qBAAqB,CAAC;CACzC;AAED,iGAAiG;AACjG,qBAAa,qBAAqB;;gBAIpB,OAAO,GAAE,4BAAiC;IAItD,QAAQ,CAAC,UAAU,EAAE,qBAAqB,GAAG,IAAI;IAKjD,OAAO,IAAI,IAAI;IAIT,MAAM,CAAC,KAAK,EAAE,sBAAsB,EAAE,MAAM,EAAE,WAAW;IAUzD,IAAI,CAAC,OAAO,EAAE,kBAAkB,EAAE,MAAM,EAAE,WAAW;IAK3D,+EAA+E;IAC/E,IAAI,MAAM,IAAI,OAAO,CAEpB;IAED;;;OAGG;IACG,MAAM,CAAC,IAAI,EAAE,cAAc,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC;IAOpG,iEAAiE;IAC3D,IAAI,CAAC,KAAK,EAAE,oBAAoB,EAAE,MAAM,EAAE,WAAW;IAK3D,qDAAqD;IAC/C,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC;IAK/D,gFAAgF;IAC1E,QAAQ,CAAC,GAAG,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAS/C,MAAM,CAAC,KAAK,EAAE,sBAAsB,EAAE,MAAM,EAAE,WAAW;CAWhE;AAED,wBAAgB,sCAAsC,CACpD,OAAO,EAAE,qBAAqB,EAC9B,eAAe,CAAC,EAAE,4BAA4B,GAC7C,SAAS,+BAA+B,EAAE,CAqC5C"}