@anthara/pi-claude 0.0.0-stage → 0.1.0

package/dist/kernel/plugin-catalog/manifest-view.js

@@ -0,0 +1,27 @@
+import { isAbsolute, join, relative, resolve, sep } from 'node:path';
+import { PLUGIN_MANIFEST_PATH } from '../claude-home/plugin-layout.js';
+import { readJsonObjectLeniently } from '../private-files/private-files.js';
+export function readManifestView(pluginRoot) {
+    const manifest = readJsonObjectLeniently(join(pluginRoot, PLUGIN_MANIFEST_PATH));
+    return {
+        defaultEnabled: manifest.defaultEnabled !== false,
+        declaredPaths: (key) => pathsInside(pluginRoot, declaredEntries(manifest, key)),
+        declaredValue: (key) => manifest[key],
+    };
+}
+function declaredEntries(manifest, key) {
+    const declared = manifest[key];
+    const entries = Array.isArray(declared) ? declared : [declared];
+    return entries.filter((entry) => typeof entry === 'string');
+}
+function pathsInside(pluginRoot, declared) {
+    return declared.map((entry) => resolve(pluginRoot, entry)).filter((path) => isInside(pluginRoot, path));
+}
+export function pathInside(pluginRoot, entry) {
+    return pathsInside(pluginRoot, [entry])[0];
+}
+function isInside(root, path) {
+    const inside = relative(root, path);
+    return inside === '' || (!inside.startsWith(`..${sep}`) && inside !== '..' && !isAbsolute(inside));
+}
+//# sourceMappingURL=manifest-view.js.map

package/dist/kernel/plugin-catalog/manifest-view.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest-view.js","sourceRoot":"","sources":["../../../src/kernel/plugin-catalog/manifest-view.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AACrE,OAAO,EAAE,oBAAoB,EAAE,MAAM,iCAAiC,CAAC;AACvE,OAAO,EAAE,uBAAuB,EAAmB,MAAM,mCAAmC,CAAC;AAQ7F,MAAM,UAAU,gBAAgB,CAAC,UAAkB;IACjD,MAAM,QAAQ,GAAG,uBAAuB,CAAC,IAAI,CAAC,UAAU,EAAE,oBAAoB,CAAC,CAAC,CAAC;IACjF,OAAO;QACL,cAAc,EAAE,QAAQ,CAAC,cAAc,KAAK,KAAK;QACjD,aAAa,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,WAAW,CAAC,UAAU,EAAE,eAAe,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;QAC/E,aAAa,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC;KACtC,CAAC;AACJ,CAAC;AAED,SAAS,eAAe,CAAC,QAAoB,EAAE,GAAW;IACxD,MAAM,QAAQ,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC;IAC/B,MAAM,OAAO,GAAuB,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;IACpF,OAAO,OAAO,CAAC,MAAM,CAAC,CAAC,KAAK,EAAmB,EAAE,CAAC,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC;AAC/E,CAAC;AAED,SAAS,WAAW,CAAC,UAAkB,EAAE,QAA2B;IAClE,OAAO,QAAQ,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,QAAQ,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC,CAAC;AAC1G,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,UAAkB,EAAE,KAAa;IAC1D,OAAO,WAAW,CAAC,UAAU,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAC7C,CAAC;AAED,SAAS,QAAQ,CAAC,IAAY,EAAE,IAAY;IAC1C,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IACpC,OAAO,MAAM,KAAK,EAAE,IAAI,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,KAAK,GAAG,EAAE,CAAC,IAAI,MAAM,KAAK,IAAI,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC;AACrG,CAAC"}

package/dist/kernel/plugin-catalog/own-installs.d.ts

@@ -0,0 +1,8 @@
+export interface OwnInstall {
+    readonly name: string;
+    readonly root: string;
+    readonly sha: string;
+    readonly dataDir: string;
+    readonly enabled: boolean;
+}
+export declare function ownInstalls(agentDir: string): readonly OwnInstall[];

package/dist/kernel/plugin-catalog/own-installs.js

