@ai-outfitter/outfitter 0.11.0 → 1.0.2

package/dist/settings/SettingsMerger.js

@@ -3,40 +3,42 @@
 import { mergeObjectsWithPolicy } from '../merge/SettingsValueMerger.js';
 import { emptySettings } from './Settings.js';
 export const mergeSettingsStack = (settingsStack) => {
-    let defaultProfile;
     let defaultAgent;
-    let profileSources;
+    let defaultHarness;
+    let sources;
     let remoteSettings;
     let cacheDirectory;
+    let statePersistence;
     let customSettings;
-    let profileExport;
     let startup;
     let enterprise;
     for (const settings of settingsStack) {
-        defaultProfile = settings.defaultProfile ?? defaultProfile;
         defaultAgent = settings.defaultAgent ?? defaultAgent;
-        profileSources = settings.profileSources ?? profileSources;
+        defaultHarness = settings.defaultHarness ?? defaultHarness;
+        sources = settings.sources ?? sources;
         remoteSettings = settings.remoteSettings ?? remoteSettings;
         cacheDirectory = settings.cacheDirectory ?? cacheDirectory;
+        statePersistence =
+            settings.statePersistence === undefined
+                ? statePersistence
+                : { ...statePersistence, ...settings.statePersistence };
         customSettings = mergeOptionalCustomSettings(customSettings, settings.customSettings);
-        profileExport = mergeOptionalBoolean(profileExport, settings.profileExport);
         startup = settings.startup === undefined ? startup : { ...startup, ...settings.startup };
         enterprise = settings.enterprise === undefined ? enterprise : { ...enterprise, ...settings.enterprise };
     }
     return {
         ...emptySettings(),
-        defaultProfile,
         defaultAgent,
-        profileSources: profileSources ?? [],
+        defaultHarness,
+        sources: sources ?? [],
         remoteSettings: remoteSettings ?? [],
         cacheDirectory,
+        statePersistence: statePersistence ?? {},
         customSettings: customSettings ?? {},
-        profileExport,
         startup: startup ?? {},
         enterprise: enterprise ?? {},
     };
 };
-const mergeOptionalBoolean = (lowerPrecedence, higherPrecedence) => higherPrecedence ?? lowerPrecedence;
 const mergeOptionalCustomSettings = (lowerPrecedence, higherPrecedence) => higherPrecedence === undefined ? lowerPrecedence : mergeCustomSettings(lowerPrecedence, higherPrecedence);
 const mergeCustomSettings = (lowerPrecedence, higherPrecedence) => mergeObjectsWithPolicy(lowerPrecedence, higherPrecedence);
 //# sourceMappingURL=SettingsMerger.js.map

package/dist/settings/SettingsMerger.js.map

