@greppleai/grip 0.0.0-stage → 0.0.1

package/dist/core/resolve-config-value.js

@@ -0,0 +1,257 @@
+/**
+ * Resolve configuration values that may be shell commands, environment variables, or literals.
+ * Used by auth-storage.ts and model-registry.ts.
+ */
+import { execSync, spawnSync } from "child_process";
+import { getShellConfig } from "../utils/shell.js";
+// Cache for shell command results (persists for process lifetime)
+const commandResultCache = new Map();
+const ENV_VAR_NAME_RE = /^[A-Za-z_][A-Za-z0-9_]*$/;
+const ENV_VAR_NAME_PREFIX_RE = /^[A-Za-z_][A-Za-z0-9_]*/;
+const LEGACY_ENV_VAR_NAME_RE = /^[A-Z_][A-Z0-9_]*$/;
+function appendLiteral(parts, value) {
+    if (!value)
+        return;
+    const previousPart = parts[parts.length - 1];
+    if (previousPart?.type === "literal") {
+        previousPart.value += value;
+        return;
+    }
+    parts.push({ type: "literal", value });
+}
+function appendBracedTemplatePart(parts, config, dollarIndex) {
+    const endIndex = config.indexOf("}", dollarIndex + 2);
+    if (endIndex < 0) {
+        appendLiteral(parts, "$");
+        return dollarIndex + 1;
+    }
+    const name = config.slice(dollarIndex + 2, endIndex);
+    if (ENV_VAR_NAME_RE.test(name)) {
+        parts.push({ type: "env", name });
+    }
+    else {
+        appendLiteral(parts, config.slice(dollarIndex, endIndex + 1));
+    }
+    return endIndex + 1;
+}
+function parseConfigValueTemplate(config) {
+    const parts = [];
+    let index = 0;
+    while (index < config.length) {
+        const dollarIndex = config.indexOf("$", index);
+        if (dollarIndex < 0) {
+            appendLiteral(parts, config.slice(index));
+            break;
+        }
+        appendLiteral(parts, config.slice(index, dollarIndex));
+        const nextChar = config[dollarIndex + 1];
+        if (nextChar === "$" || nextChar === "!") {
+            appendLiteral(parts, nextChar);
+            index = dollarIndex + 2;
+            continue;
+        }
+        if (nextChar === "{") {
+            index = appendBracedTemplatePart(parts, config, dollarIndex);
+            continue;
+        }
+        const match = config.slice(dollarIndex + 1).match(ENV_VAR_NAME_PREFIX_RE);
+        if (match) {
+            parts.push({ type: "env", name: match[0] });
+            index = dollarIndex + 1 + match[0].length;
+            continue;
+        }
+        appendLiteral(parts, "$");
+        index = dollarIndex + 1;
+    }
+    return parts;
+}
+function parseConfigValueReference(config) {
+    if (config.startsWith("!")) {
+        return { type: "command", config };
+    }
+    return { type: "template", parts: parseConfigValueTemplate(config) };
+}
+function resolveEnvConfigValue(name) {
+    return process.env[name] || undefined;
+}
+function getTemplateEnvVarNames(parts) {
+    const names = [];
+    const seen = new Set();
+    for (const part of parts) {
+        if (part.type !== "env" || seen.has(part.name))
+            continue;
+        seen.add(part.name);
+        names.push(part.name);
+    }
+    return names;
+}
+function resolveTemplate(parts) {
+    let resolved = "";
+    for (const part of parts) {
+        if (part.type === "literal") {
+            resolved += part.value;
+            continue;
+        }
+        const envValue = resolveEnvConfigValue(part.name);
+        if (envValue === undefined)
+            return undefined;
+        resolved += envValue;
+    }
+    return resolved;
+}
+export function getConfigValueEnvVarName(config) {
+    const reference = parseConfigValueReference(config);
+    if (reference.type !== "template")
+        return undefined;
+    return reference.parts.length === 1 && reference.parts[0]?.type === "env" ? reference.parts[0].name : undefined;
+}
+export function getConfigValueEnvVarNames(config) {
+    const reference = parseConfigValueReference(config);
+    return reference.type === "template" ? getTemplateEnvVarNames(reference.parts) : [];
+}
+export function getMissingConfigValueEnvVarNames(config) {
+    return getConfigValueEnvVarNames(config).filter((name) => resolveEnvConfigValue(name) === undefined);
+}
+export function isCommandConfigValue(config) {
+    return parseConfigValueReference(config).type === "command";
+}
+export function isConfigValueConfigured(config) {
+    return getMissingConfigValueEnvVarNames(config).length === 0;
+}
+export function isLegacyEnvVarNameConfigValue(config) {
+    return LEGACY_ENV_VAR_NAME_RE.test(config);
+}
+/**
+ * Resolve a config value (API key, header value, etc.) to an actual value.
+ * - If starts with "!", executes the rest as a shell command and uses stdout (cached)
+ * - Interpolates "$ENV_VAR" or "${ENV_VAR}" references with the named environment variable
+ * - In non-command values, "$$" escapes a literal "$" and "$!" escapes a literal "!"
+ * - Otherwise treats the value as a literal
+ */
+export function resolveConfigValue(config) {
+    const reference = parseConfigValueReference(config);
+    if (reference.type === "command") {
+        return executeCommand(reference.config);
+    }
+    return resolveTemplate(reference.parts);
+}
+function executeWithConfiguredShell(command) {
+    try {
+        const { shell, args } = getShellConfig();
+        const result = spawnSync(shell, [...args, command], {
+            encoding: "utf-8",
+            timeout: 10000,
+            stdio: ["ignore", "pipe", "ignore"],
+            shell: false,
+            windowsHide: true,
+        });
+        if (result.error) {
+            const error = result.error;
+            if (error.code === "ENOENT") {
+                return { executed: false, value: undefined };
+            }
+            return { executed: true, value: undefined };
+        }
+        if (result.status !== 0) {
+            return { executed: true, value: undefined };
+        }
+        const value = (result.stdout ?? "").trim();
+        return { executed: true, value: value || undefined };
+    }
+    catch {
+        return { executed: false, value: undefined };
+    }
+}
+function executeWithDefaultShell(command) {
+    try {
+        const output = execSync(command, {
+            encoding: "utf-8",
+            timeout: 10000,
+            stdio: ["ignore", "pipe", "ignore"],
+        });
+        return output.trim() || undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+function executeCommandUncached(commandConfig) {
+    const command = commandConfig.slice(1);
+    return process.platform === "win32"
+        ? (() => {
+            const configuredResult = executeWithConfiguredShell(command);
+            return configuredResult.executed ? configuredResult.value : executeWithDefaultShell(command);
+        })()
+        : executeWithDefaultShell(command);
+}
+function executeCommand(commandConfig) {
+    if (commandResultCache.has(commandConfig)) {
+        return commandResultCache.get(commandConfig);
+    }
+    const result = executeCommandUncached(commandConfig);
+    commandResultCache.set(commandConfig, result);
+    return result;
+}
+/**
+ * Resolve all header values using the same resolution logic as API keys.
+ */
+export function resolveConfigValueUncached(config) {
+    const reference = parseConfigValueReference(config);
+    if (reference.type === "command") {
+        return executeCommandUncached(reference.config);
+    }
+    return resolveTemplate(reference.parts);
+}
+export function resolveConfigValueOrThrow(config, description) {
+    const resolvedValue = resolveConfigValueUncached(config);
+    if (resolvedValue !== undefined) {
+        return resolvedValue;
+    }
+    const reference = parseConfigValueReference(config);
+    if (reference.type === "command") {
+        throw new Error(`Failed to resolve ${description} from shell command: ${reference.config.slice(1)}`);
+    }
+    if (reference.type === "template") {
+        const missingEnvVars = getMissingConfigValueEnvVarNames(config);
+        if (missingEnvVars.length === 1) {
+            throw new Error(`Failed to resolve ${description} from environment variable: ${missingEnvVars[0]}`);
+        }
+        if (missingEnvVars.length > 1) {
+            throw new Error(`Failed to resolve ${description} from environment variables: ${missingEnvVars.join(", ")}`);
+        }
+    }
+    throw new Error(`Failed to resolve ${description}`);
+}
+/**
+ * Resolve all header values using the same resolution logic as API keys.
+ */
+export function resolveHeaders(headers) {
+    if (!headers)
+        return undefined;
+    const resolved = {};
+    for (const [key, value] of Object.entries(headers)) {
+        if (value === null) {
+            resolved[key] = null;
+            continue;
+        }
+        const resolvedValue = resolveConfigValue(value);
+        if (resolvedValue) {
+            resolved[key] = resolvedValue;
+        }
+    }
+    return Object.keys(resolved).length > 0 ? resolved : undefined;
+}
+export function resolveHeadersOrThrow(headers, description) {
+    if (!headers)
+        return undefined;
+    const resolved = {};
+    for (const [key, value] of Object.entries(headers)) {
+        resolved[key] = value === null ? null : resolveConfigValueOrThrow(value, `${description} header "${key}"`);
+    }
+    return Object.keys(resolved).length > 0 ? resolved : undefined;
+}
+/** Clear the config value command cache. Exported for testing. */
+export function clearConfigValueCache() {
+    commandResultCache.clear();
+}
+//# sourceMappingURL=resolve-config-value.js.map

package/dist/core/resolve-config-value.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-config-value.js","sourceRoot":"","sources":["../../src/core/resolve-config-value.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Resolve configuration values that may be shell commands, environment variables, or literals.\n * Used by auth-storage.ts and model-registry.ts.\n */\n\nimport type { ProviderHeaders } from \"@greppleai/grip-ai\";\nimport { execSync, spawnSync } from \"child_process\";\nimport { getShellConfig } from \"../utils/shell.ts\";\n\n// Cache for shell command results (persists for process lifetime)\nconst commandResultCache = new Map<string, string | undefined>();\nconst ENV_VAR_NAME_RE = /^[A-Za-z_][A-Za-z0-9_]*$/;\nconst ENV_VAR_NAME_PREFIX_RE = /^[A-Za-z_][A-Za-z0-9_]*/;\nconst LEGACY_ENV_VAR_NAME_RE = /^[A-Z_][A-Z0-9_]*$/;\n\ntype TemplatePart = { type: \"literal\"; value: string } | { type: \"env\"; name: string };\n\ntype ConfigValueReference = { type: \"command\"; config: string } | { type: \"template\"; parts: TemplatePart[] };\n\nfunction appendLiteral(parts: TemplatePart[], value: string): void {\n\tif (!value) return;\n\tconst previousPart = parts[parts.length - 1];\n\tif (previousPart?.type === \"literal\") {\n\t\tpreviousPart.value += value;\n\t\treturn;\n\t}\n\tparts.push({ type: \"literal\", value });\n}\n\nfunction appendBracedTemplatePart(parts: TemplatePart[], config: string, dollarIndex: number): number {\n\tconst endIndex = config.indexOf(\"}\", dollarIndex + 2);\n\tif (endIndex < 0) {\n\t\tappendLiteral(parts, \"$\");\n\t\treturn dollarIndex + 1;\n\t}\n\n\tconst name = config.slice(dollarIndex + 2, endIndex);\n\tif (ENV_VAR_NAME_RE.test(name)) {\n\t\tparts.push({ type: \"env\", name });\n\t} else {\n\t\tappendLiteral(parts, config.slice(dollarIndex, endIndex + 1));\n\t}\n\treturn endIndex + 1;\n}\n\nfunction parseConfigValueTemplate(config: string): TemplatePart[] {\n\tconst parts: TemplatePart[] = [];\n\tlet index = 0;\n\n\twhile (index < config.length) {\n\t\tconst dollarIndex = config.indexOf(\"$\", index);\n\t\tif (dollarIndex < 0) {\n\t\t\tappendLiteral(parts, config.slice(index));\n\t\t\tbreak;\n\t\t}\n\n\t\tappendLiteral(parts, config.slice(index, dollarIndex));\n\t\tconst nextChar = config[dollarIndex + 1];\n\n\t\tif (nextChar === \"$\" || nextChar === \"!\") {\n\t\t\tappendLiteral(parts, nextChar);\n\t\t\tindex = dollarIndex + 2;\n\t\t\tcontinue;\n\t\t}\n\n\t\tif (nextChar === \"{\") {\n\t\t\tindex = appendBracedTemplatePart(parts, config, dollarIndex);\n\t\t\tcontinue;\n\t\t}\n\n\t\tconst match = config.slice(dollarIndex + 1).match(ENV_VAR_NAME_PREFIX_RE);\n\t\tif (match) {\n\t\t\tparts.push({ type: \"env\", name: match[0] });\n\t\t\tindex = dollarIndex + 1 + match[0].length;\n\t\t\tcontinue;\n\t\t}\n\n\t\tappendLiteral(parts, \"$\");\n\t\tindex = dollarIndex + 1;\n\t}\n\n\treturn parts;\n}\n\nfunction parseConfigValueReference(config: string): ConfigValueReference {\n\tif (config.startsWith(\"!\")) {\n\t\treturn { type: \"command\", config };\n\t}\n\n\treturn { type: \"template\", parts: parseConfigValueTemplate(config) };\n}\n\nfunction resolveEnvConfigValue(name: string): string | undefined {\n\treturn process.env[name] || undefined;\n}\n\nfunction getTemplateEnvVarNames(parts: TemplatePart[]): string[] {\n\tconst names: string[] = [];\n\tconst seen = new Set<string>();\n\tfor (const part of parts) {\n\t\tif (part.type !== \"env\" || seen.has(part.name)) continue;\n\t\tseen.add(part.name);\n\t\tnames.push(part.name);\n\t}\n\treturn names;\n}\n\nfunction resolveTemplate(parts: TemplatePart[]): string | undefined {\n\tlet resolved = \"\";\n\tfor (const part of parts) {\n\t\tif (part.type === \"literal\") {\n\t\t\tresolved += part.value;\n\t\t\tcontinue;\n\t\t}\n\t\tconst envValue = resolveEnvConfigValue(part.name);\n\t\tif (envValue === undefined) return undefined;\n\t\tresolved += envValue;\n\t}\n\treturn resolved;\n}\n\nexport function getConfigValueEnvVarName(config: string): string | undefined {\n\tconst reference = parseConfigValueReference(config);\n\tif (reference.type !== \"template\") return undefined;\n\treturn reference.parts.length === 1 && reference.parts[0]?.type === \"env\" ? reference.parts[0].name : undefined;\n}\n\nexport function getConfigValueEnvVarNames(config: string): string[] {\n\tconst reference = parseConfigValueReference(config);\n\treturn reference.type === \"template\" ? getTemplateEnvVarNames(reference.parts) : [];\n}\n\nexport function getMissingConfigValueEnvVarNames(config: string): string[] {\n\treturn getConfigValueEnvVarNames(config).filter((name) => resolveEnvConfigValue(name) === undefined);\n}\n\nexport function isCommandConfigValue(config: string): boolean {\n\treturn parseConfigValueReference(config).type === \"command\";\n}\n\nexport function isConfigValueConfigured(config: string): boolean {\n\treturn getMissingConfigValueEnvVarNames(config).length === 0;\n}\n\nexport function isLegacyEnvVarNameConfigValue(config: string): boolean {\n\treturn LEGACY_ENV_VAR_NAME_RE.test(config);\n}\n\n/**\n * Resolve a config value (API key, header value, etc.) to an actual value.\n * - If starts with \"!\", executes the rest as a shell command and uses stdout (cached)\n * - Interpolates \"$ENV_VAR\" or \"${ENV_VAR}\" references with the named environment variable\n * - In non-command values, \"$$\" escapes a literal \"$\" and \"$!\" escapes a literal \"!\"\n * - Otherwise treats the value as a literal\n */\nexport function resolveConfigValue(config: string): string | undefined {\n\tconst reference = parseConfigValueReference(config);\n\tif (reference.type === \"command\") {\n\t\treturn executeCommand(reference.config);\n\t}\n\treturn resolveTemplate(reference.parts);\n}\n\ninterface ConfiguredShellExecutionResult {\n\texecuted: boolean;\n\tvalue: string | undefined;\n}\n\nfunction executeWithConfiguredShell(command: string): ConfiguredShellExecutionResult {\n\ttry {\n\t\tconst { shell, args } = getShellConfig();\n\t\tconst result = spawnSync(shell, [...args, command], {\n\t\t\tencoding: \"utf-8\",\n\t\t\ttimeout: 10000,\n\t\t\tstdio: [\"ignore\", \"pipe\", \"ignore\"],\n\t\t\tshell: false,\n\t\t\twindowsHide: true,\n\t\t});\n\n\t\tif (result.error) {\n\t\t\tconst error = result.error as NodeJS.ErrnoException;\n\t\t\tif (error.code === \"ENOENT\") {\n\t\t\t\treturn { executed: false, value: undefined };\n\t\t\t}\n\t\t\treturn { executed: true, value: undefined };\n\t\t}\n\n\t\tif (result.status !== 0) {\n\t\t\treturn { executed: true, value: undefined };\n\t\t}\n\n\t\tconst value = (result.stdout ?? \"\").trim();\n\t\treturn { executed: true, value: value || undefined };\n\t} catch {\n\t\treturn { executed: false, value: undefined };\n\t}\n}\n\nfunction executeWithDefaultShell(command: string): string | undefined {\n\ttry {\n\t\tconst output = execSync(command, {\n\t\t\tencoding: \"utf-8\",\n\t\t\ttimeout: 10000,\n\t\t\tstdio: [\"ignore\", \"pipe\", \"ignore\"],\n\t\t});\n\t\treturn output.trim() || undefined;\n\t} catch {\n\t\treturn undefined;\n\t}\n}\n\nfunction executeCommandUncached(commandConfig: string): string | undefined {\n\tconst command = commandConfig.slice(1);\n\treturn process.platform === \"win32\"\n\t\t? (() => {\n\t\t\t\tconst configuredResult = executeWithConfiguredShell(command);\n\t\t\t\treturn configuredResult.executed ? configuredResult.value : executeWithDefaultShell(command);\n\t\t\t})()\n\t\t: executeWithDefaultShell(command);\n}\n\nfunction executeCommand(commandConfig: string): string | undefined {\n\tif (commandResultCache.has(commandConfig)) {\n\t\treturn commandResultCache.get(commandConfig);\n\t}\n\n\tconst result = executeCommandUncached(commandConfig);\n\tcommandResultCache.set(commandConfig, result);\n\treturn result;\n}\n\n/**\n * Resolve all header values using the same resolution logic as API keys.\n */\nexport function resolveConfigValueUncached(config: string): string | undefined {\n\tconst reference = parseConfigValueReference(config);\n\tif (reference.type === \"command\") {\n\t\treturn executeCommandUncached(reference.config);\n\t}\n\treturn resolveTemplate(reference.parts);\n}\n\nexport function resolveConfigValueOrThrow(config: string, description: string): string {\n\tconst resolvedValue = resolveConfigValueUncached(config);\n\tif (resolvedValue !== undefined) {\n\t\treturn resolvedValue;\n\t}\n\n\tconst reference = parseConfigValueReference(config);\n\tif (reference.type === \"command\") {\n\t\tthrow new Error(`Failed to resolve ${description} from shell command: ${reference.config.slice(1)}`);\n\t}\n\n\tif (reference.type === \"template\") {\n\t\tconst missingEnvVars = getMissingConfigValueEnvVarNames(config);\n\t\tif (missingEnvVars.length === 1) {\n\t\t\tthrow new Error(`Failed to resolve ${description} from environment variable: ${missingEnvVars[0]}`);\n\t\t}\n\t\tif (missingEnvVars.length > 1) {\n\t\t\tthrow new Error(`Failed to resolve ${description} from environment variables: ${missingEnvVars.join(\", \")}`);\n\t\t}\n\t}\n\n\tthrow new Error(`Failed to resolve ${description}`);\n}\n\n/**\n * Resolve all header values using the same resolution logic as API keys.\n */\nexport function resolveHeaders(headers: ProviderHeaders | undefined): ProviderHeaders | undefined {\n\tif (!headers) return undefined;\n\tconst resolved: ProviderHeaders = {};\n\tfor (const [key, value] of Object.entries(headers)) {\n\t\tif (value === null) {\n\t\t\tresolved[key] = null;\n\t\t\tcontinue;\n\t\t}\n\t\tconst resolvedValue = resolveConfigValue(value);\n\t\tif (resolvedValue) {\n\t\t\tresolved[key] = resolvedValue;\n\t\t}\n\t}\n\treturn Object.keys(resolved).length > 0 ? resolved : undefined;\n}\n\nexport function resolveHeadersOrThrow(\n\theaders: ProviderHeaders | undefined,\n\tdescription: string,\n): ProviderHeaders | undefined {\n\tif (!headers) return undefined;\n\tconst resolved: ProviderHeaders = {};\n\tfor (const [key, value] of Object.entries(headers)) {\n\t\tresolved[key] = value === null ? null : resolveConfigValueOrThrow(value, `${description} header \"${key}\"`);\n\t}\n\treturn Object.keys(resolved).length > 0 ? resolved : undefined;\n}\n\n/** Clear the config value command cache. Exported for testing. */\nexport function clearConfigValueCache(): void {\n\tcommandResultCache.clear();\n}\n"]}

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