@@ -0,0 +1,13 @@
+import { dataDir, indexPath, installRoot, versionDir } from '../plugin-install/install-layout.js';
+import { readOwnIndexLeniently } from '../plugin-install/own-install-index.js';
+export function ownInstalls(agentDir) {
+    const root = installRoot(agentDir);
+    const read = readOwnIndexLeniently(indexPath(root));
+    if (read.kind === 'malformed') {
+        return [];
+    }
+    return Object.entries(read.index.plugins)
+        .map(([name, { sha, enabled }]) => ({ name, root: versionDir(root, name, sha), sha, dataDir: dataDir(agentDir, name), enabled }))
+        .sort((a, b) => a.name.localeCompare(b.name));
+}
+//# sourceMappingURL=own-installs.js.map

package/dist/kernel/plugin-catalog/own-installs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"own-installs.js","sourceRoot":"","sources":["../../../src/kernel/plugin-catalog/own-installs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,qCAAqC,CAAC;AAClG,OAAO,EAAE,qBAAqB,EAAE,MAAM,wCAAwC,CAAC;AAU/E,MAAM,UAAU,WAAW,CAAC,QAAgB;IAC1C,MAAM,IAAI,GAAG,WAAW,CAAC,QAAQ,CAAC,CAAC;IACnC,MAAM,IAAI,GAAG,qBAAqB,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC;IACpD,IAAI,IAAI,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;QAC9B,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,OAAO,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC;SACtC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,GAAG,EAAE,OAAO,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,UAAU,CAAC,IAAI,EAAE,IAAI,EAAE,GAAG,CAAC,EAAE,GAAG,EAAE,OAAO,EAAE,OAAO,CAAC,QAAQ,EAAE,IAAI,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC;SAChI,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;AAClD,CAAC"}

package/dist/kernel/plugin-catalog/plugin-catalog.d.ts

@@ -0,0 +1,17 @@
+import { type CatalogPlugin } from './plugin-installs.js';
+export type { CatalogPlugin } from './plugin-installs.js';
+export interface CatalogPaths {
+    readonly claudeDir: string;
+    readonly agentDir?: string;
+}
+export type CatalogLookup = {
+    readonly kind: 'found';
+    readonly plugin: CatalogPlugin;
+} | {
+    readonly kind: 'missing';
+};
+export interface PluginCatalog {
+    enabled(): readonly CatalogPlugin[];
+    find(name: string): CatalogLookup;
+}
+export declare function loadPluginCatalog({ claudeDir, agentDir }: CatalogPaths): PluginCatalog;

package/dist/kernel/plugin-catalog/plugin-catalog.js

@@ -0,0 +1,15 @@
+import { getAgentDir } from '@earendil-works/pi-coding-agent';
+import { listInstalledPlugins } from './plugin-installs.js';
+export function loadPluginCatalog({ claudeDir, agentDir = getAgentDir() }) {
+    const plugins = listInstalledPlugins({ claudeDir, agentDir })
+        .filter(({ enabled, shadowed }) => enabled && !shadowed)
+        .map(({ plugin }) => plugin);
+    return {
+        enabled: () => plugins,
+        find: (name) => {
+            const plugin = plugins.find((candidate) => candidate.name === name);
+            return plugin === undefined ? { kind: 'missing' } : { kind: 'found', plugin };
+        },
+    };
+}
+//# sourceMappingURL=plugin-catalog.js.map

package/dist/kernel/plugin-catalog/plugin-catalog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-catalog.js","sourceRoot":"","sources":["../../../src/kernel/plugin-catalog/plugin-catalog.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAC;AAC9D,OAAO,EAAE,oBAAoB,EAAsB,MAAM,sBAAsB,CAAC;AAgBhF,MAAM,UAAU,iBAAiB,CAAC,EAAE,SAAS,EAAE,QAAQ,GAAG,WAAW,EAAE,EAAgB;IACrF,MAAM,OAAO,GAAG,oBAAoB,CAAC,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC;SAC1D,MAAM,CAAC,CAAC,EAAE,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC,OAAO,IAAI,CAAC,QAAQ,CAAC;SACvD,GAAG,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC;IAC/B,OAAO;QACL,OAAO,EAAE,GAAG,EAAE,CAAC,OAAO;QACtB,IAAI,EAAE,CAAC,IAAI,EAAE,EAAE;YACb,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;YACpE,OAAO,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;QAChF,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/kernel/plugin-catalog/plugin-installs.d.ts