@@ -1 +1 @@
-{"version":3,"file":"SettingsMerger.js","sourceRoot":"","sources":["../../src/settings/SettingsMerger.ts"],"names":[],"mappings":"AAAA,+BAA+B;AAC/B,qDAAqD;AACrD,OAAO,EAAE,sBAAsB,EAAE,MAAM,iCAAiC,CAAC;AAEzE,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAE9C,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,aAAkC,EAAY,EAAE;IACjF,IAAI,cAAkC,CAAC;IACvC,IAAI,YAAgC,CAAC;IACrC,IAAI,cAA0C,CAAC;IAC/C,IAAI,cAA0C,CAAC;IAC/C,IAAI,cAAkC,CAAC;IACvC,IAAI,cAA0C,CAAC;IAC/C,IAAI,aAAkC,CAAC;IACvC,IAAI,OAA4B,CAAC;IACjC,IAAI,UAAkC,CAAC;IAEvC,KAAK,MAAM,QAAQ,IAAI,aAAa,EAAE,CAAC;QACrC,cAAc,GAAG,QAAQ,CAAC,cAAc,IAAI,cAAc,CAAC;QAC3D,YAAY,GAAG,QAAQ,CAAC,YAAY,IAAI,YAAY,CAAC;QAErD,cAAc,GAAG,QAAQ,CAAC,cAAc,IAAI,cAAc,CAAC;QAC3D,cAAc,GAAG,QAAQ,CAAC,cAAc,IAAI,cAAc,CAAC;QAC3D,cAAc,GAAG,QAAQ,CAAC,cAAc,IAAI,cAAc,CAAC;QAC3D,cAAc,GAAG,2BAA2B,CAAC,cAAc,EAAE,QAAQ,CAAC,cAAc,CAAC,CAAC;QACtF,aAAa,GAAG,oBAAoB,CAAC,aAAa,EAAE,QAAQ,CAAC,aAAa,CAAC,CAAC;QAC5E,OAAO,GAAG,QAAQ,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,GAAG,OAAO,EAAE,GAAG,QAAQ,CAAC,OAAO,EAAE,CAAC;QACzF,UAAU,GAAG,QAAQ,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,GAAG,UAAU,EAAE,GAAG,QAAQ,CAAC,UAAU,EAAE,CAAC;IAC1G,CAAC;IAED,OAAO;QACL,GAAG,aAAa,EAAE;QAClB,cAAc;QACd,YAAY;QACZ,cAAc,EAAE,cAAc,IAAI,EAAE;QACpC,cAAc,EAAE,cAAc,IAAI,EAAE;QACpC,cAAc;QACd,cAAc,EAAE,cAAc,IAAI,EAAE;QACpC,aAAa;QACb,OAAO,EAAE,OAAO,IAAI,EAAE;QACtB,UAAU,EAAE,UAAU,IAAI,EAAE;KAC7B,CAAC;AACJ,CAAC,CAAC;AAEF,MAAM,oBAAoB,GAAG,CAC3B,eAAoC,EACpC,gBAAqC,EAChB,EAAE,CAAC,gBAAgB,IAAI,eAAe,CAAC;AAE9D,MAAM,2BAA2B,GAAG,CAClC,eAA2C,EAC3C,gBAA4C,EAChB,EAAE,CAC9B,gBAAgB,KAAK,SAAS,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,mBAAmB,CAAC,eAAe,EAAE,gBAAgB,CAAC,CAAC;AAE5G,MAAM,mBAAmB,GAAG,CAC1B,eAA2C,EAC3C,gBAAgC,EAChB,EAAE,CAAC,sBAAsB,CAAC,eAAe,EAAE,gBAAgB,CAAC,CAAC"}
+{"version":3,"file":"SettingsMerger.js","sourceRoot":"","sources":["../../src/settings/SettingsMerger.ts"],"names":[],"mappings":"AAAA,+BAA+B;AAC/B,qDAAqD;AACrD,OAAO,EAAE,sBAAsB,EAAE,MAAM,iCAAiC,CAAC;AAEzE,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAE9C,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,aAAkC,EAAY,EAAE;IACjF,IAAI,YAAgC,CAAC;IACrC,IAAI,cAA0C,CAAC;IAC/C,IAAI,OAA4B,CAAC;IACjC,IAAI,cAA0C,CAAC;IAC/C,IAAI,cAAkC,CAAC;IACvC,IAAI,gBAA8C,CAAC;IACnD,IAAI,cAA0C,CAAC;IAC/C,IAAI,OAA4B,CAAC;IACjC,IAAI,UAAkC,CAAC;IAEvC,KAAK,MAAM,QAAQ,IAAI,aAAa,EAAE,CAAC;QACrC,YAAY,GAAG,QAAQ,CAAC,YAAY,IAAI,YAAY,CAAC;QACrD,cAAc,GAAG,QAAQ,CAAC,cAAc,IAAI,cAAc,CAAC;QAE3D,OAAO,GAAG,QAAQ,CAAC,OAAO,IAAI,OAAO,CAAC;QACtC,cAAc,GAAG,QAAQ,CAAC,cAAc,IAAI,cAAc,CAAC;QAC3D,cAAc,GAAG,QAAQ,CAAC,cAAc,IAAI,cAAc,CAAC;QAC3D,gBAAgB;YACd,QAAQ,CAAC,gBAAgB,KAAK,SAAS;gBACrC,CAAC,CAAC,gBAAgB;gBAClB,CAAC,CAAC,EAAE,GAAG,gBAAgB,EAAE,GAAG,QAAQ,CAAC,gBAAgB,EAAE,CAAC;QAC5D,cAAc,GAAG,2BAA2B,CAAC,cAAc,EAAE,QAAQ,CAAC,cAAc,CAAC,CAAC;QACtF,OAAO,GAAG,QAAQ,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,GAAG,OAAO,EAAE,GAAG,QAAQ,CAAC,OAAO,EAAE,CAAC;QACzF,UAAU,GAAG,QAAQ,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,GAAG,UAAU,EAAE,GAAG,QAAQ,CAAC,UAAU,EAAE,CAAC;IAC1G,CAAC;IAED,OAAO;QACL,GAAG,aAAa,EAAE;QAClB,YAAY;QACZ,cAAc;QACd,OAAO,EAAE,OAAO,IAAI,EAAE;QACtB,cAAc,EAAE,cAAc,IAAI,EAAE;QACpC,cAAc;QACd,gBAAgB,EAAE,gBAAgB,IAAI,EAAE;QACxC,cAAc,EAAE,cAAc,IAAI,EAAE;QACpC,OAAO,EAAE,OAAO,IAAI,EAAE;QACtB,UAAU,EAAE,UAAU,IAAI,EAAE;KAC7B,CAAC;AACJ,CAAC,CAAC;AAEF,MAAM,2BAA2B,GAAG,CAClC,eAA2C,EAC3C,gBAA4C,EAChB,EAAE,CAC9B,gBAAgB,KAAK,SAAS,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,mBAAmB,CAAC,eAAe,EAAE,gBAAgB,CAAC,CAAC;AAE5G,MAAM,mBAAmB,GAAG,CAC1B,eAA2C,EAC3C,gBAAgC,EAChB,EAAE,CAAC,sBAAsB,CAAC,eAAe,EAAE,gBAAgB,CAAC,CAAC"}

package/dist/setup/DefaultCatalog.d.ts

@@ -0,0 +1,20 @@
+import type { RemoteSourceReference } from '../sources/SourceCache.js';
+export declare const defaultCatalogSource: {
+    readonly github: "ai-outfitter/default-profiles";
+    readonly ref: "v1.0.0";
+};
+export interface PinnedCatalogBootstrapInput {
+    readonly homeDirectory: string;
+    readonly source: RemoteSourceReference & {
+        readonly ref: string;
+    };
+}
+export interface PinnedCatalogBootstrapResult {
+    readonly root: string;
+    readonly source: RemoteSourceReference & {
+        readonly ref: string;
+    };
+}
+/** Fetches one immutable catalog revision into the same cache path used by normal source resolution. */
+export declare const bootstrapPinnedCatalog: (input: PinnedCatalogBootstrapInput) => PinnedCatalogBootstrapResult;
+export declare const bootstrapDefaultCatalog: (homeDirectory: string) => PinnedCatalogBootstrapResult;

package/dist/setup/DefaultCatalog.js

