@easynet/agent-tool 1.0.1 → 1.0.2

package/dist/tools/scanPackage.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Scan package for tools: scanForAllTools, scanPackageForTools, registerPackageTools.
+ * Aggregates function/skill/n8n discovery and optional directory discovery.
+ */
+import type { ToolSpec } from "../core/types/ToolSpec.js";
+export interface ScanAllToolsResult {
+    specs: ToolSpec[];
+    errors: Array<{
+        file: string;
+        message: string;
+    }>;
+    warnings: Array<{
+        file: string;
+        message: string;
+    }>;
+}
+export interface ScanAllToolsOptions {
+    include?: string[];
+    tsconfigPath?: string;
+    includeN8n?: boolean;
+}
+export declare function scanForAllTools(projectPath: string, options?: ScanAllToolsOptions): Promise<ScanAllToolsResult>;
+export interface ScanPackageResult {
+    specs: ToolSpec[];
+    errors: Array<{
+        file: string;
+        message: string;
+    }>;
+    warnings: Array<{
+        file: string;
+        message: string;
+    }>;
+}
+export interface ScanPackageOptions extends ScanAllToolsOptions {
+    includeDirectoryDiscovery?: boolean;
+    namespace?: string;
+}
+export declare function scanPackageForTools(packagePath: string, options?: ScanPackageOptions): Promise<ScanPackageResult>;
+export declare function registerPackageTools(registry: {
+    bulkRegister: (specs: ToolSpec[]) => void;
+}, packagePath: string, options?: ScanPackageOptions): Promise<ScanPackageResult>;
+//# sourceMappingURL=scanPackage.d.ts.map

package/dist/tools/scanPackage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scanPackage.d.ts","sourceRoot":"","sources":["../../src/tools/scanPackage.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAO1D,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,QAAQ,EAAE,CAAC;IAClB,MAAM,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACjD,QAAQ,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACpD;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,wBAAsB,eAAe,CACnC,WAAW,EAAE,MAAM,EACnB,OAAO,GAAE,mBAAwB,GAChC,OAAO,CAAC,kBAAkB,CAAC,CAgB7B;AAED,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,QAAQ,EAAE,CAAC;IAClB,MAAM,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACjD,QAAQ,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACpD;AAED,MAAM,WAAW,kBAAmB,SAAQ,mBAAmB;IAC7D,yBAAyB,CAAC,EAAE,OAAO,CAAC;IACpC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wBAAsB,mBAAmB,CACvC,WAAW,EAAE,MAAM,EACnB,OAAO,GAAE,kBAAuB,GAC/B,OAAO,CAAC,iBAAiB,CAAC,CAwC5B;AAED,wBAAsB,oBAAoB,CACxC,QAAQ,EAAE;IAAE,YAAY,EAAE,CAAC,KAAK,EAAE,QAAQ,EAAE,KAAK,IAAI,CAAA;CAAE,EACvD,WAAW,EAAE,MAAM,EACnB,OAAO,GAAE,kBAAuB,GAC/B,OAAO,CAAC,iBAAiB,CAAC,CAI5B"}

package/dist/{discovery/load → tools/skill}/SkillLoader.d.ts