@@ -0,0 +1,20 @@
+import { type PluginManifestView } from './manifest-view.js';
+export interface InstallPaths {
+    readonly claudeDir: string;
+    readonly agentDir: string;
+}
+export interface CatalogPlugin {
+    readonly id: string;
+    readonly name: string;
+    readonly root: string;
+    readonly version: string;
+    readonly dataDir: string;
+    readonly origin: 'own' | 'claude-code';
+    readonly manifest: PluginManifestView;
+}
+export interface ListedPlugin {
+    readonly plugin: CatalogPlugin;
+    readonly enabled: boolean;
+    readonly shadowed: boolean;
+}
+export declare function listInstalledPlugins({ claudeDir, agentDir }: InstallPaths): readonly ListedPlugin[];

package/dist/kernel/plugin-catalog/plugin-installs.js

@@ -0,0 +1,40 @@
+import { basename } from 'node:path';
+import { installedPluginEntries } from '../claude-home/installed-plugins.js';
+import { marketplaceQualifiedId, pluginDataDir } from '../claude-home/plugin-layout.js';
+import { isPlainDirectoryName } from '../claude-home/skill-mirror-layout.js';
+import { userSettingsPath } from '../claude-home/user-settings.js';
+import { readJsonObjectLeniently } from '../private-files/private-files.js';
+import { enabledPluginsOf, isEnabled } from './enablement.js';
+import { readManifestView } from './manifest-view.js';
+import { ownInstalls } from './own-installs.js';
+export function listInstalledPlugins({ claudeDir, agentDir }) {
+    const own = ownInstalls(agentDir).map(listedOwnInstall);
+    const ownNames = new Set(own.map(({ plugin }) => plugin.name));
+    const fromClaudeCode = claudeCodeInstalls(claudeDir).map((listed) => ({ ...listed, shadowed: ownNames.has(listed.plugin.name) }));
+    return [...own, ...fromClaudeCode];
+}
+function listedOwnInstall({ name, root, sha, dataDir, enabled }) {
+    const plugin = { id: name, name, root, version: sha, dataDir, origin: 'own', manifest: readManifestView(root) };
+    return { plugin, enabled, shadowed: false };
+}
+function claudeCodeInstalls(claudeDir) {
+    const settings = enabledPluginsOf(readJsonObjectLeniently(userSettingsPath(claudeDir)));
+    return installedPluginEntries(claudeDir)
+        .filter(({ name }) => isPlainDirectoryName(name))
+        .map((entry) => listedClaudeCodeInstall(claudeDir, entry, settings));
+}
+function listedClaudeCodeInstall(claudeDir, entry, settings) {
+    const id = marketplaceQualifiedId(entry.directory, entry.marketplace);
+    const manifest = readManifestView(entry.root);
+    const plugin = {
+        id,
+        name: entry.name,
+        root: entry.root,
+        version: basename(entry.root),
+        dataDir: pluginDataDir(claudeDir, id),
+        origin: 'claude-code',
+        manifest,
+    };
+    return { plugin, enabled: isEnabled(id, settings, manifest.defaultEnabled), shadowed: false };
+}
+//# sourceMappingURL=plugin-installs.js.map

package/dist/kernel/plugin-catalog/plugin-installs.js.map

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

package/dist/kernel/plugin-config/config-paths.d.ts

@@ -0,0 +1,10 @@
+export interface ConfigFolders {
+    readonly agentDir: string;
+    readonly claudeDir: string;
+}
+export interface ConfigPaths {
+    readonly valuesFile: string;
+    readonly secretsFile: string;
+    readonly claudeDir: string;
+}
+export declare const configPathsFor: ({ agentDir, claudeDir }: ConfigFolders) => ConfigPaths;

package/dist/kernel/plugin-config/config-paths.js

@@ -0,0 +1,10 @@
+import { join } from 'node:path';
+import { installRoot } from '../plugin-install/install-layout.js';
+const VALUES_FILE_NAME = 'plugin-config.json';
+const SECRETS_FILE_NAME = 'pi-claude-secrets.json';
+export const configPathsFor = ({ agentDir, claudeDir }) => ({
+    valuesFile: join(installRoot(agentDir), VALUES_FILE_NAME),
+    secretsFile: join(agentDir, SECRETS_FILE_NAME),
+    claudeDir,
+});
+//# sourceMappingURL=config-paths.js.map

