@botbotgo/kit 1.0.104

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,38 @@
+export type ToolSourceConfigs = Record<string, Record<string, Record<string, unknown>>>;
+export type ToolPathConfigs = Record<string, Record<string, unknown>>;
+export interface ToolYamlShape {
+    sandboxedPath?: string;
+    cacheDir?: string;
+    toolPath?: string;
+    skillPath?: string;
+    paths?: ToolPathConfigs;
+    enableSandboxValidation?: boolean;
+    allowedHosts?: string[];
+    blockedHosts?: string[];
+    blockedCidrs?: string[];
+    tools?: ToolSourceConfigs;
+    mcp?: {
+        name?: string;
+        version?: string;
+    };
+    openapi?: {
+        host?: string;
+        port?: number;
+        basePath?: string;
+        title?: string;
+        version?: string;
+    };
+}
+export declare function loadToolConfig(toolYamlPath: string): ToolYamlShape;
+export declare function getToolSourceDescriptors(config: ToolYamlShape, options?: {
+    includeSelf?: boolean;
+}): string[];
+export declare function getPathSourceDescriptors(config: ToolYamlShape): string[];
+export declare function resolveSandboxedPath(toolYamlPath: string, sandboxedPath: string): string;
+export declare function resolveCacheDir(toolYamlPath: string, cacheDir: string): string;
+export declare const CACHE_SUBDIR = ".agent/cache";
+export declare function getCacheBaseFromToolConfig(toolYamlPath: string): string | undefined;
+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":"AAIA,MAAM,MAAM,iBAAiB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;AACxF,MAAM,MAAM,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;AAEtE,MAAM,WAAW,aAAa;IAC5B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,eAAe,CAAC;IACxB,uBAAuB,CAAC,EAAE,OAAO,CAAC;IAClC,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,KAAK,CAAC,EAAE,iBAAiB,CAAC;IAC1B,GAAG,CAAC,EAAE;QACJ,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC;IACF,OAAO,CAAC,EAAE;QACR,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC;CACH;AA+GD,wBAAgB,cAAc,CAAC,YAAY,EAAE,MAAM,GAAG,aAAa,CA0BlE;AAED,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,aAAa,EAAE,OAAO,CAAC,EAAE;IAAE,WAAW,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,MAAM,EAAE,CAG7G;AAED,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM,EAAE,CAIxE;AAED,wBAAgB,oBAAoB,CAAC,YAAY,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,MAAM,CAKxF;AAED,wBAAgB,eAAe,CAAC,YAAY,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAK9E;AAED,eAAO,MAAM,YAAY,iBAAiB,CAAC;AAE3C,wBAAgB,0BAA0B,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAQnF;AAED,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG,aAAa,GAAG;IAAE,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,CAU1F"}

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