@@ -1,4 +1,4 @@
-import type { ToolManifest, LoadedTool } from "../types.js";
+import type { ToolManifest, LoadedTool } from "../discoveryFactory.js";
 /**
  * Load a Skill tool from its directory following Anthropic's Agent Skills spec.
  *

package/dist/tools/skill/SkillLoader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SkillLoader.d.ts","sourceRoot":"","sources":["../../../src/tools/skill/SkillLoader.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAuGvE;;;;;;;;;;GAUG;AACH,wBAAsB,aAAa,CACjC,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,YAAY,EACtB,UAAU,CAAC,EAAE,MAAM,EAAE,GACpB,OAAO,CAAC,UAAU,CAAC,CAMrB;AAED;;;;GAIG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,YAAY,EACtB,UAAU,CAAC,EAAE,MAAM,EAAE,GACpB,OAAO,CAAC,UAAU,EAAE,CAAC,CA8DvB"}

package/dist/tools/skill/SkillManifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SkillManifest.d.ts","sourceRoot":"","sources":["../../../src/tools/skill/SkillManifest.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;;;OAIG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;;OAGG;IACH,WAAW,EAAE,MAAM,CAAC;IAEpB,0EAA0E;IAC1E,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,8DAA8D;IAC9D,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB,8CAA8C;IAC9C,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAElC,2EAA2E;IAC3E,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,6CAA6C;IAC7C,YAAY,EAAE,MAAM,CAAC;IACrB,4BAA4B;IAC5B,YAAY,EAAE,MAAM,CAAC;IACrB,mDAAmD;IACnD,SAAS,EAAE,MAAM,CAAC;IAClB,4CAA4C;IAC5C,IAAI,EAAE,cAAc,GAAG,MAAM,GAAG,MAAM,CAAC;CACxC;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,2EAA2E;IAC3E,WAAW,EAAE,gBAAgB,CAAC;IAE9B,gGAAgG;IAChG,YAAY,EAAE,MAAM,CAAC;IAErB,gFAAgF;IAChF,SAAS,EAAE,aAAa,EAAE,CAAC;IAE3B,2CAA2C;IAC3C,OAAO,EAAE,MAAM,CAAC;IAEhB,yCAAyC;IACzC,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,qBAAa,kBAAmB,SAAQ,KAAK;aAEzB,IAAI,EAAE,MAAM;aACZ,KAAK,EAAE,MAAM;gBADb,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EAC7B,OAAO,EAAE,MAAM;CAKlB;AAWD;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,EAAE,EAAE,OAAO,CAAC,gBAAgB,CAAC,EAC7B,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,EAAE,IAAI,gBAAgB,CA+EhC"}

package/dist/tools/skill/SkillMdParser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SkillMdParser.d.ts","sourceRoot":"","sources":["../../../src/tools/skill/SkillMdParser.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,eAAe,EACf,gBAAgB,EAChB,aAAa,EACd,MAAM,oBAAoB,CAAC;AAgB5B;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,YAAY,CAC1B,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,GACf;IAAE,WAAW,EAAE,gBAAgB,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,CAsEzD;AA8CD;;;GAGG;AACH,wBAAsB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC,CAIlF;AAgDD;;;GAGG;AACH,wBAAsB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAwBnF"}

package/dist/tools/skill/directoryApply.d.ts

@@ -0,0 +1,10 @@
+import type { ToolSpec } from "../../core/types/ToolSpec.js";
+import type { LoadedTool, ToolManifest } from "../discoveryFactory.js";
+/** Apply skill-loaded tool to spec (implementation in skill, not in factory). */
+export declare function applyLoadedToSpec(spec: ToolSpec, loaded: LoadedTool, manifest: ToolManifest, defaultDirName: string, namespace: string): void;
+export declare const directoryMarker: {
+    kind: "skill";
+    markerFile: string;
+    defaultEntryPoint: string;
+};
+//# sourceMappingURL=directoryApply.d.ts.map

package/dist/tools/skill/directoryApply.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"directoryApply.d.ts","sourceRoot":"","sources":["../../../src/tools/skill/directoryApply.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAC;AAC7D,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAEvE,iFAAiF;AACjF,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,QAAQ,EACd,MAAM,EAAE,UAAU,EAClB,QAAQ,EAAE,YAAY,EACtB,cAAc,EAAE,MAAM,EACtB,SAAS,EAAE,MAAM,GAChB,IAAI,CAyBN;AAED,eAAO,MAAM,eAAe;;;;CAI3B,CAAC"}

package/dist/tools/skill/index.d.ts

@@ -0,0 +1,8 @@
+export { scanForSkill, scan } from "./scanSkill.js";
+export type { ScanSkillResult } from "./scanSkill.js";
+export { loadSkillTool, loadSkillTools } from "./SkillLoader.js";
+export { loadSkillDefinition, parseSkillMd, scanSkillResources } from "./SkillMdParser.js";
+export type { SkillDefinition, SkillFrontmatter, SkillResource } from "./SkillManifest.js";
+export { validateFrontmatter, SkillManifestError } from "./SkillManifest.js";
+export type { SkillToolSpec } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/tools/skill/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/skill/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AACpD,YAAY,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACjE,OAAO,EAAE,mBAAmB,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAC3F,YAAY,EAAE,eAAe,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAC3F,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAC7E,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC"}