package/dist/kernel/plugin-config/config-paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-paths.js","sourceRoot":"","sources":["../../../src/kernel/plugin-config/config-paths.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,WAAW,EAAE,MAAM,qCAAqC,CAAC;AAElE,MAAM,gBAAgB,GAAG,oBAAoB,CAAC;AAC9C,MAAM,iBAAiB,GAAG,wBAAwB,CAAC;AAanD,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,EAAE,QAAQ,EAAE,SAAS,EAAiB,EAAe,EAAE,CAAC,CAAC;IACtF,UAAU,EAAE,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,EAAE,gBAAgB,CAAC;IACzD,WAAW,EAAE,IAAI,CAAC,QAAQ,EAAE,iBAAiB,CAAC;IAC9C,SAAS;CACV,CAAC,CAAC"}

package/dist/kernel/plugin-config/config-store.d.ts

@@ -0,0 +1,13 @@
+import type { ConfigPaths } from './config-paths.js';
+import type { OptionValue, UserConfigOption } from './user-config-option.js';
+export interface ConfiguredPlugin {
+    readonly name: string;
+    readonly options: readonly UserConfigOption[];
+}
+export type PluginOptionValues = Readonly<Record<string, OptionValue>>;
+export declare class PluginConfigStore {
+    #private;
+    constructor(paths: ConfigPaths);
+    valuesFor(plugin: ConfiguredPlugin): PluginOptionValues;
+    save(plugin: ConfiguredPlugin, values: PluginOptionValues): void;
+}

package/dist/kernel/plugin-config/config-store.js

@@ -0,0 +1,46 @@
+import { userSettingsPath } from '../claude-home/user-settings.js';
+import { isJsonObject, readJsonObject, readJsonObjectLeniently, writeJsonAtomically } from '../private-files/private-files.js';
+const isSensitive = ({ sensitive }) => sensitive;
+const isPlain = ({ sensitive }) => !sensitive;
+export class PluginConfigStore {
+    #paths;
+    constructor(paths) {
+        this.#paths = paths;
+    }
+    valuesFor(plugin) {
+        const plain = plugin.options.filter(isPlain);
+        return {
+            ...pickedFrom(plain, claudeCodeOptions(this.#paths.claudeDir, plugin.name)),
+            ...this.#stored(this.#paths.valuesFile, plugin.name, plain),
+            ...this.#stored(this.#paths.secretsFile, plugin.name, plugin.options.filter(isSensitive)),
+        };
+    }
+    save(plugin, values) {
+        const given = plugin.options.filter(({ key }) => Object.hasOwn(values, key));
+        this.#store(this.#paths.valuesFile, plugin.name, given.filter(isPlain), values);
+        this.#store(this.#paths.secretsFile, plugin.name, given.filter(isSensitive), values);
+    }
+    #stored(file, plugin, options) {
+        return options.length === 0 ? {} : pickedFrom(options, savedEntry(readJsonObject(file), plugin));
+    }
+    #store(file, plugin, options, values) {
+        if (options.length === 0) {
+            return;
+        }
+        const everything = readJsonObject(file);
+        writeJsonAtomically(file, { ...everything, [plugin]: { ...savedEntry(everything, plugin), ...pickedFrom(options, values) } });
+    }
+}
+const savedEntry = (file, plugin) => {
+    const entry = file[plugin];
+    return isJsonObject(entry) ? entry : {};
+};
+const isOptionValue = (value) => typeof value === 'string' || typeof value === 'boolean' || (typeof value === 'number' && Number.isFinite(value));
+const pickedFrom = (options, source) => Object.fromEntries(options.flatMap(({ key }) => (Object.hasOwn(source, key) && isOptionValue(source[key]) ? [[key, source[key]]] : [])));
+function claudeCodeOptions(claudeDir, plugin) {
+    const configs = readJsonObjectLeniently(userSettingsPath(claudeDir)).pluginConfigs;
+    const saved = isJsonObject(configs) ? savedEntry(configs, claudeCodeIdOf(configs, plugin)) : {};
+    return isJsonObject(saved.options) ? saved.options : {};
+}
+const claudeCodeIdOf = (configs, plugin) => Object.keys(configs).find((candidate) => candidate === plugin || candidate.startsWith(`${plugin}@`)) ?? plugin;
+//# sourceMappingURL=config-store.js.map

package/dist/kernel/plugin-config/config-store.js.map

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

package/dist/kernel/plugin-config/configure-options.d.ts

