@easynet/agent-tool 1.0.97 → 1.0.98

package/README.md

@@ -15,12 +15,16 @@
 Create `tool.yaml`:
 
 ```yaml
-tools:
+apiVersion: easynet.world/v1
+kind: ToolConfig
+metadata:
+  name: agent-tool-default
+spec:
   sandboxedPath: .
   allowedHosts: []
   blockedHosts: []
-  list:
-    - npm:@easynet/agent-tool-buildin
+  tools:
+    npm:@easynet/agent-tool-buildin: {}
 ```
 
 Load tools:
@@ -45,18 +49,17 @@ kind: ToolConfig
 metadata:
   name: agent-tool-default
 spec:
+  sandboxedPath: .
+  allowedHosts: []
+  blockedHosts: []
   tools:
-    sandboxedPath: .
-    allowedHosts: []
-    blockedHosts: []
-    list:
-      - npm:@easynet/agent-tool-buildin
+    npm:@easynet/agent-tool-buildin: {}
 ```
 
 Explanation:
 
-- `spec.tools.sandboxedPath`: root directory allowed for filesystem tools.
-- `spec.tools.allowedHosts`: allowlist for outbound HTTP tools.
-- `spec.tools.blockedHosts`: denylist for outbound HTTP tools.
-- `spec.tools.list`: tool packages or tool descriptors to load.
-- `npm:@easynet/agent-tool-buildin`: load the built-in tool extension package.
+- `spec.sandboxedPath`: root directory allowed for filesystem tools.
+- `spec.allowedHosts`: allowlist for outbound HTTP tools.
+- `spec.blockedHosts`: denylist for outbound HTTP tools.
+- `spec.tools`: keyed by tool source descriptor.
+- `npm:@easynet/agent-tool-buildin: {}`: load the built-in tool extension package with default config.

package/config/tool.yaml

@@ -3,9 +3,8 @@ kind: ToolConfig
 metadata:
   name: agent-tool-default
 spec:
+  sandboxedPath: .
+  allowedHosts: []
+  blockedHosts: []
   tools:
-    sandboxedPath: .
-    allowedHosts: []
-    blockedHosts: []
-    list:
-      - npm:@easynet/agent-tool-buildin
+    npm:@easynet/agent-tool-buildin: {}

package/dist/agent-context.d.ts

@@ -1,3 +1,3 @@
-import { type AgentContext } from "@easynet/agent-common/context";
+import { type AgentContext } from "@easynet/agent-common";
 export declare function getDefaultAgentContext(): AgentContext;
 //# sourceMappingURL=agent-context.d.ts.map

package/dist/agent-context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent-context.d.ts","sourceRoot":"","sources":["../src/agent-context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsB,KAAK,YAAY,EAAE,MAAM,+BAA+B,CAAC;AActF,wBAAgB,sBAAsB,IAAI,YAAY,CAQrD"}
+{"version":3,"file":"agent-context.d.ts","sourceRoot":"","sources":["../src/agent-context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsB,KAAK,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAc9E,wBAAgB,sBAAsB,IAAI,YAAY,CAQrD"}

package/dist/api/createAgentTools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"createAgentTools.d.ts","sourceRoot":"","sources":["../../src/api/createAgentTools.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAaH,OAAO,KAAK,EAAE,oBAAoB,EAAmB,MAAM,wBAAwB,CAAC;AAEpF,OAAO,EAAmB,KAAK,gBAAgB,EAAE,KAAK,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAC/F,OAAO,EAEL,KAAK,iBAAiB,EACtB,KAAK,wBAAwB,EAC9B,MAAM,yBAAyB,CAAC;AACjC,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAKrE,MAAM,WAAW,uBAAwB,SAAQ,oBAAoB;IACnE,2GAA2G;IAC3G,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AA6LD;;;;;;;;;GASG;AACH,wBAAgB,yBAAyB,CACvC,OAAO,CAAC,EAAE,uBAAuB,GAAG,MAAM,GACzC,uBAAuB,EAAE,CAa3B;AAED;;;;;;;;;GASG;AACH,wBAAsB,eAAe,CACnC,OAAO,CAAC,EAAE,CAAC,uBAAuB,GAAG,gBAAgB,CAAC,GAAG,MAAM,GAC9D,OAAO,CAAC,SAAS,CAAC,CAWpB;AAED;;;;;;;;;GASG;AACH,wBAAsB,mBAAmB,CACvC,OAAO,CAAC,EAAE,CAAC,uBAAuB,GAAG,wBAAwB,CAAC,GAAG,MAAM,GACtE,OAAO,CAAC,iBAAiB,CAAC,CAW5B"}
+{"version":3,"file":"createAgentTools.d.ts","sourceRoot":"","sources":["../../src/api/createAgentTools.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAaH,OAAO,KAAK,EAAE,oBAAoB,EAAmB,MAAM,wBAAwB,CAAC;AAEpF,OAAO,EAAmB,KAAK,gBAAgB,EAAE,KAAK,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAC/F,OAAO,EAEL,KAAK,iBAAiB,EACtB,KAAK,wBAAwB,EAC9B,MAAM,yBAAyB,CAAC;AACjC,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAOrE,MAAM,WAAW,uBAAwB,SAAQ,oBAAoB;IACnE,2GAA2G;IAC3G,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAoRD;;;;;;;;;GASG;AACH,wBAAgB,yBAAyB,CACvC,OAAO,CAAC,EAAE,uBAAuB,GAAG,MAAM,GACzC,uBAAuB,EAAE,CAa3B;AAED;;;;;;;;;GASG;AACH,wBAAsB,eAAe,CACnC,OAAO,CAAC,EAAE,CAAC,uBAAuB,GAAG,gBAAgB,CAAC,GAAG,MAAM,GAC9D,OAAO,CAAC,SAAS,CAAC,CAWpB;AAED;;;;;;;;;GASG;AACH,wBAAsB,mBAAmB,CACvC,OAAO,CAAC,EAAE,CAAC,uBAAuB,GAAG,wBAAwB,CAAC,GAAG,MAAM,GACtE,OAAO,CAAC,iBAAiB,CAAC,CAW5B"}

package/dist/api/expose/extension-init/initExtension.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"initExtension.d.ts","sourceRoot":"","sources":["../../../../src/api/expose/extension-init/initExtension.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,MAAM,WAAW,oBAAoB;IACnC,8CAA8C;IAC9C,aAAa,EAAE,MAAM,CAAC;IACtB,iDAAiD;IACjD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,iFAAiF;IACjF,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AA+KD;;;GAGG;AACH,wBAAsB,aAAa,CACjC,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CAuBzD"}
+{"version":3,"file":"initExtension.d.ts","sourceRoot":"","sources":["../../../../src/api/expose/extension-init/initExtension.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,MAAM,WAAW,oBAAoB;IACnC,8CAA8C;IAC9C,aAAa,EAAE,MAAM,CAAC;IACtB,iDAAiD;IACjD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,iFAAiF;IACjF,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AA8KD;;;GAGG;AACH,wBAAsB,aAAa,CACjC,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CAuBzD"}

package/dist/api/extension/registerExtension.d.ts

@@ -21,6 +21,7 @@ export interface RegisterExtensionOptions<TContext> {
     /** Filter: only register tools whose name starts with one of these prefixes. */
     namePrefixes?: string[];
 }
+export declare function deriveConfigPrefixCandidates(prefixWithVersion: string): string[];
 /**
  * Load manifest from package (pre-built JSON; no @tool scanning). Register all specs, create and return adapter.
  */

package/dist/api/extension/registerExtension.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"registerExtension.d.ts","sourceRoot":"","sources":["../../../src/api/extension/registerExtension.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAChE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qCAAqC,CAAC;AACxE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAClE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAMxD,MAAM,WAAW,wBAAwB,CAAC,QAAQ;IAChD,sFAAsF;IACtF,WAAW,EAAE,MAAM,CAAC;IACpB,gEAAgE;IAChE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,+IAA+I;IAC/I,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,sEAAsE;IACtE,gBAAgB,EAAE,MAAM,aAAa,CAAC,QAAQ,CAAC,CAAC;IAChD,8CAA8C;IAC9C,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,gFAAgF;IAChF,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,SAAS;IAAE,OAAO,EAAE,WAAW,CAAC;IAAC,MAAM,EAAE,OAAO,CAAA;CAAE,EAC1F,QAAQ,EAAE,YAAY,EACtB,OAAO,EAAE,wBAAwB,CAAC,QAAQ,CAAC,GAC1C,WAAW,CAgEb"}
+{"version":3,"file":"registerExtension.d.ts","sourceRoot":"","sources":["../../../src/api/extension/registerExtension.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAChE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qCAAqC,CAAC;AACxE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAClE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAMxD,MAAM,WAAW,wBAAwB,CAAC,QAAQ;IAChD,sFAAsF;IACtF,WAAW,EAAE,MAAM,CAAC;IACpB,gEAAgE;IAChE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,+IAA+I;IAC/I,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,sEAAsE;IACtE,gBAAgB,EAAE,MAAM,aAAa,CAAC,QAAQ,CAAC,CAAC;IAChD,8CAA8C;IAC9C,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,gFAAgF;IAChF,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB;AAED,wBAAgB,4BAA4B,CAAC,iBAAiB,EAAE,MAAM,GAAG,MAAM,EAAE,CAUhF;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,SAAS;IAAE,OAAO,EAAE,WAAW,CAAC;IAAC,MAAM,EAAE,OAAO,CAAA;CAAE,EAC1F,QAAQ,EAAE,YAAY,EACtB,OAAO,EAAE,wBAAwB,CAAC,QAAQ,CAAC,GAC1C,WAAW,CA8Db"}

package/dist/{chunk-2TFGOUXN.cjs → chunk-GNYBAJZZ.cjs}

@@ -46,6 +46,20 @@ function normalizeOpenApiConfig(raw) {
   if (typeof source.port === "number" && Number.isFinite(source.port)) out.port = source.port;
   return Object.keys(out).length > 0 ? out : void 0;
 }
+function normalizeToolSources(raw) {
+  if (!raw || typeof raw !== "object" || Array.isArray(raw)) return void 0;
+  const out = {};
+  for (const [sourceKey, sourceValue] of Object.entries(raw)) {
+    if (!sourceValue || typeof sourceValue !== "object" || Array.isArray(sourceValue)) continue;
+    const toolMap = {};
+    for (const [toolName, toolValue] of Object.entries(sourceValue)) {
+      if (!toolValue || typeof toolValue !== "object" || Array.isArray(toolValue)) continue;
+      toolMap[toolName] = toolValue;
+    }
+    out[sourceKey] = toolMap;
+  }
+  return Object.keys(out).length > 0 ? out : void 0;
+}
 function loadToolConfig(toolYamlPath) {
   const abs = path.resolve(toolYamlPath);
   const raw = fs.readFileSync(abs, "utf8");
@@ -54,41 +68,21 @@ function loadToolConfig(toolYamlPath) {
   });
   if (!parsed || typeof parsed !== "object") return {};
   const source = parsed.spec && typeof parsed.spec === "object" && !Array.isArray(parsed.spec) ? parsed.spec : parsed;
-  const mcpConfig = normalizeMcpConfig(source.expose?.mcp ?? source.mcp);
-  const openApiConfig = normalizeOpenApiConfig(source.expose?.openapi ?? source.openapi);
-  const toolsBlock = source.tools;
-  if (toolsBlock != null && typeof toolsBlock === "object" && !Array.isArray(toolsBlock)) {
-    const toolDefaults = toolsBlock.defaults != null && typeof toolsBlock.defaults === "object" && !Array.isArray(toolsBlock.defaults) ? toolsBlock.defaults : void 0;
-    const packageToolDefaults2 = toolsBlock.packages != null && typeof toolsBlock.packages === "object" && !Array.isArray(toolsBlock.packages) ? toolsBlock.packages : void 0;
-    const list2 = Array.isArray(toolsBlock.list) && toolsBlock.list.length > 0 ? toolsBlock.list : void 0;
-    return {
-      tools: list2 ?? (packageToolDefaults2 ? Object.keys(packageToolDefaults2) : void 0),
-      sandboxedPath: typeof toolsBlock.sandboxedPath === "string" ? toolsBlock.sandboxedPath : source.sandboxedPath,
-      enableSandboxValidation: typeof toolsBlock.enableSandboxValidation === "boolean" ? toolsBlock.enableSandboxValidation : source.enableSandboxValidation,
-      allowedHosts: Array.isArray(toolsBlock.allowedHosts) ? toolsBlock.allowedHosts : source.allowedHosts,
-      blockedHosts: Array.isArray(toolsBlock.blockedHosts) ? toolsBlock.blockedHosts : source.blockedHosts,
-      blockedCidrs: Array.isArray(toolsBlock.blockedCidrs) ? toolsBlock.blockedCidrs : source.blockedCidrs,
-      toolDefaults,
-      packageToolDefaults: packageToolDefaults2,
-      mcp: mcpConfig,
-      openapi: openApiConfig
-    };
-  }
-  const packageToolDefaults = typeof source.packageToolDefaults === "object" && !Array.isArray(source.packageToolDefaults) ? source.packageToolDefaults : void 0;
-  const list = Array.isArray(source.tools) && source.tools.length > 0 ? source.tools : void 0;
   return {
-    tools: list ?? (packageToolDefaults ? Object.keys(packageToolDefaults) : void 0),
-    sandboxedPath: source.sandboxedPath,
+    sandboxedPath: typeof source.sandboxedPath === "string" ? source.sandboxedPath : void 0,
     enableSandboxValidation: typeof source.enableSandboxValidation === "boolean" ? source.enableSandboxValidation : void 0,
     allowedHosts: Array.isArray(source.allowedHosts) ? source.allowedHosts : void 0,
     blockedHosts: Array.isArray(source.blockedHosts) ? source.blockedHosts : void 0,
     blockedCidrs: Array.isArray(source.blockedCidrs) ? source.blockedCidrs : void 0,
-    toolDefaults: typeof source.toolDefaults === "object" && !Array.isArray(source.toolDefaults) ? source.toolDefaults : void 0,
-    packageToolDefaults,
-    mcp: mcpConfig,
-    openapi: openApiConfig
+    tools: normalizeToolSources(source.tools),
+    mcp: normalizeMcpConfig(source.expose?.mcp ?? source.mcp),
+    openapi: normalizeOpenApiConfig(source.expose?.openapi ?? source.openapi)
   };
 }
+function getToolSourceDescriptors(config, options) {
+  const includeSelf = options?.includeSelf ?? false;
+  return Object.keys(config.tools ?? {}).filter((key) => includeSelf || key !== "self");
+}
 function resolveSandboxedPath(toolYamlPath, sandboxedPath) {
   const configDir = path.dirname(path.resolve(toolYamlPath));
   return config.resolveConfigPath(sandboxedPath, configDir, {
@@ -182,23 +176,6 @@ function npmDescriptorToPackagePrefix(descriptor) {
   if (!normalized) return "";
   return "npm." + normalized;
 }
-function npmDescriptorToPackagePrefixWithVersion(descriptor) {
-  const s = descriptor.trim();
-  if (typeof s !== "string" || !s.startsWith("npm:")) return "";
-  const rest = s.slice(4).trim();
-  const hashIdx = rest.indexOf("#");
-  const beforeHash = hashIdx < 0 ? rest : rest.slice(0, hashIdx);
-  const lastAt = beforeHash.lastIndexOf("@");
-  const scopeAndPackage = lastAt <= 0 ? beforeHash : beforeHash.slice(0, lastAt);
-  const version = lastAt <= 0 ? "" : beforeHash.slice(lastAt + 1).trim();
-  const slashIdx = scopeAndPackage.indexOf("/");
-  const scope = slashIdx < 0 ? scopeAndPackage : scopeAndPackage.slice(0, slashIdx).replace(/^@/, "");
-  const pkg = slashIdx < 0 ? "" : scopeAndPackage.slice(slashIdx + 1);
-  const segment = [scope, pkg, version].filter(Boolean).join(".");
-  const normalized = chunkJW4EMVTE_cjs.normalizeToolName(segment);
-  if (!normalized) return "";
-  return "npm." + normalized;
-}
 function getDisplayScope(registryName, _kind, _toolVersion) {
   const i = registryName.indexOf(".");
   return i < 0 ? registryName : registryName.slice(0, i);
@@ -1909,7 +1886,7 @@ async function importFromCache(packageRoot) {
     fileUrl
   );
 }
-var requireFromPackage = module$1.createRequire((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('chunk-2TFGOUXN.cjs', document.baseURI).href)));
+var requireFromPackage = module$1.createRequire((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('chunk-GNYBAJZZ.cjs', document.baseURI).href)));
 function getProjectRequire() {
   const cwd = process.cwd();
   if (fs.existsSync(path.join(cwd, "package.json"))) return module$1.createRequire(path.join(cwd, "package.json"));
@@ -2075,7 +2052,7 @@ function parseNpmDescriptor(entry) {
 }
 
 // src/api/runtimeFromConfig.ts
-var requireFromPackage2 = module$1.createRequire((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('chunk-2TFGOUXN.cjs', document.baseURI).href)));
+var requireFromPackage2 = module$1.createRequire((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('chunk-GNYBAJZZ.cjs', document.baseURI).href)));
 var DEFAULT_EXTENSION_PACKAGES = [];
 function resolveFileDescriptorPath(descriptor, configFilePath) {
   const parsed = parseToolPath(descriptor.trim());
@@ -2178,7 +2155,7 @@ function loadAllExtensionsFromToolYamlSync(configFilePath, stepLog) {
   const localPath = path.isAbsolute(configFilePath) ? configFilePath : path.resolve(process.cwd(), configFilePath);
   if (!fs.existsSync(localPath)) return [];
   const config = loadToolConfig(localPath);
-  const tools = config.tools;
+  const tools = getToolSourceDescriptors(config);
   if (!Array.isArray(tools) || tools.length === 0) return [];
   if (stepLog) stepLog("Loading extensions from tool.yaml (npm + file)");
   const loaded = [];
@@ -2281,7 +2258,7 @@ async function loadAllExtensionsFromToolYamlAsync(configFilePath, stepLog) {
   const localPath = path.isAbsolute(configFilePath) ? configFilePath : path.resolve(process.cwd(), configFilePath);
   if (!fs.existsSync(localPath)) return [];
   const config = loadToolConfig(localPath);
-  const tools = config.tools;
+  const tools = getToolSourceDescriptors(config);
   if (!Array.isArray(tools) || tools.length === 0) return [];
   if (stepLog) stepLog("Loading extensions from tool.yaml (async)");
   const loaded = [];
@@ -2949,13 +2926,14 @@ exports.expandToolDescriptorsToRegistryNames = expandToolDescriptorsToRegistryNa
 exports.fileDescriptorToPackagePrefix = fileDescriptorToPackagePrefix;
 exports.findAndLoadToolConfig = findAndLoadToolConfig;
 exports.getDisplayScope = getDisplayScope;
+exports.getToolSourceDescriptors = getToolSourceDescriptors;
 exports.isBarePackageDescriptor = isBarePackageDescriptor;
 exports.loadAllExtensionsFromToolYamlSync = loadAllExtensionsFromToolYamlSync;
 exports.loadToolConfig = loadToolConfig;
-exports.npmDescriptorToPackagePrefixWithVersion = npmDescriptorToPackagePrefixWithVersion;
+exports.npmDescriptorToPackagePrefix = npmDescriptorToPackagePrefix;
 exports.resolveSandboxedPath = resolveSandboxedPath;
 exports.resolveToolDescriptor = resolveToolDescriptor;
 exports.runMCPServerOverStdio = runMCPServerOverStdio;
 exports.toToolObservationText = toToolObservationText;
-//# sourceMappingURL=chunk-2TFGOUXN.cjs.map
-//# sourceMappingURL=chunk-2TFGOUXN.cjs.map
+//# sourceMappingURL=chunk-GNYBAJZZ.cjs.map
+//# sourceMappingURL=chunk-GNYBAJZZ.cjs.map