@@ -0,0 +1,200 @@
+import { type Theme } from "../modes/interactive/theme/theme.ts";
+import type { ResourceDiagnostic } from "./diagnostics.ts";
+export type { ResourceCollision, ResourceDiagnostic } from "./diagnostics.ts";
+import { type EventBus } from "./event-bus.ts";
+import type { ExtensionFactory, LoadExtensionsResult } from "./extensions/types.ts";
+import { type PathMetadata } from "./package-manager.ts";
+import type { PromptTemplate } from "./prompt-templates.ts";
+import type { LoadRulesResult } from "./rules.ts";
+import { SettingsManager } from "./settings-manager.ts";
+import type { LoadSkillsResult } from "./skills.ts";
+import { type SourceInfo } from "./source-info.ts";
+import type { ToolOperations } from "./tools/operations.ts";
+export interface ProjectContextFile {
+    path: string;
+    content: string;
+    sourceInfo?: SourceInfo;
+}
+export interface ResourcePathEntry {
+    path: string;
+    metadata: PathMetadata;
+}
+export interface LoadPromptTemplatesResult {
+    prompts: PromptTemplate[];
+    diagnostics: ResourceDiagnostic[];
+}
+export interface LoadThemesResult {
+    themes: Theme[];
+    diagnostics: ResourceDiagnostic[];
+}
+export interface ProjectContextFilesResult {
+    agentsFiles: ProjectContextFile[];
+}
+export interface LoadProjectContextFilesOptions {
+    cwd: string;
+    agentDir: string;
+}
+export type ResourceOverride<TResult> = (base: TResult) => TResult;
+export interface ResourceExtensionPaths {
+    skillPaths?: ResourcePathEntry[];
+    rulePaths?: ResourcePathEntry[];
+    promptPaths?: ResourcePathEntry[];
+    themePaths?: ResourcePathEntry[];
+}
+export interface ResourceLoader {
+    getExtensions(): LoadExtensionsResult;
+    getSkills(): LoadSkillsResult;
+    getRules(): LoadRulesResult;
+    getPrompts(): LoadPromptTemplatesResult;
+    getThemes(): LoadThemesResult;
+    getAgentsFiles(): ProjectContextFilesResult;
+    getSystemPrompt(): string | undefined;
+    getAppendSystemPrompt(): string[];
+    setToolOperations?(operations: ToolOperations | undefined): void;
+    extendResources(paths: ResourceExtensionPaths): void;
+    reload(): Promise<void>;
+}
+export declare function loadProjectContextFiles(options: LoadProjectContextFilesOptions): ProjectContextFile[];
+export interface DefaultResourceLoaderOptions {
+    cwd: string;
+    agentDir: string;
+    settingsManager?: SettingsManager;
+    eventBus?: EventBus;
+    additionalExtensionPaths?: string[];
+    additionalSkillPaths?: string[];
+    additionalRulePaths?: string[];
+    additionalPromptTemplatePaths?: string[];
+    additionalThemePaths?: string[];
+    extensionFactories?: ExtensionFactory[];
+    noExtensions?: boolean;
+    noSkills?: boolean;
+    noRules?: boolean;
+    noPromptTemplates?: boolean;
+    noThemes?: boolean;
+    noContextFiles?: boolean;
+    systemPrompt?: string;
+    appendSystemPrompt?: string[];
+    toolOperations?: ToolOperations;
+    extensionsOverride?: (base: LoadExtensionsResult) => LoadExtensionsResult;
+    skillsOverride?: ResourceOverride<LoadSkillsResult>;
+    rulesOverride?: ResourceOverride<LoadRulesResult>;
+    promptsOverride?: ResourceOverride<LoadPromptTemplatesResult>;
+    themesOverride?: ResourceOverride<LoadThemesResult>;
+    agentsFilesOverride?: ResourceOverride<ProjectContextFilesResult>;
+    systemPromptOverride?: (base: string | undefined) => string | undefined;
+    appendSystemPromptOverride?: (base: string[]) => string[];
+}
+export declare class DefaultResourceLoader implements ResourceLoader {
+    private cwd;
+    private agentDir;
+    private settingsManager;
+    private eventBus;
+    private packageManager;
+    private additionalExtensionPaths;
+    private additionalSkillPaths;
+    private additionalRulePaths;
+    private additionalPromptTemplatePaths;
+    private additionalThemePaths;
+    private extensionFactories;
+    private noExtensions;
+    private noSkills;
+    private noRules;
+    private noPromptTemplates;
+    private noThemes;
+    private noContextFiles;
+    private systemPromptSource?;
+    private appendSystemPromptSource?;
+    private toolOperations?;
+    private extensionsOverride?;
+    private skillsOverride?;
+    private rulesOverride?;
+    private promptsOverride?;
+    private themesOverride?;
+    private agentsFilesOverride?;
+    private systemPromptOverride?;
+    private appendSystemPromptOverride?;
+    private extensionsResult;
+    private skills;
+    private skillDiagnostics;
+    private rules;
+    private ruleDiagnostics;
+    private prompts;
+    private promptDiagnostics;
+    private themes;
+    private themeDiagnostics;
+    private agentsFiles;
+    private systemPrompt?;
+    private appendSystemPrompt;
+    private lastSkillPaths;
+    private lastRulePaths;
+    private extensionSkillSourceInfos;
+    private extensionRuleSourceInfos;
+    private extensionPromptSourceInfos;
+    private extensionThemeSourceInfos;
+    private lastPromptPaths;
+    private lastThemePaths;
+    constructor(options: DefaultResourceLoaderOptions);
+    getExtensions(): LoadExtensionsResult;
+    getSkills(): LoadSkillsResult;
+    getRules(): LoadRulesResult;
+    getPrompts(): LoadPromptTemplatesResult;
+    getThemes(): LoadThemesResult;
+    getAgentsFiles(): ProjectContextFilesResult;
+    getSystemPrompt(): string | undefined;
+    getAppendSystemPrompt(): string[];
+    setToolOperations(operations: ToolOperations | undefined): void;
+    private getInstructionOperations;
+    private getRemoteProjectInstructionResourcePaths;
+    extendResources(paths: ResourceExtensionPaths): void;
+    private recordResourceMetadata;
+    private getEnabledResources;
+    private getEnabledPaths;
+    private shouldExcludeLocalProjectInstructionResource;
+    private normalizePackagedInstructionPath;
+    private filterExistingRemoteInstructionPaths;
+    private discoverRemoteInstructionResourcePaths;
+    private recordRemoteInstructionMetadata;
+    private recordCliInstructionMetadata;
+    private collectReloadResourcePaths;
+    private reloadExtensions;
+    private reloadSkills;
+    private reloadRules;
+    private reloadPrompts;
+    private reloadThemes;
+    private reloadProjectContextFiles;
+    private reloadSystemPrompts;
+    reload(): Promise<void>;
+    private normalizeExtensionPaths;
+    private getExtensionRegisteredSkills;
+    private getExtensionRegisteredRules;
+    private getExtensionRegisteredPrompts;
+    private applyLoadedSkills;
+    private updateSkillsFromPaths;
+    private shouldLoadPathWithInstructionOperations;
+    private updateSkillsFromPathsForReload;
+    private applyLoadedRules;
+    private updateRulesFromPaths;
+    private updateRulesFromPathsForReload;
+    private applyLoadedPrompts;
+    private updatePromptsFromPaths;
+    private updatePromptsFromPathsForReload;
+    private updateThemesFromPaths;
+    private applyExtensionSourceInfo;
+    private findRegisteredSourceInfoForPath;
+    private findResolvedResourceSourceInfoForPath;
+    private findSourceInfoForPath;
+    private getDefaultSourceInfoForPath;
+    private mergePaths;
+    private resolveResourcePath;
+    private loadThemes;
+    private loadThemesFromDir;
+    private loadThemeFromFile;
+    private loadExtensionFactories;
+    private dedupePrompts;
+    private dedupeThemes;
+    private discoverSystemPromptFile;
+    private discoverAppendSystemPromptFile;
+    private isUnderPath;
+    private detectExtensionConflicts;
+}
+//# sourceMappingURL=resource-loader.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"resource-loader.d.ts","sourceRoot":"","sources":["../../src/core/resource-loader.ts"],"names":[],"mappings":"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","sourcesContent":["import { existsSync, readdirSync, readFileSync, statSync } from \"node:fs\";\nimport { join, resolve, sep } from \"node:path\";\nimport chalk from \"chalk\";\nimport { CONFIG_DIR_NAME } from \"../config.ts\";\nimport { loadThemeFromPath, type Theme } from \"../modes/interactive/theme/theme.ts\";\nimport type { ResourceDiagnostic } from \"./diagnostics.ts\";\n\nexport type { ResourceCollision, ResourceDiagnostic } from \"./diagnostics.ts\";\n\nimport { canonicalizePath, isLocalPath, resolvePath } from \"../utils/paths.ts\";\nimport { createEventBus, type EventBus } from \"./event-bus.ts\";\nimport { createExtensionRuntime, loadExtensionFromFactory, loadExtensions } from \"./extensions/loader.ts\";\nimport type { Extension, ExtensionFactory, ExtensionRuntime, LoadExtensionsResult } from \"./extensions/types.ts\";\nimport { dirnamePortablePath, joinPortablePath, pathComparisonValue, relativeWithin } from \"./lsp/portable-path.ts\";\nimport {\n\tDefaultPackageManager,\n\ttype PathMetadata,\n\ttype ResolvedPaths,\n\ttype ResolvedResource,\n} from \"./package-manager.ts\";\nimport type { PromptTemplate } from \"./prompt-templates.ts\";\nimport { loadPromptTemplates, loadPromptTemplatesWithOperations } from \"./prompt-templates.ts\";\nimport type { LoadRulesResult, Rule } from \"./rules.ts\";\nimport { loadRules, loadRulesWithOperations } from \"./rules.ts\";\nimport { SettingsManager } from \"./settings-manager.ts\";\nimport type { LoadSkillsResult, Skill } from \"./skills.ts\";\nimport { loadSkills, loadSkillsWithOperations } from \"./skills.ts\";\nimport { createSourceInfo, createSyntheticSourceInfo, type SourceInfo, type SourceScope } from \"./source-info.ts\";\nimport { resetTimings } from \"./timings.ts\";\nimport type { ToolBackendInfo, ToolOperations } from \"./tools/operations.ts\";\nimport type { WorkspaceIdentity } from \"./workspace-identity.ts\";\n\nexport interface ProjectContextFile {\n\tpath: string;\n\tcontent: string;\n\tsourceInfo?: SourceInfo;\n}\n\ninterface NamedResourceMergeResult<T> {\n\tresources: T[];\n\tdiagnostics: ResourceDiagnostic[];\n}\n\nexport interface ResourcePathEntry {\n\tpath: string;\n\tmetadata: PathMetadata;\n}\n\nexport interface LoadPromptTemplatesResult {\n\tprompts: PromptTemplate[];\n\tdiagnostics: ResourceDiagnostic[];\n}\n\nexport interface LoadThemesResult {\n\tthemes: Theme[];\n\tdiagnostics: ResourceDiagnostic[];\n}\n\nexport interface ProjectContextFilesResult {\n\tagentsFiles: ProjectContextFile[];\n}\n\nexport interface LoadProjectContextFilesOptions {\n\tcwd: string;\n\tagentDir: string;\n}\n\nexport type ResourceOverride<TResult> = (base: TResult) => TResult;\n\ninterface LoadProjectContextFilesWithOperationsOptions extends LoadProjectContextFilesOptions {\n\toperations: ToolOperations;\n\tworkspace?: WorkspaceIdentity;\n}\n\ntype ConfiguredInstructionBackend = Extract<ToolBackendInfo, { type: \"remote\"; configured: true }>;\n\ninterface RemoteInstructionResourcePaths {\n\tskills: ResourcePathEntry[];\n\trules: ResourcePathEntry[];\n\tprompts: ResourcePathEntry[];\n}\n\n// grip-ignore noNearIdenticalDataStructures: Resolved reload paths are required runtime inputs, while GripManifest is an optional package declaration with independent validation and evolution.\ninterface ReloadResourcePaths {\n\textensions: string[];\n\tskills: string[];\n\trules: string[];\n\tprompts: string[];\n\tthemes: string[];\n}\n\ntype InlineExtensionLoadResult = Pick<LoadExtensionsResult, \"extensions\" | \"errors\">;\n\nfunction appendMissingResourceDiagnostic(\n\tresolvedPath: string,\n\tdiagnostics: ResourceDiagnostic[],\n\tdiagnosticPaths: Set<string | undefined>,\n\tmessage: string,\n): void {\n\tif (existsSync(resolvedPath) || diagnosticPaths.has(resolvedPath)) return;\n\tdiagnostics.push({ type: \"error\", message, path: resolvedPath });\n\tdiagnosticPaths.add(resolvedPath);\n}\n\ninterface ExtensionConflict {\n\tpath: string;\n\tmessage: string;\n}\n\ntype NamedInstructionResourceType = \"skill\" | \"rule\";\n\nfunction mergeNamedResources<T extends { name: string; filePath: string }>(\n\tprimary: readonly T[],\n\tsecondary: readonly T[],\n\tresourceType: NamedInstructionResourceType,\n): NamedResourceMergeResult<T> {\n\tconst resources = new Map(primary.map((resource) => [resource.name, resource]));\n\tconst diagnostics: ResourceDiagnostic[] = [];\n\tfor (const resource of secondary) {\n\t\tconst winner = resources.get(resource.name);\n\t\tif (!winner) {\n\t\t\tresources.set(resource.name, resource);\n\t\t\tcontinue;\n\t\t}\n\t\tdiagnostics.push({\n\t\t\ttype: \"collision\",\n\t\t\tmessage: `name ${JSON.stringify(resource.name)} collision`,\n\t\t\tpath: resource.filePath,\n\t\t\tcollision: {\n\t\t\t\tresourceType,\n\t\t\t\tname: resource.name,\n\t\t\t\twinnerPath: winner.filePath,\n\t\t\t\tloserPath: resource.filePath,\n\t\t\t},\n\t\t});\n\t}\n\treturn { resources: [...resources.values()], diagnostics };\n}\nexport interface ResourceExtensionPaths {\n\tskillPaths?: ResourcePathEntry[];\n\trulePaths?: ResourcePathEntry[];\n\tpromptPaths?: ResourcePathEntry[];\n\tthemePaths?: ResourcePathEntry[];\n}\n\nexport interface ResourceLoader {\n\tgetExtensions(): LoadExtensionsResult;\n\tgetSkills(): LoadSkillsResult;\n\tgetRules(): LoadRulesResult;\n\tgetPrompts(): LoadPromptTemplatesResult;\n\tgetThemes(): LoadThemesResult;\n\tgetAgentsFiles(): ProjectContextFilesResult;\n\tgetSystemPrompt(): string | undefined;\n\tgetAppendSystemPrompt(): string[];\n\tsetToolOperations?(operations: ToolOperations | undefined): void;\n\textendResources(paths: ResourceExtensionPaths): void;\n\treload(): Promise<void>;\n}\n\nasync function resolvePromptInput(\n\tinput: string | undefined,\n\tdescription: string,\n\toperations?: ToolOperations,\n): Promise<string | undefined> {\n\tif (!input) {\n\t\treturn undefined;\n\t}\n\n\tif (existsSync(input)) {\n\t\ttry {\n\t\t\treturn readFileSync(input, \"utf-8\");\n\t\t} catch (error) {\n\t\t\tconsole.error(chalk.yellow(`Warning: Could not read ${description} file ${input}: ${error}`));\n\t\t\treturn input;\n\t\t}\n\t}\n\n\tif (operations) {\n\t\ttry {\n\t\t\tawait operations.access(input, \"read\");\n\t\t\treturn (await operations.readFile(input)).toString(\"utf-8\");\n\t\t} catch {}\n\t}\n\n\treturn input;\n}\n\nconst CONTEXT_FILE_CANDIDATES = [\"AGENTS.override.md\", \"AGENTS.md\", \"AGENTS.MD\", \"CLAUDE.md\", \"CLAUDE.MD\"];\n\nfunction loadContextFileFromDir(dir: string): ProjectContextFile | null {\n\tfor (const filename of CONTEXT_FILE_CANDIDATES) {\n\t\tconst filePath = join(dir, filename);\n\t\tif (existsSync(filePath)) {\n\t\t\ttry {\n\t\t\t\tif (!statSync(filePath).isFile()) continue;\n\t\t\t\treturn {\n\t\t\t\t\tpath: filePath,\n\t\t\t\t\tcontent: readFileSync(filePath, \"utf-8\"),\n\t\t\t\t};\n\t\t\t} catch (error) {\n\t\t\t\tconsole.error(chalk.yellow(`Warning: Could not read ${filePath}: ${error}`));\n\t\t\t}\n\t\t}\n\t}\n\treturn null;\n}\n\nexport function loadProjectContextFiles(options: LoadProjectContextFilesOptions): ProjectContextFile[] {\n\tconst resolvedCwd = resolvePath(options.cwd);\n\tconst resolvedAgentDir = resolvePath(options.agentDir);\n\n\tconst contextFiles: ProjectContextFile[] = [];\n\tconst seenPaths = new Set<string>();\n\n\tconst globalContext = loadContextFileFromDir(resolvedAgentDir);\n\tif (globalContext) {\n\t\tcontextFiles.push(globalContext);\n\t\tseenPaths.add(globalContext.path);\n\t}\n\n\tconst ancestorContextFiles: ProjectContextFile[] = [];\n\n\tlet currentDir = resolvedCwd;\n\tconst root = resolve(\"/\");\n\n\twhile (true) {\n\t\tconst contextFile = loadContextFileFromDir(currentDir);\n\t\tif (contextFile && !seenPaths.has(contextFile.path)) {\n\t\t\tancestorContextFiles.unshift(contextFile);\n\t\t\tseenPaths.add(contextFile.path);\n\t\t}\n\n\t\tif (currentDir === root) break;\n\n\t\tconst parentDir = resolve(currentDir, \"..\");\n\t\tif (parentDir === currentDir) break;\n\t\tcurrentDir = parentDir;\n\t}\n\n\tcontextFiles.push(...ancestorContextFiles);\n\n\treturn contextFiles;\n}\n\nasync function loadContextFileFromDirWithOperations(\n\toperations: ToolOperations,\n\tdir: string,\n\tworkspace?: WorkspaceIdentity,\n): Promise<ProjectContextFile | null> {\n\tfor (const filename of CONTEXT_FILE_CANDIDATES) {\n\t\tconst filePath = joinPortablePath(dir, filename);\n\t\ttry {\n\t\t\tif (!(await operations.stat(filePath)).isFile()) continue;\n\t\t\tawait operations.access(filePath, \"read\");\n\t\t\treturn {\n\t\t\t\tpath: filePath,\n\t\t\t\tcontent: (await operations.readFile(filePath)).toString(\"utf-8\"),\n\t\t\t\tsourceInfo: {\n\t\t\t\t\tpath: filePath,\n\t\t\t\t\tsource: \"remote\",\n\t\t\t\t\tscope: \"project\",\n\t\t\t\t\torigin: \"top-level\",\n\t\t\t\t\tbaseDir: dir,\n\t\t\t\t\t...(workspace ? { workspace } : {}),\n\t\t\t\t},\n\t\t\t};\n\t\t} catch {}\n\t}\n\treturn null;\n}\n\nasync function loadProjectContextFilesWithOperations(\n\toptions: LoadProjectContextFilesWithOperationsOptions,\n): Promise<ProjectContextFile[]> {\n\tconst contextFiles: ProjectContextFile[] = [];\n\tconst seenPaths = new Set<string>();\n\tconst globalContext = loadContextFileFromDir(resolvePath(options.agentDir));\n\tif (globalContext) {\n\t\tcontextFiles.push(globalContext);\n\t\tseenPaths.add(globalContext.path);\n\t}\n\tconst sandboxUserContext = await loadDaemonContextFileWithOperations(\n\t\toptions.operations,\n\t\toptions.workspace,\n\t\t\"AGENTS.md\",\n\t\t\"~/.grip/AGENTS.md\",\n\t\t\"user\",\n\t\t\"~/.grip\",\n\t);\n\tif (sandboxUserContext && !seenPaths.has(sandboxUserContext.path)) {\n\t\tcontextFiles.push(sandboxUserContext);\n\t\tseenPaths.add(sandboxUserContext.path);\n\t}\n\tconst ancestorContextFiles: ProjectContextFile[] = [];\n\tlet currentDir = options.cwd;\n\twhile (true) {\n\t\tconst contextFile = await loadContextFileFromDirWithOperations(options.operations, currentDir, options.workspace);\n\t\tif (contextFile && !seenPaths.has(contextFile.path)) {\n\t\t\tancestorContextFiles.unshift(contextFile);\n\t\t\tseenPaths.add(contextFile.path);\n\t\t}\n\t\tif (\n\t\t\toptions.workspace &&\n\t\t\tpathComparisonValue(currentDir, options.workspace.pathFlavor) ===\n\t\t\t\tpathComparisonValue(options.workspace.root, options.workspace.pathFlavor)\n\t\t)\n\t\t\tbreak;\n\t\tconst parentDir = dirnamePortablePath(currentDir, options.workspace?.pathFlavor);\n\t\tif (parentDir === currentDir) break;\n\t\tcurrentDir = parentDir;\n\t}\n\tcontextFiles.push(...ancestorContextFiles);\n\tconst sandboxContext = await loadDaemonContextFileWithOperations(\n\t\toptions.operations,\n\t\toptions.workspace,\n\t\t\"SANDBOX.md\",\n\t\t\"SANDBOX.md\",\n\t\t\"project\",\n\t\toptions.workspace?.root,\n\t);\n\tif (sandboxContext && !seenPaths.has(sandboxContext.path)) contextFiles.push(sandboxContext);\n\treturn contextFiles;\n}\n\nasync function loadDaemonContextFileWithOperations(\n\toperations: ToolOperations,\n\tworkspace: WorkspaceIdentity | undefined,\n\tresourcePath: string,\n\tdisplayPath: string,\n\tscope: SourceScope,\n\tbaseDir: string | undefined,\n): Promise<ProjectContextFile | null> {\n\tif (!workspace || !operations.readResource) return null;\n\ttry {\n\t\tconst content = (await operations.readResource(resourcePath)).toString(\"utf-8\");\n\t\treturn {\n\t\t\tpath: displayPath,\n\t\t\tcontent,\n\t\t\tsourceInfo: createSyntheticSourceInfo(displayPath, {\n\t\t\t\tsource: \"remote\",\n\t\t\t\tscope,\n\t\t\t\torigin: \"top-level\",\n\t\t\t\tbaseDir,\n\t\t\t\tworkspace,\n\t\t\t}),\n\t\t};\n\t} catch {\n\t\treturn null;\n\t}\n}\n\nexport interface DefaultResourceLoaderOptions {\n\tcwd: string;\n\tagentDir: string;\n\tsettingsManager?: SettingsManager;\n\teventBus?: EventBus;\n\tadditionalExtensionPaths?: string[];\n\tadditionalSkillPaths?: string[];\n\tadditionalRulePaths?: string[];\n\tadditionalPromptTemplatePaths?: string[];\n\tadditionalThemePaths?: string[];\n\textensionFactories?: ExtensionFactory[];\n\tnoExtensions?: boolean;\n\tnoSkills?: boolean;\n\tnoRules?: boolean;\n\tnoPromptTemplates?: boolean;\n\tnoThemes?: boolean;\n\tnoContextFiles?: boolean;\n\tsystemPrompt?: string;\n\tappendSystemPrompt?: string[];\n\ttoolOperations?: ToolOperations;\n\textensionsOverride?: (base: LoadExtensionsResult) => LoadExtensionsResult;\n\tskillsOverride?: ResourceOverride<LoadSkillsResult>;\n\trulesOverride?: ResourceOverride<LoadRulesResult>;\n\tpromptsOverride?: ResourceOverride<LoadPromptTemplatesResult>;\n\tthemesOverride?: ResourceOverride<LoadThemesResult>;\n\tagentsFilesOverride?: ResourceOverride<ProjectContextFilesResult>;\n\tsystemPromptOverride?: (base: string | undefined) => string | undefined;\n\tappendSystemPromptOverride?: (base: string[]) => string[];\n}\n\nexport class DefaultResourceLoader implements ResourceLoader {\n\tprivate cwd: string;\n\tprivate agentDir: string;\n\tprivate settingsManager: SettingsManager;\n\tprivate eventBus: EventBus;\n\tprivate packageManager: DefaultPackageManager;\n\tprivate additionalExtensionPaths: string[];\n\tprivate additionalSkillPaths: string[];\n\tprivate additionalRulePaths: string[];\n\tprivate additionalPromptTemplatePaths: string[];\n\tprivate additionalThemePaths: string[];\n\tprivate extensionFactories: ExtensionFactory[];\n\tprivate noExtensions: boolean;\n\tprivate noSkills: boolean;\n\tprivate noRules: boolean;\n\tprivate noPromptTemplates: boolean;\n\tprivate noThemes: boolean;\n\tprivate noContextFiles: boolean;\n\tprivate systemPromptSource?: string;\n\tprivate appendSystemPromptSource?: string[];\n\tprivate toolOperations?: ToolOperations;\n\tprivate extensionsOverride?: (base: LoadExtensionsResult) => LoadExtensionsResult;\n\tprivate skillsOverride?: ResourceOverride<LoadSkillsResult>;\n\tprivate rulesOverride?: ResourceOverride<LoadRulesResult>;\n\tprivate promptsOverride?: ResourceOverride<LoadPromptTemplatesResult>;\n\tprivate themesOverride?: ResourceOverride<LoadThemesResult>;\n\tprivate agentsFilesOverride?: ResourceOverride<ProjectContextFilesResult>;\n\tprivate systemPromptOverride?: (base: string | undefined) => string | undefined;\n\tprivate appendSystemPromptOverride?: (base: string[]) => string[];\n\n\tprivate extensionsResult: LoadExtensionsResult;\n\tprivate skills: Skill[];\n\tprivate skillDiagnostics: ResourceDiagnostic[];\n\tprivate rules: Rule[];\n\tprivate ruleDiagnostics: ResourceDiagnostic[];\n\tprivate prompts: PromptTemplate[];\n\tprivate promptDiagnostics: ResourceDiagnostic[];\n\tprivate themes: Theme[];\n\tprivate themeDiagnostics: ResourceDiagnostic[];\n\tprivate agentsFiles: ProjectContextFile[];\n\tprivate systemPrompt?: string;\n\tprivate appendSystemPrompt: string[];\n\tprivate lastSkillPaths: string[];\n\tprivate lastRulePaths: string[];\n\tprivate extensionSkillSourceInfos: Map<string, SourceInfo>;\n\tprivate extensionRuleSourceInfos: Map<string, SourceInfo>;\n\tprivate extensionPromptSourceInfos: Map<string, SourceInfo>;\n\tprivate extensionThemeSourceInfos: Map<string, SourceInfo>;\n\tprivate lastPromptPaths: string[];\n\tprivate lastThemePaths: string[];\n\n\tconstructor(options: DefaultResourceLoaderOptions) {\n\t\tthis.cwd = resolvePath(options.cwd);\n\t\tthis.agentDir = resolvePath(options.agentDir);\n\t\tthis.settingsManager = options.settingsManager ?? SettingsManager.create(this.cwd, this.agentDir);\n\t\tthis.eventBus = options.eventBus ?? createEventBus();\n\t\tthis.packageManager = new DefaultPackageManager({\n\t\t\tcwd: this.cwd,\n\t\t\tagentDir: this.agentDir,\n\t\t\tsettingsManager: this.settingsManager,\n\t\t});\n\t\tthis.additionalExtensionPaths = options.additionalExtensionPaths ?? [];\n\t\tthis.additionalSkillPaths = options.additionalSkillPaths ?? [];\n\t\tthis.additionalRulePaths = options.additionalRulePaths ?? [];\n\t\tthis.additionalPromptTemplatePaths = options.additionalPromptTemplatePaths ?? [];\n\t\tthis.additionalThemePaths = options.additionalThemePaths ?? [];\n\t\tthis.extensionFactories = options.extensionFactories ?? [];\n\t\tthis.noExtensions = options.noExtensions ?? false;\n\t\tthis.noSkills = options.noSkills ?? false;\n\t\tthis.noRules = options.noRules ?? false;\n\t\tthis.noPromptTemplates = options.noPromptTemplates ?? false;\n\t\tthis.noThemes = options.noThemes ?? false;\n\t\tthis.noContextFiles = options.noContextFiles ?? false;\n\t\tthis.systemPromptSource = options.systemPrompt;\n\t\tthis.appendSystemPromptSource = options.appendSystemPrompt;\n\t\tthis.toolOperations = options.toolOperations;\n\t\tthis.extensionsOverride = options.extensionsOverride;\n\t\tthis.skillsOverride = options.skillsOverride;\n\t\tthis.rulesOverride = options.rulesOverride;\n\t\tthis.promptsOverride = options.promptsOverride;\n\t\tthis.themesOverride = options.themesOverride;\n\t\tthis.agentsFilesOverride = options.agentsFilesOverride;\n\t\tthis.systemPromptOverride = options.systemPromptOverride;\n\t\tthis.appendSystemPromptOverride = options.appendSystemPromptOverride;\n\n\t\tthis.extensionsResult = { extensions: [], errors: [], runtime: createExtensionRuntime() };\n\t\tthis.skills = [];\n\t\tthis.skillDiagnostics = [];\n\t\tthis.rules = [];\n\t\tthis.ruleDiagnostics = [];\n\t\tthis.prompts = [];\n\t\tthis.promptDiagnostics = [];\n\t\tthis.themes = [];\n\t\tthis.themeDiagnostics = [];\n\t\tthis.agentsFiles = [];\n\t\tthis.appendSystemPrompt = [];\n\t\tthis.lastSkillPaths = [];\n\t\tthis.lastRulePaths = [];\n\t\tthis.extensionSkillSourceInfos = new Map();\n\t\tthis.extensionRuleSourceInfos = new Map();\n\t\tthis.extensionPromptSourceInfos = new Map();\n\t\tthis.extensionThemeSourceInfos = new Map();\n\t\tthis.lastPromptPaths = [];\n\t\tthis.lastThemePaths = [];\n\t}\n\n\tgetExtensions(): LoadExtensionsResult {\n\t\treturn this.extensionsResult;\n\t}\n\n\tgetSkills(): LoadSkillsResult {\n\t\treturn { skills: this.skills, diagnostics: this.skillDiagnostics };\n\t}\n\n\tgetRules(): LoadRulesResult {\n\t\treturn { rules: this.rules, diagnostics: this.ruleDiagnostics };\n\t}\n\n\tgetPrompts(): LoadPromptTemplatesResult {\n\t\treturn { prompts: this.prompts, diagnostics: this.promptDiagnostics };\n\t}\n\n\tgetThemes(): LoadThemesResult {\n\t\treturn { themes: this.themes, diagnostics: this.themeDiagnostics };\n\t}\n\n\tgetAgentsFiles(): ProjectContextFilesResult {\n\t\treturn { agentsFiles: this.agentsFiles };\n\t}\n\n\tgetSystemPrompt(): string | undefined {\n\t\treturn this.systemPrompt;\n\t}\n\n\tgetAppendSystemPrompt(): string[] {\n\t\treturn this.appendSystemPrompt;\n\t}\n\n\tsetToolOperations(operations: ToolOperations | undefined): void {\n\t\tthis.toolOperations = operations;\n\t}\n\n\tprivate getInstructionOperations(): ToolOperations | undefined {\n\t\tconst backend = this.toolOperations?.getBackendInfo?.();\n\t\treturn backend?.type === \"remote\" && backend.configured ? this.toolOperations : undefined;\n\t}\n\n\tprivate getRemoteProjectInstructionResourcePaths(\n\t\tcwd: string,\n\t\tbackend: ConfiguredInstructionBackend,\n\t): RemoteInstructionResourcePaths {\n\t\tconst projectBaseDir = joinPortablePath(cwd, CONFIG_DIR_NAME);\n\t\tconst projectMetadata: PathMetadata = {\n\t\t\tsource: \"remote\",\n\t\t\tscope: \"project\",\n\t\t\torigin: \"top-level\",\n\t\t\tbaseDir: projectBaseDir,\n\t\t\tworkspace: backend.workspace,\n\t\t};\n\t\tconst skills: ResourcePathEntry[] = [\n\t\t\t{ path: joinPortablePath(projectBaseDir, \"skills\"), metadata: projectMetadata },\n\t\t];\n\t\tconst rules: ResourcePathEntry[] = [\n\t\t\t{ path: joinPortablePath(projectBaseDir, \"rules\"), metadata: projectMetadata },\n\t\t];\n\t\tconst prompts: ResourcePathEntry[] = [\n\t\t\t{ path: joinPortablePath(projectBaseDir, \"prompts\"), metadata: projectMetadata },\n\t\t];\n\n\t\tlet currentDir = cwd;\n\t\tconst boundary = backend.workspace.root;\n\t\twhile (true) {\n\t\t\tconst agentsBaseDir = joinPortablePath(currentDir, \".agents\");\n\t\t\tconst agentsMetadata: PathMetadata = {\n\t\t\t\tsource: \"remote\",\n\t\t\t\tscope: \"project\",\n\t\t\t\torigin: \"top-level\",\n\t\t\t\tbaseDir: agentsBaseDir,\n\t\t\t\tworkspace: backend.workspace,\n\t\t\t};\n\t\t\tskills.push({ path: joinPortablePath(agentsBaseDir, \"skills\"), metadata: agentsMetadata });\n\t\t\trules.push({ path: joinPortablePath(agentsBaseDir, \"rules\"), metadata: agentsMetadata });\n\t\t\tif (\n\t\t\t\tpathComparisonValue(currentDir, backend.workspace.pathFlavor) ===\n\t\t\t\tpathComparisonValue(boundary, backend.workspace.pathFlavor)\n\t\t\t)\n\t\t\t\tbreak;\n\t\t\tconst parentDir = dirnamePortablePath(currentDir, backend.workspace.pathFlavor);\n\t\t\tif (parentDir === currentDir) break;\n\t\t\tcurrentDir = parentDir;\n\t\t}\n\n\t\treturn { skills, rules, prompts };\n\t}\n\n\textendResources(paths: ResourceExtensionPaths): void {\n\t\tconst skillPaths = this.normalizeExtensionPaths(paths.skillPaths ?? []);\n\t\tconst rulePaths = this.normalizeExtensionPaths(paths.rulePaths ?? []);\n\t\tconst promptPaths = this.normalizeExtensionPaths(paths.promptPaths ?? []);\n\t\tconst themePaths = this.normalizeExtensionPaths(paths.themePaths ?? []);\n\n\t\tfor (const entry of skillPaths) {\n\t\t\tthis.extensionSkillSourceInfos.set(entry.path, createSourceInfo(entry.path, entry.metadata));\n\t\t}\n\t\tfor (const entry of rulePaths) {\n\t\t\tthis.extensionRuleSourceInfos.set(entry.path, createSourceInfo(entry.path, entry.metadata));\n\t\t}\n\t\tfor (const entry of promptPaths) {\n\t\t\tthis.extensionPromptSourceInfos.set(entry.path, createSourceInfo(entry.path, entry.metadata));\n\t\t}\n\t\tfor (const entry of themePaths) {\n\t\t\tthis.extensionThemeSourceInfos.set(entry.path, createSourceInfo(entry.path, entry.metadata));\n\t\t}\n\n\t\tif (skillPaths.length > 0) {\n\t\t\tthis.lastSkillPaths = this.mergePaths(\n\t\t\t\tthis.lastSkillPaths,\n\t\t\t\tskillPaths.map((entry) => entry.path),\n\t\t\t);\n\t\t\tthis.updateSkillsFromPaths(this.lastSkillPaths);\n\t\t}\n\n\t\tif (rulePaths.length > 0) {\n\t\t\tthis.lastRulePaths = this.mergePaths(\n\t\t\t\tthis.lastRulePaths,\n\t\t\t\trulePaths.map((entry) => entry.path),\n\t\t\t);\n\t\t\tthis.updateRulesFromPaths(this.lastRulePaths);\n\t\t}\n\n\t\tif (promptPaths.length > 0) {\n\t\t\tthis.lastPromptPaths = this.mergePaths(\n\t\t\t\tthis.lastPromptPaths,\n\t\t\t\tpromptPaths.map((entry) => entry.path),\n\t\t\t);\n\t\t\tthis.updatePromptsFromPaths(this.lastPromptPaths);\n\t\t}\n\n\t\tif (themePaths.length > 0) {\n\t\t\tthis.lastThemePaths = this.mergePaths(\n\t\t\t\tthis.lastThemePaths,\n\t\t\t\tthemePaths.map((entry) => entry.path),\n\t\t\t);\n\t\t\tthis.updateThemesFromPaths(this.lastThemePaths);\n\t\t}\n\t}\n\n\tprivate recordResourceMetadata(resources: ResolvedResource[], metadataByPath: Map<string, PathMetadata>): void {\n\t\tfor (const resource of resources) {\n\t\t\tif (!metadataByPath.has(resource.path)) metadataByPath.set(resource.path, resource.metadata);\n\t\t}\n\t}\n\n\tprivate getEnabledResources(\n\t\tresources: ResolvedResource[],\n\t\tmetadataByPath: Map<string, PathMetadata>,\n\t): ResolvedResource[] {\n\t\tthis.recordResourceMetadata(resources, metadataByPath);\n\t\treturn resources.filter((resource) => resource.enabled);\n\t}\n\n\tprivate getEnabledPaths(resources: ResolvedResource[], metadataByPath: Map<string, PathMetadata>): string[] {\n\t\treturn this.getEnabledResources(resources, metadataByPath).map((resource) => resource.path);\n\t}\n\n\tprivate shouldExcludeLocalProjectInstructionResource(\n\t\tresource: ResolvedResource,\n\t\tloadProjectInstructionsRemotely: boolean,\n\t): boolean {\n\t\treturn (\n\t\t\tloadProjectInstructionsRemotely &&\n\t\t\tresource.metadata.scope === \"project\" &&\n\t\t\tresource.metadata.origin === \"top-level\"\n\t\t);\n\t}\n\n\tprivate normalizePackagedInstructionPath(\n\t\tresource: ResolvedResource,\n\t\tfilename: string,\n\t\tmetadataByPath: Map<string, PathMetadata>,\n\t): string {\n\t\tif (resource.metadata.source !== \"auto\" && resource.metadata.origin !== \"package\") return resource.path;\n\t\ttry {\n\t\t\tif (!statSync(resource.path).isDirectory()) return resource.path;\n\t\t} catch {\n\t\t\treturn resource.path;\n\t\t}\n\t\tconst instructionFile = join(resource.path, filename);\n\t\tif (!existsSync(instructionFile)) return resource.path;\n\t\tif (!metadataByPath.has(instructionFile)) metadataByPath.set(instructionFile, resource.metadata);\n\t\treturn instructionFile;\n\t}\n\n\tprivate async filterExistingRemoteInstructionPaths(\n\t\tentries: ResourcePathEntry[],\n\t\toperations: ToolOperations,\n\t): Promise<ResourcePathEntry[]> {\n\t\tconst existing: ResourcePathEntry[] = [];\n\t\tfor (const entry of entries) {\n\t\t\ttry {\n\t\t\t\tawait operations.access(entry.path, \"exists\");\n\t\t\t\texisting.push(entry);\n\t\t\t} catch {}\n\t\t}\n\t\treturn existing;\n\t}\n\n\tprivate async discoverRemoteInstructionResourcePaths(\n\t\toperations: ToolOperations | undefined,\n\t): Promise<RemoteInstructionResourcePaths> {\n\t\tconst emptyPaths = { skills: [], rules: [], prompts: [] };\n\t\tif (!operations) return emptyPaths;\n\t\tconst backend = operations.getBackendInfo?.();\n\t\tif (backend?.type !== \"remote\" || !backend.configured) return emptyPaths;\n\t\tconst discovered = this.getRemoteProjectInstructionResourcePaths(operations.cwd, backend);\n\t\treturn {\n\t\t\tskills: await this.filterExistingRemoteInstructionPaths(discovered.skills, operations),\n\t\t\trules: await this.filterExistingRemoteInstructionPaths(discovered.rules, operations),\n\t\t\tprompts: await this.filterExistingRemoteInstructionPaths(discovered.prompts, operations),\n\t\t};\n\t}\n\n\tprivate recordRemoteInstructionMetadata(\n\t\tpaths: RemoteInstructionResourcePaths,\n\t\tmetadataByPath: Map<string, PathMetadata>,\n\t): void {\n\t\tfor (const entry of [...paths.skills, ...paths.rules, ...paths.prompts]) {\n\t\t\tmetadataByPath.set(entry.path, entry.metadata);\n\t\t}\n\t}\n\n\tprivate recordCliInstructionMetadata(paths: ResolvedPaths, metadataByPath: Map<string, PathMetadata>): void {\n\t\tfor (const resource of [...paths.extensions, ...paths.skills, ...paths.rules]) {\n\t\t\tif (!metadataByPath.has(resource.path)) {\n\t\t\t\tmetadataByPath.set(resource.path, { source: \"cli\", scope: \"temporary\", origin: \"top-level\" });\n\t\t\t}\n\t\t}\n\t}\n\n\tprivate async collectReloadResourcePaths(\n\t\tresolvedPaths: ResolvedPaths,\n\t\tcliPaths: ResolvedPaths,\n\t\tmetadataByPath: Map<string, PathMetadata>,\n\t\tinstructionOperations: ToolOperations | undefined,\n\t): Promise<ReloadResourcePaths> {\n\t\tconst loadProjectInstructionsRemotely = instructionOperations !== undefined;\n\t\tconst enabledExtensions = this.getEnabledPaths(resolvedPaths.extensions, metadataByPath);\n\t\tconst enabledSkillResources = this.getEnabledResources(resolvedPaths.skills, metadataByPath).filter(\n\t\t\t(resource) => !this.shouldExcludeLocalProjectInstructionResource(resource, loadProjectInstructionsRemotely),\n\t\t);\n\t\tconst enabledRuleResources = this.getEnabledResources(resolvedPaths.rules, metadataByPath).filter(\n\t\t\t(resource) => !this.shouldExcludeLocalProjectInstructionResource(resource, loadProjectInstructionsRemotely),\n\t\t);\n\t\tconst enabledPrompts = this.getEnabledResources(resolvedPaths.prompts, metadataByPath)\n\t\t\t.filter(\n\t\t\t\t(resource) => !this.shouldExcludeLocalProjectInstructionResource(resource, loadProjectInstructionsRemotely),\n\t\t\t)\n\t\t\t.map((resource) => resource.path);\n\t\tconst enabledThemes = this.getEnabledPaths(resolvedPaths.themes, metadataByPath);\n\n\t\tconst remotePaths = await this.discoverRemoteInstructionResourcePaths(instructionOperations);\n\t\tthis.recordRemoteInstructionMetadata(remotePaths, metadataByPath);\n\t\tconst enabledSkills = enabledSkillResources.map((resource) =>\n\t\t\tthis.normalizePackagedInstructionPath(resource, \"SKILL.md\", metadataByPath),\n\t\t);\n\t\tconst enabledRules = enabledRuleResources.map((resource) =>\n\t\t\tthis.normalizePackagedInstructionPath(resource, \"RULES.md\", metadataByPath),\n\t\t);\n\n\t\tthis.recordCliInstructionMetadata(cliPaths, metadataByPath);\n\t\tconst cliExtensions = this.getEnabledPaths(cliPaths.extensions, metadataByPath);\n\t\tconst cliSkills = this.getEnabledPaths(cliPaths.skills, metadataByPath);\n\t\tconst cliRules = this.getEnabledPaths(cliPaths.rules, metadataByPath);\n\t\tconst cliPrompts = this.getEnabledPaths(cliPaths.prompts, metadataByPath);\n\t\tconst cliThemes = this.getEnabledPaths(cliPaths.themes, metadataByPath);\n\n\t\treturn {\n\t\t\textensions: this.noExtensions ? cliExtensions : this.mergePaths(cliExtensions, enabledExtensions),\n\t\t\tskills: this.noSkills\n\t\t\t\t? this.mergePaths(cliSkills, this.additionalSkillPaths)\n\t\t\t\t: this.mergePaths(\n\t\t\t\t\t\t[...cliSkills, ...enabledSkills, ...remotePaths.skills.map((entry) => entry.path)],\n\t\t\t\t\t\tthis.additionalSkillPaths,\n\t\t\t\t\t),\n\t\t\trules: this.noRules\n\t\t\t\t? this.mergePaths(cliRules, this.additionalRulePaths)\n\t\t\t\t: this.mergePaths(\n\t\t\t\t\t\t[...cliRules, ...enabledRules, ...remotePaths.rules.map((entry) => entry.path)],\n\t\t\t\t\t\tthis.additionalRulePaths,\n\t\t\t\t\t),\n\t\t\tprompts: this.noPromptTemplates\n\t\t\t\t? this.mergePaths(cliPrompts, this.additionalPromptTemplatePaths)\n\t\t\t\t: this.mergePaths(\n\t\t\t\t\t\t[...cliPrompts, ...enabledPrompts, ...remotePaths.prompts.map((entry) => entry.path)],\n\t\t\t\t\t\tthis.additionalPromptTemplatePaths,\n\t\t\t\t\t),\n\t\t\tthemes: this.noThemes\n\t\t\t\t? this.mergePaths(cliThemes, this.additionalThemePaths)\n\t\t\t\t: this.mergePaths([...cliThemes, ...enabledThemes], this.additionalThemePaths),\n\t\t};\n\t}\n\n\tprivate async reloadExtensions(extensionPaths: string[], metadataByPath: Map<string, PathMetadata>): Promise<void> {\n\t\tconst extensionsResult = await loadExtensions(extensionPaths, this.cwd, this.eventBus);\n\t\tconst inlineExtensions = await this.loadExtensionFactories(extensionsResult.runtime);\n\t\textensionsResult.extensions.push(...inlineExtensions.extensions);\n\t\textensionsResult.errors.push(...inlineExtensions.errors);\n\t\tfor (const conflict of this.detectExtensionConflicts(extensionsResult.extensions)) {\n\t\t\textensionsResult.errors.push({ path: conflict.path, error: conflict.message });\n\t\t}\n\t\tfor (const path of this.additionalExtensionPaths) {\n\t\t\tif (!isLocalPath(path)) continue;\n\t\t\tconst resolved = this.resolveResourcePath(path);\n\t\t\tif (!existsSync(resolved)) {\n\t\t\t\textensionsResult.errors.push({ path: resolved, error: `Extension path does not exist: ${resolved}` });\n\t\t\t}\n\t\t}\n\t\tthis.extensionsResult = this.extensionsOverride ? this.extensionsOverride(extensionsResult) : extensionsResult;\n\t\tthis.applyExtensionSourceInfo(this.extensionsResult.extensions, metadataByPath);\n\t}\n\n\tprivate async reloadSkills(skillPaths: string[], metadataByPath: Map<string, PathMetadata>): Promise<void> {\n\t\tthis.lastSkillPaths = skillPaths;\n\t\tawait this.updateSkillsFromPathsForReload(skillPaths, metadataByPath);\n\t\tconst diagnosticPaths = new Set(this.skillDiagnostics.map((diagnostic) => diagnostic.path));\n\t\tfor (const path of this.additionalSkillPaths) {\n\t\t\tif (!isLocalPath(path)) continue;\n\t\t\tconst resolved = this.resolveResourcePath(path);\n\t\t\tappendMissingResourceDiagnostic(resolved, this.skillDiagnostics, diagnosticPaths, \"Skill path does not exist\");\n\t\t}\n\t}\n\n\tprivate async reloadRules(rulePaths: string[], metadataByPath: Map<string, PathMetadata>): Promise<void> {\n\t\tthis.lastRulePaths = rulePaths;\n\t\tawait this.updateRulesFromPathsForReload(rulePaths, metadataByPath);\n\t\tconst diagnosticPaths = new Set(this.ruleDiagnostics.map((diagnostic) => diagnostic.path));\n\t\tfor (const path of this.additionalRulePaths) {\n\t\t\tif (!isLocalPath(path)) continue;\n\t\t\tconst resolved = this.resolveResourcePath(path);\n\t\t\tappendMissingResourceDiagnostic(resolved, this.ruleDiagnostics, diagnosticPaths, \"Rule path does not exist\");\n\t\t}\n\t}\n\n\tprivate async reloadPrompts(promptPaths: string[], metadataByPath: Map<string, PathMetadata>): Promise<void> {\n\t\tthis.lastPromptPaths = promptPaths;\n\t\tawait this.updatePromptsFromPathsForReload(promptPaths, metadataByPath);\n\t\tconst diagnosticPaths = new Set(this.promptDiagnostics.map((diagnostic) => diagnostic.path));\n\t\tfor (const path of this.additionalPromptTemplatePaths) {\n\t\t\tif (!isLocalPath(path)) continue;\n\t\t\tconst resolved = this.resolveResourcePath(path);\n\t\t\tappendMissingResourceDiagnostic(\n\t\t\t\tresolved,\n\t\t\t\tthis.promptDiagnostics,\n\t\t\t\tdiagnosticPaths,\n\t\t\t\t\"Prompt template path does not exist\",\n\t\t\t);\n\t\t}\n\t}\n\n\tprivate reloadThemes(themePaths: string[], metadataByPath: Map<string, PathMetadata>): void {\n\t\tthis.lastThemePaths = themePaths;\n\t\tthis.updateThemesFromPaths(themePaths, metadataByPath);\n\t\tconst diagnosticPaths = new Set(this.themeDiagnostics.map((diagnostic) => diagnostic.path));\n\t\tfor (const path of this.additionalThemePaths) {\n\t\t\tconst resolved = this.resolveResourcePath(path);\n\t\t\tappendMissingResourceDiagnostic(resolved, this.themeDiagnostics, diagnosticPaths, \"Theme path does not exist\");\n\t\t}\n\t}\n\n\tprivate async reloadProjectContextFiles(instructionOperations: ToolOperations | undefined): Promise<void> {\n\t\tconst backend = instructionOperations?.getBackendInfo?.();\n\t\tconst agentsFiles = {\n\t\t\tagentsFiles: this.noContextFiles\n\t\t\t\t? []\n\t\t\t\t: instructionOperations\n\t\t\t\t\t? await loadProjectContextFilesWithOperations({\n\t\t\t\t\t\t\tcwd: instructionOperations.cwd,\n\t\t\t\t\t\t\tagentDir: this.agentDir,\n\t\t\t\t\t\t\toperations: instructionOperations,\n\t\t\t\t\t\t\tworkspace: backend?.type === \"remote\" && backend.configured ? backend.workspace : undefined,\n\t\t\t\t\t\t})\n\t\t\t\t\t: loadProjectContextFiles({ cwd: this.cwd, agentDir: this.agentDir }),\n\t\t};\n\t\tconst resolvedAgentsFiles = this.agentsFilesOverride ? this.agentsFilesOverride(agentsFiles) : agentsFiles;\n\t\tthis.agentsFiles = resolvedAgentsFiles.agentsFiles;\n\t}\n\n\tprivate async reloadSystemPrompts(): Promise<void> {\n\t\tconst baseSystemPrompt = await resolvePromptInput(\n\t\t\tthis.systemPromptSource ?? this.discoverSystemPromptFile(),\n\t\t\t\"system prompt\",\n\t\t\tthis.getInstructionOperations(),\n\t\t);\n\t\tthis.systemPrompt = this.systemPromptOverride ? this.systemPromptOverride(baseSystemPrompt) : baseSystemPrompt;\n\n\t\tconst appendSources =\n\t\t\tthis.appendSystemPromptSource ??\n\t\t\t(this.discoverAppendSystemPromptFile() ? [this.discoverAppendSystemPromptFile()!] : []);\n\t\tconst baseAppend = (\n\t\t\tawait Promise.all(\n\t\t\t\tappendSources.map((source) =>\n\t\t\t\t\tresolvePromptInput(source, \"append system prompt\", this.getInstructionOperations()),\n\t\t\t\t),\n\t\t\t)\n\t\t).filter((source): source is string => source !== undefined);\n\t\tthis.appendSystemPrompt = this.appendSystemPromptOverride\n\t\t\t? this.appendSystemPromptOverride(baseAppend)\n\t\t\t: baseAppend;\n\t}\n\n\tasync reload(): Promise<void> {\n\t\tresetTimings(\"extensions\");\n\t\tawait this.settingsManager.reload();\n\t\tconst resolvedPaths = await this.packageManager.resolve();\n\t\tconst cliPaths = await this.packageManager.resolveExtensionSources(this.additionalExtensionPaths, {\n\t\t\ttemporary: true,\n\t\t});\n\t\tconst metadataByPath = new Map<string, PathMetadata>();\n\t\tthis.extensionSkillSourceInfos = new Map();\n\t\tthis.extensionRuleSourceInfos = new Map();\n\t\tthis.extensionPromptSourceInfos = new Map();\n\t\tthis.extensionThemeSourceInfos = new Map();\n\n\t\tconst instructionOperations = this.getInstructionOperations();\n\t\tconst paths = await this.collectReloadResourcePaths(\n\t\t\tresolvedPaths,\n\t\t\tcliPaths,\n\t\t\tmetadataByPath,\n\t\t\tinstructionOperations,\n\t\t);\n\t\tawait this.reloadExtensions(paths.extensions, metadataByPath);\n\t\tawait this.reloadSkills(paths.skills, metadataByPath);\n\t\tawait this.reloadRules(paths.rules, metadataByPath);\n\t\tawait this.reloadPrompts(paths.prompts, metadataByPath);\n\t\tthis.reloadThemes(paths.themes, metadataByPath);\n\t\tawait this.reloadProjectContextFiles(instructionOperations);\n\t\tawait this.reloadSystemPrompts();\n\t}\n\n\tprivate normalizeExtensionPaths(entries: ResourcePathEntry[]): ResourcePathEntry[] {\n\t\treturn entries.map((entry) => {\n\t\t\tconst metadata = entry.metadata.baseDir\n\t\t\t\t? { ...entry.metadata, baseDir: this.resolveResourcePath(entry.metadata.baseDir) }\n\t\t\t\t: entry.metadata;\n\t\t\treturn {\n\t\t\t\tpath: this.resolveResourcePath(entry.path),\n\t\t\t\tmetadata,\n\t\t\t};\n\t\t});\n\t}\n\n\tprivate getExtensionRegisteredSkills(): Skill[] {\n\t\treturn this.extensionsResult.extensions.flatMap((extension) => Array.from(extension.skills.values()));\n\t}\n\n\tprivate getExtensionRegisteredRules(): Rule[] {\n\t\treturn this.extensionsResult.extensions.flatMap((extension) => Array.from(extension.rules.values()));\n\t}\n\n\tprivate getExtensionRegisteredPrompts(): PromptTemplate[] {\n\t\treturn this.extensionsResult.extensions.flatMap((extension) => Array.from(extension.prompts.values()));\n\t}\n\n\tprivate applyLoadedSkills(skillsResult: LoadSkillsResult, metadataByPath?: Map<string, PathMetadata>): void {\n\t\tconst extensionSkills = this.getExtensionRegisteredSkills();\n\t\tconst seenSkillNames = new Set(extensionSkills.map((skill) => skill.name));\n\t\tconst baseSkillsResult = {\n\t\t\tskills: [...extensionSkills, ...skillsResult.skills.filter((skill) => !seenSkillNames.has(skill.name))],\n\t\t\tdiagnostics: skillsResult.diagnostics,\n\t\t};\n\t\tconst resolvedSkills = this.skillsOverride ? this.skillsOverride(baseSkillsResult) : baseSkillsResult;\n\t\tthis.skills = resolvedSkills.skills.map((skill) => ({\n\t\t\t...skill,\n\t\t\tsourceInfo:\n\t\t\t\tthis.findSourceInfoForPath(skill.filePath, this.extensionSkillSourceInfos, metadataByPath) ??\n\t\t\t\tskill.sourceInfo ??\n\t\t\t\tthis.getDefaultSourceInfoForPath(skill.filePath),\n\t\t}));\n\t\tthis.skillDiagnostics = resolvedSkills.diagnostics;\n\t}\n\n\tprivate updateSkillsFromPaths(skillPaths: string[], metadataByPath?: Map<string, PathMetadata>): void {\n\t\tlet skillsResult: { skills: Skill[]; diagnostics: ResourceDiagnostic[] };\n\t\tif (this.noSkills && skillPaths.length === 0) {\n\t\t\tskillsResult = { skills: [], diagnostics: [] };\n\t\t} else {\n\t\t\tskillsResult = loadSkills({\n\t\t\t\tcwd: this.cwd,\n\t\t\t\tagentDir: this.agentDir,\n\t\t\t\tskillPaths,\n\t\t\t\tincludeDefaults: false,\n\t\t\t});\n\t\t}\n\t\tthis.applyLoadedSkills(skillsResult, metadataByPath);\n\t}\n\n\tprivate shouldLoadPathWithInstructionOperations(path: string, metadataByPath?: Map<string, PathMetadata>): boolean {\n\t\tconst operations = this.getInstructionOperations();\n\t\tif (!operations) return false;\n\t\tconst sourceInfo = this.findSourceInfoForPath(path, undefined, metadataByPath);\n\t\tif (sourceInfo?.source === \"remote\") return true;\n\t\tconst backend = operations.getBackendInfo?.();\n\t\tif (backend?.type === \"remote\" && backend.configured) {\n\t\t\treturn relativeWithin(backend.workspace.root, path) !== undefined;\n\t\t}\n\t\tconst cwd = operations.cwd.endsWith(sep) ? operations.cwd : `${operations.cwd}${sep}`;\n\t\treturn path === operations.cwd || path.startsWith(cwd);\n\t}\n\n\tprivate async updateSkillsFromPathsForReload(\n\t\tskillPaths: string[],\n\t\tmetadataByPath?: Map<string, PathMetadata>,\n\t): Promise<void> {\n\t\tlet skillsResult: { skills: Skill[]; diagnostics: ResourceDiagnostic[] };\n\t\tconst operations = this.getInstructionOperations();\n\t\tif (this.noSkills && skillPaths.length === 0) {\n\t\t\tskillsResult = { skills: [], diagnostics: [] };\n\t\t} else if (operations) {\n\t\t\tconst remotePaths = skillPaths.filter((path) =>\n\t\t\t\tthis.shouldLoadPathWithInstructionOperations(path, metadataByPath),\n\t\t\t);\n\t\t\tconst localPaths = skillPaths.filter(\n\t\t\t\t(path) => !this.shouldLoadPathWithInstructionOperations(path, metadataByPath),\n\t\t\t);\n\t\t\tconst remoteResult = await loadSkillsWithOperations({\n\t\t\t\tcwd: operations.cwd,\n\t\t\t\tagentDir: this.agentDir,\n\t\t\t\tskillPaths: remotePaths,\n\t\t\t\tincludeDefaults: false,\n\t\t\t\toperations,\n\t\t\t});\n\t\t\tconst localResult = loadSkills({\n\t\t\t\tcwd: this.cwd,\n\t\t\t\tagentDir: this.agentDir,\n\t\t\t\tskillPaths: localPaths,\n\t\t\t\tincludeDefaults: false,\n\t\t\t});\n\t\t\tconst merged = mergeNamedResources(remoteResult.skills, localResult.skills, \"skill\");\n\t\t\tskillsResult = {\n\t\t\t\tskills: merged.resources,\n\t\t\t\tdiagnostics: [...remoteResult.diagnostics, ...localResult.diagnostics, ...merged.diagnostics],\n\t\t\t};\n\t\t} else {\n\t\t\tskillsResult = loadSkills({\n\t\t\t\tcwd: this.cwd,\n\t\t\t\tagentDir: this.agentDir,\n\t\t\t\tskillPaths,\n\t\t\t\tincludeDefaults: false,\n\t\t\t});\n\t\t}\n\t\tthis.applyLoadedSkills(skillsResult, metadataByPath);\n\t}\n\n\tprivate applyLoadedRules(rulesResult: LoadRulesResult, metadataByPath?: Map<string, PathMetadata>): void {\n\t\tconst extensionRules = this.getExtensionRegisteredRules();\n\t\tconst seenRuleNames = new Set(extensionRules.map((rule) => rule.name));\n\t\tconst baseRulesResult = {\n\t\t\trules: [...extensionRules, ...rulesResult.rules.filter((rule) => !seenRuleNames.has(rule.name))],\n\t\t\tdiagnostics: rulesResult.diagnostics,\n\t\t};\n\t\tconst resolvedRules = this.rulesOverride ? this.rulesOverride(baseRulesResult) : baseRulesResult;\n\t\tthis.rules = resolvedRules.rules.map((rule) => ({\n\t\t\t...rule,\n\t\t\tsourceInfo:\n\t\t\t\tthis.findSourceInfoForPath(rule.filePath, this.extensionRuleSourceInfos, metadataByPath) ??\n\t\t\t\trule.sourceInfo ??\n\t\t\t\tthis.getDefaultSourceInfoForPath(rule.filePath),\n\t\t}));\n\t\tthis.ruleDiagnostics = resolvedRules.diagnostics;\n\t}\n\n\tprivate updateRulesFromPaths(rulePaths: string[], metadataByPath?: Map<string, PathMetadata>): void {\n\t\tlet rulesResult: { rules: Rule[]; diagnostics: ResourceDiagnostic[] };\n\t\tif (this.noRules && rulePaths.length === 0) {\n\t\t\trulesResult = { rules: [], diagnostics: [] };\n\t\t} else {\n\t\t\trulesResult = loadRules({\n\t\t\t\tcwd: this.cwd,\n\t\t\t\tagentDir: this.agentDir,\n\t\t\t\trulePaths,\n\t\t\t\tincludeDefaults: false,\n\t\t\t});\n\t\t}\n\t\tthis.applyLoadedRules(rulesResult, metadataByPath);\n\t}\n\n\tprivate async updateRulesFromPathsForReload(\n\t\trulePaths: string[],\n\t\tmetadataByPath?: Map<string, PathMetadata>,\n\t): Promise<void> {\n\t\tlet rulesResult: { rules: Rule[]; diagnostics: ResourceDiagnostic[] };\n\t\tconst operations = this.getInstructionOperations();\n\t\tif (this.noRules && rulePaths.length === 0) {\n\t\t\trulesResult = { rules: [], diagnostics: [] };\n\t\t} else if (operations) {\n\t\t\tconst remotePaths = rulePaths.filter((path) =>\n\t\t\t\tthis.shouldLoadPathWithInstructionOperations(path, metadataByPath),\n\t\t\t);\n\t\t\tconst localPaths = rulePaths.filter(\n\t\t\t\t(path) => !this.shouldLoadPathWithInstructionOperations(path, metadataByPath),\n\t\t\t);\n\t\t\tconst remoteResult = await loadRulesWithOperations({\n\t\t\t\tcwd: operations.cwd,\n\t\t\t\tagentDir: this.agentDir,\n\t\t\t\trulePaths: remotePaths,\n\t\t\t\tincludeDefaults: false,\n\t\t\t\toperations,\n\t\t\t});\n\t\t\tconst localResult = loadRules({\n\t\t\t\tcwd: this.cwd,\n\t\t\t\tagentDir: this.agentDir,\n\t\t\t\trulePaths: localPaths,\n\t\t\t\tincludeDefaults: false,\n\t\t\t});\n\t\t\tconst merged = mergeNamedResources(remoteResult.rules, localResult.rules, \"rule\");\n\t\t\trulesResult = {\n\t\t\t\trules: merged.resources,\n\t\t\t\tdiagnostics: [...remoteResult.diagnostics, ...localResult.diagnostics, ...merged.diagnostics],\n\t\t\t};\n\t\t} else {\n\t\t\trulesResult = loadRules({\n\t\t\t\tcwd: this.cwd,\n\t\t\t\tagentDir: this.agentDir,\n\t\t\t\trulePaths,\n\t\t\t\tincludeDefaults: false,\n\t\t\t});\n\t\t}\n\t\tthis.applyLoadedRules(rulesResult, metadataByPath);\n\t}\n\n\tprivate applyLoadedPrompts(\n\t\tpromptsResult: LoadPromptTemplatesResult,\n\t\tmetadataByPath?: Map<string, PathMetadata>,\n\t): void {\n\t\tconst extensionPrompts = this.getExtensionRegisteredPrompts();\n\t\tconst basePromptsResult = this.dedupePrompts([...extensionPrompts, ...promptsResult.prompts]);\n\t\tbasePromptsResult.diagnostics.unshift(...promptsResult.diagnostics);\n\t\tconst resolvedPrompts = this.promptsOverride ? this.promptsOverride(basePromptsResult) : basePromptsResult;\n\t\tthis.prompts = resolvedPrompts.prompts.map((prompt) => ({\n\t\t\t...prompt,\n\t\t\tsourceInfo:\n\t\t\t\tthis.findSourceInfoForPath(prompt.filePath, this.extensionPromptSourceInfos, metadataByPath) ??\n\t\t\t\tprompt.sourceInfo ??\n\t\t\t\tthis.getDefaultSourceInfoForPath(prompt.filePath),\n\t\t}));\n\t\tthis.promptDiagnostics = resolvedPrompts.diagnostics;\n\t}\n\n\tprivate updatePromptsFromPaths(promptPaths: string[], metadataByPath?: Map<string, PathMetadata>): void {\n\t\tlet promptsResult: { prompts: PromptTemplate[]; diagnostics: ResourceDiagnostic[] };\n\t\tif (this.noPromptTemplates && promptPaths.length === 0) {\n\t\t\tpromptsResult = { prompts: [], diagnostics: [] };\n\t\t} else {\n\t\t\tconst allPrompts = loadPromptTemplates({\n\t\t\t\tcwd: this.cwd,\n\t\t\t\tagentDir: this.agentDir,\n\t\t\t\tpromptPaths,\n\t\t\t\tincludeDefaults: false,\n\t\t\t});\n\t\t\tpromptsResult = this.dedupePrompts(allPrompts);\n\t\t}\n\t\tthis.applyLoadedPrompts(promptsResult, metadataByPath);\n\t}\n\n\tprivate async updatePromptsFromPathsForReload(\n\t\tpromptPaths: string[],\n\t\tmetadataByPath?: Map<string, PathMetadata>,\n\t): Promise<void> {\n\t\tlet promptsResult: { prompts: PromptTemplate[]; diagnostics: ResourceDiagnostic[] };\n\t\tconst operations = this.getInstructionOperations();\n\t\tif (this.noPromptTemplates && promptPaths.length === 0) {\n\t\t\tpromptsResult = { prompts: [], diagnostics: [] };\n\t\t} else if (operations) {\n\t\t\tconst remotePaths = promptPaths.filter((path) =>\n\t\t\t\tthis.shouldLoadPathWithInstructionOperations(path, metadataByPath),\n\t\t\t);\n\t\t\tconst localPaths = promptPaths.filter(\n\t\t\t\t(path) => !this.shouldLoadPathWithInstructionOperations(path, metadataByPath),\n\t\t\t);\n\t\t\tconst remotePrompts = await loadPromptTemplatesWithOperations({\n\t\t\t\tcwd: operations.cwd,\n\t\t\t\tagentDir: this.agentDir,\n\t\t\t\tpromptPaths: remotePaths,\n\t\t\t\tincludeDefaults: false,\n\t\t\t\toperations,\n\t\t\t});\n\t\t\tconst localPrompts = loadPromptTemplates({\n\t\t\t\tcwd: this.cwd,\n\t\t\t\tagentDir: this.agentDir,\n\t\t\t\tpromptPaths: localPaths,\n\t\t\t\tincludeDefaults: false,\n\t\t\t});\n\t\t\tpromptsResult = this.dedupePrompts([...remotePrompts, ...localPrompts]);\n\t\t} else {\n\t\t\tconst allPrompts = loadPromptTemplates({\n\t\t\t\tcwd: this.cwd,\n\t\t\t\tagentDir: this.agentDir,\n\t\t\t\tpromptPaths,\n\t\t\t\tincludeDefaults: false,\n\t\t\t});\n\t\t\tpromptsResult = this.dedupePrompts(allPrompts);\n\t\t}\n\t\tthis.applyLoadedPrompts(promptsResult, metadataByPath);\n\t}\n\n\tprivate updateThemesFromPaths(themePaths: string[], metadataByPath?: Map<string, PathMetadata>): void {\n\t\tlet themesResult: { themes: Theme[]; diagnostics: ResourceDiagnostic[] };\n\t\tif (this.noThemes && themePaths.length === 0) {\n\t\t\tthemesResult = { themes: [], diagnostics: [] };\n\t\t} else {\n\t\t\tconst loaded = this.loadThemes(themePaths, false);\n\t\t\tconst deduped = this.dedupeThemes(loaded.themes);\n\t\t\tthemesResult = { themes: deduped.themes, diagnostics: [...loaded.diagnostics, ...deduped.diagnostics] };\n\t\t}\n\t\tconst resolvedThemes = this.themesOverride ? this.themesOverride(themesResult) : themesResult;\n\t\tthis.themes = resolvedThemes.themes.map((theme) => {\n\t\t\tconst sourcePath = theme.sourcePath;\n\t\t\ttheme.sourceInfo = sourcePath\n\t\t\t\t? (this.findSourceInfoForPath(sourcePath, this.extensionThemeSourceInfos, metadataByPath) ??\n\t\t\t\t\ttheme.sourceInfo ??\n\t\t\t\t\tthis.getDefaultSourceInfoForPath(sourcePath))\n\t\t\t\t: theme.sourceInfo;\n\t\t\treturn theme;\n\t\t});\n\t\tthis.themeDiagnostics = resolvedThemes.diagnostics;\n\t}\n\n\tprivate applyExtensionSourceInfo(extensions: Extension[], metadataByPath: Map<string, PathMetadata>): void {\n\t\tfor (const extension of extensions) {\n\t\t\textension.sourceInfo =\n\t\t\t\tthis.findSourceInfoForPath(extension.path, undefined, metadataByPath) ??\n\t\t\t\tthis.getDefaultSourceInfoForPath(extension.path);\n\t\t\tfor (const command of extension.commands.values()) {\n\t\t\t\tcommand.sourceInfo = extension.sourceInfo;\n\t\t\t}\n\t\t\tfor (const tool of extension.tools.values()) {\n\t\t\t\ttool.sourceInfo = extension.sourceInfo;\n\t\t\t}\n\t\t\tfor (const skill of extension.skills.values()) {\n\t\t\t\tskill.sourceInfo = extension.sourceInfo;\n\t\t\t}\n\t\t\tfor (const rule of extension.rules.values()) {\n\t\t\t\trule.sourceInfo = extension.sourceInfo;\n\t\t\t}\n\t\t\tfor (const prompt of extension.prompts.values()) {\n\t\t\t\tprompt.sourceInfo = extension.sourceInfo;\n\t\t\t}\n\t\t}\n\t}\n\n\tprivate findRegisteredSourceInfoForPath(\n\t\tresourcePath: string,\n\t\tnormalizedResourcePath: string,\n\t\tsourceInfos: Map<string, SourceInfo>,\n\t): SourceInfo | undefined {\n\t\tfor (const [sourcePath, sourceInfo] of sourceInfos.entries()) {\n\t\t\tconst normalizedSourcePath = resolve(sourcePath);\n\t\t\tif (\n\t\t\t\tnormalizedResourcePath === normalizedSourcePath ||\n\t\t\t\tnormalizedResourcePath.startsWith(`${normalizedSourcePath}${sep}`)\n\t\t\t) {\n\t\t\t\treturn { ...sourceInfo, path: resourcePath };\n\t\t\t}\n\t\t}\n\t\treturn undefined;\n\t}\n\n\tprivate findResolvedResourceSourceInfoForPath(\n\t\tresourcePath: string,\n\t\tnormalizedResourcePath: string,\n\t\tmetadataByPath: Map<string, PathMetadata>,\n\t): SourceInfo | undefined {\n\t\tconst exact = metadataByPath.get(normalizedResourcePath) ?? metadataByPath.get(resourcePath);\n\t\tif (exact) return createSourceInfo(resourcePath, exact);\n\n\t\tfor (const [sourcePath, metadata] of metadataByPath.entries()) {\n\t\t\tif (metadata.workspace) {\n\t\t\t\tif (relativeWithin(sourcePath, resourcePath) !== undefined) {\n\t\t\t\t\treturn createSourceInfo(resourcePath, metadata);\n\t\t\t\t}\n\t\t\t\tcontinue;\n\t\t\t}\n\t\t\tconst normalizedSourcePath = resolve(sourcePath);\n\t\t\tif (\n\t\t\t\tnormalizedResourcePath === normalizedSourcePath ||\n\t\t\t\tnormalizedResourcePath.startsWith(`${normalizedSourcePath}${sep}`)\n\t\t\t) {\n\t\t\t\treturn createSourceInfo(resourcePath, metadata);\n\t\t\t}\n\t\t}\n\t\treturn undefined;\n\t}\n\n\tprivate findSourceInfoForPath(\n\t\tresourcePath: string,\n\t\textraSourceInfos?: Map<string, SourceInfo>,\n\t\tmetadataByPath?: Map<string, PathMetadata>,\n\t): SourceInfo | undefined {\n\t\tif (!resourcePath) return undefined;\n\t\tif (resourcePath.startsWith(\"<\")) return this.getDefaultSourceInfoForPath(resourcePath);\n\n\t\tconst normalizedResourcePath = resolve(resourcePath);\n\t\tconst registeredSourceInfo = extraSourceInfos\n\t\t\t? this.findRegisteredSourceInfoForPath(resourcePath, normalizedResourcePath, extraSourceInfos)\n\t\t\t: undefined;\n\t\tif (registeredSourceInfo) return registeredSourceInfo;\n\t\treturn metadataByPath\n\t\t\t? this.findResolvedResourceSourceInfoForPath(resourcePath, normalizedResourcePath, metadataByPath)\n\t\t\t: undefined;\n\t}\n\n\tprivate getDefaultSourceInfoForPath(filePath: string): SourceInfo {\n\t\tif (filePath.startsWith(\"<\") && filePath.endsWith(\">\")) {\n\t\t\treturn {\n\t\t\t\tpath: filePath,\n\t\t\t\tsource: filePath.slice(1, -1).split(\":\")[0] || \"temporary\",\n\t\t\t\tscope: \"temporary\",\n\t\t\t\torigin: \"top-level\",\n\t\t\t};\n\t\t}\n\n\t\tconst normalizedPath = resolve(filePath);\n\t\tconst agentRoots = [\n\t\t\tjoin(this.agentDir, \"skills\"),\n\t\t\tjoin(this.agentDir, \"rules\"),\n\t\t\tjoin(this.agentDir, \"prompts\"),\n\t\t\tjoin(this.agentDir, \"themes\"),\n\t\t\tjoin(this.agentDir, \"extensions\"),\n\t\t];\n\t\tconst projectRoots = [\n\t\t\tjoin(this.cwd, CONFIG_DIR_NAME, \"skills\"),\n\t\t\tjoin(this.cwd, CONFIG_DIR_NAME, \"rules\"),\n\t\t\tjoin(this.cwd, CONFIG_DIR_NAME, \"prompts\"),\n\t\t\tjoin(this.cwd, CONFIG_DIR_NAME, \"themes\"),\n\t\t\tjoin(this.cwd, CONFIG_DIR_NAME, \"extensions\"),\n\t\t];\n\n\t\tfor (const root of agentRoots) {\n\t\t\tif (this.isUnderPath(normalizedPath, root)) {\n\t\t\t\treturn { path: filePath, source: \"local\", scope: \"user\", origin: \"top-level\", baseDir: root };\n\t\t\t}\n\t\t}\n\n\t\tfor (const root of projectRoots) {\n\t\t\tif (this.isUnderPath(normalizedPath, root)) {\n\t\t\t\treturn { path: filePath, source: \"local\", scope: \"project\", origin: \"top-level\", baseDir: root };\n\t\t\t}\n\t\t}\n\n\t\treturn {\n\t\t\tpath: filePath,\n\t\t\tsource: \"local\",\n\t\t\tscope: \"temporary\",\n\t\t\torigin: \"top-level\",\n\t\t\tbaseDir: statSync(normalizedPath).isDirectory() ? normalizedPath : resolve(normalizedPath, \"..\"),\n\t\t};\n\t}\n\n\tprivate mergePaths(primary: string[], additional: string[]): string[] {\n\t\tconst merged: string[] = [];\n\t\tconst seen = new Set<string>();\n\n\t\tfor (const p of [...primary, ...additional]) {\n\t\t\tconst resolved = this.resolveResourcePath(p);\n\t\t\tconst canonicalPath = canonicalizePath(resolved);\n\t\t\tif (seen.has(canonicalPath)) continue;\n\t\t\tseen.add(canonicalPath);\n\t\t\tmerged.push(resolved);\n\t\t}\n\n\t\treturn merged;\n\t}\n\n\tprivate resolveResourcePath(p: string): string {\n\t\treturn resolvePath(p, this.cwd, { trim: true });\n\t}\n\n\tprivate loadThemes(paths: string[], includeDefaults: boolean = true): LoadThemesResult {\n\t\tconst themes: Theme[] = [];\n\t\tconst diagnostics: ResourceDiagnostic[] = [];\n\t\tif (includeDefaults) {\n\t\t\tconst defaultDirs = [join(this.agentDir, \"themes\"), join(this.cwd, CONFIG_DIR_NAME, \"themes\")];\n\n\t\t\tfor (const dir of defaultDirs) {\n\t\t\t\tthis.loadThemesFromDir(dir, themes, diagnostics);\n\t\t\t}\n\t\t}\n\n\t\tfor (const p of paths) {\n\t\t\tconst resolved = this.resolveResourcePath(p);\n\t\t\tif (!existsSync(resolved)) {\n\t\t\t\tdiagnostics.push({ type: \"warning\", message: \"theme path does not exist\", path: resolved });\n\t\t\t\tcontinue;\n\t\t\t}\n\n\t\t\ttry {\n\t\t\t\tconst stats = statSync(resolved);\n\t\t\t\tif (stats.isDirectory()) {\n\t\t\t\t\tthis.loadThemesFromDir(resolved, themes, diagnostics);\n\t\t\t\t} else if (stats.isFile() && resolved.endsWith(\".json\")) {\n\t\t\t\t\tthis.loadThemeFromFile(resolved, themes, diagnostics);\n\t\t\t\t} else {\n\t\t\t\t\tdiagnostics.push({ type: \"warning\", message: \"theme path is not a json file\", path: resolved });\n\t\t\t\t}\n\t\t\t} catch (error) {\n\t\t\t\tconst message = error instanceof Error ? error.message : \"failed to read theme path\";\n\t\t\t\tdiagnostics.push({ type: \"warning\", message, path: resolved });\n\t\t\t}\n\t\t}\n\n\t\treturn { themes, diagnostics };\n\t}\n\n\tprivate loadThemesFromDir(dir: string, themes: Theme[], diagnostics: ResourceDiagnostic[]): void {\n\t\tif (!existsSync(dir)) {\n\t\t\treturn;\n\t\t}\n\n\t\ttry {\n\t\t\tconst entries = readdirSync(dir, { withFileTypes: true });\n\t\t\tfor (const entry of entries) {\n\t\t\t\tlet isFile = entry.isFile();\n\t\t\t\tif (entry.isSymbolicLink()) {\n\t\t\t\t\ttry {\n\t\t\t\t\t\tisFile = statSync(join(dir, entry.name)).isFile();\n\t\t\t\t\t} catch {\n\t\t\t\t\t\tcontinue;\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t\tif (!isFile) {\n\t\t\t\t\tcontinue;\n\t\t\t\t}\n\t\t\t\tif (!entry.name.endsWith(\".json\")) {\n\t\t\t\t\tcontinue;\n\t\t\t\t}\n\t\t\t\tthis.loadThemeFromFile(join(dir, entry.name), themes, diagnostics);\n\t\t\t}\n\t\t} catch (error) {\n\t\t\tconst message = error instanceof Error ? error.message : \"failed to read theme directory\";\n\t\t\tdiagnostics.push({ type: \"warning\", message, path: dir });\n\t\t}\n\t}\n\n\tprivate loadThemeFromFile(filePath: string, themes: Theme[], diagnostics: ResourceDiagnostic[]): void {\n\t\ttry {\n\t\t\tthemes.push(loadThemeFromPath(filePath));\n\t\t} catch (error) {\n\t\t\tconst message = error instanceof Error ? error.message : \"failed to load theme\";\n\t\t\tdiagnostics.push({ type: \"warning\", message, path: filePath });\n\t\t}\n\t}\n\n\tprivate async loadExtensionFactories(runtime: ExtensionRuntime): Promise<InlineExtensionLoadResult> {\n\t\tconst extensions: Extension[] = [];\n\t\tconst errors: Array<{ path: string; error: string }> = [];\n\n\t\tfor (const [index, factory] of this.extensionFactories.entries()) {\n\t\t\tconst extensionPath = `<inline:${index + 1}>`;\n\t\t\ttry {\n\t\t\t\tconst extension = await loadExtensionFromFactory(factory, this.cwd, this.eventBus, runtime, extensionPath);\n\t\t\t\textensions.push(extension);\n\t\t\t} catch (error) {\n\t\t\t\tconst message = error instanceof Error ? error.message : \"failed to load extension\";\n\t\t\t\terrors.push({ path: extensionPath, error: message });\n\t\t\t}\n\t\t}\n\n\t\treturn { extensions, errors };\n\t}\n\n\tprivate dedupePrompts(prompts: PromptTemplate[]): LoadPromptTemplatesResult {\n\t\tconst seen = new Map<string, PromptTemplate>();\n\t\tconst diagnostics: ResourceDiagnostic[] = [];\n\n\t\tfor (const prompt of prompts) {\n\t\t\tconst existing = seen.get(prompt.name);\n\t\t\tif (existing) {\n\t\t\t\tdiagnostics.push({\n\t\t\t\t\ttype: \"collision\",\n\t\t\t\t\tmessage: `name \"/${prompt.name}\" collision`,\n\t\t\t\t\tpath: prompt.filePath,\n\t\t\t\t\tcollision: {\n\t\t\t\t\t\tresourceType: \"prompt\",\n\t\t\t\t\t\tname: prompt.name,\n\t\t\t\t\t\twinnerPath: existing.filePath,\n\t\t\t\t\t\tloserPath: prompt.filePath,\n\t\t\t\t\t},\n\t\t\t\t});\n\t\t\t} else {\n\t\t\t\tseen.set(prompt.name, prompt);\n\t\t\t}\n\t\t}\n\n\t\treturn { prompts: Array.from(seen.values()), diagnostics };\n\t}\n\n\tprivate dedupeThemes(themes: Theme[]): LoadThemesResult {\n\t\tconst seen = new Map<string, Theme>();\n\t\tconst diagnostics: ResourceDiagnostic[] = [];\n\n\t\tfor (const t of themes) {\n\t\t\tconst name = t.name ?? \"unnamed\";\n\t\t\tconst existing = seen.get(name);\n\t\t\tif (existing) {\n\t\t\t\tdiagnostics.push({\n\t\t\t\t\ttype: \"collision\",\n\t\t\t\t\tmessage: `name \"${name}\" collision`,\n\t\t\t\t\tpath: t.sourcePath,\n\t\t\t\t\tcollision: {\n\t\t\t\t\t\tresourceType: \"theme\",\n\t\t\t\t\t\tname,\n\t\t\t\t\t\twinnerPath: existing.sourcePath ?? \"<builtin>\",\n\t\t\t\t\t\tloserPath: t.sourcePath ?? \"<builtin>\",\n\t\t\t\t\t},\n\t\t\t\t});\n\t\t\t} else {\n\t\t\t\tseen.set(name, t);\n\t\t\t}\n\t\t}\n\n\t\treturn { themes: Array.from(seen.values()), diagnostics };\n\t}\n\n\tprivate discoverSystemPromptFile(): string | undefined {\n\t\tconst projectPath = join(this.cwd, CONFIG_DIR_NAME, \"SYSTEM.md\");\n\t\tif (existsSync(projectPath)) {\n\t\t\treturn projectPath;\n\t\t}\n\n\t\tconst globalPath = join(this.agentDir, \"SYSTEM.md\");\n\t\tif (existsSync(globalPath)) {\n\t\t\treturn globalPath;\n\t\t}\n\n\t\treturn undefined;\n\t}\n\n\tprivate discoverAppendSystemPromptFile(): string | undefined {\n\t\tconst projectPath = join(this.cwd, CONFIG_DIR_NAME, \"APPEND_SYSTEM.md\");\n\t\tif (existsSync(projectPath)) {\n\t\t\treturn projectPath;\n\t\t}\n\n\t\tconst globalPath = join(this.agentDir, \"APPEND_SYSTEM.md\");\n\t\tif (existsSync(globalPath)) {\n\t\t\treturn globalPath;\n\t\t}\n\n\t\treturn undefined;\n\t}\n\n\tprivate isUnderPath(target: string, root: string): boolean {\n\t\tconst normalizedRoot = resolve(root);\n\t\tif (target === normalizedRoot) {\n\t\t\treturn true;\n\t\t}\n\t\tconst prefix = normalizedRoot.endsWith(sep) ? normalizedRoot : `${normalizedRoot}${sep}`;\n\t\treturn target.startsWith(prefix);\n\t}\n\n\tprivate detectExtensionConflicts(extensions: Extension[]): ExtensionConflict[] {\n\t\tconst conflicts: ExtensionConflict[] = [];\n\n\t\t// Track which extension registered each tool and flag\n\t\tconst toolOwners = new Map<string, string>();\n\t\tconst flagOwners = new Map<string, string>();\n\n\t\tfor (const ext of extensions) {\n\t\t\t// Check tools\n\t\t\tfor (const toolName of ext.tools.keys()) {\n\t\t\t\tconst existingOwner = toolOwners.get(toolName);\n\t\t\t\tif (existingOwner && existingOwner !== ext.path) {\n\t\t\t\t\tconflicts.push({\n\t\t\t\t\t\tpath: ext.path,\n\t\t\t\t\t\tmessage: `Tool \"${toolName}\" conflicts with ${existingOwner}`,\n\t\t\t\t\t});\n\t\t\t\t} else {\n\t\t\t\t\ttoolOwners.set(toolName, ext.path);\n\t\t\t\t}\n\t\t\t}\n\n\t\t\t// Check flags\n\t\t\tfor (const flagName of ext.flags.keys()) {\n\t\t\t\tconst existingOwner = flagOwners.get(flagName);\n\t\t\t\tif (existingOwner && existingOwner !== ext.path) {\n\t\t\t\t\tconflicts.push({\n\t\t\t\t\t\tpath: ext.path,\n\t\t\t\t\t\tmessage: `Flag \"--${flagName}\" conflicts with ${existingOwner}`,\n\t\t\t\t\t});\n\t\t\t\t} else {\n\t\t\t\t\tflagOwners.set(flagName, ext.path);\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\n\t\treturn conflicts;\n\t}\n}\n"]}