package/dist/tools/skill/scanSkill.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Scan project for SKILL.md directories; produce MCP tool specs.
+ * Exposes both scanForSkill (raw) and scan (unified DiscoverToolsResult).
+ */
+import type { SkillToolSpec } from "./types.js";
+import type { DiscoverToolsOptions, DiscoverToolsResult } from "../discoveryFactory.js";
+export interface ScanSkillResult {
+    skills: SkillToolSpec[];
+    errors: Array<{
+        dir: string;
+        message: string;
+    }>;
+}
+/**
+ * Scan projectPath for SKILL.md directories; return skill tool specs.
+ */
+export declare function scanForSkill(projectPath: string): Promise<ScanSkillResult>;
+/** Unified scan: (path, options) → DiscoverToolsResult. */
+export declare function scan(projectPath: string, _options?: DiscoverToolsOptions): Promise<DiscoverToolsResult>;
+//# sourceMappingURL=scanSkill.d.ts.map

package/dist/tools/skill/scanSkill.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scanSkill.d.ts","sourceRoot":"","sources":["../../../src/tools/skill/scanSkill.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD,OAAO,KAAK,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAGxF,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,aAAa,EAAE,CAAC;IACxB,MAAM,EAAE,KAAK,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACjD;AAID;;GAEG;AACH,wBAAsB,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CA0BhF;AAED,2DAA2D;AAC3D,wBAAsB,IAAI,CACxB,WAAW,EAAE,MAAM,EACnB,QAAQ,GAAE,oBAAyB,GAClC,OAAO,CAAC,mBAAmB,CAAC,CAQ9B"}

package/dist/tools/skill/types.d.ts

@@ -0,0 +1,19 @@
+import type { SideEffect } from "../function/types.js";
+/** Kind for SKILL.md discovery. */
+export declare const SKILL_KIND: "skill";
+/** Conventional directory name for skill tools. */
+export declare const SKILL_DIR_NAME: "skill";
+/** Single tool spec from SKILL.md directory. */
+export interface SkillToolSpec {
+    kind: typeof SKILL_KIND;
+    name: string;
+    description: string;
+    inputSchema: object;
+    _meta?: {
+        hitl?: {
+            sideEffect?: SideEffect;
+        };
+    };
+    sourcePath: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/tools/skill/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/tools/skill/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAEvD,mCAAmC;AACnC,eAAO,MAAM,UAAU,EAAG,OAAgB,CAAC;AAE3C,mDAAmD;AACnD,eAAO,MAAM,cAAc,EAAG,OAAgB,CAAC;AAE/C,gDAAgD;AAChD,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,OAAO,UAAU,CAAC;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE;YAAE,UAAU,CAAC,EAAE,UAAU,CAAA;SAAE,CAAA;KAAE,CAAC;IAC/C,UAAU,EAAE,MAAM,CAAC;CACpB"}

package/dist/tools/util/canonicalCoreSchemas.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Canonical input/output schemas for core (builtin) tools.
+ * Used when the builtin package registers specs with generic schema
+ * (type: object, additionalProperties: true) so CLI describe and OpenAPI show real schemas.
+ */
+import type { ToolSpec } from "../../core/types/ToolSpec.js";
+/** Canonical inputSchema (and optional outputSchema) by tool name (e.g. core/fs.readText). */
+export declare const CORE_TOOL_SCHEMAS: Record<string, {
+    inputSchema: object;
+    outputSchema?: object;
+}>;
+/** True if schema looks like the generic permissive one. */
+export declare function isGenericSchema(schema: unknown): boolean;
+/**
+ * If spec is a core tool with generic input/output schema, return spec with canonical schema.
+ * Otherwise return spec unchanged.
+ */
+export declare function enrichSpecWithCanonicalSchema(spec: ToolSpec): ToolSpec;
+//# sourceMappingURL=canonicalCoreSchemas.d.ts.map

package/dist/tools/util/canonicalCoreSchemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"canonicalCoreSchemas.d.ts","sourceRoot":"","sources":["../../../src/tools/util/canonicalCoreSchemas.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAC;AAI7D,8FAA8F;AAC9F,eAAO,MAAM,iBAAiB,EAAE,MAAM,CACpC,MAAM,EACN;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,YAAY,CAAC,EAAE,MAAM,CAAA;CAAE,CAoN/C,CAAC;AAEF,4DAA4D;AAC5D,wBAAgB,eAAe,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CAOxD;AAED;;;GAGG;AACH,wBAAgB,6BAA6B,CAAC,IAAI,EAAE,QAAQ,GAAG,QAAQ,CAetE"}

package/dist/tools/util/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Shared utilities for tool discovery.
+ */
+export { DiscoveryError, type DiscoverableKind, type DiscoverToolsOptions, type DiscoverToolsResult, type MCPServerConfig, type ToolManifest, type DirectoryScannerOptions, type LoadedTool, type SideEffect, type FunctionToolSpec, type SkillToolSpec, type N8nToolSpec, type MCPToolSpec, } from "../discoveryFactory.js";
+export { findDirsContainingFile, pathToToolName } from "./scanUtil.js";
+export { resolveEntryPoint } from "./resolveEntry.js";
+export { loadToolConfig } from "./toolConfig.js";
+export type { ToolYamlShape } from "./toolConfig.js";
+export { mcpSpecToToolSpec } from "../mcp/mcpSpecToToolSpec.js";
+export { isToolPath, parseToolPath, parsePackageVersion, formatToolPath, isNpmToolDescriptor, parseNpmToolDescriptor, resolveNpmToolDescriptor, resolveToolDescriptor, normalizeToolList, expandToolDescriptorsToRegistryNames, } from "./toolDescriptor.js";
+export type { ToolPath, PackageVersion, NpmToolDescriptor } from "./toolDescriptor.js";
+export { enrichSpecWithCanonicalSchema, isGenericSchema } from "./canonicalCoreSchemas.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/tools/util/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/util/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACL,cAAc,EACd,KAAK,gBAAgB,EACrB,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,EACxB,KAAK,eAAe,EACpB,KAAK,YAAY,EACjB,KAAK,uBAAuB,EAC5B,KAAK,UAAU,EACf,KAAK,UAAU,EACf,KAAK,gBAAgB,EACrB,KAAK,aAAa,EAClB,KAAK,WAAW,EAChB,KAAK,WAAW,GACjB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,sBAAsB,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACvE,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACjD,YAAY,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAChE,OAAO,EACL,UAAU,EACV,aAAa,EACb,mBAAmB,EACnB,cAAc,EACd,mBAAmB,EACnB,sBAAsB,EACtB,wBAAwB,EACxB,qBAAqB,EACrB,iBAAiB,EACjB,oCAAoC,GACrC,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EAAE,QAAQ,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACvF,OAAO,EAAE,6BAA6B,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC"}

