@agent-api/sdk 1.4.6 → 1.4.7

package/CHANGELOG.md

@@ -1,5 +1,15 @@
 # Changelog — @agent-api/sdk
 
+## 1.4.7
+
+### Added
+
+- Added warning-aware low-level local workdir listing via `listWithWarnings()`.
+
+### Fixed
+
+- Made local context packages use bounded recursive scans and expose `scan_warnings` for skipped child paths.
+
 ## 1.4.6
 
 ### Fixed

package/dist/local/context.d.ts

@@ -1,4 +1,4 @@
-import { type LocalFileDeliver, type LocalGrepResponse, type LocalPathSensitivity, type LocalPathSensitivityInfo, type LocalSummary, type LocalWorkdir, type LocalWorkdirSnapshotFile } from "./core.js";
+import { type LocalFileDeliver, type LocalGrepResponse, type LocalPathSensitivity, type LocalPathSensitivityInfo, type LocalScanWarning, type LocalSummary, type LocalWorkdir, type LocalWorkdirSnapshotFile } from "./core.js";
 export interface LocalContextPackageParams {
     path?: string;
     include?: string[];
@@ -7,6 +7,7 @@ export interface LocalContextPackageParams {
     maxFiles?: number;
     maxBytes?: number;
     maxBytesPerFile?: number;
+    maxDepth?: number;
     previewBytes?: number;
     includeContent?: boolean;
     includeHashes?: boolean;
@@ -38,6 +39,7 @@ export interface LocalContextManifest {
     included_bytes: number;
     truncated: boolean;
     files: LocalContextFile[];
+    scan_warnings?: LocalScanWarning[];
     summary?: LocalSummary;
     search?: LocalGrepResponse;
 }

package/dist/local/context.js

@@ -6,13 +6,14 @@ export async function createLocalContextPackage(workdir, params = {}) {
     const maxFiles = positiveInt(params.maxFiles, 80);
     const maxBytes = positiveInt(params.maxBytes, 256 * 1024);
     const maxBytesPerFile = positiveInt(params.maxBytesPerFile, 32 * 1024);
+    const maxDepth = positiveInt(params.maxDepth, 3);
     const previewBytes = positiveInt(params.previewBytes, maxBytesPerFile);
     const includeContent = params.includeContent ?? true;
     const includeHashes = params.includeHashes ?? true;
     const includeSummary = params.includeSummary ?? true;
     const includeSearch = Boolean(params.includeSearch && params.query?.trim());
     const includeSecrets = params.includeSecrets ?? false;
-    const stats = await workdir.list(basePath, { recursive: true });
+    const { stats, warnings } = await workdir.listWithWarnings(basePath, { recursive: true, maxDepth });
     const fileStats = stats
         .filter((item) => item.type === "file")
         .filter((item) => matchesPathFilters(item.path, params.include, params.exclude))
@@ -75,6 +76,7 @@ export async function createLocalContextPackage(workdir, params = {}) {
         ? await workdir.summarize({
             path: basePath,
             maxFiles,
+            maxDepth,
             previewBytes,
             ignore: params.exclude,
         })
@@ -99,6 +101,7 @@ export async function createLocalContextPackage(workdir, params = {}) {
         included_bytes: includedBytes,
         truncated,
         files,
+        scan_warnings: warnings.length ? warnings : undefined,
         summary,
         search,
     };

package/dist/local/core.d.ts

@@ -68,6 +68,10 @@ export interface LocalEntryList {
     entries: LocalEntry[];
     scan_warnings?: LocalScanWarning[];
 }
+export interface LocalFileStatList {
+    stats: LocalFileStat[];
+    warnings: LocalScanWarning[];
+}
 export interface LocalScanWarning {
     path: string;
     code?: string;
@@ -286,6 +290,7 @@ export declare class LocalFileStore {
     stat(relativePath?: string): Promise<LocalFileStat>;
     mkdir(relativePath?: string): Promise<string>;
     list(relativePath?: string, options?: LocalListOptions): Promise<LocalFileStat[]>;
+    listWithWarnings(relativePath?: string, options?: LocalListOptions): Promise<LocalFileStatList>;
     listEntries(relativePath?: string, options?: LocalListOptions): Promise<LocalEntryList>;
     searchEntries(params: LocalSearchEntriesParams): Promise<LocalEntryList>;
     readText(relativePath: string): Promise<string>;
@@ -317,7 +322,6 @@ export declare class LocalFileStore {
     grep(params: LocalGrepParams): Promise<LocalGrepResponse>;
     private grepCandidates;
     summarize(params?: LocalSummarizeParams): Promise<LocalSummary>;
-    private listWithWarnings;
     private walk;
 }
 export declare class LocalConfigStore {
@@ -348,6 +352,7 @@ export declare class LocalWorkdir {
     child(relativePath: string, options?: LocalWorkdirOptions): LocalWorkdir;
     resolvePath(relativePath?: string): string;
     list(relativePath?: string, options?: LocalListOptions): Promise<LocalFileStat[]>;
+    listWithWarnings(relativePath?: string, options?: LocalListOptions): Promise<LocalFileStatList>;
     listEntries(relativePath?: string, options?: LocalListOptions): Promise<LocalEntryList>;
     searchEntries(params: LocalSearchEntriesParams): Promise<LocalEntryList>;
     readFile(relativePath: string, params: LocalReadFileRawParams): Promise<LocalFileRaw>;

package/dist/local/core.js

@@ -141,6 +141,14 @@ export class LocalFileStore {
     async list(relativePath = ".", options = {}) {
         return (await this.listWithWarnings(relativePath, options)).stats;
     }
+    async listWithWarnings(relativePath = ".", options = {}) {
+        const base = this.resolvePath(relativePath);
+        const maxDepth = options.recursive ? options.maxDepth ?? Number.POSITIVE_INFINITY : 1;
+        const out = [];
+        const warnings = [];
+        await this.walk(this.root, base, base, out, maxDepth, options, warnings);
+        return { stats: out.sort((a, b) => a.path.localeCompare(b.path)), warnings };
+    }
     async listEntries(relativePath = ".", options = {}) {
         const { stats, warnings } = await this.listWithWarnings(relativePath, { ...options, includeDirectories: options.includeDirectories ?? true });
         return withScanWarnings({ object: "list", entries: stats.map(localEntryFromStat) }, warnings);
@@ -408,14 +416,6 @@ export class LocalFileStore {
             scan_truncated: scanTruncated,
         }, warnings);
     }
-    async listWithWarnings(relativePath = ".", options = {}) {
-        const base = this.resolvePath(relativePath);
-        const maxDepth = options.recursive ? options.maxDepth ?? Number.POSITIVE_INFINITY : 1;
-        const out = [];
-        const warnings = [];
-        await this.walk(this.root, base, base, out, maxDepth, options, warnings);
-        return { stats: out.sort((a, b) => a.path.localeCompare(b.path)), warnings };
-    }
     async walk(storeRoot, scanRoot, dir, out, maxDepth, options, warnings) {
         let entries;
         try {
@@ -562,6 +562,9 @@ export class LocalWorkdir {
     async list(relativePath = ".", options = {}) {
         return await this.files.list(relativePath, this.scopedListOptions(options));
     }
+    async listWithWarnings(relativePath = ".", options = {}) {
+        return await this.files.listWithWarnings(relativePath, this.scopedListOptions(options));
+    }
     async listEntries(relativePath = ".", options = {}) {
         return await this.files.listEntries(relativePath, this.scopedListOptions(options));
     }

package/dist/local/tools.js

@@ -255,6 +255,7 @@ function contextPackageArgs(args) {
         maxFiles: optionalNumberArg(args, "maxFiles", "max_files"),
         maxBytes: optionalNumberArg(args, "maxBytes", "max_bytes"),
         maxBytesPerFile: optionalNumberArg(args, "maxBytesPerFile", "max_bytes_per_file"),
+        maxDepth: optionalNumberArg(args, "maxDepth", "max_depth"),
         includeContent: optionalBooleanArg(args, "includeContent", "include_content"),
         includeSummary: optionalBooleanArg(args, "includeSummary", "include_summary"),
         includeSearch: optionalBooleanArg(args, "includeSearch", "include_search"),

package/dist/version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "1.4.6";
-export declare const USER_AGENT = "@agent-api/sdk/1.4.6";
+export declare const VERSION = "1.4.7";
+export declare const USER_AGENT = "@agent-api/sdk/1.4.7";

package/dist/version.js

@@ -1,2 +1,2 @@
-export const VERSION = "1.4.6";
+export const VERSION = "1.4.7";
 export const USER_AGENT = `@agent-api/sdk/${VERSION}`;

package/dist-cjs/local/context.js

@@ -10,13 +10,14 @@ async function createLocalContextPackage(workdir, params = {}) {
     const maxFiles = positiveInt(params.maxFiles, 80);
     const maxBytes = positiveInt(params.maxBytes, 256 * 1024);
     const maxBytesPerFile = positiveInt(params.maxBytesPerFile, 32 * 1024);
+    const maxDepth = positiveInt(params.maxDepth, 3);
     const previewBytes = positiveInt(params.previewBytes, maxBytesPerFile);
     const includeContent = params.includeContent ?? true;
     const includeHashes = params.includeHashes ?? true;
     const includeSummary = params.includeSummary ?? true;
     const includeSearch = Boolean(params.includeSearch && params.query?.trim());
     const includeSecrets = params.includeSecrets ?? false;
-    const stats = await workdir.list(basePath, { recursive: true });
+    const { stats, warnings } = await workdir.listWithWarnings(basePath, { recursive: true, maxDepth });
     const fileStats = stats
         .filter((item) => item.type === "file")
         .filter((item) => matchesPathFilters(item.path, params.include, params.exclude))
@@ -79,6 +80,7 @@ async function createLocalContextPackage(workdir, params = {}) {
         ? await workdir.summarize({
             path: basePath,
             maxFiles,
+            maxDepth,
             previewBytes,
             ignore: params.exclude,
         })
@@ -103,6 +105,7 @@ async function createLocalContextPackage(workdir, params = {}) {
         included_bytes: includedBytes,
         truncated,
         files,
+        scan_warnings: warnings.length ? warnings : undefined,
         summary,
         search,
     };

package/dist-cjs/local/core.js

@@ -156,6 +156,14 @@ class LocalFileStore {
     async list(relativePath = ".", options = {}) {
         return (await this.listWithWarnings(relativePath, options)).stats;
     }
+    async listWithWarnings(relativePath = ".", options = {}) {
+        const base = this.resolvePath(relativePath);
+        const maxDepth = options.recursive ? options.maxDepth ?? Number.POSITIVE_INFINITY : 1;
+        const out = [];
+        const warnings = [];
+        await this.walk(this.root, base, base, out, maxDepth, options, warnings);
+        return { stats: out.sort((a, b) => a.path.localeCompare(b.path)), warnings };
+    }
     async listEntries(relativePath = ".", options = {}) {
         const { stats, warnings } = await this.listWithWarnings(relativePath, { ...options, includeDirectories: options.includeDirectories ?? true });
         return withScanWarnings({ object: "list", entries: stats.map(localEntryFromStat) }, warnings);
@@ -423,14 +431,6 @@ class LocalFileStore {
             scan_truncated: scanTruncated,
         }, warnings);
     }
-    async listWithWarnings(relativePath = ".", options = {}) {
-        const base = this.resolvePath(relativePath);
-        const maxDepth = options.recursive ? options.maxDepth ?? Number.POSITIVE_INFINITY : 1;
-        const out = [];
-        const warnings = [];
-        await this.walk(this.root, base, base, out, maxDepth, options, warnings);
-        return { stats: out.sort((a, b) => a.path.localeCompare(b.path)), warnings };
-    }
     async walk(storeRoot, scanRoot, dir, out, maxDepth, options, warnings) {
         let entries;
         try {
@@ -580,6 +580,9 @@ class LocalWorkdir {
     async list(relativePath = ".", options = {}) {
         return await this.files.list(relativePath, this.scopedListOptions(options));
     }
+    async listWithWarnings(relativePath = ".", options = {}) {
+        return await this.files.listWithWarnings(relativePath, this.scopedListOptions(options));
+    }
     async listEntries(relativePath = ".", options = {}) {
         return await this.files.listEntries(relativePath, this.scopedListOptions(options));
     }

package/dist-cjs/local/tools.js

@@ -262,6 +262,7 @@ function contextPackageArgs(args) {
         maxFiles: optionalNumberArg(args, "maxFiles", "max_files"),
         maxBytes: optionalNumberArg(args, "maxBytes", "max_bytes"),
         maxBytesPerFile: optionalNumberArg(args, "maxBytesPerFile", "max_bytes_per_file"),
+        maxDepth: optionalNumberArg(args, "maxDepth", "max_depth"),
         includeContent: optionalBooleanArg(args, "includeContent", "include_content"),
         includeSummary: optionalBooleanArg(args, "includeSummary", "include_summary"),
         includeSearch: optionalBooleanArg(args, "includeSearch", "include_search"),

package/dist-cjs/version.js

@@ -1,5 +1,5 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.USER_AGENT = exports.VERSION = void 0;
-exports.VERSION = "1.4.6";
+exports.VERSION = "1.4.7";
 exports.USER_AGENT = `@agent-api/sdk/${exports.VERSION}`;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-api/sdk",
-  "version": "1.4.6",
+  "version": "1.4.7",
   "description": "Production JavaScript SDK for the Managed Agent API",
   "license": "MIT",
   "repository": {