@ai-outfitter/outfitter 0.11.0 → 1.0.2

package/dist/projection/Materialize.js

@@ -0,0 +1,83 @@
+// Materializes a CompositionPlan into a runtime configuration directory the harness launches from.
+import { copyFileSync, lstatSync, mkdirSync, readdirSync, writeFileSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { escapesRoots } from '../dump/Containment.js';
+import { removeTargetTypeConflict } from '../fs/TypeConflict.js';
+/** Recursively copies a directory, skipping symlinked entries so no path escapes the tree. */
+const copyDirectory = (sourceDir, targetDir) => {
+    removeTargetTypeConflict(targetDir, 'directory');
+    mkdirSync(targetDir, { recursive: true });
+    for (const entry of readdirSync(sourceDir, { withFileTypes: true })) {
+        const sourcePath = join(sourceDir, entry.name);
+        if (lstatSync(sourcePath).isSymbolicLink()) {
+            continue;
+        }
+        if (entry.isDirectory()) {
+            copyDirectory(sourcePath, join(targetDir, entry.name));
+        }
+        else if (entry.isFile()) {
+            const targetPath = join(targetDir, entry.name);
+            removeTargetTypeConflict(targetPath, 'file');
+            copyFileSync(sourcePath, targetPath);
+        }
+    }
+};
+const writeGeneratedFile = (path, content) => {
+    removeTargetTypeConflict(path, 'file');
+    writeFileSync(path, content);
+};
+/**
+ * Overlays native harness configuration into the runtime root. Inputs arrive highest precedence
+ * first, so copying in reverse order lets higher layers replace matching files. Symlinked overlay
+ * roots and entries are skipped so a catalog cannot make projection read outside its layer.
+ */
+export const materializeConfigurationOverlays = (sourceDirectories, rootDirectory) => {
+    mkdirSync(rootDirectory, { recursive: true });
+    for (const sourceDirectory of [...sourceDirectories].reverse()) {
+        if (lstatSync(sourceDirectory).isSymbolicLink())
+            continue;
+        copyDirectory(sourceDirectory, rootDirectory);
+    }
+};
+const materializeSkill = (skill, rootDirectory) => {
+    const sourceDir = dirname(skill.winner.path);
+    // A skill whose directory resolves outside its layer cannot be materialized safely.
+    if (escapesRoots(sourceDir, [skill.winner.layer.root])) {
+        return undefined;
+    }
+    const targetDir = join(rootDirectory, 'skills', skill.slug);
+    copyDirectory(sourceDir, targetDir);
+    return targetDir;
+};
+/**
+ * Writes the composed identity and skills into `rootDirectory`. The base `system-prompt.md` becomes
+ * the system prompt; shared `agents.md` context and the agent body are appended in order. Each
+ * selected skill directory (SKILL.md + scripts/assets) is copied so the harness has real content.
+ */
+export const materializeComposition = (composition, rootDirectory) => {
+    mkdirSync(rootDirectory, { recursive: true });
+    const systemPromptPath = join(rootDirectory, 'system-prompt.md');
+    writeGeneratedFile(systemPromptPath, composition.identity.systemPrompt ?? '');
+    const appendPromptPaths = [];
+    if (composition.identity.sharedContext !== undefined) {
+        const contextPath = join(rootDirectory, 'agents.md');
+        writeGeneratedFile(contextPath, composition.identity.sharedContext);
+        appendPromptPaths.push(contextPath);
+    }
+    const agentBodyPath = join(rootDirectory, 'agent.md');
+    writeGeneratedFile(agentBodyPath, composition.identity.agentBody);
+    appendPromptPaths.push(agentBodyPath);
+    const skillDirectories = [];
+    const skippedSkills = [];
+    for (const skill of composition.loadout.skills) {
+        const materialized = materializeSkill(skill, rootDirectory);
+        if (materialized === undefined) {
+            skippedSkills.push(skill.slug);
+        }
+        else {
+            skillDirectories.push(materialized);
+        }
+    }
+    return { rootDirectory, systemPromptPath, appendPromptPaths, skillDirectories, skippedSkills };
+};
+//# sourceMappingURL=Materialize.js.map

package/dist/projection/Materialize.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Materialize.js","sourceRoot":"","sources":["../../src/projection/Materialize.ts"],"names":[],"mappings":"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"}

package/dist/projection/ProjectHarness.d.ts

@@ -0,0 +1,5 @@
+import type { CompositionPlan } from '../composer/Composition.js';
+import type { AgentProjectionPlan, ProjectionInput } from './Projection.js';
+export declare const unsupportedElements: (composition: CompositionPlan, input: ProjectionInput) => readonly string[];
+/** Materializes the composition into the runtime root and builds the harness launch plan. */
+export declare const projectComposition: (composition: CompositionPlan, input: ProjectionInput) => AgentProjectionPlan;

package/dist/projection/ProjectHarness.js

@@ -0,0 +1,77 @@
+import { materializeComposition, materializeConfigurationOverlays } from './Materialize.js';
+// Loadout elements a projection actually maps to native config. Anything else is reported
+// unsupported so `--strict` catches silently-dropped selections. Baseline for both harnesses is
+// identity + skills + model + thinking; pi additionally projects `extensions` once the run path has
+// resolved their install dirs (`extensionLoadDirs`). subagents/mcp/plugins/tools remain unsupported
+// pending incremental parity (#183).
+const supportedElements = (input) => {
+    const baseline = ['skills', 'model', 'thinking'];
+    return input.harness === 'pi' && input.extensionLoadDirs !== undefined ? [...baseline, 'extensions'] : baseline;
+};
+const loadoutElementsInUse = (composition) => {
+    const { loadout } = composition;
+    const present = [];
+    if (loadout.skills.length > 0)
+        present.push('skills');
+    if (loadout.subagents.length > 0)
+        present.push('subagents');
+    if (loadout.extensions.length > 0)
+        present.push('extensions');
+    if (loadout.plugins.length > 0)
+        present.push('plugins');
+    if (loadout.mcp.length > 0)
+        present.push('mcp');
+    if (loadout.model !== undefined)
+        present.push('model');
+    if (loadout.thinking !== undefined)
+        present.push('thinking');
+    if (loadout.tools !== undefined)
+        present.push('tools');
+    return present;
+};
+export const unsupportedElements = (composition, input) => loadoutElementsInUse(composition).filter((element) => !supportedElements(input).includes(element));
+const promptArgs = (systemPromptPath, appendPromptPaths) => [
+    '--system-prompt',
+    systemPromptPath,
+    ...appendPromptPaths.flatMap((path) => ['--append-system-prompt', path]),
+];
+const modelArgs = (composition, harness) => {
+    const args = [];
+    if (composition.loadout.model !== undefined) {
+        args.push('--model', composition.loadout.model);
+    }
+    if (composition.loadout.thinking !== undefined) {
+        args.push(harness === 'pi' ? '--thinking' : '--effort', composition.loadout.thinking);
+    }
+    return args;
+};
+const buildLaunchPlan = (composition, input, systemPromptPath, appendPromptPaths) => {
+    const isPi = input.harness === 'pi';
+    const skillArgs = isPi ? composition.loadout.skills.flatMap((skill) => ['--skill', skill.slug]) : [];
+    const extensionArgs = isPi ? (input.extensionLoadDirs ?? []).flatMap((dir) => ['--extension', dir]) : [];
+    return {
+        command: isPi ? 'pi' : 'claude',
+        args: [
+            ...promptArgs(systemPromptPath, appendPromptPaths),
+            ...skillArgs,
+            ...extensionArgs,
+            ...modelArgs(composition, input.harness),
+            ...(input.passThroughArgs ?? []),
+        ],
+        env: isPi ? { PI_CODING_AGENT_DIR: input.rootDirectory } : { CLAUDE_CONFIG_DIR: input.rootDirectory },
+    };
+};
+/** Materializes the composition into the runtime root and builds the harness launch plan. */
+export const projectComposition = (composition, input) => {
+    if (input.harness === 'pi') {
+        materializeConfigurationOverlays(input.configurationOverlayDirectories ?? [], input.rootDirectory);
+    }
+    const materialized = materializeComposition(composition, input.rootDirectory);
+    const launch = buildLaunchPlan(composition, input, materialized.systemPromptPath, materialized.appendPromptPaths);
+    const unsupported = [
+        ...unsupportedElements(composition, input),
+        ...materialized.skippedSkills.map((slug) => `skill:${slug} (escaping symlink)`),
+    ];
+    return { rootDirectory: input.rootDirectory, launch, unsupported };
+};
+//# sourceMappingURL=ProjectHarness.js.map

package/dist/projection/ProjectHarness.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProjectHarness.js","sourceRoot":"","sources":["../../src/projection/ProjectHarness.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,sBAAsB,EAAE,gCAAgC,EAAE,MAAM,kBAAkB,CAAC;AAG5F,0FAA0F;AAC1F,gGAAgG;AAChG,oGAAoG;AACpG,oGAAoG;AACpG,qCAAqC;AACrC,MAAM,iBAAiB,GAAG,CAAC,KAAsB,EAAqB,EAAE;IACtE,MAAM,QAAQ,GAAG,CAAC,QAAQ,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC;IACjD,OAAO,KAAK,CAAC,OAAO,KAAK,IAAI,IAAI,KAAK,CAAC,iBAAiB,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,GAAG,QAAQ,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;AAClH,CAAC,CAAC;AAEF,MAAM,oBAAoB,GAAG,CAAC,WAA4B,EAAqB,EAAE;IAC/E,MAAM,EAAE,OAAO,EAAE,GAAG,WAAW,CAAC;IAChC,MAAM,OAAO,GAAa,EAAE,CAAC;IAE7B,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACtD,IAAI,OAAO,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IAC5D,IAAI,OAAO,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IAC9D,IAAI,OAAO,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACxD,IAAI,OAAO,CAAC,GAAG,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAChD,IAAI,OAAO,CAAC,KAAK,KAAK,SAAS;QAAE,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACvD,IAAI,OAAO,CAAC,QAAQ,KAAK,SAAS;QAAE,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAC7D,IAAI,OAAO,CAAC,KAAK,KAAK,SAAS;QAAE,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAEvD,OAAO,OAAO,CAAC;AACjB,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,WAA4B,EAAE,KAAsB,EAAqB,EAAE,CAC7G,oBAAoB,CAAC,WAAW,CAAC,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,iBAAiB,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC;AAErG,MAAM,UAAU,GAAG,CAAC,gBAAwB,EAAE,iBAAoC,EAAqB,EAAE,CAAC;IACxG,iBAAiB;IACjB,gBAAgB;IAChB,GAAG,iBAAiB,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,wBAAwB,EAAE,IAAI,CAAC,CAAC;CACzE,CAAC;AAEF,MAAM,SAAS,GAAG,CAAC,WAA4B,EAAE,OAAgB,EAAqB,EAAE;IACtF,MAAM,IAAI,GAAa,EAAE,CAAC;IAE1B,IAAI,WAAW,CAAC,OAAO,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;QAC5C,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,WAAW,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IAClD,CAAC;IAED,IAAI,WAAW,CAAC,OAAO,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC/C,IAAI,CAAC,IAAI,CAAC,OAAO,KAAK,IAAI,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,UAAU,EAAE,WAAW,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACxF,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC,CAAC;AAEF,MAAM,eAAe,GAAG,CACtB,WAA4B,EAC5B,KAAsB,EACtB,gBAAwB,EACxB,iBAAoC,EACnB,EAAE;IACnB,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,KAAK,IAAI,CAAC;IACpC,MAAM,SAAS,GAAG,IAAI,CAAC,CAAC,CAAC,WAAW,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,SAAS,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACrG,MAAM,aAAa,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,iBAAiB,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,aAAa,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAEzG,OAAO;QACL,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ;QAC/B,IAAI,EAAE;YACJ,GAAG,UAAU,CAAC,gBAAgB,EAAE,iBAAiB,CAAC;YAClD,GAAG,SAAS;YACZ,GAAG,aAAa;YAChB,GAAG,SAAS,CAAC,WAAW,EAAE,KAAK,CAAC,OAAO,CAAC;YACxC,GAAG,CAAC,KAAK,CAAC,eAAe,IAAI,EAAE,CAAC;SACjC;QACD,GAAG,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,mBAAmB,EAAE,KAAK,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE,iBAAiB,EAAE,KAAK,CAAC,aAAa,EAAE;KACtG,CAAC;AACJ,CAAC,CAAC;AAEF,6FAA6F;AAC7F,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,WAA4B,EAAE,KAAsB,EAAuB,EAAE;IAC9G,IAAI,KAAK,CAAC,OAAO,KAAK,IAAI,EAAE,CAAC;QAC3B,gCAAgC,CAAC,KAAK,CAAC,+BAA+B,IAAI,EAAE,EAAE,KAAK,CAAC,aAAa,CAAC,CAAC;IACrG,CAAC;IACD,MAAM,YAAY,GAAG,sBAAsB,CAAC,WAAW,EAAE,KAAK,CAAC,aAAa,CAAC,CAAC;IAC9E,MAAM,MAAM,GAAG,eAAe,CAAC,WAAW,EAAE,KAAK,EAAE,YAAY,CAAC,gBAAgB,EAAE,YAAY,CAAC,iBAAiB,CAAC,CAAC;IAClH,MAAM,WAAW,GAAG;QAClB,GAAG,mBAAmB,CAAC,WAAW,EAAE,KAAK,CAAC;QAC1C,GAAG,YAAY,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,SAAS,IAAI,qBAAqB,CAAC;KAChF,CAAC;IAEF,OAAO,EAAE,aAAa,EAAE,KAAK,CAAC,aAAa,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC;AACrE,CAAC,CAAC"}

package/dist/projection/Projection.d.ts

@@ -0,0 +1,23 @@
+import type { Harness } from '../settings/Settings.js';
+export interface AgentLaunchPlan {
+    readonly command: string;
+    readonly args: readonly string[];
+    readonly env: Readonly<Record<string, string>>;
+}
+export interface AgentProjectionPlan {
+    /** Absolute path to the materialized runtime configuration root for this run. */
+    readonly rootDirectory: string;
+    readonly launch: AgentLaunchPlan;
+    /** Composition elements the selected harness cannot project. */
+    readonly unsupported: readonly string[];
+}
+export interface ProjectionInput {
+    readonly harness: Harness;
+    readonly rootDirectory: string;
+    readonly homeDirectory: string;
+    readonly passThroughArgs?: readonly string[];
+    /** Local pi extension install directories to load with `--extension` (pi only). */
+    readonly extensionLoadDirs?: readonly string[];
+    /** Harness-native configuration directories, highest precedence first, overlaid into the root. */
+    readonly configurationOverlayDirectories?: readonly string[];
+}

package/dist/projection/Projection.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=Projection.js.map

package/dist/projection/Projection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Projection.js","sourceRoot":"","sources":["../../src/projection/Projection.ts"],"names":[],"mappings":""}

package/dist/resolver/AgentDefinition.d.ts

@@ -0,0 +1,30 @@
+import type { Loadout } from './Resource.js';
+export interface AgentDefinition {
+    readonly name: string;
+    readonly description?: string;
+    /** Markdown body after the frontmatter — the agent's identity prose. */
+    readonly body: string;
+    readonly loadout: Loadout;
+}
+export interface AgentDefinitionIssue {
+    readonly path: string;
+    readonly message: string;
+}
+export declare const isAgentDefinitionIssue: <T extends object>(value: T | AgentDefinitionIssue) => value is AgentDefinitionIssue;
+/** Loadout fields a per-agent config.json may override; identity fields (`name`) are frontmatter-only. */
+export declare const loadoutKeys: readonly ["skills", "subagents", "mcp", "extensions", "plugins", "model", "thinking", "tools"];
+/** Restricts an arbitrary record to the loadout keys config.json is allowed to supply. */
+export declare const pickLoadoutKeys: (record: Readonly<Record<string, unknown>>) => Record<string, unknown>;
+interface FrontmatterSplit {
+    readonly frontmatter: string;
+    readonly body: string;
+}
+/** Splits leading `---` YAML frontmatter from the markdown body. */
+export declare const splitFrontmatter: (content: string) => FrontmatterSplit | undefined;
+/**
+ * Parses an agent definition. `configPaths` are highest-precedence first; each is a loadout-only
+ * override that JSON-merges by key across layers over the frontmatter loadout.
+ */
+export declare const parseAgentDefinition: (content: string, configPaths: readonly string[], agentPath: string) => AgentDefinition | AgentDefinitionIssue;
+export declare const readAgentDefinition: (agentPath: string, configPaths?: readonly string[]) => AgentDefinition | AgentDefinitionIssue;
+export {};

package/dist/resolver/AgentDefinition.js

@@ -0,0 +1,123 @@
+// Parses `agents/<id>/agent.md` frontmatter and merges per-layer config.json loadout overrides.
+import { readFileSync } from 'node:fs';
+import { validateSchema } from '../validation/SchemaValidator.js';
+import { parseYamlDocument } from '../validation/YamlDocument.js';
+import { emptyLoadout } from './Resource.js';
+export const isAgentDefinitionIssue = (value) => 'message' in value;
+/** Loadout fields a per-agent config.json may override; identity fields (`name`) are frontmatter-only. */
+export const loadoutKeys = [
+    'skills',
+    'subagents',
+    'mcp',
+    'extensions',
+    'plugins',
+    'model',
+    'thinking',
+    'tools',
+];
+/** Restricts an arbitrary record to the loadout keys config.json is allowed to supply. */
+export const pickLoadoutKeys = (record) => Object.fromEntries(loadoutKeys.filter((key) => key in record).map((key) => [key, record[key]]));
+/** Splits leading `---` YAML frontmatter from the markdown body. */
+export const splitFrontmatter = (content) => {
+    const lines = content.split('\n');
+    if (lines[0]?.trimEnd() !== '---') {
+        return undefined;
+    }
+    const closingIndex = lines.findIndex((line, index) => index > 0 && line.trimEnd() === '---');
+    if (closingIndex === -1) {
+        return undefined;
+    }
+    return {
+        frontmatter: lines.slice(1, closingIndex).join('\n'),
+        body: lines
+            .slice(closingIndex + 1)
+            .join('\n')
+            .replace(/^\n/, ''),
+    };
+};
+const asStringArray = (value) => Array.isArray(value) ? value.filter((entry) => typeof entry === 'string') : [];
+const asString = (value) => (typeof value === 'string' ? value : undefined);
+const loadoutFromRecord = (record) => {
+    const tools = record.tools;
+    return {
+        ...emptyLoadout(),
+        skills: asStringArray(record.skills),
+        subagents: asStringArray(record.subagents),
+        mcp: asStringArray(record.mcp),
+        extensions: asStringArray(record.extensions),
+        plugins: asStringArray(record.plugins),
+        model: asString(record.model),
+        thinking: asString(record.thinking),
+        tools: tools === undefined ? undefined : { allow: asStringArray(tools.allow), deny: asStringArray(tools.deny) },
+    };
+};
+/** Reads one config.json, restricting it to loadout keys; parse/read/non-object failures are issues. */
+const readConfigLoadout = (configPath) => {
+    let parsed;
+    try {
+        parsed = JSON.parse(readFileSync(configPath, 'utf8'));
+    }
+    catch (error) {
+        return { path: configPath, message: `config.json is not readable JSON: ${String(error)}` };
+    }
+    if (parsed === null || typeof parsed !== 'object' || Array.isArray(parsed)) {
+        return { path: configPath, message: 'config.json must be a JSON object of loadout overrides.' };
+    }
+    return pickLoadoutKeys(parsed);
+};
+const parseFrontmatterRecord = (content, agentPath) => {
+    const split = splitFrontmatter(content);
+    if (split === undefined) {
+        return { path: agentPath, message: 'agent.md must start with a `---` YAML frontmatter block.' };
+    }
+    const parsed = parseYamlDocument(split.frontmatter, agentPath);
+    if (!parsed.ok) {
+        return { path: agentPath, message: `agent.md frontmatter is not valid YAML: ${parsed.issue.message}` };
+    }
+    if (parsed.document === null || typeof parsed.document !== 'object' || Array.isArray(parsed.document)) {
+        return { path: agentPath, message: 'agent.md frontmatter must be a YAML mapping.' };
+    }
+    // Validate the frontmatter on its own so config.json cannot supply required identity fields.
+    const validation = validateSchema('agent', parsed.document);
+    if (!validation.valid) {
+        // An invalid document always yields at least one issue.
+        return { path: agentPath, message: `agent.md is invalid: ${validation.issues[0].message}` };
+    }
+    return { record: parsed.document, body: split.body };
+};
+/**
+ * Parses an agent definition. `configPaths` are highest-precedence first; each is a loadout-only
+ * override that JSON-merges by key across layers over the frontmatter loadout.
+ */
+export const parseAgentDefinition = (content, configPaths, agentPath) => {
+    const frontmatter = parseFrontmatterRecord(content, agentPath);
+    if (isAgentDefinitionIssue(frontmatter)) {
+        return frontmatter;
+    }
+    let merged = { ...frontmatter.record };
+    // Apply lowest precedence first so higher layers win per key.
+    for (const configPath of [...configPaths].reverse()) {
+        const config = readConfigLoadout(configPath);
+        if (isAgentDefinitionIssue(config)) {
+            return config;
+        }
+        merged = { ...merged, ...config };
+    }
+    return {
+        name: frontmatter.record.name,
+        description: asString(frontmatter.record.description),
+        body: frontmatter.body,
+        loadout: loadoutFromRecord(merged),
+    };
+};
+export const readAgentDefinition = (agentPath, configPaths = []) => {
+    let content;
+    try {
+        content = readFileSync(agentPath, 'utf8');
+    }
+    catch (error) {
+        return { path: agentPath, message: `Could not read agent.md: ${String(error)}` };
+    }
+    return parseAgentDefinition(content, configPaths, agentPath);
+};
+//# sourceMappingURL=AgentDefinition.js.map

package/dist/resolver/AgentDefinition.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AgentDefinition.js","sourceRoot":"","sources":["../../src/resolver/AgentDefinition.ts"],"names":[],"mappings":"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"}

package/dist/resolver/Layer.d.ts

@@ -0,0 +1,12 @@
+import type { Settings } from '../settings/Settings.js';
+import type { Layer } from './Resource.js';
+export interface LayerDiscoveryInput {
+    readonly homeDirectory: string;
+    readonly projectDirectory: string;
+    readonly settings: Settings;
+}
+/**
+ * Orders layers highest precedence first: workspace `.agents`, then global `~/.agents`,
+ * then configured sources in order. Only layers whose root exists on disk are included.
+ */
+export declare const discoverLayers: (input: LayerDiscoveryInput) => readonly Layer[];

package/dist/resolver/Layer.js

@@ -0,0 +1,30 @@
+// Builds the ordered `.agents` layer stack (workspace over global over remote sources) from settings.
+import { existsSync } from 'node:fs';
+import { join } from 'node:path';
+import { encodeRemoteSource, resolveRemoteRepositorySubpath } from '../sources/SourceCache.js';
+const agentsRoot = (directory) => join(directory, '.agents');
+// Remote sources cache under the configured cache_directory, defaulting to ~/.agents/cache.
+const cacheRoot = (input) => input.settings.cacheDirectory ?? join(input.homeDirectory, '.agents', 'cache');
+const sourceLayer = (input, source) => {
+    if (source.path !== undefined && source.uri === undefined && source.github === undefined) {
+        return { root: source.path, origin: 'source', label: source.path };
+    }
+    const remote = source;
+    const repositoryPath = join(cacheRoot(input), 'repos', encodeRemoteSource(remote));
+    const root = source.path === undefined ? repositoryPath : resolveRemoteRepositorySubpath(repositoryPath, source.path);
+    const label = remote.uri ?? `github:${remote.github}`;
+    return { root, origin: 'source', label };
+};
+/**
+ * Orders layers highest precedence first: workspace `.agents`, then global `~/.agents`,
+ * then configured sources in order. Only layers whose root exists on disk are included.
+ */
+export const discoverLayers = (input) => {
+    const candidates = [
+        { root: agentsRoot(input.projectDirectory), origin: 'workspace', label: 'workspace' },
+        { root: agentsRoot(input.homeDirectory), origin: 'global', label: 'global' },
+        ...(input.settings.sources ?? []).map((source) => sourceLayer(input, source)),
+    ];
+    return candidates.filter((layer) => existsSync(layer.root));
+};
+//# sourceMappingURL=Layer.js.map

package/dist/resolver/Layer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Layer.js","sourceRoot":"","sources":["../../src/resolver/Layer.ts"],"names":[],"mappings":"AAAA,sGAAsG;AACtG,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,kBAAkB,EAAE,8BAA8B,EAAE,MAAM,2BAA2B,CAAC;AAU/F,MAAM,UAAU,GAAG,CAAC,SAAiB,EAAU,EAAE,CAAC,IAAI,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;AAE7E,4FAA4F;AAC5F,MAAM,SAAS,GAAG,CAAC,KAA0B,EAAU,EAAE,CACvD,KAAK,CAAC,QAAQ,CAAC,cAAc,IAAI,IAAI,CAAC,KAAK,CAAC,aAAa,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;AAEjF,MAAM,WAAW,GAAG,CAAC,KAA0B,EAAE,MAAuB,EAAS,EAAE;IACjF,IAAI,MAAM,CAAC,IAAI,KAAK,SAAS,IAAI,MAAM,CAAC,GAAG,KAAK,SAAS,IAAI,MAAM,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QACzF,OAAO,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC;IACrE,CAAC;IAED,MAAM,MAAM,GAAG,MAAoF,CAAC;IACpG,MAAM,cAAc,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,OAAO,EAAE,kBAAkB,CAAC,MAAe,CAAC,CAAC,CAAC;IAC5F,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,8BAA8B,CAAC,cAAc,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;IACtH,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,IAAI,UAAU,MAAM,CAAC,MAAM,EAAE,CAAC;IAEtD,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;AAC3C,CAAC,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,KAA0B,EAAoB,EAAE;IAC7E,MAAM,UAAU,GAAY;QAC1B,EAAE,IAAI,EAAE,UAAU,CAAC,KAAK,CAAC,gBAAgB,CAAC,EAAE,MAAM,EAAE,WAAW,EAAE,KAAK,EAAE,WAAW,EAAE;QACrF,EAAE,IAAI,EAAE,UAAU,CAAC,KAAK,CAAC,aAAa,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE;QAC5E,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,WAAW,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;KAC9E,CAAC;IAEF,OAAO,UAAU,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;AAC9D,CAAC,CAAC"}

package/dist/resolver/Resolver.d.ts

@@ -0,0 +1,3 @@
+import type { EffectiveResourceSet, Layer } from './Resource.js';
+/** Produces the single effective resource set consumed by list, validate, run, and dump. */
+export declare const resolveResources: (layers: readonly Layer[]) => EffectiveResourceSet;

package/dist/resolver/Resolver.js

@@ -0,0 +1,163 @@
+// Resolves protocol resources from layered `.agents` trees into one immutable effective resource set.
+import { existsSync, readdirSync, statSync } from 'node:fs';
+import { join, posix, relative, sep } from 'node:path';
+import { agentLocalKinds, compareSlugs, resourceKinds } from './Resource.js';
+/** True when the path resolves (following symlinks) to a directory; false for broken links. */
+const resolvesToDirectory = (path) => {
+    try {
+        return statSync(path).isDirectory();
+    }
+    catch {
+        return false;
+    }
+};
+/** True when the path resolves (following symlinks) to a file; false for broken links. */
+const resolvesToFile = (path) => {
+    try {
+        return statSync(path).isFile();
+    }
+    catch {
+        return false;
+    }
+};
+const directoryResourceKinds = new Map([
+    ['agent', 'agents'],
+    ['skill', 'skills'],
+]);
+const entryFileByKind = new Map([
+    ['agent', 'agent.md'],
+    ['skill', 'SKILL.md'],
+]);
+const fileTreeResourceKinds = new Map([
+    ['knowledge', 'knowledge'],
+    ['command', 'commands'],
+]);
+// Symlinked directories are followed (matching the skill catalog), so a resource can be a link.
+const listSubdirectories = (directory) => {
+    if (!existsSync(directory)) {
+        return [];
+    }
+    return readdirSync(directory, { withFileTypes: true })
+        .filter((entry) => resolvesToDirectory(join(directory, entry.name)))
+        .map((entry) => entry.name);
+};
+const listFilesRecursively = (root) => {
+    if (!existsSync(root)) {
+        return [];
+    }
+    const files = [];
+    for (const entry of readdirSync(root, { withFileTypes: true })) {
+        const entryPath = join(root, entry.name);
+        if (resolvesToDirectory(entryPath)) {
+            files.push(...listFilesRecursively(entryPath));
+        }
+        else if (resolvesToFile(entryPath)) {
+            files.push(entryPath);
+        }
+    }
+    return files;
+};
+const toSlug = (root, entryPath) => relative(root, entryPath).split(sep).join(posix.sep);
+// `base` is the directory the kind's container sits under: a layer root for catalog-wide resources,
+// or `<layer.root>/agents/<owner>` for agent-local ones. Attribution (`layer`) is separate from it.
+const discoverDirectoryResources = (layer, kind, base = layer.root) => {
+    const container = join(base, directoryResourceKinds.get(kind));
+    const entryFile = entryFileByKind.get(kind);
+    return listSubdirectories(container)
+        .filter((slug) => resolvesToFile(join(container, slug, entryFile)))
+        .map((slug) => ({ kind, slug, layer, path: join(container, slug, entryFile) }));
+};
+// Existing `agents/<slug>/<...>` files across every layer that defines the agent, highest first.
+const collectAgentFiles = (layers, slug, ...segments) => layers.map((layer) => join(layer.root, 'agents', slug, ...segments)).filter((path) => resolvesToFile(path));
+const isNonEmptyDirectory = (directory) => {
+    try {
+        return statSync(directory).isDirectory() && readdirSync(directory).length > 0;
+    }
+    catch {
+        return false;
+    }
+};
+// Non-empty `agents/<slug>/hooks/` directories across layers (reserved namespace; surfaced, not resolved).
+const collectAgentHookDirs = (layers, slug) => layers.map((layer) => join(layer.root, 'agents', slug, 'hooks')).filter(isNonEmptyDirectory);
+// Existing harness-native Pi configuration directories across layers, highest precedence first.
+// Empty directories are retained because they are still valid overlays and deterministic inputs.
+const collectAgentPiConfigDirs = (layers, slug) => layers.map((layer) => join(layer.root, 'agents', slug, 'pi')).filter(resolvesToDirectory);
+const withAgentResourcePaths = (layers, agents) => new Map([...agents.entries()].map(([slug, resource]) => [
+    slug,
+    {
+        ...resource,
+        configPaths: collectAgentFiles(layers, slug, 'config.json'),
+        mcpPaths: collectAgentFiles(layers, slug, 'mcp.json'),
+        hookPaths: collectAgentHookDirs(layers, slug),
+        piConfigDirectories: collectAgentPiConfigDirs(layers, slug),
+    },
+]));
+const discoverFileResources = (layer, kind, base = layer.root) => {
+    const container = join(base, fileTreeResourceKinds.get(kind));
+    return listFilesRecursively(container).map((path) => ({ kind, slug: toSlug(container, path), layer, path }));
+};
+const discoverLayerResources = (layer, kind, base = layer.root) => directoryResourceKinds.has(kind)
+    ? discoverDirectoryResources(layer, kind, base)
+    : discoverFileResources(layer, kind, base);
+// Agent-local discovery of kind K = catalog discovery of K, re-rooted under `agents/<owner>/` and
+// attributed to the real layer. One generic path serves skills, knowledge, and commands.
+const discoverAgentResources = (layer) => {
+    const agentsDirectory = join(layer.root, 'agents');
+    return listSubdirectories(agentsDirectory).flatMap((ownerAgent) => {
+        const agentBase = join(agentsDirectory, ownerAgent);
+        return agentLocalKinds.flatMap((kind) => discoverLayerResources(layer, kind, agentBase).map((definition) => ({ ...definition, ownerAgent })));
+    });
+};
+const resolveDefinitions = (definitions) => {
+    const bySlug = new Map();
+    for (const definition of definitions) {
+        const existing = bySlug.get(definition.slug);
+        if (existing === undefined) {
+            bySlug.set(definition.slug, { winner: definition, shadowed: [] });
+        }
+        else {
+            existing.shadowed.push(definition);
+        }
+    }
+    return new Map([...bySlug.entries()].map(([slug, entry]) => [
+        slug,
+        { kind: entry.winner.kind, slug, winner: entry.winner, shadowed: entry.shadowed },
+    ]));
+};
+const resolveKind = (layers, kind) => {
+    // Layers are ordered highest precedence first, so the first definition of a slug wins.
+    return resolveDefinitions(layers.flatMap((layer) => discoverLayerResources(layer, kind)));
+};
+// Groups one agent's local definitions by kind, then resolves each kind's slug precedence.
+const resolveAgentKinds = (definitions) => {
+    const byKind = new Map();
+    for (const definition of definitions) {
+        const kindDefinitions = byKind.get(definition.kind) ?? [];
+        kindDefinitions.push(definition);
+        byKind.set(definition.kind, kindDefinitions);
+    }
+    return new Map([...byKind.entries()].map(([kind, kindDefinitions]) => [kind, resolveDefinitions(kindDefinitions)]));
+};
+const resolveAgentResources = (layers) => {
+    const definitionsByAgent = new Map();
+    for (const layer of layers) {
+        for (const definition of discoverAgentResources(layer)) {
+            const definitions = definitionsByAgent.get(definition.ownerAgent) ?? [];
+            definitions.push(definition);
+            definitionsByAgent.set(definition.ownerAgent, definitions);
+        }
+    }
+    return new Map([...definitionsByAgent.entries()]
+        .sort(([left], [right]) => compareSlugs(left, right))
+        .map(([agentSlug, definitions]) => [agentSlug, resolveAgentKinds(definitions)]));
+};
+/** Produces the single effective resource set consumed by list, validate, run, and dump. */
+export const resolveResources = (layers) => {
+    const resources = new Map();
+    for (const kind of resourceKinds) {
+        const resolved = resolveKind(layers, kind);
+        resources.set(kind, kind === 'agent' ? withAgentResourcePaths(layers, resolved) : resolved);
+    }
+    return { layers, resources, agentResources: resolveAgentResources(layers) };
+};
+//# sourceMappingURL=Resolver.js.map

package/dist/resolver/Resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Resolver.js","sourceRoot":"","sources":["../../src/resolver/Resolver.ts"],"names":[],"mappings":"AAAA,sGAAsG;AACtG,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAC5D,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AAGvD,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAE7E,+FAA+F;AAC/F,MAAM,mBAAmB,GAAG,CAAC,IAAY,EAAW,EAAE;IACpD,IAAI,CAAC;QACH,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC;IACtC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC,CAAC;AAEF,0FAA0F;AAC1F,MAAM,cAAc,GAAG,CAAC,IAAY,EAAW,EAAE;IAC/C,IAAI,CAAC;QACH,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,CAAC;IACjC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC,CAAC;AAEF,MAAM,sBAAsB,GAAsC,IAAI,GAAG,CAAC;IACxE,CAAC,OAAO,EAAE,QAAQ,CAAC;IACnB,CAAC,OAAO,EAAE,QAAQ,CAAC;CACpB,CAAC,CAAC;AAEH,MAAM,eAAe,GAAsC,IAAI,GAAG,CAAC;IACjE,CAAC,OAAO,EAAE,UAAU,CAAC;IACrB,CAAC,OAAO,EAAE,UAAU,CAAC;CACtB,CAAC,CAAC;AAEH,MAAM,qBAAqB,GAAsC,IAAI,GAAG,CAAC;IACvE,CAAC,WAAW,EAAE,WAAW,CAAC;IAC1B,CAAC,SAAS,EAAE,UAAU,CAAC;CACxB,CAAC,CAAC;AAEH,gGAAgG;AAChG,MAAM,kBAAkB,GAAG,CAAC,SAAiB,EAAqB,EAAE;IAClE,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;QAC3B,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,OAAO,WAAW,CAAC,SAAS,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC;SACnD,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,mBAAmB,CAAC,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;SACnE,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;AAChC,CAAC,CAAC;AAEF,MAAM,oBAAoB,GAAG,CAAC,IAAY,EAAqB,EAAE;IAC/D,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QACtB,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,KAAK,MAAM,KAAK,IAAI,WAAW,CAAC,IAAI,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;QAC/D,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QAEzC,IAAI,mBAAmB,CAAC,SAAS,CAAC,EAAE,CAAC;YACnC,KAAK,CAAC,IAAI,CAAC,GAAG,oBAAoB,CAAC,SAAS,CAAC,CAAC,CAAC;QACjD,CAAC;aAAM,IAAI,cAAc,CAAC,SAAS,CAAC,EAAE,CAAC;YACrC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACxB,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC,CAAC;AAEF,MAAM,MAAM,GAAG,CAAC,IAAY,EAAE,SAAiB,EAAU,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;AAEjH,oGAAoG;AACpG,oGAAoG;AACpG,MAAM,0BAA0B,GAAG,CACjC,KAAY,EACZ,IAAkB,EAClB,OAAe,KAAK,CAAC,IAAI,EACM,EAAE;IACjC,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,EAAE,sBAAsB,CAAC,GAAG,CAAC,IAAI,CAAE,CAAC,CAAC;IAChE,MAAM,SAAS,GAAG,eAAe,CAAC,GAAG,CAAC,IAAI,CAAE,CAAC;IAE7C,OAAO,kBAAkB,CAAC,SAAS,CAAC;SACjC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,cAAc,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC;SAClE,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,SAAS,CAAC,EAAE,CAAC,CAAC,CAAC;AACpF,CAAC,CAAC;AAEF,iGAAiG;AACjG,MAAM,iBAAiB,GAAG,CAAC,MAAwB,EAAE,IAAY,EAAE,GAAG,QAAkB,EAAqB,EAAE,CAC7G,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,GAAG,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC;AAE9G,MAAM,mBAAmB,GAAG,CAAC,SAAiB,EAAW,EAAE;IACzD,IAAI,CAAC;QACH,OAAO,QAAQ,CAAC,SAAS,CAAC,CAAC,WAAW,EAAE,IAAI,WAAW,CAAC,SAAS,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;IAChF,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC,CAAC;AAEF,2GAA2G;AAC3G,MAAM,oBAAoB,GAAG,CAAC,MAAwB,EAAE,IAAY,EAAqB,EAAE,CACzF,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,mBAAmB,CAAC,CAAC;AAE/F,gGAAgG;AAChG,iGAAiG;AACjG,MAAM,wBAAwB,GAAG,CAAC,MAAwB,EAAE,IAAY,EAAqB,EAAE,CAC7F,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,mBAAmB,CAAC,CAAC;AAE5F,MAAM,sBAAsB,GAAG,CAC7B,MAAwB,EACxB,MAA6C,EACN,EAAE,CACzC,IAAI,GAAG,CACL,CAAC,GAAG,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,QAAQ,CAAC,EAAE,EAAE,CAAC;IAC9C,IAAI;IACJ;QACE,GAAG,QAAQ;QACX,WAAW,EAAE,iBAAiB,CAAC,MAAM,EAAE,IAAI,EAAE,aAAa,CAAC;QAC3D,QAAQ,EAAE,iBAAiB,CAAC,MAAM,EAAE,IAAI,EAAE,UAAU,CAAC;QACrD,SAAS,EAAE,oBAAoB,CAAC,MAAM,EAAE,IAAI,CAAC;QAC7C,mBAAmB,EAAE,wBAAwB,CAAC,MAAM,EAAE,IAAI,CAAC;KAC5D;CACF,CAAC,CACH,CAAC;AAEJ,MAAM,qBAAqB,GAAG,CAC5B,KAAY,EACZ,IAAkB,EAClB,OAAe,KAAK,CAAC,IAAI,EACM,EAAE;IACjC,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,EAAE,qBAAqB,CAAC,GAAG,CAAC,IAAI,CAAE,CAAC,CAAC;IAE/D,OAAO,oBAAoB,CAAC,SAAS,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,SAAS,EAAE,IAAI,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;AAC/G,CAAC,CAAC;AAEF,MAAM,sBAAsB,GAAG,CAC7B,KAAY,EACZ,IAAkB,EAClB,OAAe,KAAK,CAAC,IAAI,EACM,EAAE,CACjC,sBAAsB,CAAC,GAAG,CAAC,IAAI,CAAC;IAC9B,CAAC,CAAC,0BAA0B,CAAC,KAAK,EAAE,IAAI,EAAE,IAAI,CAAC;IAC/C,CAAC,CAAC,qBAAqB,CAAC,KAAK,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;AAI/C,kGAAkG;AAClG,yFAAyF;AACzF,MAAM,sBAAsB,GAAG,CAAC,KAAY,EAAsC,EAAE;IAClF,MAAM,eAAe,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IAEnD,OAAO,kBAAkB,CAAC,eAAe,CAAC,CAAC,OAAO,CAAC,CAAC,UAAU,EAAE,EAAE;QAChE,MAAM,SAAS,GAAG,IAAI,CAAC,eAAe,EAAE,UAAU,CAAC,CAAC;QAEpD,OAAO,eAAe,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,CACtC,sBAAsB,CAAC,KAAK,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC,GAAG,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,UAAU,EAAE,UAAU,EAAE,CAAC,CAAC,CACpG,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC,CAAC;AAEF,MAAM,kBAAkB,GAAG,CAAC,WAA0C,EAAyC,EAAE;IAC/G,MAAM,MAAM,GAAG,IAAI,GAAG,EAA0E,CAAC;IAEjG,KAAK,MAAM,UAAU,IAAI,WAAW,EAAE,CAAC;QACrC,MAAM,QAAQ,GAAG,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;QAE7C,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;YAC3B,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC,CAAC;QACpE,CAAC;aAAM,CAAC;YACN,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACrC,CAAC;IACH,CAAC;IAED,OAAO,IAAI,GAAG,CACZ,CAAC,GAAG,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC;QAC3C,IAAI;QACJ,EAAE,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE;KAClF,CAAC,CACH,CAAC;AACJ,CAAC,CAAC;AAEF,MAAM,WAAW,GAAG,CAAC,MAAwB,EAAE,IAAkB,EAAyC,EAAE;IAC1G,uFAAuF;IACvF,OAAO,kBAAkB,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,sBAAsB,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;AAC5F,CAAC,CAAC;AAEF,2FAA2F;AAC3F,MAAM,iBAAiB,GAAG,CACxB,WAA+C,EACmB,EAAE;IACpE,MAAM,MAAM,GAAG,IAAI,GAAG,EAAsC,CAAC;IAE7D,KAAK,MAAM,UAAU,IAAI,WAAW,EAAE,CAAC;QACrC,MAAM,eAAe,GAAG,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;QAC1D,eAAe,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACjC,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,EAAE,eAAe,CAAC,CAAC;IAC/C,CAAC;IAED,OAAO,IAAI,GAAG,CAAC,CAAC,GAAG,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,eAAe,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,kBAAkB,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC;AACtH,CAAC,CAAC;AAEF,MAAM,qBAAqB,GAAG,CAC5B,MAAwB,EAC+D,EAAE;IACzF,MAAM,kBAAkB,GAAG,IAAI,GAAG,EAAqC,CAAC;IAExE,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,KAAK,MAAM,UAAU,IAAI,sBAAsB,CAAC,KAAK,CAAC,EAAE,CAAC;YACvD,MAAM,WAAW,GAAG,kBAAkB,CAAC,GAAG,CAAC,UAAU,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC;YACxE,WAAW,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YAC7B,kBAAkB,CAAC,GAAG,CAAC,UAAU,CAAC,UAAU,EAAE,WAAW,CAAC,CAAC;QAC7D,CAAC;IACH,CAAC;IAED,OAAO,IAAI,GAAG,CACZ,CAAC,GAAG,kBAAkB,CAAC,OAAO,EAAE,CAAC;SAC9B,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC,YAAY,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;SACpD,GAAG,CAAC,CAAC,CAAC,SAAS,EAAE,WAAW,CAAC,EAAE,EAAE,CAAC,CAAC,SAAS,EAAE,iBAAiB,CAAC,WAAW,CAAC,CAAC,CAAC,CAClF,CAAC;AACJ,CAAC,CAAC;AAEF,4FAA4F;AAC5F,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,MAAwB,EAAwB,EAAE;IACjF,MAAM,SAAS,GAAG,IAAI,GAAG,EAAuD,CAAC;IAEjF,KAAK,MAAM,IAAI,IAAI,aAAa,EAAE,CAAC;QACjC,MAAM,QAAQ,GAAG,WAAW,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;QAC3C,SAAS,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,sBAAsB,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;IAC9F,CAAC;IAED,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,cAAc,EAAE,qBAAqB,CAAC,MAAM,CAAC,EAAE,CAAC;AAC9E,CAAC,CAAC"}

package/dist/resolver/ResolverContext.d.ts

@@ -0,0 +1,15 @@
+import type { SettingsLoadIssue } from '../settings/SettingsLoader.js';
+import type { Settings } from '../settings/Settings.js';
+import type { EffectiveResourceSet } from './Resource.js';
+export interface ResolveInput {
+    readonly homeDirectory: string;
+    readonly projectDirectory: string;
+}
+export interface ResolveResult {
+    readonly set: EffectiveResourceSet;
+    /** The merged settings loaded during resolution, so callers need not reload them. */
+    readonly settings: Settings;
+    readonly settingsIssues: readonly SettingsLoadIssue[];
+}
+/** The single shared resolution path used by list, validate, run, and dump. */
+export declare const resolveEffectiveSet: (input: ResolveInput) => ResolveResult;