package/dist/tools/util/resolveEntry.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Resolve entry point file for a tool directory.
+ * Used by skill and langchain loaders (each has its own default: handler vs index).
+ */
+export declare function resolveEntryPoint(dirPath: string, baseName: string, extensions?: string[]): Promise<string>;
+//# sourceMappingURL=resolveEntry.d.ts.map

package/dist/tools/util/resolveEntry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolveEntry.d.ts","sourceRoot":"","sources":["../../../src/tools/util/resolveEntry.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAQH,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,UAAU,GAAE,MAAM,EAAuB,GACxC,OAAO,CAAC,MAAM,CAAC,CAkBjB"}

package/dist/tools/util/scanUtil.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Shared scan helpers for tool-type scanners (function, skill, n8n).
+ * findDirsContainingFile: recursive dirs that contain a given file name.
+ * pathToToolName: build dotted tool name from source path and program name.
+ */
+export declare function findDirsContainingFile(rootPath: string, fileName: string): Promise<string[]>;
+/** Build dotted tool name from source path (extension stripped) and program name. */
+export declare function pathToToolName(sourcePath: string, programName: string): string;
+//# sourceMappingURL=scanUtil.d.ts.map

package/dist/tools/util/scanUtil.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scanUtil.d.ts","sourceRoot":"","sources":["../../../src/tools/util/scanUtil.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,wBAAsB,sBAAsB,CAC1C,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,MAAM,EAAE,CAAC,CAInB;AAyBD,qFAAqF;AACrF,wBAAgB,cAAc,CAAC,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CAM9E"}

