@greppleai/grip 0.0.0-stage → 0.1.3

package/dist/core/instruction-resource-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"instruction-resource-loader.d.ts","sourceRoot":"","sources":["../../src/core/instruction-resource-loader.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAW9E,OAAO,EAA6B,KAAK,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9E,OAAO,KAAK,EAAgB,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAS1E,MAAM,WAAW,8BAA8B;IAC9C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAC1B,0BAA0B,CAAC,EAAE,OAAO,CAAC;IACrC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACvB;AAED,MAAM,WAAW,mBAAmB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,UAAU,CAAC;IACvB,sBAAsB,EAAE,OAAO,CAAC;IAChC,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,6BAA6B,CAAC,SAAS,SAAS,mBAAmB;IACnF,SAAS,EAAE,SAAS,EAAE,CAAC;IACvB,WAAW,EAAE,kBAAkB,EAAE,CAAC;CAClC;AAED,MAAM,WAAW,mCAAmC;IACnD,mDAAmD;IACnD,GAAG,EAAE,MAAM,CAAC;IACZ,yDAAyD;IACzD,MAAM,EAAE,MAAM,CAAC;CACf;AA6BD,UAAU,sCAAsC;IAC/C,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,gCAAgC;IAChD,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,eAAe,EAAE,OAAO,CAAC;CACzB;AAED,MAAM,WAAW,8CAA+C,SAAQ,gCAAgC;IACvG,UAAU,EAAE,cAAc,CAAC;CAC3B;AAED,MAAM,WAAW,+BAA+B;IAC/C,YAAY,EAAE,iBAAiB,CAAC,cAAc,CAAC,CAAC;IAChD,oBAAoB,EAAE,MAAM,CAAC;IAC7B,YAAY,EAAE,MAAM,CAAC;CACrB;AA8FD,8BAAsB,yBAAyB,CAC9C,SAAS,SAAS,mBAAmB,EACrC,YAAY,SAAS,8BAA8B;IAEnD,OAAO,CAAC,YAAY,CAAoC;IACxD,OAAO,CAAC,oBAAoB,CAAS;IACrC,OAAO,CAAC,YAAY,CAAS;IAE7B,YAAY,MAAM,EAAE,+BAA+B,EAIlD;IAED,SAAS,CAAC,QAAQ,CAAC,cAAc,CAAC,QAAQ,EAAE,mBAAmB,EAAE,WAAW,EAAE,YAAY,GAAG,SAAS,CAAC;IAEvG,SAAS,CAAC,oBAAoB,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,6BAA6B,CAAC,SAAS,CAAC,CAEpG;IAED,OAAO,CAAC,+BAA+B;IAqCvC,SAAS,CAAC,aAAa,CAAC,OAAO,EAAE,gCAAgC,GAAG,6BAA6B,CAAC,SAAS,CAAC,CAuD3G;YAEa,6CAA6C;IA4C3D,UAAgB,2BAA2B,CAC1C,OAAO,EAAE,8CAA8C,GACrD,OAAO,CAAC,6BAA6B,CAAC,SAAS,CAAC,CAAC,CAqEnD;IAED,OAAO,CAAC,yBAAyB;IAcjC,OAAO,CAAC,cAAc;YAgBR,4BAA4B;IAsB1C,OAAO,CAAC,qBAAqB;IAS7B,OAAO,CAAC,2BAA2B;IAkBnC,OAAO,CAAC,uBAAuB;IAyB/B,OAAO,CAAC,8BAA8B;IAItC,OAAO,CAAC,4BAA4B;YAgCtB,uBAAuB;YAWvB,8BAA8B;YAkB9B,gCAAgC;YA6BhC,iCAAiC;YAIjC,0CAA0C;IAkCxD,OAAO,CAAC,oBAAoB;YAQd,kCAAkC;IAmBhD,OAAO,CAAC,aAAa;IAoCrB,OAAO,CAAC,gBAAgB;CAYxB;AAED,wBAAgB,mCAAmC,CAClD,SAAS,EAAE,mBAAmB,EAAE,EAChC,OAAO,EAAE,sCAAsC,GAC7C,MAAM,CAeR","sourcesContent":["import { type Dirent, existsSync, readdirSync, readFileSync, type Stats, statSync } from \"node:fs\";\nimport { dirname, join, relative, resolve, sep } from \"node:path\";\nimport ignore from \"ignore\";\nimport { CONFIG_DIR_NAME, getAgentDir } from \"../config.ts\";\nimport { parseFrontmatter } from \"../utils/frontmatter.ts\";\nimport { canonicalizePath, resolvePath } from \"../utils/paths.ts\";\nimport type { ResourceCollision, ResourceDiagnostic } from \"./diagnostics.ts\";\nimport {\n\tdirnamePortablePath,\n\tjoinPortablePath,\n\tnormalizePortablePath,\n\ttype PortablePathFlavor,\n\tpathComparisonValue,\n\trelativePortablePath,\n\trelativeWithin,\n\tresolvePortablePath,\n} from \"./lsp/portable-path.ts\";\nimport { createSyntheticSourceInfo, type SourceInfo } from \"./source-info.ts\";\nimport type { ToolFileStat, ToolOperations } from \"./tools/operations.ts\";\n\nconst MAX_NAME_LENGTH = 64;\nconst MAX_DESCRIPTION_LENGTH = 1024;\nconst IGNORE_FILE_NAMES = [\".gitignore\", \".ignore\", \".fdignore\"];\n\ntype ConfiguredResourceSource = \"user\" | \"project\" | \"path\";\ntype ResourceSource = ConfiguredResourceSource | string;\n\nexport interface InstructionResourceFrontmatter {\n\tname?: string;\n\tdescription?: string;\n\ttools?: string | string[];\n\t\"disable-model-invocation\"?: boolean;\n\t[key: string]: unknown;\n}\n\nexport interface InstructionResource {\n\tname: string;\n\tdescription: string;\n\tfilePath: string;\n\tbaseDir: string;\n\tsourceInfo: SourceInfo;\n\tdisableModelInvocation: boolean;\n\ttools?: string[];\n\tcontent?: string;\n}\n\nexport interface InstructionResourceLoadResult<TResource extends InstructionResource> {\n\tresources: TResource[];\n\tdiagnostics: ResourceDiagnostic[];\n}\n\nexport interface InstructionResourceDirectoryOptions {\n\t/** Directory to scan for instruction resources. */\n\tdir: string;\n\t/** Source identifier for these instruction resources. */\n\tsource: string;\n}\ninterface LocalResourceTraversal<TResource extends InstructionResource> {\n\tentries: Dirent[];\n\tdir: string;\n\tsource: string;\n\tincludeRootFiles: boolean;\n\tignoreMatcher: ignore.Ignore;\n\trootDir: string;\n\tresources: TResource[];\n\tdiagnostics: ResourceDiagnostic[];\n}\n\ninterface BackendResourceTraversal<TResource extends InstructionResource> {\n\tentries: string[];\n\toperations: ToolOperations;\n\tdir: string;\n\tsource: string;\n\tincludeRootFiles: boolean;\n\tignoreMatcher: ignore.Ignore;\n\trootDir: string;\n\tresources: TResource[];\n\tdiagnostics: ResourceDiagnostic[];\n}\n\ninterface InstructionResourceParseResult<TResource extends InstructionResource> {\n\tresource: TResource | null;\n\tdiagnostics: ResourceDiagnostic[];\n}\n\ninterface InstructionResourcePromptFormatOptions {\n\tintro: string[];\n\tcontainerTag: string;\n\titemTag: string;\n}\n\nexport interface InstructionResourceLoaderOptions {\n\tcwd: string;\n\tagentDir: string;\n\tresourcePaths: string[];\n\tincludeDefaults: boolean;\n}\n\nexport interface InstructionResourceLoaderWithOperationsOptions extends InstructionResourceLoaderOptions {\n\toperations: ToolOperations;\n}\n\nexport interface InstructionResourceLoaderConfig {\n\tresourceType: ResourceCollision[\"resourceType\"];\n\tdefaultDirectoryName: string;\n\trootFileName: string;\n}\n\nfunction toPosixPath(path: string): string {\n\treturn path.split(sep).join(\"/\");\n}\n\nfunction prefixIgnorePattern(line: string, prefix: string): string | null {\n\tconst trimmed = line.trim();\n\tif (!trimmed) return null;\n\tif (trimmed.startsWith(\"#\") && !trimmed.startsWith(\"\\\\#\")) return null;\n\n\tlet pattern = line;\n\tlet negated = false;\n\tif (pattern.startsWith(\"!\")) {\n\t\tnegated = true;\n\t\tpattern = pattern.slice(1);\n\t} else if (pattern.startsWith(\"\\\\!\")) {\n\t\tpattern = pattern.slice(1);\n\t}\n\tif (pattern.startsWith(\"/\")) pattern = pattern.slice(1);\n\n\tconst prefixed = prefix ? `${prefix}${pattern}` : pattern;\n\treturn negated ? `!${prefixed}` : prefixed;\n}\n\nfunction validateName(name: string): string[] {\n\tconst errors: string[] = [];\n\tif (name.length > MAX_NAME_LENGTH) {\n\t\terrors.push(`name exceeds ${MAX_NAME_LENGTH} characters (${name.length})`);\n\t}\n\tif (!/^[a-z0-9-]+$/.test(name)) {\n\t\terrors.push(\"name contains invalid characters (must be lowercase a-z, 0-9, hyphens only)\");\n\t}\n\tif (name.startsWith(\"-\") || name.endsWith(\"-\")) {\n\t\terrors.push(\"name must not start or end with a hyphen\");\n\t}\n\tif (name.includes(\"--\")) {\n\t\terrors.push(\"name must not contain consecutive hyphens\");\n\t}\n\treturn errors;\n}\n\nfunction validateDescription(description: string | undefined): string[] {\n\tif (!description || description.trim() === \"\") return [\"description is required\"];\n\tif (description.length > MAX_DESCRIPTION_LENGTH) {\n\t\treturn [`description exceeds ${MAX_DESCRIPTION_LENGTH} characters (${description.length})`];\n\t}\n\treturn [];\n}\n\nfunction normalizeFrontmatterTools(value: unknown): string[] {\n\tconst raw = Array.isArray(value) ? value : typeof value === \"string\" ? value.split(/[\\s,]+/) : [];\n\tconst tools: string[] = [];\n\tconst seen = new Set<string>();\n\tfor (const entry of raw) {\n\t\tif (typeof entry !== \"string\") continue;\n\t\tconst trimmed = entry.trim();\n\t\tif (trimmed.length > 0 && !seen.has(trimmed)) {\n\t\t\tseen.add(trimmed);\n\t\t\ttools.push(trimmed);\n\t\t}\n\t}\n\treturn tools;\n}\n\nfunction createResourceSourceInfo(filePath: string, baseDir: string, source: ResourceSource): SourceInfo {\n\tswitch (source) {\n\t\tcase \"user\":\n\t\t\treturn createSyntheticSourceInfo(filePath, { source: \"local\", scope: \"user\", baseDir });\n\t\tcase \"project\":\n\t\t\treturn createSyntheticSourceInfo(filePath, { source: \"local\", scope: \"project\", baseDir });\n\t\tcase \"path\":\n\t\t\treturn createSyntheticSourceInfo(filePath, { source: \"local\", baseDir });\n\t\tdefault:\n\t\t\treturn createSyntheticSourceInfo(filePath, { source, baseDir });\n\t}\n}\n\nfunction isUnderPath(target: string, root: string): boolean {\n\tconst normalizedRoot = resolve(root);\n\tif (target === normalizedRoot) return true;\n\tconst prefix = normalizedRoot.endsWith(sep) ? normalizedRoot : `${normalizedRoot}${sep}`;\n\treturn target.startsWith(prefix);\n}\n\nasync function backendPathExists(operations: ToolOperations, path: string): Promise<boolean> {\n\ttry {\n\t\tawait operations.access(path, \"exists\");\n\t\treturn true;\n\t} catch {\n\t\treturn false;\n\t}\n}\n\nexport abstract class InstructionResourceLoader<\n\tTResource extends InstructionResource,\n\tTFrontmatter extends InstructionResourceFrontmatter,\n> {\n\tprivate resourceType: ResourceCollision[\"resourceType\"];\n\tprivate defaultDirectoryName: string;\n\tprivate rootFileName: string;\n\n\tconstructor(config: InstructionResourceLoaderConfig) {\n\t\tthis.resourceType = config.resourceType;\n\t\tthis.defaultDirectoryName = config.defaultDirectoryName;\n\t\tthis.rootFileName = config.rootFileName;\n\t}\n\n\tprotected abstract createResource(resource: InstructionResource, frontmatter: TFrontmatter): TResource;\n\n\tprotected loadResourcesFromDir(dir: string, source: string): InstructionResourceLoadResult<TResource> {\n\t\treturn this.loadResourcesFromDirInternal(dir, source, true);\n\t}\n\n\tprivate loadResourcesFromConfiguredPath(\n\t\tresolvedPath: string,\n\t\tsource: ConfiguredResourceSource,\n\t): InstructionResourceLoadResult<TResource> {\n\t\tif (!existsSync(resolvedPath)) {\n\t\t\treturn {\n\t\t\t\tresources: [],\n\t\t\t\tdiagnostics: [{ type: \"warning\", message: `${this.resourceType} path does not exist`, path: resolvedPath }],\n\t\t\t};\n\t\t}\n\t\ttry {\n\t\t\tconst stats = statSync(resolvedPath);\n\t\t\tif (stats.isDirectory()) return this.loadResourcesFromDirInternal(resolvedPath, source, true);\n\t\t\tif (!stats.isFile() || !resolvedPath.endsWith(\".md\")) {\n\t\t\t\treturn {\n\t\t\t\t\tresources: [],\n\t\t\t\t\tdiagnostics: [\n\t\t\t\t\t\t{ type: \"warning\", message: `${this.resourceType} path is not a markdown file`, path: resolvedPath },\n\t\t\t\t\t],\n\t\t\t\t};\n\t\t\t}\n\t\t\tconst result = this.loadResourceFromFile(resolvedPath, source);\n\t\t\treturn { resources: result.resource ? [result.resource] : [], diagnostics: result.diagnostics };\n\t\t} catch (error) {\n\t\t\treturn {\n\t\t\t\tresources: [],\n\t\t\t\tdiagnostics: [\n\t\t\t\t\t{\n\t\t\t\t\t\ttype: \"warning\",\n\t\t\t\t\t\tmessage: error instanceof Error ? error.message : `failed to read ${this.resourceType} path`,\n\t\t\t\t\t\tpath: resolvedPath,\n\t\t\t\t\t},\n\t\t\t\t],\n\t\t\t};\n\t\t}\n\t}\n\n\tprotected loadResources(options: InstructionResourceLoaderOptions): InstructionResourceLoadResult<TResource> {\n\t\tconst resolvedCwd = resolvePath(options.cwd);\n\t\tconst resolvedAgentDir = resolvePath(options.agentDir ?? getAgentDir());\n\t\tconst resourceMap = new Map<string, TResource>();\n\t\tconst realPathSet = new Set<string>();\n\t\tconst allDiagnostics: ResourceDiagnostic[] = [];\n\t\tconst collisionDiagnostics: ResourceDiagnostic[] = [];\n\n\t\tconst addResources = (result: InstructionResourceLoadResult<TResource>): void => {\n\t\t\tallDiagnostics.push(...result.diagnostics);\n\t\t\tfor (const resource of result.resources) {\n\t\t\t\tconst realPath = canonicalizePath(resource.filePath);\n\t\t\t\tif (realPathSet.has(realPath)) continue;\n\t\t\t\tconst existing = resourceMap.get(resource.name);\n\t\t\t\tif (existing) {\n\t\t\t\t\tcollisionDiagnostics.push(this.createCollisionDiagnostic(resource, existing));\n\t\t\t\t} else {\n\t\t\t\t\tresourceMap.set(resource.name, resource);\n\t\t\t\t\trealPathSet.add(realPath);\n\t\t\t\t}\n\t\t\t}\n\t\t};\n\n\t\tif (options.includeDefaults) {\n\t\t\taddResources(\n\t\t\t\tthis.loadResourcesFromDirInternal(join(resolvedAgentDir, this.defaultDirectoryName), \"user\", true),\n\t\t\t);\n\t\t\taddResources(\n\t\t\t\tthis.loadResourcesFromDirInternal(\n\t\t\t\t\tresolve(resolvedCwd, CONFIG_DIR_NAME, this.defaultDirectoryName),\n\t\t\t\t\t\"project\",\n\t\t\t\t\ttrue,\n\t\t\t\t),\n\t\t\t);\n\t\t}\n\n\t\tconst userDir = join(resolvedAgentDir, this.defaultDirectoryName);\n\t\tconst projectDir = resolve(resolvedCwd, CONFIG_DIR_NAME, this.defaultDirectoryName);\n\t\tconst getSource = (resolvedPath: string): ConfiguredResourceSource => {\n\t\t\tif (!options.includeDefaults) {\n\t\t\t\tif (isUnderPath(resolvedPath, userDir)) return \"user\";\n\t\t\t\tif (isUnderPath(resolvedPath, projectDir)) return \"project\";\n\t\t\t}\n\t\t\treturn \"path\";\n\t\t};\n\n\t\tfor (const rawPath of options.resourcePaths) {\n\t\t\tconst resolvedPath = resolvePath(rawPath, resolvedCwd, { trim: true });\n\t\t\taddResources(this.loadResourcesFromConfiguredPath(resolvedPath, getSource(resolvedPath)));\n\t\t}\n\n\t\treturn {\n\t\t\tresources: Array.from(resourceMap.values()),\n\t\t\tdiagnostics: [...allDiagnostics, ...collisionDiagnostics],\n\t\t};\n\t}\n\n\tprivate async loadResourcesFromConfiguredPathWithOperations(\n\t\toperations: ToolOperations,\n\t\tresolvedPath: string,\n\t\tsource: ConfiguredResourceSource,\n\t): Promise<InstructionResourceLoadResult<TResource>> {\n\t\tif (!(await backendPathExists(operations, resolvedPath))) {\n\t\t\treturn {\n\t\t\t\tresources: [],\n\t\t\t\tdiagnostics: [{ type: \"warning\", message: `${this.resourceType} path does not exist`, path: resolvedPath }],\n\t\t\t};\n\t\t}\n\t\ttry {\n\t\t\tconst stats = await operations.stat(resolvedPath);\n\t\t\tif (stats.isDirectory()) {\n\t\t\t\treturn this.loadResourcesFromDirInternalWithOperations(operations, resolvedPath, source, true);\n\t\t\t}\n\t\t\tif (!stats.isFile() || !resolvedPath.endsWith(\".md\")) {\n\t\t\t\treturn {\n\t\t\t\t\tresources: [],\n\t\t\t\t\tdiagnostics: [\n\t\t\t\t\t\t{\n\t\t\t\t\t\t\ttype: \"warning\",\n\t\t\t\t\t\t\tmessage: `${this.resourceType} path is not a markdown file`,\n\t\t\t\t\t\t\tpath: resolvedPath,\n\t\t\t\t\t\t},\n\t\t\t\t\t],\n\t\t\t\t};\n\t\t\t}\n\t\t\tconst result = await this.loadResourceFromFileWithOperations(operations, resolvedPath, source);\n\t\t\treturn { resources: result.resource ? [result.resource] : [], diagnostics: result.diagnostics };\n\t\t} catch (error) {\n\t\t\treturn {\n\t\t\t\tresources: [],\n\t\t\t\tdiagnostics: [\n\t\t\t\t\t{\n\t\t\t\t\t\ttype: \"warning\",\n\t\t\t\t\t\tmessage: error instanceof Error ? error.message : `failed to read ${this.resourceType} path`,\n\t\t\t\t\t\tpath: resolvedPath,\n\t\t\t\t\t},\n\t\t\t\t],\n\t\t\t};\n\t\t}\n\t}\n\n\tprotected async loadResourcesWithOperations(\n\t\toptions: InstructionResourceLoaderWithOperationsOptions,\n\t): Promise<InstructionResourceLoadResult<TResource>> {\n\t\tconst backend = options.operations.getBackendInfo?.();\n\t\tconst pathFlavor = backend?.type === \"remote\" && backend.configured ? backend.workspace.pathFlavor : undefined;\n\t\tconst resolvedCwd = resolvePortablePath(options.operations.cwd, options.cwd);\n\t\tconst resolvedAgentDir = normalizePortablePath(options.agentDir ?? getAgentDir(), pathFlavor);\n\t\tconst resourceMap = new Map<string, TResource>();\n\t\tconst pathSet = new Set<string>();\n\t\tconst allDiagnostics: ResourceDiagnostic[] = [];\n\t\tconst collisionDiagnostics: ResourceDiagnostic[] = [];\n\n\t\tconst addResources = (result: InstructionResourceLoadResult<TResource>): void => {\n\t\t\tallDiagnostics.push(...result.diagnostics);\n\t\t\tfor (const resource of result.resources) {\n\t\t\t\tconst canonicalPath = pathComparisonValue(resource.filePath, pathFlavor);\n\t\t\t\tif (pathSet.has(canonicalPath)) continue;\n\t\t\t\tconst existing = resourceMap.get(resource.name);\n\t\t\t\tif (existing) {\n\t\t\t\t\tcollisionDiagnostics.push(this.createCollisionDiagnostic(resource, existing));\n\t\t\t\t} else {\n\t\t\t\t\tresourceMap.set(resource.name, resource);\n\t\t\t\t\tpathSet.add(canonicalPath);\n\t\t\t\t}\n\t\t\t}\n\t\t};\n\n\t\tif (options.includeDefaults) {\n\t\t\taddResources(\n\t\t\t\tawait this.loadResourcesFromDirInternalWithOperations(\n\t\t\t\t\toptions.operations,\n\t\t\t\t\tjoinPortablePath(resolvedAgentDir, this.defaultDirectoryName),\n\t\t\t\t\t\"user\",\n\t\t\t\t\ttrue,\n\t\t\t\t),\n\t\t\t);\n\t\t\taddResources(\n\t\t\t\tawait this.loadResourcesFromDirInternalWithOperations(\n\t\t\t\t\toptions.operations,\n\t\t\t\t\tjoinPortablePath(resolvedCwd, CONFIG_DIR_NAME, this.defaultDirectoryName),\n\t\t\t\t\t\"project\",\n\t\t\t\t\ttrue,\n\t\t\t\t),\n\t\t\t);\n\t\t}\n\n\t\tconst userDir = joinPortablePath(resolvedAgentDir, this.defaultDirectoryName);\n\t\tconst projectDir = joinPortablePath(resolvedCwd, CONFIG_DIR_NAME, this.defaultDirectoryName);\n\t\tconst getSource = (resolvedPath: string): ConfiguredResourceSource => {\n\t\t\tif (!options.includeDefaults) {\n\t\t\t\tif (relativeWithin(userDir, resolvedPath) !== undefined) return \"user\";\n\t\t\t\tif (relativeWithin(projectDir, resolvedPath) !== undefined) return \"project\";\n\t\t\t}\n\t\t\treturn \"path\";\n\t\t};\n\n\t\tfor (const rawPath of options.resourcePaths) {\n\t\t\tconst resolvedPath = resolvePortablePath(resolvedCwd, rawPath.trim());\n\t\t\taddResources(\n\t\t\t\tawait this.loadResourcesFromConfiguredPathWithOperations(\n\t\t\t\t\toptions.operations,\n\t\t\t\t\tresolvedPath,\n\t\t\t\t\tgetSource(resolvedPath),\n\t\t\t\t),\n\t\t\t);\n\t\t}\n\n\t\treturn {\n\t\t\tresources: Array.from(resourceMap.values()),\n\t\t\tdiagnostics: [...allDiagnostics, ...collisionDiagnostics],\n\t\t};\n\t}\n\n\tprivate createCollisionDiagnostic(resource: TResource, existing: TResource): ResourceDiagnostic {\n\t\treturn {\n\t\t\ttype: \"collision\",\n\t\t\tmessage: `name \"${resource.name}\" collision`,\n\t\t\tpath: resource.filePath,\n\t\t\tcollision: {\n\t\t\t\tresourceType: this.resourceType,\n\t\t\t\tname: resource.name,\n\t\t\t\twinnerPath: existing.filePath,\n\t\t\t\tloserPath: resource.filePath,\n\t\t\t},\n\t\t};\n\t}\n\n\tprivate addIgnoreRules(ig: ignore.Ignore, dir: string, rootDir: string): void {\n\t\tconst relativeDir = relative(rootDir, dir);\n\t\tconst prefix = relativeDir ? `${toPosixPath(relativeDir)}/` : \"\";\n\t\tfor (const filename of IGNORE_FILE_NAMES) {\n\t\t\tconst ignorePath = join(dir, filename);\n\t\t\tif (!existsSync(ignorePath)) continue;\n\t\t\ttry {\n\t\t\t\tconst patterns = readFileSync(ignorePath, \"utf-8\")\n\t\t\t\t\t.split(/\\r?\\n/)\n\t\t\t\t\t.map((line) => prefixIgnorePattern(line, prefix))\n\t\t\t\t\t.filter((line): line is string => Boolean(line));\n\t\t\t\tif (patterns.length > 0) ig.add(patterns);\n\t\t\t} catch {}\n\t\t}\n\t}\n\n\tprivate async addIgnoreRulesWithOperations(\n\t\toperations: ToolOperations,\n\t\tig: ignore.Ignore,\n\t\tdir: string,\n\t\trootDir: string,\n\t): Promise<void> {\n\t\tconst relativeDir = relativePortablePath(rootDir, dir);\n\t\tconst prefix = relativeDir && relativeDir !== \".\" ? `${relativeDir.replace(/\\\\/g, \"/\")}/` : \"\";\n\t\tfor (const filename of IGNORE_FILE_NAMES) {\n\t\t\tconst ignorePath = joinPortablePath(dir, filename);\n\t\t\tif (!(await backendPathExists(operations, ignorePath))) continue;\n\t\t\ttry {\n\t\t\t\tconst patterns = (await operations.readFile(ignorePath))\n\t\t\t\t\t.toString(\"utf-8\")\n\t\t\t\t\t.split(/\\r?\\n/)\n\t\t\t\t\t.map((line) => prefixIgnorePattern(line, prefix))\n\t\t\t\t\t.filter((line): line is string => Boolean(line));\n\t\t\t\tif (patterns.length > 0) ig.add(patterns);\n\t\t\t} catch {}\n\t\t}\n\t}\n\n\tprivate getLocalResourceEntry(entry: Dirent, fullPath: string): Dirent | Stats | undefined {\n\t\tif (!entry.isSymbolicLink()) return entry;\n\t\ttry {\n\t\t\treturn statSync(fullPath);\n\t\t} catch {\n\t\t\treturn undefined;\n\t\t}\n\t}\n\n\tprivate loadRootResourceFromEntries(\n\t\tentries: Dirent[],\n\t\tdir: string,\n\t\tsource: string,\n\t\tignoreMatcher: ignore.Ignore,\n\t\trootDir: string,\n\t): InstructionResourceLoadResult<TResource> | undefined {\n\t\tfor (const entry of entries) {\n\t\t\tif (entry.name !== this.rootFileName) continue;\n\t\t\tconst fullPath = join(dir, entry.name);\n\t\t\tconst resourceEntry = this.getLocalResourceEntry(entry, fullPath);\n\t\t\tif (!resourceEntry?.isFile() || ignoreMatcher.ignores(toPosixPath(relative(rootDir, fullPath)))) continue;\n\t\t\tconst result = this.loadResourceFromFile(fullPath, source);\n\t\t\treturn { resources: result.resource ? [result.resource] : [], diagnostics: result.diagnostics };\n\t\t}\n\t\treturn undefined;\n\t}\n\n\tprivate loadNestedResourceEntry(entry: Dirent, context: LocalResourceTraversal<TResource>): void {\n\t\tif (entry.name.startsWith(\".\") || entry.name === \"node_modules\") return;\n\t\tconst fullPath = join(context.dir, entry.name);\n\t\tconst resourceEntry = this.getLocalResourceEntry(entry, fullPath);\n\t\tif (!resourceEntry) return;\n\t\tconst relativePath = toPosixPath(relative(context.rootDir, fullPath));\n\t\tif (context.ignoreMatcher.ignores(resourceEntry.isDirectory() ? `${relativePath}/` : relativePath)) return;\n\t\tif (resourceEntry.isDirectory()) {\n\t\t\tconst nested = this.loadResourcesFromDirInternal(\n\t\t\t\tfullPath,\n\t\t\t\tcontext.source,\n\t\t\t\tfalse,\n\t\t\t\tcontext.ignoreMatcher,\n\t\t\t\tcontext.rootDir,\n\t\t\t);\n\t\t\tcontext.resources.push(...nested.resources);\n\t\t\tcontext.diagnostics.push(...nested.diagnostics);\n\t\t\treturn;\n\t\t}\n\t\tif (!resourceEntry.isFile() || !context.includeRootFiles || !entry.name.endsWith(\".md\")) return;\n\t\tconst result = this.loadResourceFromFile(fullPath, context.source);\n\t\tif (result.resource) context.resources.push(result.resource);\n\t\tcontext.diagnostics.push(...result.diagnostics);\n\t}\n\n\tprivate loadNestedResourcesFromEntries(context: LocalResourceTraversal<TResource>): void {\n\t\tfor (const entry of context.entries) this.loadNestedResourceEntry(entry, context);\n\t}\n\n\tprivate loadResourcesFromDirInternal(\n\t\tdir: string,\n\t\tsource: string,\n\t\tincludeRootFiles: boolean,\n\t\tignoreMatcher?: ignore.Ignore,\n\t\trootDir?: string,\n\t): InstructionResourceLoadResult<TResource> {\n\t\tconst resources: TResource[] = [];\n\t\tconst diagnostics: ResourceDiagnostic[] = [];\n\t\tif (!existsSync(dir)) return { resources, diagnostics };\n\n\t\tconst root = rootDir ?? dir;\n\t\tconst ig = ignoreMatcher ?? ignore();\n\t\tthis.addIgnoreRules(ig, dir, root);\n\t\ttry {\n\t\t\tconst entries = readdirSync(dir, { withFileTypes: true });\n\t\t\tconst rootResource = this.loadRootResourceFromEntries(entries, dir, source, ig, root);\n\t\t\tif (rootResource) return rootResource;\n\t\t\tthis.loadNestedResourcesFromEntries({\n\t\t\t\tentries,\n\t\t\t\tdir,\n\t\t\t\tsource,\n\t\t\t\tincludeRootFiles,\n\t\t\t\tignoreMatcher: ig,\n\t\t\t\trootDir: root,\n\t\t\t\tresources,\n\t\t\t\tdiagnostics,\n\t\t\t});\n\t\t} catch {}\n\t\treturn { resources, diagnostics };\n\t}\n\n\tprivate async getBackendResourceEntry(\n\t\toperations: ToolOperations,\n\t\tfullPath: string,\n\t): Promise<ToolFileStat | undefined> {\n\t\ttry {\n\t\t\treturn await operations.stat(fullPath);\n\t\t} catch {\n\t\t\treturn undefined;\n\t\t}\n\t}\n\n\tprivate async loadRootResourceWithOperations(\n\t\tcontext: BackendResourceTraversal<TResource>,\n\t): Promise<InstructionResourceLoadResult<TResource> | undefined> {\n\t\tfor (const name of context.entries) {\n\t\t\tif (name !== this.rootFileName) continue;\n\t\t\tconst fullPath = joinPortablePath(context.dir, name);\n\t\t\tconst resourceEntry = await this.getBackendResourceEntry(context.operations, fullPath);\n\t\t\tif (\n\t\t\t\t!resourceEntry?.isFile() ||\n\t\t\t\tcontext.ignoreMatcher.ignores(relativePortablePath(context.rootDir, fullPath).replace(/\\\\/g, \"/\"))\n\t\t\t)\n\t\t\t\tcontinue;\n\t\t\tconst result = await this.loadResourceFromFileWithOperations(context.operations, fullPath, context.source);\n\t\t\treturn { resources: result.resource ? [result.resource] : [], diagnostics: result.diagnostics };\n\t\t}\n\t\treturn undefined;\n\t}\n\n\tprivate async loadNestedResourceWithOperations(\n\t\tname: string,\n\t\tcontext: BackendResourceTraversal<TResource>,\n\t): Promise<void> {\n\t\tif (name.startsWith(\".\") || name === \"node_modules\") return;\n\t\tconst fullPath = joinPortablePath(context.dir, name);\n\t\tconst resourceEntry = await this.getBackendResourceEntry(context.operations, fullPath);\n\t\tif (!resourceEntry) return;\n\t\tconst relativePath = relativePortablePath(context.rootDir, fullPath).replace(/\\\\/g, \"/\");\n\t\tif (context.ignoreMatcher.ignores(resourceEntry.isDirectory() ? `${relativePath}/` : relativePath)) return;\n\t\tif (resourceEntry.isDirectory()) {\n\t\t\tconst nested = await this.loadResourcesFromDirInternalWithOperations(\n\t\t\t\tcontext.operations,\n\t\t\t\tfullPath,\n\t\t\t\tcontext.source,\n\t\t\t\tfalse,\n\t\t\t\tcontext.ignoreMatcher,\n\t\t\t\tcontext.rootDir,\n\t\t\t);\n\t\t\tcontext.resources.push(...nested.resources);\n\t\t\tcontext.diagnostics.push(...nested.diagnostics);\n\t\t\treturn;\n\t\t}\n\t\tif (!resourceEntry.isFile() || !context.includeRootFiles || !name.endsWith(\".md\")) return;\n\t\tconst result = await this.loadResourceFromFileWithOperations(context.operations, fullPath, context.source);\n\t\tif (result.resource) context.resources.push(result.resource);\n\t\tcontext.diagnostics.push(...result.diagnostics);\n\t}\n\n\tprivate async loadNestedResourcesWithOperations(context: BackendResourceTraversal<TResource>): Promise<void> {\n\t\tfor (const name of context.entries) await this.loadNestedResourceWithOperations(name, context);\n\t}\n\n\tprivate async loadResourcesFromDirInternalWithOperations(\n\t\toperations: ToolOperations,\n\t\tdir: string,\n\t\tsource: string,\n\t\tincludeRootFiles: boolean,\n\t\tignoreMatcher?: ignore.Ignore,\n\t\trootDir?: string,\n\t): Promise<InstructionResourceLoadResult<TResource>> {\n\t\tconst resources: TResource[] = [];\n\t\tconst diagnostics: ResourceDiagnostic[] = [];\n\t\tif (!(await backendPathExists(operations, dir))) return { resources, diagnostics };\n\n\t\tconst root = rootDir ?? dir;\n\t\tconst ig = ignoreMatcher ?? ignore();\n\t\tawait this.addIgnoreRulesWithOperations(operations, ig, dir, root);\n\t\ttry {\n\t\t\tconst context: BackendResourceTraversal<TResource> = {\n\t\t\t\tentries: await operations.readdir(dir),\n\t\t\t\toperations,\n\t\t\t\tdir,\n\t\t\t\tsource,\n\t\t\t\tincludeRootFiles,\n\t\t\t\tignoreMatcher: ig,\n\t\t\t\trootDir: root,\n\t\t\t\tresources,\n\t\t\t\tdiagnostics,\n\t\t\t};\n\t\t\tconst rootResource = await this.loadRootResourceWithOperations(context);\n\t\t\tif (rootResource) return rootResource;\n\t\t\tawait this.loadNestedResourcesWithOperations(context);\n\t\t} catch {}\n\t\treturn { resources, diagnostics };\n\t}\n\n\tprivate loadResourceFromFile(filePath: string, source: string): InstructionResourceParseResult<TResource> {\n\t\ttry {\n\t\t\treturn this.parseResource(readFileSync(filePath, \"utf-8\"), filePath, source);\n\t\t} catch (error) {\n\t\t\treturn this.createParseError(error, filePath);\n\t\t}\n\t}\n\n\tprivate async loadResourceFromFileWithOperations(\n\t\toperations: ToolOperations,\n\t\tfilePath: string,\n\t\tsource: string,\n\t): Promise<InstructionResourceParseResult<TResource>> {\n\t\ttry {\n\t\t\tconst backend = operations.getBackendInfo?.();\n\t\t\tconst pathFlavor = backend?.type === \"remote\" && backend.configured ? backend.workspace.pathFlavor : undefined;\n\t\t\treturn this.parseResource(\n\t\t\t\t(await operations.readFile(filePath)).toString(\"utf-8\"),\n\t\t\t\tfilePath,\n\t\t\t\tsource,\n\t\t\t\tpathFlavor,\n\t\t\t);\n\t\t} catch (error) {\n\t\t\treturn this.createParseError(error, filePath);\n\t\t}\n\t}\n\n\tprivate parseResource(\n\t\trawContent: string,\n\t\tfilePath: string,\n\t\tsource: string,\n\t\tpathFlavor?: PortablePathFlavor,\n\t): InstructionResourceParseResult<TResource> {\n\t\tconst diagnostics: ResourceDiagnostic[] = [];\n\t\tconst { frontmatter } = parseFrontmatter<TFrontmatter>(rawContent);\n\t\tfor (const error of validateDescription(frontmatter.description)) {\n\t\t\tdiagnostics.push({ type: \"warning\", message: error, path: filePath });\n\t\t}\n\t\tif (!frontmatter.name || frontmatter.name.trim() === \"\") {\n\t\t\tdiagnostics.push({ type: \"warning\", message: \"name is required\", path: filePath });\n\t\t}\n\t\tconst name = frontmatter.name;\n\t\tif (name) {\n\t\t\tfor (const error of validateName(name)) {\n\t\t\t\tdiagnostics.push({ type: \"warning\", message: error, path: filePath });\n\t\t\t}\n\t\t}\n\t\tif (!name || !frontmatter.description || frontmatter.description.trim() === \"\") {\n\t\t\treturn { resource: null, diagnostics };\n\t\t}\n\t\tconst baseDir = pathFlavor ? dirnamePortablePath(filePath, pathFlavor) : dirname(filePath);\n\t\tconst resource: InstructionResource = {\n\t\t\tname,\n\t\t\tdescription: frontmatter.description,\n\t\t\tfilePath,\n\t\t\tbaseDir,\n\t\t\tsourceInfo: createResourceSourceInfo(filePath, baseDir, source),\n\t\t\tdisableModelInvocation: frontmatter[\"disable-model-invocation\"] === true,\n\t\t\ttools: normalizeFrontmatterTools(frontmatter.tools),\n\t\t};\n\t\treturn { resource: this.createResource(resource, frontmatter), diagnostics };\n\t}\n\n\tprivate createParseError(error: unknown, filePath: string): InstructionResourceParseResult<TResource> {\n\t\treturn {\n\t\t\tresource: null,\n\t\t\tdiagnostics: [\n\t\t\t\t{\n\t\t\t\t\ttype: \"warning\",\n\t\t\t\t\tmessage: error instanceof Error ? error.message : `failed to parse ${this.resourceType} file`,\n\t\t\t\t\tpath: filePath,\n\t\t\t\t},\n\t\t\t],\n\t\t};\n\t}\n}\n\nexport function formatInstructionResourcesForPrompt(\n\tresources: InstructionResource[],\n\toptions: InstructionResourcePromptFormatOptions,\n): string {\n\tconst visibleResources = resources.filter((resource) => !resource.disableModelInvocation);\n\tif (visibleResources.length === 0) return \"\";\n\n\tconst [firstIntroLine = \"\", ...remainingIntroLines] = options.intro;\n\tconst lines = [`\\n\\n${firstIntroLine}`, ...remainingIntroLines, \"\", `<${options.containerTag}>`];\n\tfor (const resource of visibleResources) {\n\t\tlines.push(`  <${options.itemTag}>`);\n\t\tlines.push(`    <name>${escapeXml(resource.name)}</name>`);\n\t\tlines.push(`    <description>${escapeXml(resource.description)}</description>`);\n\t\tlines.push(`    <location>${escapeXml(resource.filePath)}</location>`);\n\t\tlines.push(`  </${options.itemTag}>`);\n\t}\n\tlines.push(`</${options.containerTag}>`);\n\treturn lines.join(\"\\n\");\n}\n\nfunction escapeXml(value: string): string {\n\treturn value\n\t\t.replace(/&/g, \"&amp;\")\n\t\t.replace(/</g, \"&lt;\")\n\t\t.replace(/>/g, \"&gt;\")\n\t\t.replace(/\"/g, \"&quot;\")\n\t\t.replace(/'/g, \"&apos;\");\n}\n"]}