@@ -0,0 +1,12 @@
+import type { ConfiguredPlugin, PluginConfigStore } from './config-store.js';
+import type { UserConfigOption } from './user-config-option.js';
+export interface OptionPrompter {
+    ask(option: UserConfigOption): Promise<string | undefined>;
+    refuse(message: string): void;
+}
+export interface ConfigureOutcome {
+    readonly saved: readonly string[];
+    readonly declined: boolean;
+}
+export type ConfigureScope = 'unset' | 'all';
+export declare function configureOptions(plugin: ConfiguredPlugin, prompter: OptionPrompter, store: PluginConfigStore, scope: ConfigureScope): Promise<ConfigureOutcome>;

package/dist/kernel/plugin-config/configure-options.js

@@ -0,0 +1,41 @@
+import { InvalidOptionValueError } from './errors.js';
+import { validateOptionValue } from './option-schema.js';
+export async function configureOptions(plugin, prompter, store, scope) {
+    const saved = [];
+    for (const option of optionsToAsk(plugin, store, scope)) {
+        const reply = await askUntilValid(option, prompter);
+        if (reply.kind === 'dismissed') {
+            return { saved, declined: true };
+        }
+        if (reply.kind === 'value') {
+            store.save(plugin, { [option.key]: reply.value });
+            saved.push(option.key);
+        }
+    }
+    return { saved, declined: false };
+}
+function optionsToAsk(plugin, store, scope) {
+    if (scope === 'all') {
+        return plugin.options;
+    }
+    const alreadySet = store.valuesFor(plugin);
+    return plugin.options.filter(({ key }) => !Object.hasOwn(alreadySet, key));
+}
+async function askUntilValid(option, prompter) {
+    for (;;) {
+        const raw = await prompter.ask(option);
+        if (raw === undefined) {
+            return { kind: 'dismissed' };
+        }
+        try {
+            return validateOptionValue(option, raw);
+        }
+        catch (error) {
+            if (!(error instanceof InvalidOptionValueError)) {
+                throw error;
+            }
+            prompter.refuse(error.message);
+        }
+    }
+}
+//# sourceMappingURL=configure-options.js.map