package/dist/tools/util/toolConfig.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Load tool.yaml: list of tool names or npm descriptors (npm:@scope/package#path),
+ * and optional sandboxedPath (fs tools can only access that directory; cache is under it).
+ */
+/** Shape of tool.yaml: tools list and optional sandboxedPath. */
+export interface ToolYamlShape {
+    tools?: string[];
+    /** Root path for fs sandbox; tools can only access under this path. Resolved relative to tool.yaml dir. */
+    sandboxedPath?: string;
+}
+/**
+ * Load tool.yaml and return tools list and sandboxedPath (if set).
+ */
+export declare function loadToolConfig(toolYamlPath: string): ToolYamlShape;
+/**
+ * Resolve sandboxedPath from tool.yaml relative to the config file directory.
+ */
+export declare function resolveSandboxedPath(toolYamlPath: string, sandboxedPath: string): string;
+/** Default subdir under sandboxedPath for the npm package cache. */
+export declare const CACHE_SUBDIR = ".agent/cache";
+/**
+ * Return cache base path when tool.yaml has sandboxedPath: sandboxedPath/.agent/cache.
+ * Call ensurePackageInCache(..., { cacheBase: getCacheBaseFromToolConfig(path) }) to use it.
+ */
+export declare function getCacheBaseFromToolConfig(toolYamlPath: string): string | undefined;
+/**
+ * Find tool.yaml in directory (tool.yaml or .tool.yaml) and load it.
+ */
+export declare function findAndLoadToolConfig(dir: string): ToolYamlShape & {
+    configPath?: string;
+};
+//# sourceMappingURL=toolConfig.d.ts.map

package/dist/tools/util/toolConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toolConfig.d.ts","sourceRoot":"","sources":["../../../src/tools/util/toolConfig.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,iEAAiE;AACjE,MAAM,WAAW,aAAa;IAC5B,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,2GAA2G;IAC3G,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,YAAY,EAAE,MAAM,GAAG,aAAa,CAMlE;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,YAAY,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,MAAM,CAGxF;AAED,oEAAoE;AACpE,eAAO,MAAM,YAAY,iBAAiB,CAAC;AAE3C;;;GAGG;AACH,wBAAgB,0BAA0B,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAKnF;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG,aAAa,GAAG;IAAE,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,CAS1F"}

package/dist/tools/util/toolDescriptor.d.ts

@@ -0,0 +1,92 @@
+/**
+ * Tool path format (canonical, supported everywhere):
+ *   [protocol]:[scope]/[package with version]#[tool name]   (tool name required)
+ *   [protocol]:[scope]/[package with version]                 (bare package; tool name omitted = all tools)
+ *
+ * Examples:
+ *   npm:@easynet/agent-tool-builtin#fs.readText
+ *   npm:@scope/pkg@1.0.0#http.fetchText
+ *   npm:@easynet/agent-tool-builtin   (bare package)
+ *   file:./local/tools#myTool
+ */
+export interface ToolPath {
+    /** Protocol (npm, file, http, etc.) */
+    protocol: string;
+    /** Scope, e.g. @easynet or scope */
+    scope: string;
+    /** Package id, optionally with version (e.g. pkg or pkg@1.0.0) */
+    packageWithVersion: string;
+    /** Tool name after #; empty string when bare package (no #) */
+    toolName: string;
+}
+/** Parsed package and optional version from packageWithVersion (e.g. "pkg@1.0.0" -> { package: "pkg", version: "1.0.0" }) */
+export interface PackageVersion {
+    package: string;
+    version?: string;
+}
+/**
+ * Check if a string is a tool path in canonical form.
+ * Format: [protocol]:[scope]/[package with version]#[tool name]
+ */
+export declare function isToolPath(descriptor: string): boolean;
+/**
+ * Parse a tool path into { protocol, scope, packageWithVersion, toolName }.
+ * Returns null if the string does not match the format.
+ */
+export declare function parseToolPath(descriptor: string): ToolPath | null;
+/**
+ * Split packageWithVersion into package and optional version (e.g. "pkg@1.0.0" -> { package: "pkg", version: "1.0.0" }).
+ */
+export declare function parsePackageVersion(packageWithVersion: string): PackageVersion;
+export interface NpmToolDescriptor {
+    /** Full package id, e.g. @scope/package */
+    fullPackage: string;
+    /** Tool path after #, e.g. fs.readText */
+    toolPath: string;
+}
+/**
+ * Check if a string is an npm tool path (npm:@scope/package#path).
+ * @deprecated Prefer isToolPath(descriptor) and parseToolPath(descriptor)?.protocol === 'npm'
+ */
+export declare function isNpmToolDescriptor(descriptor: string): boolean;
+/**
+ * Parse npm tool path into { fullPackage, toolPath } or null.
+ * @deprecated Prefer parseToolPath(descriptor) for protocol:scope/package#toolName
+ */
+export declare function parseNpmToolDescriptor(descriptor: string): NpmToolDescriptor | null;
+/** Full package descriptor for builtin tools (display scope). Use with optional @version. */
+export declare const BUILTIN_DISPLAY_SCOPE_PREFIX = "npm:@easynet/agent-tool-builtin";
+/**
+ * Return the display scope (full package name) for a tool. For core/builtin tools returns
+ * npm:@easynet/agent-tool-builtin@[version]; for others returns the scope part of the registry name.
+ */
+export declare function getDisplayScope(registryName: string, kind: string, toolVersion?: string): string;
+/**
+ * Resolve a single npm tool descriptor to one or more registry names (builtin: npm:@easynet/agent-tool-builtin#path -> core/path).
+ * Returns null if not a known npm descriptor. For wildcards or bare package, use expandToolDescriptorsToRegistryNames.
+ */
+export declare function resolveNpmToolDescriptor(descriptor: string): string | null;
+/**
+ * Expand a list of tool descriptors (npm:...#path, npm:...#prefix.*, bare npm:...# omitted) to registry tool names.
+ * - npm:@easynet/agent-tool-builtin#path -> core/path
+ * - npm:@easynet/agent-tool-builtin#fs.* -> all core/fs.* names from registry
+ * - npm:@easynet/agent-tool-builtin -> all core/* names from registry
+ * - Plain names and already-resolved names are kept as-is (exact match).
+ */
+export declare function expandToolDescriptorsToRegistryNames(descriptors: string[], registryNames: string[]): string[];
+/**
+ * Resolve a single tool descriptor to a tool name.
+ * If it is a tool path, returns it as-is (no resolution in this package); otherwise returns the string as-is (plain name).
+ */
+export declare function resolveToolDescriptor(descriptor: string): string;
+/**
+ * Normalize a list of tool descriptors (plain names or [protocol]:[scope]/[package]#[tool name]).
+ * Deduplicates and preserves order. Tool paths are kept as-is (no resolution in this package).
+ */
+export declare function normalizeToolList(descriptors: string[]): string[];
+/**
+ * Serialize ToolPath back to canonical string.
+ * [protocol]:[scope]/[package with version]#[tool name]
+ */
+export declare function formatToolPath(path: ToolPath): string;
+//# sourceMappingURL=toolDescriptor.d.ts.map

package/dist/tools/util/toolDescriptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toolDescriptor.d.ts","sourceRoot":"","sources":["../../../src/tools/util/toolDescriptor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAKH,MAAM,WAAW,QAAQ;IACvB,uCAAuC;IACvC,QAAQ,EAAE,MAAM,CAAC;IACjB,oCAAoC;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,kEAAkE;IAClE,kBAAkB,EAAE,MAAM,CAAC;IAC3B,+DAA+D;IAC/D,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,6HAA6H;AAC7H,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAEtD;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI,CAUjE;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,kBAAkB,EAAE,MAAM,GAAG,cAAc,CAO9E;AAOD,MAAM,WAAW,iBAAiB;IAChC,2CAA2C;IAC3C,WAAW,EAAE,MAAM,CAAC;IACpB,0CAA0C;IAC1C,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAE/D;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,MAAM,GAAG,iBAAiB,GAAG,IAAI,CAOnF;AAMD,6FAA6F;AAC7F,eAAO,MAAM,4BAA4B,oCAAoC,CAAC;AAE9E;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,YAAY,EAAE,MAAM,EACpB,IAAI,EAAE,MAAM,EACZ,WAAW,CAAC,EAAE,MAAM,GACnB,MAAM,CAQR;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAS1E;AAED;;;;;;GAMG;AACH,wBAAgB,oCAAoC,CAClD,WAAW,EAAE,MAAM,EAAE,EACrB,aAAa,EAAE,MAAM,EAAE,GACtB,MAAM,EAAE,CAyCV;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAKhE;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAYjE;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,CAErD"}