package/dist/core/instruction-resource-loader.js

@@ -0,0 +1,574 @@
+import { existsSync, readdirSync, readFileSync, statSync } from "node:fs";
+import { dirname, join, relative, resolve, sep } from "node:path";
+import ignore from "ignore";
+import { CONFIG_DIR_NAME, getAgentDir } from "../config.js";
+import { parseFrontmatter } from "../utils/frontmatter.js";
+import { canonicalizePath, resolvePath } from "../utils/paths.js";
+import { dirnamePortablePath, joinPortablePath, normalizePortablePath, pathComparisonValue, relativePortablePath, relativeWithin, resolvePortablePath, } from "./lsp/portable-path.js";
+import { createSyntheticSourceInfo } from "./source-info.js";
+const MAX_NAME_LENGTH = 64;
+const MAX_DESCRIPTION_LENGTH = 1024;
+const IGNORE_FILE_NAMES = [".gitignore", ".ignore", ".fdignore"];
+function toPosixPath(path) {
+    return path.split(sep).join("/");
+}
+function prefixIgnorePattern(line, prefix) {
+    const trimmed = line.trim();
+    if (!trimmed)
+        return null;
+    if (trimmed.startsWith("#") && !trimmed.startsWith("\\#"))
+        return null;
+    let pattern = line;
+    let negated = false;
+    if (pattern.startsWith("!")) {
+        negated = true;
+        pattern = pattern.slice(1);
+    }
+    else if (pattern.startsWith("\\!")) {
+        pattern = pattern.slice(1);
+    }
+    if (pattern.startsWith("/"))
+        pattern = pattern.slice(1);
+    const prefixed = prefix ? `${prefix}${pattern}` : pattern;
+    return negated ? `!${prefixed}` : prefixed;
+}
+function validateName(name) {
+    const errors = [];
+    if (name.length > MAX_NAME_LENGTH) {
+        errors.push(`name exceeds ${MAX_NAME_LENGTH} characters (${name.length})`);
+    }
+    if (!/^[a-z0-9-]+$/.test(name)) {
+        errors.push("name contains invalid characters (must be lowercase a-z, 0-9, hyphens only)");
+    }
+    if (name.startsWith("-") || name.endsWith("-")) {
+        errors.push("name must not start or end with a hyphen");
+    }
+    if (name.includes("--")) {
+        errors.push("name must not contain consecutive hyphens");
+    }
+    return errors;
+}
+function validateDescription(description) {
+    if (!description || description.trim() === "")
+        return ["description is required"];
+    if (description.length > MAX_DESCRIPTION_LENGTH) {
+        return [`description exceeds ${MAX_DESCRIPTION_LENGTH} characters (${description.length})`];
+    }
+    return [];
+}
+function normalizeFrontmatterTools(value) {
+    const raw = Array.isArray(value) ? value : typeof value === "string" ? value.split(/[\s,]+/) : [];
+    const tools = [];
+    const seen = new Set();
+    for (const entry of raw) {
+        if (typeof entry !== "string")
+            continue;
+        const trimmed = entry.trim();
+        if (trimmed.length > 0 && !seen.has(trimmed)) {
+            seen.add(trimmed);
+            tools.push(trimmed);
+        }
+    }
+    return tools;
+}
+function createResourceSourceInfo(filePath, baseDir, source) {
+    switch (source) {
+        case "user":
+            return createSyntheticSourceInfo(filePath, { source: "local", scope: "user", baseDir });
+        case "project":
+            return createSyntheticSourceInfo(filePath, { source: "local", scope: "project", baseDir });
+        case "path":
+            return createSyntheticSourceInfo(filePath, { source: "local", baseDir });
+        default:
+            return createSyntheticSourceInfo(filePath, { source, baseDir });
+    }
+}
+function isUnderPath(target, root) {
+    const normalizedRoot = resolve(root);
+    if (target === normalizedRoot)
+        return true;
+    const prefix = normalizedRoot.endsWith(sep) ? normalizedRoot : `${normalizedRoot}${sep}`;
+    return target.startsWith(prefix);
+}
+async function backendPathExists(operations, path) {
+    try {
+        await operations.access(path, "exists");
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+export class InstructionResourceLoader {
+    resourceType;
+    defaultDirectoryName;
+    rootFileName;
+    constructor(config) {
+        this.resourceType = config.resourceType;
+        this.defaultDirectoryName = config.defaultDirectoryName;
+        this.rootFileName = config.rootFileName;
+    }
+    loadResourcesFromDir(dir, source) {
+        return this.loadResourcesFromDirInternal(dir, source, true);
+    }
+    loadResourcesFromConfiguredPath(resolvedPath, source) {
+        if (!existsSync(resolvedPath)) {
+            return {
+                resources: [],
+                diagnostics: [{ type: "warning", message: `${this.resourceType} path does not exist`, path: resolvedPath }],
+            };
+        }
+        try {
+            const stats = statSync(resolvedPath);
+            if (stats.isDirectory())
+                return this.loadResourcesFromDirInternal(resolvedPath, source, true);
+            if (!stats.isFile() || !resolvedPath.endsWith(".md")) {
+                return {
+                    resources: [],
+                    diagnostics: [
+                        { type: "warning", message: `${this.resourceType} path is not a markdown file`, path: resolvedPath },
+                    ],
+                };
+            }
+            const result = this.loadResourceFromFile(resolvedPath, source);
+            return { resources: result.resource ? [result.resource] : [], diagnostics: result.diagnostics };
+        }
+        catch (error) {
+            return {
+                resources: [],
+                diagnostics: [
+                    {
+                        type: "warning",
+                        message: error instanceof Error ? error.message : `failed to read ${this.resourceType} path`,
+                        path: resolvedPath,
+                    },
+                ],
+            };
+        }
+    }
+    loadResources(options) {
+        const resolvedCwd = resolvePath(options.cwd);
+        const resolvedAgentDir = resolvePath(options.agentDir ?? getAgentDir());
+        const resourceMap = new Map();
+        const realPathSet = new Set();
+        const allDiagnostics = [];
+        const collisionDiagnostics = [];
+        const addResources = (result) => {
+            allDiagnostics.push(...result.diagnostics);
+            for (const resource of result.resources) {
+                const realPath = canonicalizePath(resource.filePath);
+                if (realPathSet.has(realPath))
+                    continue;
+                const existing = resourceMap.get(resource.name);
+                if (existing) {
+                    collisionDiagnostics.push(this.createCollisionDiagnostic(resource, existing));
+                }
+                else {
+                    resourceMap.set(resource.name, resource);
+                    realPathSet.add(realPath);
+                }
+            }
+        };
+        if (options.includeDefaults) {
+            addResources(this.loadResourcesFromDirInternal(join(resolvedAgentDir, this.defaultDirectoryName), "user", true));
+            addResources(this.loadResourcesFromDirInternal(resolve(resolvedCwd, CONFIG_DIR_NAME, this.defaultDirectoryName), "project", true));
+        }
+        const userDir = join(resolvedAgentDir, this.defaultDirectoryName);
+        const projectDir = resolve(resolvedCwd, CONFIG_DIR_NAME, this.defaultDirectoryName);
+        const getSource = (resolvedPath) => {
+            if (!options.includeDefaults) {
+                if (isUnderPath(resolvedPath, userDir))
+                    return "user";
+                if (isUnderPath(resolvedPath, projectDir))
+                    return "project";
+            }
+            return "path";
+        };
+        for (const rawPath of options.resourcePaths) {
+            const resolvedPath = resolvePath(rawPath, resolvedCwd, { trim: true });
+            addResources(this.loadResourcesFromConfiguredPath(resolvedPath, getSource(resolvedPath)));
+        }
+        return {
+            resources: Array.from(resourceMap.values()),
+            diagnostics: [...allDiagnostics, ...collisionDiagnostics],
+        };
+    }
+    async loadResourcesFromConfiguredPathWithOperations(operations, resolvedPath, source) {
+        if (!(await backendPathExists(operations, resolvedPath))) {
+            return {
+                resources: [],
+                diagnostics: [{ type: "warning", message: `${this.resourceType} path does not exist`, path: resolvedPath }],
+            };
+        }
+        try {
+            const stats = await operations.stat(resolvedPath);
+            if (stats.isDirectory()) {
+                return this.loadResourcesFromDirInternalWithOperations(operations, resolvedPath, source, true);
+            }
+            if (!stats.isFile() || !resolvedPath.endsWith(".md")) {
+                return {
+                    resources: [],
+                    diagnostics: [
+                        {
+                            type: "warning",
+                            message: `${this.resourceType} path is not a markdown file`,
+                            path: resolvedPath,
+                        },
+                    ],
+                };
+            }
+            const result = await this.loadResourceFromFileWithOperations(operations, resolvedPath, source);
+            return { resources: result.resource ? [result.resource] : [], diagnostics: result.diagnostics };
+        }
+        catch (error) {
+            return {
+                resources: [],
+                diagnostics: [
+                    {
+                        type: "warning",
+                        message: error instanceof Error ? error.message : `failed to read ${this.resourceType} path`,
+                        path: resolvedPath,
+                    },
+                ],
+            };
+        }
+    }
+    async loadResourcesWithOperations(options) {
+        const backend = options.operations.getBackendInfo?.();
+        const pathFlavor = backend?.type === "remote" && backend.configured ? backend.workspace.pathFlavor : undefined;
+        const resolvedCwd = resolvePortablePath(options.operations.cwd, options.cwd);
+        const resolvedAgentDir = normalizePortablePath(options.agentDir ?? getAgentDir(), pathFlavor);
+        const resourceMap = new Map();
+        const pathSet = new Set();
+        const allDiagnostics = [];
+        const collisionDiagnostics = [];
+        const addResources = (result) => {
+            allDiagnostics.push(...result.diagnostics);
+            for (const resource of result.resources) {
+                const canonicalPath = pathComparisonValue(resource.filePath, pathFlavor);
+                if (pathSet.has(canonicalPath))
+                    continue;
+                const existing = resourceMap.get(resource.name);
+                if (existing) {
+                    collisionDiagnostics.push(this.createCollisionDiagnostic(resource, existing));
+                }
+                else {
+                    resourceMap.set(resource.name, resource);
+                    pathSet.add(canonicalPath);
+                }
+            }
+        };
+        if (options.includeDefaults) {
+            addResources(await this.loadResourcesFromDirInternalWithOperations(options.operations, joinPortablePath(resolvedAgentDir, this.defaultDirectoryName), "user", true));
+            addResources(await this.loadResourcesFromDirInternalWithOperations(options.operations, joinPortablePath(resolvedCwd, CONFIG_DIR_NAME, this.defaultDirectoryName), "project", true));
+        }
+        const userDir = joinPortablePath(resolvedAgentDir, this.defaultDirectoryName);
+        const projectDir = joinPortablePath(resolvedCwd, CONFIG_DIR_NAME, this.defaultDirectoryName);
+        const getSource = (resolvedPath) => {
+            if (!options.includeDefaults) {
+                if (relativeWithin(userDir, resolvedPath) !== undefined)
+                    return "user";
+                if (relativeWithin(projectDir, resolvedPath) !== undefined)
+                    return "project";
+            }
+            return "path";
+        };
+        for (const rawPath of options.resourcePaths) {
+            const resolvedPath = resolvePortablePath(resolvedCwd, rawPath.trim());
+            addResources(await this.loadResourcesFromConfiguredPathWithOperations(options.operations, resolvedPath, getSource(resolvedPath)));
+        }
+        return {
+            resources: Array.from(resourceMap.values()),
+            diagnostics: [...allDiagnostics, ...collisionDiagnostics],
+        };
+    }
+    createCollisionDiagnostic(resource, existing) {
+        return {
+            type: "collision",
+            message: `name "${resource.name}" collision`,
+            path: resource.filePath,
+            collision: {
+                resourceType: this.resourceType,
+                name: resource.name,
+                winnerPath: existing.filePath,
+                loserPath: resource.filePath,
+            },
+        };
+    }
+    addIgnoreRules(ig, dir, rootDir) {
+        const relativeDir = relative(rootDir, dir);
+        const prefix = relativeDir ? `${toPosixPath(relativeDir)}/` : "";
+        for (const filename of IGNORE_FILE_NAMES) {
+            const ignorePath = join(dir, filename);
+            if (!existsSync(ignorePath))
+                continue;
+            try {
+                const patterns = readFileSync(ignorePath, "utf-8")
+                    .split(/\r?\n/)
+                    .map((line) => prefixIgnorePattern(line, prefix))
+                    .filter((line) => Boolean(line));
+                if (patterns.length > 0)
+                    ig.add(patterns);
+            }
+            catch { }
+        }
+    }
+    async addIgnoreRulesWithOperations(operations, ig, dir, rootDir) {
+        const relativeDir = relativePortablePath(rootDir, dir);
+        const prefix = relativeDir && relativeDir !== "." ? `${relativeDir.replace(/\\/g, "/")}/` : "";
+        for (const filename of IGNORE_FILE_NAMES) {
+            const ignorePath = joinPortablePath(dir, filename);
+            if (!(await backendPathExists(operations, ignorePath)))
+                continue;
+            try {
+                const patterns = (await operations.readFile(ignorePath))
+                    .toString("utf-8")
+                    .split(/\r?\n/)
+                    .map((line) => prefixIgnorePattern(line, prefix))
+                    .filter((line) => Boolean(line));
+                if (patterns.length > 0)
+                    ig.add(patterns);
+            }
+            catch { }
+        }
+    }
+    getLocalResourceEntry(entry, fullPath) {
+        if (!entry.isSymbolicLink())
+            return entry;
+        try {
+            return statSync(fullPath);
+        }
+        catch {
+            return undefined;
+        }
+    }
+    loadRootResourceFromEntries(entries, dir, source, ignoreMatcher, rootDir) {
+        for (const entry of entries) {
+            if (entry.name !== this.rootFileName)
+                continue;
+            const fullPath = join(dir, entry.name);
+            const resourceEntry = this.getLocalResourceEntry(entry, fullPath);
+            if (!resourceEntry?.isFile() || ignoreMatcher.ignores(toPosixPath(relative(rootDir, fullPath))))
+                continue;
+            const result = this.loadResourceFromFile(fullPath, source);
+            return { resources: result.resource ? [result.resource] : [], diagnostics: result.diagnostics };
+        }
+        return undefined;
+    }
+    loadNestedResourceEntry(entry, context) {
+        if (entry.name.startsWith(".") || entry.name === "node_modules")
+            return;
+        const fullPath = join(context.dir, entry.name);
+        const resourceEntry = this.getLocalResourceEntry(entry, fullPath);
+        if (!resourceEntry)
+            return;
+        const relativePath = toPosixPath(relative(context.rootDir, fullPath));
+        if (context.ignoreMatcher.ignores(resourceEntry.isDirectory() ? `${relativePath}/` : relativePath))
+            return;
+        if (resourceEntry.isDirectory()) {
+            const nested = this.loadResourcesFromDirInternal(fullPath, context.source, false, context.ignoreMatcher, context.rootDir);
+            context.resources.push(...nested.resources);
+            context.diagnostics.push(...nested.diagnostics);
+            return;
+        }
+        if (!resourceEntry.isFile() || !context.includeRootFiles || !entry.name.endsWith(".md"))
+            return;
+        const result = this.loadResourceFromFile(fullPath, context.source);
+        if (result.resource)
+            context.resources.push(result.resource);
+        context.diagnostics.push(...result.diagnostics);
+    }
+    loadNestedResourcesFromEntries(context) {
+        for (const entry of context.entries)
+            this.loadNestedResourceEntry(entry, context);
+    }
+    loadResourcesFromDirInternal(dir, source, includeRootFiles, ignoreMatcher, rootDir) {
+        const resources = [];
+        const diagnostics = [];
+        if (!existsSync(dir))
+            return { resources, diagnostics };
+        const root = rootDir ?? dir;
+        const ig = ignoreMatcher ?? ignore();
+        this.addIgnoreRules(ig, dir, root);
+        try {
+            const entries = readdirSync(dir, { withFileTypes: true });
+            const rootResource = this.loadRootResourceFromEntries(entries, dir, source, ig, root);
+            if (rootResource)
+                return rootResource;
+            this.loadNestedResourcesFromEntries({
+                entries,
+                dir,
+                source,
+                includeRootFiles,
+                ignoreMatcher: ig,
+                rootDir: root,
+                resources,
+                diagnostics,
+            });
+        }
+        catch { }
+        return { resources, diagnostics };
+    }
+    async getBackendResourceEntry(operations, fullPath) {
+        try {
+            return await operations.stat(fullPath);
+        }
+        catch {
+            return undefined;
+        }
+    }
+    async loadRootResourceWithOperations(context) {
+        for (const name of context.entries) {
+            if (name !== this.rootFileName)
+                continue;
+            const fullPath = joinPortablePath(context.dir, name);
+            const resourceEntry = await this.getBackendResourceEntry(context.operations, fullPath);
+            if (!resourceEntry?.isFile() ||
+                context.ignoreMatcher.ignores(relativePortablePath(context.rootDir, fullPath).replace(/\\/g, "/")))
+                continue;
+            const result = await this.loadResourceFromFileWithOperations(context.operations, fullPath, context.source);
+            return { resources: result.resource ? [result.resource] : [], diagnostics: result.diagnostics };
+        }
+        return undefined;
+    }
+    async loadNestedResourceWithOperations(name, context) {
+        if (name.startsWith(".") || name === "node_modules")
+            return;
+        const fullPath = joinPortablePath(context.dir, name);
+        const resourceEntry = await this.getBackendResourceEntry(context.operations, fullPath);
+        if (!resourceEntry)
+            return;
+        const relativePath = relativePortablePath(context.rootDir, fullPath).replace(/\\/g, "/");
+        if (context.ignoreMatcher.ignores(resourceEntry.isDirectory() ? `${relativePath}/` : relativePath))
+            return;
+        if (resourceEntry.isDirectory()) {
+            const nested = await this.loadResourcesFromDirInternalWithOperations(context.operations, fullPath, context.source, false, context.ignoreMatcher, context.rootDir);
+            context.resources.push(...nested.resources);
+            context.diagnostics.push(...nested.diagnostics);
+            return;
+        }
+        if (!resourceEntry.isFile() || !context.includeRootFiles || !name.endsWith(".md"))
+            return;
+        const result = await this.loadResourceFromFileWithOperations(context.operations, fullPath, context.source);
+        if (result.resource)
+            context.resources.push(result.resource);
+        context.diagnostics.push(...result.diagnostics);
+    }
+    async loadNestedResourcesWithOperations(context) {
+        for (const name of context.entries)
+            await this.loadNestedResourceWithOperations(name, context);
+    }
+    async loadResourcesFromDirInternalWithOperations(operations, dir, source, includeRootFiles, ignoreMatcher, rootDir) {
+        const resources = [];
+        const diagnostics = [];
+        if (!(await backendPathExists(operations, dir)))
+            return { resources, diagnostics };
+        const root = rootDir ?? dir;
+        const ig = ignoreMatcher ?? ignore();
+        await this.addIgnoreRulesWithOperations(operations, ig, dir, root);
+        try {
+            const context = {
+                entries: await operations.readdir(dir),
+                operations,
+                dir,
+                source,
+                includeRootFiles,
+                ignoreMatcher: ig,
+                rootDir: root,
+                resources,
+                diagnostics,
+            };
+            const rootResource = await this.loadRootResourceWithOperations(context);
+            if (rootResource)
+                return rootResource;
+            await this.loadNestedResourcesWithOperations(context);
+        }
+        catch { }
+        return { resources, diagnostics };
+    }
+    loadResourceFromFile(filePath, source) {
+        try {
+            return this.parseResource(readFileSync(filePath, "utf-8"), filePath, source);
+        }
+        catch (error) {
+            return this.createParseError(error, filePath);
+        }
+    }
+    async loadResourceFromFileWithOperations(operations, filePath, source) {
+        try {
+            const backend = operations.getBackendInfo?.();
+            const pathFlavor = backend?.type === "remote" && backend.configured ? backend.workspace.pathFlavor : undefined;
+            return this.parseResource((await operations.readFile(filePath)).toString("utf-8"), filePath, source, pathFlavor);
+        }
+        catch (error) {
+            return this.createParseError(error, filePath);
+        }
+    }
+    parseResource(rawContent, filePath, source, pathFlavor) {
+        const diagnostics = [];
+        const { frontmatter } = parseFrontmatter(rawContent);
+        for (const error of validateDescription(frontmatter.description)) {
+            diagnostics.push({ type: "warning", message: error, path: filePath });
+        }
+        if (!frontmatter.name || frontmatter.name.trim() === "") {
+            diagnostics.push({ type: "warning", message: "name is required", path: filePath });
+        }
+        const name = frontmatter.name;
+        if (name) {
+            for (const error of validateName(name)) {
+                diagnostics.push({ type: "warning", message: error, path: filePath });
+            }
+        }
+        if (!name || !frontmatter.description || frontmatter.description.trim() === "") {
+            return { resource: null, diagnostics };
+        }
+        const baseDir = pathFlavor ? dirnamePortablePath(filePath, pathFlavor) : dirname(filePath);
+        const resource = {
+            name,
+            description: frontmatter.description,
+            filePath,
+            baseDir,
+            sourceInfo: createResourceSourceInfo(filePath, baseDir, source),
+            disableModelInvocation: frontmatter["disable-model-invocation"] === true,
+            tools: normalizeFrontmatterTools(frontmatter.tools),
+        };
+        return { resource: this.createResource(resource, frontmatter), diagnostics };
+    }
+    createParseError(error, filePath) {
+        return {
+            resource: null,
+            diagnostics: [
+                {
+                    type: "warning",
+                    message: error instanceof Error ? error.message : `failed to parse ${this.resourceType} file`,
+                    path: filePath,
+                },
+            ],
+        };
+    }
+}
+export function formatInstructionResourcesForPrompt(resources, options) {
+    const visibleResources = resources.filter((resource) => !resource.disableModelInvocation);
+    if (visibleResources.length === 0)
+        return "";
+    const [firstIntroLine = "", ...remainingIntroLines] = options.intro;
+    const lines = [`\n\n${firstIntroLine}`, ...remainingIntroLines, "", `<${options.containerTag}>`];
+    for (const resource of visibleResources) {
+        lines.push(`  <${options.itemTag}>`);
+        lines.push(`    <name>${escapeXml(resource.name)}</name>`);
+        lines.push(`    <description>${escapeXml(resource.description)}</description>`);
+        lines.push(`    <location>${escapeXml(resource.filePath)}</location>`);
+        lines.push(`  </${options.itemTag}>`);
+    }
+    lines.push(`</${options.containerTag}>`);
+    return lines.join("\n");
+}
+function escapeXml(value) {
+    return value
+        .replace(/&/g, "&amp;")
+        .replace(/</g, "&lt;")
+        .replace(/>/g, "&gt;")
+        .replace(/"/g, "&quot;")
+        .replace(/'/g, "&apos;");
+}
+//# sourceMappingURL=instruction-resource-loader.js.map