package/dist/kernel/plugin-config/configure-options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"configure-options.js","sourceRoot":"","sources":["../../../src/kernel/plugin-config/configure-options.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AACtD,OAAO,EAAE,mBAAmB,EAAqB,MAAM,oBAAoB,CAAC;AAkB5E,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,MAAwB,EAAE,QAAwB,EAAE,KAAwB,EAAE,KAAqB;IACxI,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,MAAM,MAAM,IAAI,YAAY,CAAC,MAAM,EAAE,KAAK,EAAE,KAAK,CAAC,EAAE,CAAC;QACxD,MAAM,KAAK,GAAG,MAAM,aAAa,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;QACpD,IAAI,KAAK,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;YAC/B,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;QACnC,CAAC;QACD,IAAI,KAAK,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;YAC3B,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC;YAClD,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACzB,CAAC;IACH,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;AACpC,CAAC;AAED,SAAS,YAAY,CAAC,MAAwB,EAAE,KAAwB,EAAE,KAAqB;IAC7F,IAAI,KAAK,KAAK,KAAK,EAAE,CAAC;QACpB,OAAO,MAAM,CAAC,OAAO,CAAC;IACxB,CAAC;IACD,MAAM,UAAU,GAAG,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IAC3C,OAAO,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,EAAE,GAAG,EAAE,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC,CAAC;AAC7E,CAAC;AAED,KAAK,UAAU,aAAa,CAAC,MAAwB,EAAE,QAAwB;IAC7E,SAAS,CAAC;QACR,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACvC,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;YACtB,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC;QAC/B,CAAC;QACD,IAAI,CAAC;YACH,OAAO,mBAAmB,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QAC1C,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,CAAC,KAAK,YAAY,uBAAuB,CAAC,EAAE,CAAC;gBAChD,MAAM,KAAK,CAAC;YACd,CAAC;YACD,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QACjC,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/kernel/plugin-config/errors.d.ts

@@ -0,0 +1,4 @@
+import { AntharaError } from '../../errors/anthara-error.js';
+export declare class InvalidOptionValueError extends AntharaError {
+    constructor(key: string, problem: string);
+}

package/dist/kernel/plugin-config/errors.js

@@ -0,0 +1,7 @@
+import { AntharaError } from '../../errors/anthara-error.js';
+export class InvalidOptionValueError extends AntharaError {
+    constructor(key, problem) {
+        super(`The value for option "${key}" is refused: ${problem}.`);
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/kernel/plugin-config/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../src/kernel/plugin-config/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAE7D,MAAM,OAAO,uBAAwB,SAAQ,YAAY;IACvD,YAAY,GAAW,EAAE,OAAe;QACtC,KAAK,CAAC,yBAAyB,GAAG,iBAAiB,OAAO,GAAG,CAAC,CAAC;IACjE,CAAC;CACF"}

package/dist/kernel/plugin-config/option-schema.d.ts

@@ -0,0 +1,8 @@
+import type { OptionValue, UserConfigOption } from './user-config-option.js';
+export type OptionAnswer = {
+    readonly kind: 'value';
+    readonly value: OptionValue;
+} | {
+    readonly kind: 'skipped';
+};
+export declare function validateOptionValue(option: UserConfigOption, raw: string): OptionAnswer;

package/dist/kernel/plugin-config/option-schema.js

@@ -0,0 +1,56 @@
+import { InvalidOptionValueError } from './errors.js';
+const BOOLEAN_TEXTS = { true: true, false: false };
+export function validateOptionValue(option, raw) {
+    if (raw === '') {
+        return blankAnswer(option);
+    }
+    const value = VALUE_READERS[option.type](option, raw);
+    assertOffered(option, value);
+    return { kind: 'value', value };
+}
+function blankAnswer(option) {
+    if (option.default !== undefined) {
+        return { kind: 'value', value: option.default };
+    }
+    if (option.required) {
+        throw new InvalidOptionValueError(option.key, 'it is required');
+    }
+    return { kind: 'skipped' };
+}
+const readText = (_option, raw) => raw;
+const readBoolean = (option, raw) => {
+    const value = BOOLEAN_TEXTS[raw.toLowerCase()];
+    if (value === undefined) {
+        throw new InvalidOptionValueError(option.key, 'it must be true or false');
+    }
+    return value;
+};
+const readNumber = (option, raw) => {
+    const value = Number(raw);
+    if (raw.trim() === '' || !Number.isFinite(value)) {
+        throw new InvalidOptionValueError(option.key, 'it must be a number');
+    }
+    assertWithinBounds(option, value);
+    return value;
+};
+const VALUE_READERS = {
+    string: readText,
+    directory: readText,
+    file: readText,
+    boolean: readBoolean,
+    number: readNumber,
+};
+function assertWithinBounds({ key, min, max }, value) {
+    if (min !== undefined && value < min) {
+        throw new InvalidOptionValueError(key, `it must be at least ${String(min)}`);
+    }
+    if (max !== undefined && value > max) {
+        throw new InvalidOptionValueError(key, `it must be at most ${String(max)}`);
+    }
+}
+function assertOffered({ key, options }, value) {
+    if (options !== undefined && !options.includes(String(value))) {
+        throw new InvalidOptionValueError(key, 'it must be one of the offered options');
+    }
+}
+//# sourceMappingURL=option-schema.js.map

package/dist/kernel/plugin-config/option-schema.js.map

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

package/dist/kernel/plugin-config/session-resolver.d.ts

@@ -0,0 +1,2 @@
+import { UserConfigResolver } from './user-config-resolver.js';
+export declare const sessionUserConfigResolver: () => UserConfigResolver;

package/dist/kernel/plugin-config/session-resolver.js

@@ -0,0 +1,8 @@
+import { homedir } from 'node:os';
+import { getAgentDir } from '@earendil-works/pi-coding-agent';
+import { claudeConfigDir } from '../claude-home/config-dir.js';
+import { configPathsFor } from './config-paths.js';
+import { PluginConfigStore } from './config-store.js';
+import { UserConfigResolver } from './user-config-resolver.js';
+export const sessionUserConfigResolver = () => new UserConfigResolver(new PluginConfigStore(configPathsFor({ agentDir: getAgentDir(), claudeDir: claudeConfigDir(process.env, homedir()) })));
+//# sourceMappingURL=session-resolver.js.map

package/dist/kernel/plugin-config/session-resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-resolver.js","sourceRoot":"","sources":["../../../src/kernel/plugin-config/session-resolver.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAC;AAC9D,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAC/D,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAE/D,MAAM,CAAC,MAAM,yBAAyB,GAAG,GAAuB,EAAE,CAChE,IAAI,kBAAkB,CAAC,IAAI,iBAAiB,CAAC,cAAc,CAAC,EAAE,QAAQ,EAAE,WAAW,EAAE,EAAE,SAAS,EAAE,eAAe,CAAC,OAAO,CAAC,GAAG,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC"}

package/dist/kernel/plugin-config/shell-reference-check.d.ts

@@ -0,0 +1 @@
+export declare const referencesUserConfig: (command: string) => boolean;

package/dist/kernel/plugin-config/shell-reference-check.js

@@ -0,0 +1,3 @@
+const USER_CONFIG_REFERENCE = /\$\{user_config\./;
+export const referencesUserConfig = (command) => USER_CONFIG_REFERENCE.test(command);
+//# sourceMappingURL=shell-reference-check.js.map

package/dist/kernel/plugin-config/shell-reference-check.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shell-reference-check.js","sourceRoot":"","sources":["../../../src/kernel/plugin-config/shell-reference-check.ts"],"names":[],"mappings":"AAAA,MAAM,qBAAqB,GAAG,mBAAmB,CAAC;AAElD,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,OAAe,EAAW,EAAE,CAAC,qBAAqB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC"}

package/dist/kernel/plugin-config/user-config-option.d.ts

@@ -0,0 +1,15 @@
+export type OptionType = 'string' | 'number' | 'boolean' | 'directory' | 'file';
+export type OptionValue = string | number | boolean;
+export interface UserConfigOption {
+    readonly key: string;
+    readonly title: string;
+    readonly description: string;
+    readonly type: OptionType;
+    readonly required: boolean;
+    readonly sensitive: boolean;
+    readonly default?: OptionValue;
+    readonly min?: number;
+    readonly max?: number;
+    readonly options?: readonly string[];
+}
+export declare function userConfigOptionsOf(declared: unknown): readonly UserConfigOption[];

package/dist/kernel/plugin-config/user-config-option.js

@@ -0,0 +1,35 @@
+import { isJsonObject } from '../private-files/private-files.js';
+const REFERENCABLE_KEY = /^\w+$/;
+const OPTION_TYPES = new Set(['string', 'number', 'boolean', 'directory', 'file']);
+export function userConfigOptionsOf(declared) {
+    if (!isJsonObject(declared)) {
+        return [];
+    }
+    return Object.entries(declared)
+        .filter((entry) => REFERENCABLE_KEY.test(entry[0]) && isJsonObject(entry[1]))
+        .map(([key, entry]) => optionOf(key, entry));
+}
+function optionOf(key, entry) {
+    return {
+        key,
+        title: textOr(entry.title, key),
+        description: textOr(entry.description, ''),
+        type: typeOf(entry.type),
+        required: entry.required === true,
+        sensitive: entry.sensitive === true,
+        ...present('default', optionValueOf(entry.default)),
+        ...present('min', numberOf(entry.min)),
+        ...present('max', numberOf(entry.max)),
+        ...present('options', choicesOf(entry.options)),
+    };
+}
+const present = (key, value) => value === undefined ? {} : { [key]: value };
+const textOr = (value, fallback) => (typeof value === 'string' ? value : fallback);
+const typeOf = (value) => (typeof value === 'string' && OPTION_TYPES.has(value) ? value : 'string');
+const numberOf = (value) => (typeof value === 'number' && Number.isFinite(value) ? value : undefined);
+const optionValueOf = (value) => typeof value === 'string' || typeof value === 'boolean' || numberOf(value) !== undefined ? value : undefined;
+function choicesOf(value) {
+    const choices = Array.isArray(value) ? value.filter((choice) => typeof choice === 'string') : [];
+    return choices.length === 0 ? undefined : choices;
+}
+//# sourceMappingURL=user-config-option.js.map

package/dist/kernel/plugin-config/user-config-option.js.map

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

package/dist/kernel/plugin-config/user-config-resolver.d.ts

@@ -0,0 +1,15 @@
+import type { PluginConfigStore } from './config-store.js';
+import { type UserConfigOption } from './user-config-option.js';
+export type SubstitutionTarget = 'mcp' | 'hook-args' | 'body';
+export interface ConfigSubject {
+    readonly name: string;
+    readonly root: string;
+}
+export declare class UserConfigResolver {
+    #private;
+    constructor(store: PluginConfigStore);
+    optionsOf({ root }: ConfigSubject): readonly UserConfigOption[];
+    unsetOptions(subject: ConfigSubject): readonly UserConfigOption[];
+    substitute(text: string, subject: ConfigSubject, target: SubstitutionTarget): string;
+    optionEnvironment(subject: ConfigSubject): Readonly<Record<string, string>>;
+}

package/dist/kernel/plugin-config/user-config-resolver.js

@@ -0,0 +1,46 @@
+import { readManifestView } from '../plugin-catalog/manifest-view.js';
+import { referencesUserConfig } from './shell-reference-check.js';
+import { userConfigOptionsOf } from './user-config-option.js';
+const USER_CONFIG_REFERENCE = /\$\{user_config\.(\w+)\}/g;
+const SENSITIVE_PLACEHOLDER = '[sensitive value]';
+const OPTION_VARIABLE_PREFIX = 'CLAUDE_PLUGIN_OPTION_';
+export class UserConfigResolver {
+    #store;
+    constructor(store) {
+        this.#store = store;
+    }
+    optionsOf({ root }) {
+        return userConfigOptionsOf(readManifestView(root).declaredValue('userConfig'));
+    }
+    unsetOptions(subject) {
+        const options = this.optionsOf(subject);
+        const saved = this.#store.valuesFor({ name: subject.name, options });
+        return options.filter(({ key }) => !Object.hasOwn(saved, key));
+    }
+    substitute(text, subject, target) {
+        if (!referencesUserConfig(text)) {
+            return text;
+        }
+        const options = this.optionsOf(subject);
+        const values = this.#effectiveValues(subject, options);
+        return text.replace(USER_CONFIG_REFERENCE, (_reference, key) => replacementFor(options.find((option) => option.key === key), values, target));
+    }
+    optionEnvironment(subject) {
+        const values = this.#effectiveValues(subject, this.optionsOf(subject));
+        return Object.fromEntries(Object.entries(values).map(([key, value]) => [`${OPTION_VARIABLE_PREFIX}${key.toUpperCase()}`, String(value)]));
+    }
+    #effectiveValues(subject, options) {
+        return { ...defaultsOf(options), ...this.#store.valuesFor({ name: subject.name, options }) };
+    }
+}
+function replacementFor(option, values, target) {
+    if (option === undefined) {
+        return '';
+    }
+    if (option.sensitive && target === 'body') {
+        return SENSITIVE_PLACEHOLDER;
+    }
+    return Object.hasOwn(values, option.key) ? String(values[option.key]) : '';
+}
+const defaultsOf = (options) => Object.fromEntries(options.flatMap(({ key, default: fallback }) => (fallback === undefined ? [] : [[key, fallback]])));
+//# sourceMappingURL=user-config-resolver.js.map

package/dist/kernel/plugin-config/user-config-resolver.js.map

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

package/dist/kernel/plugin-install/adopt-install.d.ts

@@ -0,0 +1,11 @@
+import type { InstalledSource } from './install-record.js';
+import type { Sha } from './sha.js';
+import { type RenameDirectory } from './staging.js';
+export interface AdoptedInstall {
+    readonly name: string;
+    readonly source: InstalledSource;
+    readonly sha: Sha;
+    readonly enabled: boolean;
+    readonly dir: string;
+}
+export declare function adoptInstall(root: string, install: AdoptedInstall, renameDirectory?: RenameDirectory): void;

package/dist/kernel/plugin-install/adopt-install.js

@@ -0,0 +1,26 @@
+import { renameSync } from 'node:fs';
+import { removeWithin } from '../private-files/confined-removal.js';
+import { InvalidPluginNameError } from './errors.js';
+import { indexPath, stagingDir } from './install-layout.js';
+import { readOwnIndex, withEntry, writeOwnIndex } from './own-install-index.js';
+import { isPluginName } from './plugin-manifest.js';
+import { promote, stageCopy } from './staging.js';
+export function adoptInstall(root, install, renameDirectory = renameSync) {
+    const { name, source, sha, enabled } = install;
+    if (!isPluginName(name)) {
+        throw new InvalidPluginNameError(name);
+    }
+    const index = readOwnIndex(indexPath(root));
+    if (index.plugins[name] !== undefined) {
+        return;
+    }
+    const staged = stageCopy(install.dir, stagingDir(root));
+    try {
+        promote({ dir: staged, name, sha }, root, renameDirectory);
+    }
+    finally {
+        removeWithin(stagingDir(root), staged);
+    }
+    writeOwnIndex(indexPath(root), withEntry(index, name, { source, sha, enabled }));
+}
+//# sourceMappingURL=adopt-install.js.map