@@ -0,0 +1,117 @@
+export interface ToolPath {
+    /** Protocol (npm, file, http, etc.) */
+    protocol: string;
+    /** Scope, e.g. @botbotgo 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;
+/**
+ * Check if a descriptor is a bare package (no #toolName).
+ * When true, the intent is to load all tools from that package.
+ */
+export declare function isBarePackageDescriptor(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;
+/**
+ * Build registry name prefix from an npm descriptor (only [a-zA-Z0-9.] in result).
+ * Npm tools are always managed in the registry with a concrete version; we never use "latest" in the registry.
+ * When the descriptor omits version or uses @latest, the caller must resolve to the actual latest version
+ * (e.g. via resolveLatestVersionFromRegistry) and pass it as resolvedVersion.
+ *
+ * @param descriptor - e.g. "npm:@botbotgo/kit-builtin" or "npm:@scope/pkg@1.0.0"
+ * @param resolvedVersion - Actual version (e.g. "0.0.11"); required when descriptor has no version or @latest
+ * @returns e.g. "npm.botbotgo.kit.builtin.0.0.11." (never contains "latest")
+ * @throws if descriptor uses latest but resolvedVersion is missing or equals "latest"
+ */
+export declare function npmDescriptorToRegistryPrefix(descriptor: string, resolvedVersion?: string): string;
+/**
+ * Package prefix from npm descriptor without version (for package-scoped config keys).
+ * e.g. "npm:@botbotgo/kit-builtin" or "npm:@botbotgo/kit-builtin@0.0.11" -> "npm.botbotgo.kit.builtin"
+ */
+export declare function npmDescriptorToPackagePrefix(descriptor: string): string;
+/**
+ * Package prefix with version when descriptor has explicit version (for same package at multiple versions).
+ * e.g. "npm:@botbotgo/kit-builtin@1.0.0" -> "npm.botbotgo.kit.builtin.1.0.0"
+ * "npm:@botbotgo/kit-builtin" -> "npm.botbotgo.kit.builtin" (no version)
+ */
+export declare function npmDescriptorToPackagePrefixWithVersion(descriptor: string): string;
+/**
+ * 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;
+/**
+ * Return the display scope for a tool: the first segment of the registry name (before the first "."),
+ * or the full name if there is no ".".
+ */
+export declare function getDisplayScope(registryName: string, _kind?: string, _toolVersion?: string): string;
+/**
+ * Resolve a single npm tool descriptor to a registry name.
+ * This package does not resolve npm descriptors to registry names; resolution is done by the runtime/loader.
+ * Returns null so that resolveToolDescriptor returns the descriptor as-is.
+ */
+export declare function resolveNpmToolDescriptor(_descriptor: string): string | null;
+/**
+ * Expand a list of tool descriptors to registry tool names.
+ * - Plain names: match registry name or suffix (e.g. readText -> npm...readText).
+ * - protocol:scope/package#toolName: resolve to registry names that start with package prefix and end with .toolName.
+ * - protocol:scope/package (bare): resolve to all registry names that start with package prefix.
+ */
+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;
+/**
+ * Package prefix for a file: descriptor.
+ * e.g. "file:./local-tools" -> "file.local.tools"
+ */
+export declare function fileDescriptorToPackagePrefix(descriptor: string): string;
+/**
+ * Registry prefix for file: descriptor (local folder). Path is scope/packageWithVersion from parseToolPath. Has trailing dot.
+ * e.g. "file:./local-tools" -> "file.local.tools.", "file:../other/pkg" -> "file.other.pkg."
+ */
+export declare function fileDescriptorToRegistryPrefix(descriptor: string): 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":"AAiBA,MAAM,WAAW,QAAQ;IACvB,uCAAuC;IACvC,QAAQ,EAAE,MAAM,CAAC;IACjB,qCAAqC;IACrC,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,uBAAuB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAGnE;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI,CAUjE;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,6BAA6B,CAAC,UAAU,EAAE,MAAM,EAAE,eAAe,CAAC,EAAE,MAAM,GAAG,MAAM,CAiClG;AAED;;;GAGG;AACH,wBAAgB,4BAA4B,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAevE;AAED;;;;GAIG;AACH,wBAAgB,uCAAuC,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAgBlF;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,kBAAkB,EAAE,MAAM,GAAG,cAAc,CAO9E;AAID,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;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,YAAY,EAAE,MAAM,EACpB,KAAK,CAAC,EAAE,MAAM,EACd,YAAY,CAAC,EAAE,MAAM,GACpB,MAAM,CAGR;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAE3E;AAED;;;;;GAKG;AACH,wBAAgB,oCAAoC,CAClD,WAAW,EAAE,MAAM,EAAE,EACrB,aAAa,EAAE,MAAM,EAAE,GACtB,MAAM,EAAE,CA+DV;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;AAED;;;GAGG;AACH,wBAAgB,6BAA6B,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAOxE;AAED;;;GAGG;AACH,wBAAgB,8BAA8B,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAGzE"}

package/dist/utils/cli/help.d.ts

@@ -0,0 +1,2 @@
+export declare function printHelp(bin?: string): void;
+//# sourceMappingURL=help.d.ts.map

package/dist/utils/cli/help.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"help.d.ts","sourceRoot":"","sources":["../../../src/utils/cli/help.ts"],"names":[],"mappings":"AAAA,wBAAgB,SAAS,CAAC,GAAG,SAAe,GAAG,IAAI,CA2ClD"}