@@ -0,0 +1,89 @@
+// Bootstraps the one canonical default catalog at the immutable revision shipped by Outfitter.
+import { execFileSync } from 'node:child_process';
+import { existsSync, mkdirSync, renameSync, rmSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { createRemoteRepositoryCachePath, normalizeGitUri, normalizeRemoteSourceUri } from '../sources/SourceCache.js';
+export const defaultCatalogSource = {
+    github: 'ai-outfitter/default-profiles',
+    // TODO(release-automation): when default-profiles publishes a new Release Please tag, open a
+    // conventional dependency-bump commit in Outfitter so its next Release Please release ships it.
+    ref: 'v1.0.0',
+};
+const runGit = (arguments_) => {
+    try {
+        return execFileSync('git', [...arguments_], {
+            encoding: 'utf8',
+            stdio: ['ignore', 'pipe', 'pipe'],
+        }).trim();
+    }
+    catch (error) {
+        throw new Error(`git ${arguments_.join(' ')} failed: ${String(error)}`, { cause: error });
+    }
+};
+const fullCommitPattern = /^[a-f0-9]{40}$/u;
+const versionTagPattern = /^v\d+\.\d+\.\d+(?:-[0-9A-Za-z.-]+)?$/u;
+const assertImmutableRef = (ref) => {
+    if (!fullCommitPattern.test(ref) && !versionTagPattern.test(ref)) {
+        throw new Error(`Default catalog ref '${ref}' must be a full commit SHA or version tag.`);
+    }
+};
+const resolveExpectedCommit = (root, ref) => fullCommitPattern.test(ref) ? ref : runGit(['-C', root, 'rev-parse', `refs/tags/${ref}^{commit}`]);
+const isPinnedCatalogCheckout = (root, ref) => {
+    if (!existsSync(join(root, 'agents')))
+        return false;
+    try {
+        return (runGit(['-C', root, 'rev-parse', 'HEAD']) === resolveExpectedCommit(root, ref) &&
+            runGit(['-C', root, 'status', '--porcelain']) === '');
+    }
+    catch {
+        return false;
+    }
+};
+/** Fetches one immutable catalog revision into the same cache path used by normal source resolution. */
+export const bootstrapPinnedCatalog = (input) => {
+    assertImmutableRef(input.source.ref);
+    const root = createRemoteRepositoryCachePath(input.homeDirectory, input.source);
+    if (isPinnedCatalogCheckout(root, input.source.ref))
+        return { root, source: input.source };
+    mkdirSync(dirname(root), { recursive: true });
+    const nonce = `${process.pid}-${Math.random().toString(16).slice(2)}`;
+    const temporaryRoot = `${root}.outfitter-${nonce}.tmp`;
+    const staleRoot = `${root}.outfitter-${nonce}.stale`;
+    const remote = normalizeGitUri(normalizeRemoteSourceUri(input.source));
+    let movedStaleCache = false;
+    try {
+        runGit(['init', '--quiet', temporaryRoot]);
+        runGit(['-C', temporaryRoot, 'remote', 'add', 'origin', remote]);
+        const fetchRef = fullCommitPattern.test(input.source.ref)
+            ? input.source.ref
+            : `refs/tags/${input.source.ref}:refs/tags/${input.source.ref}`;
+        runGit(['-C', temporaryRoot, 'fetch', '--quiet', '--depth=1', 'origin', fetchRef]);
+        runGit(['-C', temporaryRoot, 'checkout', '--quiet', '--detach', 'FETCH_HEAD']);
+        if (!isPinnedCatalogCheckout(temporaryRoot, input.source.ref)) {
+            throw new Error(`Fetched default catalog did not resolve to ${input.source.ref}.`);
+        }
+        if (existsSync(root)) {
+            renameSync(root, staleRoot);
+            movedStaleCache = true;
+        }
+        renameSync(temporaryRoot, root);
+        if (movedStaleCache)
+            rmSync(staleRoot, { recursive: true, force: true });
+        return { root, source: input.source };
+    }
+    catch (error) {
+        /* v8 ignore next -- only an OS-level failure during the atomic cache rename requires restoration. */
+        if (movedStaleCache && !existsSync(root) && existsSync(staleRoot))
+            renameSync(staleRoot, root);
+        const detail = String(error);
+        throw new Error(`Could not fetch the default Outfitter catalog at pinned revision ${input.source.ref}. ${detail}`, {
+            cause: error,
+        });
+    }
+    finally {
+        rmSync(temporaryRoot, { recursive: true, force: true });
+        rmSync(staleRoot, { recursive: true, force: true });
+    }
+};
+export const bootstrapDefaultCatalog = (homeDirectory) => bootstrapPinnedCatalog({ homeDirectory, source: defaultCatalogSource });
+//# sourceMappingURL=DefaultCatalog.js.map

package/dist/setup/DefaultCatalog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DefaultCatalog.js","sourceRoot":"","sources":["../../src/setup/DefaultCatalog.ts"],"names":[],"mappings":"AAAA,+FAA+F;AAC/F,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACpE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAE1C,OAAO,EAAE,+BAA+B,EAAE,eAAe,EAAE,wBAAwB,EAAE,MAAM,2BAA2B,CAAC;AAGvH,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,MAAM,EAAE,+BAA+B;IACvC,6FAA6F;IAC7F,gGAAgG;IAChG,GAAG,EAAE,QAAQ;CAC2B,CAAC;AAY3C,MAAM,MAAM,GAAG,CAAC,UAA6B,EAAU,EAAE;IACvD,IAAI,CAAC;QACH,OAAO,YAAY,CAAC,KAAK,EAAE,CAAC,GAAG,UAAU,CAAC,EAAE;YAC1C,QAAQ,EAAE,MAAM;YAChB,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC;SAClC,CAAC,CAAC,IAAI,EAAE,CAAC;IACZ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CAAC,OAAO,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,YAAY,MAAM,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;IAC5F,CAAC;AACH,CAAC,CAAC;AAEF,MAAM,iBAAiB,GAAG,iBAAiB,CAAC;AAC5C,MAAM,iBAAiB,GAAG,uCAAuC,CAAC;AAElE,MAAM,kBAAkB,GAAG,CAAC,GAAW,EAAQ,EAAE;IAC/C,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QACjE,MAAM,IAAI,KAAK,CAAC,wBAAwB,GAAG,6CAA6C,CAAC,CAAC;IAC5F,CAAC;AACH,CAAC,CAAC;AAEF,MAAM,qBAAqB,GAAG,CAAC,IAAY,EAAE,GAAW,EAAU,EAAE,CAClE,iBAAiB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,WAAW,EAAE,aAAa,GAAG,WAAW,CAAC,CAAC,CAAC;AAErG,MAAM,uBAAuB,GAAG,CAAC,IAAY,EAAE,GAAW,EAAW,EAAE;IACrE,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;QAAE,OAAO,KAAK,CAAC;IACpD,IAAI,CAAC;QACH,OAAO,CACL,MAAM,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,CAAC,CAAC,KAAK,qBAAqB,CAAC,IAAI,EAAE,GAAG,CAAC;YAC9E,MAAM,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,aAAa,CAAC,CAAC,KAAK,EAAE,CACrD,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC,CAAC;AAEF,wGAAwG;AACxG,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,KAAkC,EAAgC,EAAE;IACzG,kBAAkB,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IACrC,MAAM,IAAI,GAAG,+BAA+B,CAAC,KAAK,CAAC,aAAa,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IAChF,IAAI,uBAAuB,CAAC,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC;QAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC;IAE3F,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC9C,MAAM,KAAK,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;IACtE,MAAM,aAAa,GAAG,GAAG,IAAI,cAAc,KAAK,MAAM,CAAC;IACvD,MAAM,SAAS,GAAG,GAAG,IAAI,cAAc,KAAK,QAAQ,CAAC;IACrD,MAAM,MAAM,GAAG,eAAe,CAAC,wBAAwB,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC;IACvE,IAAI,eAAe,GAAG,KAAK,CAAC;IAE5B,IAAI,CAAC;QACH,MAAM,CAAC,CAAC,MAAM,EAAE,SAAS,EAAE,aAAa,CAAC,CAAC,CAAC;QAC3C,MAAM,CAAC,CAAC,IAAI,EAAE,aAAa,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC;QACjE,MAAM,QAAQ,GAAG,iBAAiB,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC;YACvD,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG;YAClB,CAAC,CAAC,aAAa,KAAK,CAAC,MAAM,CAAC,GAAG,cAAc,KAAK,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC;QAClE,MAAM,CAAC,CAAC,IAAI,EAAE,aAAa,EAAE,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC;QACnF,MAAM,CAAC,CAAC,IAAI,EAAE,aAAa,EAAE,UAAU,EAAE,SAAS,EAAE,UAAU,EAAE,YAAY,CAAC,CAAC,CAAC;QAE/E,IAAI,CAAC,uBAAuB,CAAC,aAAa,EAAE,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;YAC9D,MAAM,IAAI,KAAK,CAAC,8CAA8C,KAAK,CAAC,MAAM,CAAC,GAAG,GAAG,CAAC,CAAC;QACrF,CAAC;QAED,IAAI,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YACrB,UAAU,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;YAC5B,eAAe,GAAG,IAAI,CAAC;QACzB,CAAC;QACD,UAAU,CAAC,aAAa,EAAE,IAAI,CAAC,CAAC;QAChC,IAAI,eAAe;YAAE,MAAM,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QACzE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC;IACxC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,qGAAqG;QACrG,IAAI,eAAe,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,UAAU,CAAC,SAAS,CAAC;YAAE,UAAU,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;QAC/F,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;QAC7B,MAAM,IAAI,KAAK,CAAC,oEAAoE,KAAK,CAAC,MAAM,CAAC,GAAG,KAAK,MAAM,EAAE,EAAE;YACjH,KAAK,EAAE,KAAK;SACb,CAAC,CAAC;IACL,CAAC;YAAS,CAAC;QACT,MAAM,CAAC,aAAa,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QACxD,MAAM,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IACtD,CAAC;AACH,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,aAAqB,EAAgC,EAAE,CAC7F,sBAAsB,CAAC,EAAE,aAAa,EAAE,MAAM,EAAE,oBAAoB,EAAE,CAAC,CAAC"}

package/dist/setup/Setup.d.ts

@@ -0,0 +1,43 @@
+import type { Harness } from '../settings/Settings.js';
+export type SetupScope = 'home' | 'project';
+export type SetupMode = 'default' | 'create' | 'catalog' | 'source';
+export interface SetupAgentChoice {
+    readonly id: string;
+    readonly label: string;
+    readonly description: string;
+}
+export interface SetupSelection {
+    readonly setupMode: SetupMode;
+    readonly agentId?: string;
+    readonly agentLabel?: string;
+    readonly github?: string;
+    readonly ref?: string;
+    readonly settingsPath?: string;
+    readonly sourceUri?: string;
+    readonly harness: Harness;
+    readonly privateCatalogsEnabled?: boolean;
+    readonly privateCatalogAccepted?: boolean;
+    readonly target: SetupScope;
+}
+export interface SetupInput {
+    readonly homeDirectory: string;
+    readonly projectDirectory: string;
+    readonly selection: SetupSelection;
+    readonly availableAgents: readonly SetupAgentChoice[];
+    readonly defaultCatalogRoot?: string;
+}
+export interface SetupResult {
+    readonly created: readonly string[];
+    readonly updated: readonly string[];
+    readonly settingsPath: string;
+    readonly defaultAgent?: string;
+    readonly defaultHarness: Harness;
+    readonly messages: readonly string[];
+}
+export declare const sanitizeAgentSlug: (raw: string) => string;
+/** Returns the profiles shown by the original default-catalog setup picker. */
+export declare const discoverSetupAgentChoices: (input: {
+    readonly defaultCatalogRoot?: string;
+}) => readonly SetupAgentChoice[];
+/** Applies a UI selection without touching any existing agent resource. */
+export declare const applySetupSelection: (input: SetupInput) => SetupResult;

package/dist/setup/Setup.js

@@ -0,0 +1,261 @@
+/* eslint-disable complexity */
+// Harness-neutral setup state: applies the original profile-era setup outcomes to `.agents`.
+import { existsSync, mkdirSync, readFileSync, readdirSync, renameSync, rmSync, statSync, writeFileSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { HARNESSES } from '../settings/Settings.js';
+import { defaultCatalogSource } from './DefaultCatalog.js';
+const defaultAgentSlug = 'assistant';
+const maxSlugLength = 64;
+const agentSlugPattern = /^[a-z0-9]+(?:-[a-z0-9]+)*$/;
+export const sanitizeAgentSlug = (raw) => {
+    const slug = raw
+        .trim()
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, '-')
+        .replace(/^-+|-+$/g, '')
+        .slice(0, maxSlugLength)
+        .replace(/-+$/g, '');
+    return agentSlugPattern.test(slug) ? slug : defaultAgentSlug;
+};
+const readFrontmatterValue = (content, key) => {
+    const match = new RegExp(`^${key}:\\s*([^\\n]+)`, 'mu').exec(content);
+    // Strip only a real inline YAML comment (whitespace + '#'), so values like 'C#' survive.
+    return match?.[1]
+        ?.replace(/\s+#.*$/u, '')
+        .trim()
+        .replace(/^['"]|['"]$/gu, '');
+};
+const readMarkdownHeading = (content) => /^#\s+(.+)$/mu.exec(content)?.[1]?.trim();
+const discoverAgentsInCatalog = (root) => {
+    const agentsDirectory = join(root, 'agents');
+    if (!existsSync(agentsDirectory))
+        return [];
+    let entries;
+    try {
+        entries = readdirSync(agentsDirectory).sort();
+    }
+    catch {
+        return [];
+    }
+    const choices = entries.flatMap((entry) => {
+        const agentPath = join(agentsDirectory, entry, 'agent.md');
+        try {
+            if (!statSync(agentPath).isFile())
+                return [];
+            const content = readFileSync(agentPath, 'utf8');
+            const id = sanitizeAgentSlug(readFrontmatterValue(content, 'name') ?? entry);
+            if (id !== entry || !agentSlugPattern.test(id))
+                return [];
+            return [
+                {
+                    id,
+                    label: readFrontmatterValue(content, 'label') ?? readMarkdownHeading(content) ?? id,
+                    description: readFrontmatterValue(content, 'description') ?? 'Outfitter profile from the default catalog.',
+                },
+            ];
+        }
+        catch {
+            return [];
+        }
+    });
+    return choices.sort((left, right) => {
+        if (left.id === 'founder')
+            return -1;
+        if (right.id === 'founder')
+            return 1;
+        return left.id.localeCompare(right.id);
+    });
+};
+/** Returns the profiles shown by the original default-catalog setup picker. */
+export const discoverSetupAgentChoices = (input) => {
+    if (input.defaultCatalogRoot === undefined)
+        return [];
+    return discoverAgentsInCatalog(input.defaultCatalogRoot);
+};
+const userProfileMarkdown = (slug, label) => `---\nname: "${slug}"\nlabel: "${label}"\ndescription: User-created Outfitter profile.\n---\n\n# ${label}\n\n` +
+    'You are a helpful coding agent. Follow the instructions and skills available in this .agents tree.\n';
+const replaceOrAppendScalar = (content, key, value) => {
+    const linePattern = new RegExp(`^${key}:.*$`, 'mu');
+    if (linePattern.test(content))
+        return content.replace(linePattern, `${key}: ${value}`);
+    return `${content.replace(/\s*$/u, '')}${content.trim() === '' ? '' : '\n'}${key}: ${value}\n`;
+};
+const upsertDefaultCatalogSource = (content) => {
+    const sourceLines = [`  - github: ${defaultCatalogSource.github}`, `    ref: ${defaultCatalogSource.ref}`];
+    if (!/^sources:\s*$/mu.test(content)) {
+        return `${content.replace(/\s*$/u, '')}\nsources:\n${sourceLines.join('\n')}\n`;
+    }
+    const lines = content.replace(/\s*$/u, '').split('\n');
+    const start = lines.findIndex((line) => /^sources:\s*$/u.test(line));
+    let end = start + 1;
+    while (end < lines.length && (/^\s/u.test(lines[end] ?? '') || (lines[end] ?? '') === ''))
+        end += 1;
+    const existing = lines.findIndex((line, index) => {
+        if (index <= start || index >= end)
+            return false;
+        const match = /^\s*-\s+github:\s*(.+?)\s*$/u.exec(line);
+        return match?.[1]?.replace(/^['"]|['"]$/gu, '') === defaultCatalogSource.github;
+    });
+    if (existing === -1) {
+        lines.splice(start + 1, 0, ...sourceLines);
+        return `${lines.join('\n')}\n`;
+    }
+    let blockEnd = existing + 1;
+    while (blockEnd < end && !/^\s*-\s+/u.test(lines[blockEnd] ?? ''))
+        blockEnd += 1;
+    const block = lines.slice(existing, blockEnd).filter((line) => !/^\s+path:\s*/u.test(line));
+    const refIndex = block.findIndex((line) => /^\s+ref:\s*/u.test(line));
+    if (refIndex === -1)
+        block.splice(1, 0, `    ref: ${defaultCatalogSource.ref}`);
+    else
+        block[refIndex] = `    ref: ${defaultCatalogSource.ref}`;
+    lines.splice(existing, blockEnd - existing, ...block);
+    return `${lines.join('\n')}\n`;
+};
+const createSettingsContent = (existing, selection) => {
+    if (selection.setupMode === 'source') {
+        return [
+            `default_harness: ${selection.harness}`,
+            'remote_settings:',
+            `  - uri: ${JSON.stringify(selection.sourceUri)}`,
+            '    path: settings.yml',
+            '',
+        ].join('\n');
+    }
+    if (selection.setupMode === 'catalog') {
+        return [
+            ...(selection.privateCatalogsEnabled && selection.target === 'home'
+                ? ['enterprise:', '  private_catalogs: true']
+                : []),
+            `default_harness: ${selection.harness}`,
+            'remote_settings:',
+            `  - github: ${selection.github}`,
+            `    ref: ${selection.ref}`,
+            `    path: ${selection.settingsPath}`,
+            '',
+        ].join('\n');
+    }
+    let content = replaceOrAppendScalar(existing, 'default_agent', String(selection.agentId));
+    content = replaceOrAppendScalar(content, 'default_harness', selection.harness);
+    return selection.setupMode === 'default' ? upsertDefaultCatalogSource(content) : content;
+};
+const enablePrivateCatalogs = (content) => {
+    if (/^\s*private_catalogs:\s*true\s*$/mu.test(content))
+        return content;
+    if (/^\s*private_catalogs:\s*(?:true|false)\s*$/mu.test(content)) {
+        return content.replace(/^\s*private_catalogs:\s*(?:true|false)\s*$/mu, '  private_catalogs: true');
+    }
+    if (/^enterprise:\s*$/mu.test(content)) {
+        return content.replace(/^enterprise:\s*$/mu, 'enterprise:\n  private_catalogs: true');
+    }
+    return `${content.replace(/\s*$/u, '')}${content.trim() === '' ? '' : '\n'}enterprise:\n  private_catalogs: true\n`;
+};
+const atomicWrite = (path, content) => {
+    mkdirSync(dirname(path), { recursive: true });
+    const temporaryPath = `${path}.outfitter-${process.pid}-${Math.random().toString(16).slice(2)}.tmp`;
+    try {
+        writeFileSync(temporaryPath, content, { flag: 'wx' });
+        renameSync(temporaryPath, path);
+    }
+    finally {
+        rmSync(temporaryPath, { force: true });
+    }
+};
+const assertSelection = (input) => {
+    const { selection } = input;
+    if (!HARNESSES.includes(selection.harness)) {
+        throw new Error(`Setup returned unsupported harness '${String(selection.harness)}'.`);
+    }
+    if (selection.setupMode === 'catalog') {
+        if (!selection.github || !/^[A-Za-z0-9_.-]+\/[A-Za-z0-9_.-]+$/u.test(selection.github)) {
+            throw new Error('Setup returned an invalid catalog repository.');
+        }
+        if (!selection.ref ||
+            !selection.settingsPath ||
+            selection.settingsPath.startsWith('/') ||
+            selection.settingsPath.includes('..')) {
+            throw new Error('Setup returned invalid catalog settings.');
+        }
+        return;
+    }
+    if (selection.setupMode === 'source') {
+        if (!selection.sourceUri)
+            throw new Error('Setup returned an invalid source URI.');
+        return;
+    }
+    // Validate the exact id that gets written as the agent directory/frontmatter name — do not
+    // normalize here, or an id that passes validation could still be written in a schema-invalid form.
+    if (!selection.agentId || !agentSlugPattern.test(selection.agentId)) {
+        throw new Error(`Setup returned invalid agent id '${selection.agentId}'.`);
+    }
+    if (selection.setupMode === 'default') {
+        if (!input.availableAgents.some((candidate) => candidate.id === selection.agentId)) {
+            throw new Error(`Setup selected unavailable agent '${selection.agentId}'.`);
+        }
+        if (input.defaultCatalogRoot === undefined)
+            throw new Error('The default Outfitter profile catalog is unavailable.');
+    }
+};
+/** Applies a UI selection without touching any existing agent resource. */
+export const applySetupSelection = (input) => {
+    assertSelection(input);
+    const targetRoot = input.selection.target === 'home' ? input.homeDirectory : input.projectDirectory;
+    const settingsPath = join(targetRoot, '.agents', 'settings.yml');
+    const created = [];
+    const updated = [];
+    let createdAgentPath;
+    let privateHomeSettingsPath;
+    let privateHomeSettingsExisted = false;
+    let previousPrivateHomeSettings = '';
+    if (input.selection.setupMode === 'create') {
+        const agentPath = join(targetRoot, '.agents', 'agents', input.selection.agentId, 'agent.md');
+        if (!existsSync(agentPath)) {
+            atomicWrite(agentPath, userProfileMarkdown(input.selection.agentId, input.selection.agentLabel?.trim() || input.selection.agentId));
+            created.push(agentPath);
+            createdAgentPath = agentPath;
+        }
+    }
+    try {
+        if (input.selection.setupMode === 'catalog' &&
+            input.selection.privateCatalogAccepted === true &&
+            input.selection.target === 'project') {
+            privateHomeSettingsPath = join(input.homeDirectory, '.agents', 'settings.yml');
+            privateHomeSettingsExisted = existsSync(privateHomeSettingsPath);
+            previousPrivateHomeSettings = privateHomeSettingsExisted ? readFileSync(privateHomeSettingsPath, 'utf8') : '';
+            atomicWrite(privateHomeSettingsPath, enablePrivateCatalogs(previousPrivateHomeSettings));
+            (privateHomeSettingsExisted ? updated : created).push(privateHomeSettingsPath);
+        }
+        const settingsExisted = existsSync(settingsPath);
+        const existingSettings = settingsExisted ? readFileSync(settingsPath, 'utf8') : '';
+        atomicWrite(settingsPath, createSettingsContent(existingSettings, input.selection));
+        (settingsExisted ? updated : created).unshift(settingsPath);
+    }
+    catch (error) {
+        if (createdAgentPath !== undefined)
+            rmSync(createdAgentPath, { force: true });
+        if (privateHomeSettingsPath !== undefined) {
+            if (privateHomeSettingsExisted)
+                atomicWrite(privateHomeSettingsPath, previousPrivateHomeSettings);
+            else
+                rmSync(privateHomeSettingsPath, { force: true });
+        }
+        throw error;
+    }
+    return {
+        created,
+        updated,
+        settingsPath,
+        defaultAgent: input.selection.agentId,
+        defaultHarness: input.selection.harness,
+        messages: [
+            ...created.map((path) => `Created ${path}`),
+            ...updated.map((path) => `Updated ${path}`),
+            ...(input.selection.agentId === undefined
+                ? []
+                : [
+                    `Default agent '${input.selection.agentId}' will launch in ${input.selection.harness} on the next Outfitter run.`,
+                ]),
+        ],
+    };
+};
+//# sourceMappingURL=Setup.js.map

package/dist/setup/Setup.js.map

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

package/dist/skills/SkillDocument.d.ts

@@ -1,4 +1,9 @@
-import type { SkillReference } from '../profiles/Profile.js';
+/** A materializable skill reference: a source-tree `file` or an active-project `repo_file`. */
+export type SkillReference = {
+    readonly file: string;
+} | {
+    readonly repo_file: string;
+};
 export declare const isSkillReference: (value: unknown) => value is SkillReference;
 /** Frontmatter keys that materialize external files into a generated skill directory. */
 export declare const skillMaterializationSections: readonly ["references", "scripts", "assets"];

package/dist/skills/SkillDocument.js.map

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

package/dist/sources/SourceCache.d.ts

@@ -0,0 +1,19 @@
+/** A remote `.agents` source: a git URI or a `github` shorthand, with an optional ref. */
+export type RemoteSourceReference = {
+    readonly uri: string;
+    readonly github?: never;
+    readonly ref?: string;
+    readonly path?: string;
+} | {
+    readonly github: string;
+    readonly uri?: never;
+    readonly ref?: string;
+    readonly path?: string;
+};
+export declare const normalizeGitUri: (uri: string) => string;
+export declare const normalizeRemoteSourceUri: (source: RemoteSourceReference) => string;
+export declare const redactSourceUriCredentials: (uri: string) => string;
+export declare const encodeSourceUri: (uri: string) => string;
+export declare const encodeRemoteSource: (source: RemoteSourceReference) => string;
+export declare const createRemoteRepositoryCachePath: (homeDirectory: string, source: RemoteSourceReference) => string;
+export declare const resolveRemoteRepositorySubpath: (repositoryPath: string, subpath?: string) => string;

package/dist/{profiles/ProfileCache.js → sources/SourceCache.js}

@@ -1,22 +1,13 @@
-// Encodes remote profile/source cache paths.
+// Encodes remote `.agents` source cache paths and normalizes remote source references.
 import { isAbsolute, join, relative, resolve } from 'node:path';
-import { normalizeRemoteSourceUri } from './ProfileSource.js';
-export const encodeProfileSourceUri = (uri) => Buffer.from(redactProfileSourceUriCredentials(uri), 'utf8').toString('base64url');
-export const encodeRemoteSource = (source) => encodeProfileSourceUri(`${normalizeRemoteSourceUri(source)}#${source.ref ?? ''}`);
-export const createProfileSourceCachePath = (homeDirectory, uri) => join(homeDirectory, '.outfitter', 'cache', 'profiles', encodeProfileSourceUri(uri));
-export const createRemoteRepositoryCachePath = (homeDirectory, source) => join(homeDirectory, '.outfitter', 'cache', 'repos', encodeRemoteSource(source));
-export const resolveRemoteRepositorySubpath = (repositoryPath, subpath = '') => {
-    if (isAbsolute(subpath)) {
-        throw new Error(`Remote repository path '${subpath}' must be relative.`);
-    }
-    const resolvedPath = resolve(repositoryPath, subpath);
-    const relativePath = relative(repositoryPath, resolvedPath);
-    if (relativePath === '..' || relativePath.startsWith('../') || isAbsolute(relativePath)) {
-        throw new Error(`Remote repository path '${subpath}' must stay inside the repository.`);
+export const normalizeGitUri = (uri) => (uri.startsWith('git+') ? uri.slice('git+'.length) : uri);
+export const normalizeRemoteSourceUri = (source) => {
+    if (source.uri !== undefined) {
+        return source.uri;
     }
-    return resolvedPath;
+    return `git+https://github.com/${source.github}.git`;
 };
-export const redactProfileSourceUriCredentials = (uri) => {
+export const redactSourceUriCredentials = (uri) => {
     const prefix = uri.startsWith('git+') ? 'git+' : '';
     const normalizedUri = normalizeGitUri(uri);
     try {
@@ -32,5 +23,18 @@ export const redactProfileSourceUriCredentials = (uri) => {
         return uri.replace(/\/\/[^/@\s]+@/u, '//REDACTED@');
     }
 };
-export const normalizeGitUri = (uri) => (uri.startsWith('git+') ? uri.slice('git+'.length) : uri);
-//# sourceMappingURL=ProfileCache.js.map
+export const encodeSourceUri = (uri) => Buffer.from(redactSourceUriCredentials(uri), 'utf8').toString('base64url');
+export const encodeRemoteSource = (source) => encodeSourceUri(`${normalizeRemoteSourceUri(source)}#${source.ref ?? ''}`);
+export const createRemoteRepositoryCachePath = (homeDirectory, source) => join(homeDirectory, '.agents', 'cache', 'repos', encodeRemoteSource(source));
+export const resolveRemoteRepositorySubpath = (repositoryPath, subpath = '') => {
+    if (isAbsolute(subpath)) {
+        throw new Error(`Remote repository path '${subpath}' must be relative.`);
+    }
+    const resolvedPath = resolve(repositoryPath, subpath);
+    const relativePath = relative(repositoryPath, resolvedPath);
+    if (relativePath === '..' || relativePath.startsWith('../') || isAbsolute(relativePath)) {
+        throw new Error(`Remote repository path '${subpath}' must stay inside the repository.`);
+    }
+    return resolvedPath;
+};
+//# sourceMappingURL=SourceCache.js.map

package/dist/sources/SourceCache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SourceCache.js","sourceRoot":"","sources":["../../src/sources/SourceCache.ts"],"names":[],"mappings":"AAAA,uFAAuF;AACvF,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAOhE,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,GAAW,EAAU,EAAE,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;AAElH,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,MAA6B,EAAU,EAAE;IAChF,IAAI,MAAM,CAAC,GAAG,KAAK,SAAS,EAAE,CAAC;QAC7B,OAAO,MAAM,CAAC,GAAG,CAAC;IACpB,CAAC;IAED,OAAO,0BAA0B,MAAM,CAAC,MAAM,MAAM,CAAC;AACvD,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,GAAW,EAAU,EAAE;IAChE,MAAM,MAAM,GAAG,GAAG,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;IACpD,MAAM,aAAa,GAAG,eAAe,CAAC,GAAG,CAAC,CAAC;IAE3C,IAAI,CAAC;QACH,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,aAAa,CAAC,CAAC;QAEzC,IAAI,SAAS,CAAC,QAAQ,KAAK,EAAE,IAAI,SAAS,CAAC,QAAQ,KAAK,EAAE,EAAE,CAAC;YAC3D,OAAO,GAAG,CAAC;QACb,CAAC;QAED,SAAS,CAAC,QAAQ,GAAG,UAAU,CAAC;QAChC,SAAS,CAAC,QAAQ,GAAG,EAAE,CAAC;QACxB,OAAO,GAAG,MAAM,GAAG,SAAS,CAAC,QAAQ,EAAE,EAAE,CAAC;IAC5C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,GAAG,CAAC,OAAO,CAAC,gBAAgB,EAAE,aAAa,CAAC,CAAC;IACtD,CAAC;AACH,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,GAAW,EAAU,EAAE,CACrD,MAAM,CAAC,IAAI,CAAC,0BAA0B,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;AAE7E,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,MAA6B,EAAU,EAAE,CAC1E,eAAe,CAAC,GAAG,wBAAwB,CAAC,MAAM,CAAC,IAAI,MAAM,CAAC,GAAG,IAAI,EAAE,EAAE,CAAC,CAAC;AAE7E,MAAM,CAAC,MAAM,+BAA+B,GAAG,CAAC,aAAqB,EAAE,MAA6B,EAAU,EAAE,CAC9G,IAAI,CAAC,aAAa,EAAE,SAAS,EAAE,OAAO,EAAE,OAAO,EAAE,kBAAkB,CAAC,MAAM,CAAC,CAAC,CAAC;AAE/E,MAAM,CAAC,MAAM,8BAA8B,GAAG,CAAC,cAAsB,EAAE,OAAO,GAAG,EAAE,EAAU,EAAE;IAC7F,IAAI,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;QACxB,MAAM,IAAI,KAAK,CAAC,2BAA2B,OAAO,qBAAqB,CAAC,CAAC;IAC3E,CAAC;IAED,MAAM,YAAY,GAAG,OAAO,CAAC,cAAc,EAAE,OAAO,CAAC,CAAC;IACtD,MAAM,YAAY,GAAG,QAAQ,CAAC,cAAc,EAAE,YAAY,CAAC,CAAC;IAE5D,IAAI,YAAY,KAAK,IAAI,IAAI,YAAY,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;QACxF,MAAM,IAAI,KAAK,CAAC,2BAA2B,OAAO,oCAAoC,CAAC,CAAC;IAC1F,CAAC;IAED,OAAO,YAAY,CAAC;AACtB,CAAC,CAAC"}

package/dist/validation/SchemaValidator.d.ts

@@ -1,4 +1,4 @@
-export type SchemaName = 'settings' | 'profile' | 'profile-source';
+export type SchemaName = 'settings' | 'agent';
 export interface ValidationIssue {
     readonly path: string;
     readonly message: string;