@vibesdotdev/external 0.0.0-stage → 1.0.0-rc.0

package/dist/plugins/installers/config-value.d.ts

@@ -0,0 +1,35 @@
+/**
+ * The value contract of a host config document (JSON, JSONC or TOML), as the
+ * MCP installers read and edit it.
+ *
+ * A parsed config is a tree of JSON values. Keys come from user files and
+ * userland manifests (`mcpPath`, server names), so every read here is an own-
+ * property read and every write defines an own data property: `__proto__`,
+ * `constructor` or `toString` are ordinary keys and never reach a prototype.
+ */
+import * as z from 'zod/v4';
+/** One config value: a JSON value (TOML values are a subset). */
+export type ConfigValue = string | number | boolean | null | ConfigValue[] | ConfigObject;
+/** A config object: string keys to config values. */
+export interface ConfigObject {
+    [key: string]: ConfigValue;
+}
+/** A JSON document whose root is an object. */
+export declare const ConfigObjectSchema: z.ZodType<ConfigObject>;
+/** Whether a config value is an object (not an array, not null). */
+export declare function isConfigObject(value: ConfigValue | undefined): value is ConfigObject;
+/** Whether a config value is a string. */
+export declare function isConfigString(value: ConfigValue | undefined): value is string;
+/** Whether a config value is a number. */
+export declare function isConfigNumber(value: ConfigValue | undefined): value is number;
+/** `object[key]` only when it is the object's own property. */
+export declare function ownValue(object: ConfigObject, key: string): ConfigValue | undefined;
+/** `object[key]` when it is an own config object. */
+export declare function ownObject(object: ConfigObject, key: string): ConfigObject | undefined;
+/** Define `key` on `object` as an own data property, never through a prototype setter. */
+export declare function setOwn(object: ConfigObject, key: string, value: ConfigValue): void;
+/** Remove an own `key`; `false` when the object had none. */
+export declare function deleteOwn(object: ConfigObject, key: string): boolean;
+/** A shallow copy as a fresh own-property object. */
+export declare function copyConfigObject(object: ConfigObject): ConfigObject;
+//# sourceMappingURL=config-value.d.ts.map

package/dist/plugins/installers/config-value.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-value.d.ts","sourceRoot":"","sources":["../../../src/plugins/installers/config-value.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAE5B,iEAAiE;AACjE,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,WAAW,EAAE,GAAG,YAAY,CAAC;AAE1F,qDAAqD;AACrD,MAAM,WAAW,YAAY;IAC5B,CAAC,GAAG,EAAE,MAAM,GAAG,WAAW,CAAC;CAC3B;AAED,+CAA+C;AAC/C,eAAO,MAAM,kBAAkB,EAAE,CAAC,CAAC,OAAO,CAAC,YAAY,CAAyC,CAAC;AAEjG,oEAAoE;AACpE,wBAAgB,cAAc,CAAC,KAAK,EAAE,WAAW,GAAG,SAAS,GAAG,KAAK,IAAI,YAAY,CAEpF;AAED,0CAA0C;AAC1C,wBAAgB,cAAc,CAAC,KAAK,EAAE,WAAW,GAAG,SAAS,GAAG,KAAK,IAAI,MAAM,CAE9E;AAED,0CAA0C;AAC1C,wBAAgB,cAAc,CAAC,KAAK,EAAE,WAAW,GAAG,SAAS,GAAG,KAAK,IAAI,MAAM,CAE9E;AAED,+DAA+D;AAC/D,wBAAgB,QAAQ,CAAC,MAAM,EAAE,YAAY,EAAE,GAAG,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAEnF;AAED,qDAAqD;AACrD,wBAAgB,SAAS,CAAC,MAAM,EAAE,YAAY,EAAE,GAAG,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAGrF;AAED,0FAA0F;AAC1F,wBAAgB,MAAM,CAAC,MAAM,EAAE,YAAY,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,GAAG,IAAI,CAElF;AAED,6DAA6D;AAC7D,wBAAgB,SAAS,CAAC,MAAM,EAAE,YAAY,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAGpE;AAED,qDAAqD;AACrD,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,YAAY,GAAG,YAAY,CAInE"}

package/dist/plugins/installers/config-value.js

@@ -0,0 +1,52 @@
+/**
+ * The value contract of a host config document (JSON, JSONC or TOML), as the
+ * MCP installers read and edit it.
+ *
+ * A parsed config is a tree of JSON values. Keys come from user files and
+ * userland manifests (`mcpPath`, server names), so every read here is an own-
+ * property read and every write defines an own data property: `__proto__`,
+ * `constructor` or `toString` are ordinary keys and never reach a prototype.
+ */
+import { JsonValueSchema } from '@vibesdotdev/kernel/schemas/json';
+import * as z from 'zod/v4';
+/** A JSON document whose root is an object. */
+export const ConfigObjectSchema = z.record(z.string(), JsonValueSchema);
+/** Whether a config value is an object (not an array, not null). */
+export function isConfigObject(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+/** Whether a config value is a string. */
+export function isConfigString(value) {
+    return typeof value === 'string';
+}
+/** Whether a config value is a number. */
+export function isConfigNumber(value) {
+    return typeof value === 'number';
+}
+/** `object[key]` only when it is the object's own property. */
+export function ownValue(object, key) {
+    return Object.hasOwn(object, key) ? object[key] : undefined;
+}
+/** `object[key]` when it is an own config object. */
+export function ownObject(object, key) {
+    const value = ownValue(object, key);
+    return isConfigObject(value) ? value : undefined;
+}
+/** Define `key` on `object` as an own data property, never through a prototype setter. */
+export function setOwn(object, key, value) {
+    Object.defineProperty(object, key, { value, writable: true, enumerable: true, configurable: true });
+}
+/** Remove an own `key`; `false` when the object had none. */
+export function deleteOwn(object, key) {
+    if (!Object.hasOwn(object, key))
+        return false;
+    return Reflect.deleteProperty(object, key);
+}
+/** A shallow copy as a fresh own-property object. */
+export function copyConfigObject(object) {
+    const copy = {};
+    for (const [key, value] of Object.entries(object))
+        setOwn(copy, key, value);
+    return copy;
+}
+//# sourceMappingURL=config-value.js.map

package/dist/plugins/installers/config-value.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-value.js","sourceRoot":"","sources":["../../../src/plugins/installers/config-value.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,kCAAkC,CAAC;AACnE,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAU5B,+CAA+C;AAC/C,MAAM,CAAC,MAAM,kBAAkB,GAA4B,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,eAAe,CAAC,CAAC;AAEjG,oEAAoE;AACpE,MAAM,UAAU,cAAc,CAAC,KAA8B;IAC5D,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC7E,CAAC;AAED,0CAA0C;AAC1C,MAAM,UAAU,cAAc,CAAC,KAA8B;IAC5D,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC;AAClC,CAAC;AAED,0CAA0C;AAC1C,MAAM,UAAU,cAAc,CAAC,KAA8B;IAC5D,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC;AAClC,CAAC;AAED,+DAA+D;AAC/D,MAAM,UAAU,QAAQ,CAAC,MAAoB,EAAE,GAAW;IACzD,OAAO,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AAC7D,CAAC;AAED,qDAAqD;AACrD,MAAM,UAAU,SAAS,CAAC,MAAoB,EAAE,GAAW;IAC1D,MAAM,KAAK,GAAG,QAAQ,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACpC,OAAO,cAAc,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;AAClD,CAAC;AAED,0FAA0F;AAC1F,MAAM,UAAU,MAAM,CAAC,MAAoB,EAAE,GAAW,EAAE,KAAkB;IAC3E,MAAM,CAAC,cAAc,CAAC,MAAM,EAAE,GAAG,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC,CAAC;AACrG,CAAC;AAED,6DAA6D;AAC7D,MAAM,UAAU,SAAS,CAAC,MAAoB,EAAE,GAAW;IAC1D,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;QAAE,OAAO,KAAK,CAAC;IAC9C,OAAO,OAAO,CAAC,cAAc,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;AAC5C,CAAC;AAED,qDAAqD;AACrD,MAAM,UAAU,gBAAgB,CAAC,MAAoB;IACpD,MAAM,IAAI,GAAiB,EAAE,CAAC;IAC9B,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC;QAAE,MAAM,CAAC,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC;IAC5E,OAAO,IAAI,CAAC;AACb,CAAC"}

package/dist/plugins/installers/hooks/index.d.ts

@@ -0,0 +1,9 @@
+export { ShellHooksInstaller } from './shell-installer.ts';
+export { registerHooksInJsonSettings, unregisterHooksFromJsonSettings, canRegisterInSettings, isManagedEntry } from './settings-registration.ts';
+export { resolveScopedHooksDir, resolveScopedSettingsPath } from './scoped-paths.ts';
+export { backupSettingsBeforeUninstall } from './uninstall-backup.ts';
+import type { VibesRuntime } from '@vibesdotdev/kernel';
+import type { HooksInstaller } from '../types.ts';
+export declare function getHooksInstaller(format: string, runtime: VibesRuntime): Promise<HooksInstaller | undefined>;
+export declare function getAllHooksInstallers(runtime: VibesRuntime): Promise<HooksInstaller[]>;
+//# sourceMappingURL=index.d.ts.map

package/dist/plugins/installers/hooks/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/plugins/installers/hooks/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,EACN,2BAA2B,EAC3B,+BAA+B,EAC/B,qBAAqB,EACrB,cAAc,EACd,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,qBAAqB,EAAE,yBAAyB,EAAE,MAAM,mBAAmB,CAAC;AACrF,OAAO,EAAE,6BAA6B,EAAE,MAAM,uBAAuB,CAAC;AAEtE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAMlD,wBAAgB,iBAAiB,CAChC,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,YAAY,GACnB,OAAO,CAAC,cAAc,GAAG,SAAS,CAAC,CAErC;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC,CAEtF"}

package/dist/plugins/installers/hooks/index.js

@@ -0,0 +1,12 @@
+export { ShellHooksInstaller } from "./shell-installer.js";
+export { registerHooksInJsonSettings, unregisterHooksFromJsonSettings, canRegisterInSettings, isManagedEntry } from "./settings-registration.js";
+export { resolveScopedHooksDir, resolveScopedSettingsPath } from "./scoped-paths.js";
+export { backupSettingsBeforeUninstall } from "./uninstall-backup.js";
+import { listExternalConfigInstallers, resolveExternalConfigInstaller } from "../runtime.js";
+export function getHooksInstaller(format, runtime) {
+    return resolveExternalConfigInstaller('hooks', format, runtime);
+}
+export function getAllHooksInstallers(runtime) {
+    return listExternalConfigInstallers('hooks', runtime);
+}
+//# sourceMappingURL=index.js.map

package/dist/plugins/installers/hooks/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/plugins/installers/hooks/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,EACN,2BAA2B,EAC3B,+BAA+B,EAC/B,qBAAqB,EACrB,cAAc,EACd,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,qBAAqB,EAAE,yBAAyB,EAAE,MAAM,mBAAmB,CAAC;AACrF,OAAO,EAAE,6BAA6B,EAAE,MAAM,uBAAuB,CAAC;AAItE,OAAO,EACN,4BAA4B,EAC5B,8BAA8B,EAC9B,MAAM,eAAe,CAAC;AAEvB,MAAM,UAAU,iBAAiB,CAChC,MAAc,EACd,OAAqB;IAErB,OAAO,8BAA8B,CAAiB,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;AACjF,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,OAAqB;IAC1D,OAAO,4BAA4B,CAAiB,OAAO,EAAE,OAAO,CAAC,CAAC;AACvE,CAAC"}

package/dist/plugins/installers/hooks/scoped-paths.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Resolve project vs global hook script + settings paths for a manifest.
+ *
+ * Some tools declare:
+ * - `assets.hooks` under `${HOME}/...` (global-shaped)
+ * - `assets.settings` as project-relative (`.tool/settings.local.json`)
+ *
+ * A naive resolve writes project installs' scripts to $HOME while registering
+ * settings under the project — split brain. When `global` is false and settings
+ * are project-relative, co-locate hooks next to that settings file. When
+ * `global` is true and settings are project-relative, lift settings into
+ * `detection.configDir` (or the dirname of the resolved global hooks path).
+ */
+import type { ExternalHostManifest } from '../../schemas/manifest.ts';
+import type { ExternalInstallRoots } from '../types.ts';
+/**
+ * Absolute hooks directory for this install scope.
+ */
+export declare function resolveScopedHooksDir(manifest: ExternalHostManifest, global: boolean, roots: ExternalInstallRoots, override?: string): string;
+/**
+ * Absolute settings path for this install scope, or undefined if none declared.
+ */
+export declare function resolveScopedSettingsPath(manifest: ExternalHostManifest, global: boolean, roots: ExternalInstallRoots, override?: string): string | undefined;
+//# sourceMappingURL=scoped-paths.d.ts.map

package/dist/plugins/installers/hooks/scoped-paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scoped-paths.d.ts","sourceRoot":"","sources":["../../../../src/plugins/installers/hooks/scoped-paths.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAIH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACtE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAYxD;;GAEG;AACH,wBAAgB,qBAAqB,CACpC,QAAQ,EAAE,oBAAoB,EAC9B,MAAM,EAAE,OAAO,EACf,KAAK,EAAE,oBAAoB,EAC3B,QAAQ,CAAC,EAAE,MAAM,GACf,MAAM,CAiCR;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CACxC,QAAQ,EAAE,oBAAoB,EAC9B,MAAM,EAAE,OAAO,EACf,KAAK,EAAE,oBAAoB,EAC3B,QAAQ,CAAC,EAAE,MAAM,GACf,MAAM,GAAG,SAAS,CAyBpB"}

package/dist/plugins/installers/hooks/scoped-paths.js

@@ -0,0 +1,80 @@
+/**
+ * Resolve project vs global hook script + settings paths for a manifest.
+ *
+ * Some tools declare:
+ * - `assets.hooks` under `${HOME}/...` (global-shaped)
+ * - `assets.settings` as project-relative (`.tool/settings.local.json`)
+ *
+ * A naive resolve writes project installs' scripts to $HOME while registering
+ * settings under the project — split brain. When `global` is false and settings
+ * are project-relative, co-locate hooks next to that settings file. When
+ * `global` is true and settings are project-relative, lift settings into
+ * `detection.configDir` (or the dirname of the resolved global hooks path).
+ */
+import { basename, dirname, join } from '@vibesdotdev/filesystem';
+import { CapabilityError } from '@vibesdotdev/kernel';
+import { resolvePathTemplate } from "../../../external-tool/path-template.js";
+function isProjectRelativeTemplate(template) {
+    return (!template.includes('${HOME}') &&
+        !template.includes('${XDG_CONFIG_HOME}') &&
+        !template.includes('${APPDATA}') &&
+        !template.startsWith('/'));
+}
+/**
+ * Absolute hooks directory for this install scope.
+ */
+export function resolveScopedHooksDir(manifest, global, roots, override) {
+    if (override)
+        return override;
+    const hooksTemplate = manifest.assets?.hooks;
+    const settingsTemplate = manifest.assets?.settings;
+    // Project install + project-relative settings → hooks live next to settings
+    // (e.g. `.tool/settings.local.json` → `<project>/.tool/hooks`).
+    if (!global && roots.projectDir && settingsTemplate && isProjectRelativeTemplate(settingsTemplate)) {
+        const settingsPath = resolvePathTemplate(settingsTemplate, roots);
+        return join(dirname(settingsPath), 'hooks');
+    }
+    if (hooksTemplate) {
+        return resolvePathTemplate(hooksTemplate, roots);
+    }
+    // Global default lives under the runtime-selected vibes home (paths/roots,
+    // #1098); project default is workspace-private state next to the project.
+    if (global) {
+        return join(roots.vibesHome, 'external', manifest.id, 'hooks');
+    }
+    if (!roots.projectDir) {
+        throw new CapabilityError(`Project hooks for ${manifest.id} need a project directory.`, 'INVALID_INPUT', {
+            reason: 'project-dir-required',
+            recoveryHint: 'Pass the project directory, or run inside a workspace so it is bound.'
+        });
+    }
+    return join(roots.projectDir, '.vibes', 'external', manifest.id, 'hooks');
+}
+/**
+ * Absolute settings path for this install scope, or undefined if none declared.
+ */
+export function resolveScopedSettingsPath(manifest, global, roots, override) {
+    if (override)
+        return override;
+    const globalSettingsTemplate = manifest.assets?.globalSettings;
+    if (global && globalSettingsTemplate) {
+        return resolvePathTemplate(globalSettingsTemplate, roots);
+    }
+    const settingsTemplate = manifest.assets?.settings;
+    if (!settingsTemplate)
+        return undefined;
+    // Global install of a project-relative settings path → lift into configDir
+    // (`.tool/settings.local.json` → `~/.tool/settings.local.json`).
+    if (global && isProjectRelativeTemplate(settingsTemplate)) {
+        const configDirTemplate = manifest.detection?.configDir;
+        if (configDirTemplate) {
+            const configDir = resolvePathTemplate(configDirTemplate, roots);
+            return join(configDir, basename(settingsTemplate));
+        }
+        // Fall back: dirname of global hooks + settings basename
+        const hooksDir = resolveScopedHooksDir(manifest, true, roots);
+        return join(dirname(hooksDir), basename(settingsTemplate));
+    }
+    return resolvePathTemplate(settingsTemplate, roots);
+}
+//# sourceMappingURL=scoped-paths.js.map

package/dist/plugins/installers/hooks/scoped-paths.js.map

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

package/dist/plugins/installers/hooks/settings-registration.d.ts

@@ -0,0 +1,79 @@
+/**
+ * Hook settings registration — the half of "install" that was missing.
+ *
+ * Writing a delegator script to a hooks directory does NOT install a hook. A tool
+ * only runs hooks it has been *told about* in its settings file; a loose `.sh` on
+ * disk is inert. `ShellHooksInstaller` wrote the scripts, skipped registration, and
+ * still returned `success: true, "Installed N hooks"` — so `vibes dev external hooks
+ * install <tool>` reported a healthy projection that could never fire. That is
+ * a green light over a dead limb.
+ *
+ * Registration is settings-format-specific, and manifests declare wildly different
+ * settings files (`settings.local.json`, `config.toml`, `GEMINI.md`). This module owns
+ * the JSON case used by JSON-settings tools. Formats we cannot register are reported
+ * as unregistered — never as installed. The settings file is user data: entries of
+ * any shape that are not ours survive install and uninstall unchanged.
+ */
+import { CapabilityError } from '@vibesdotdev/kernel';
+import type { ExternalFileSystem } from '../../../utils/runtime-fs.ts';
+import { type ConfigObject, type ConfigValue } from '../config-value.ts';
+/** One settings hook entry as Vibes writes it. */
+export interface JsonHookEntry {
+    matcher?: string;
+    hooks: Array<{
+        type: 'command';
+        command: string;
+        [key: string]: ConfigValue;
+    }>;
+}
+/**
+ * Identity of the hooks WE own: a script is ours only if it lives in *our* hooks
+ * directory AND bears a filename we generate.
+ */
+export interface ManagedHookIdentity {
+    /** Absolute hooks directory this installer writes into. */
+    hooksDir: string;
+    /** Delegator filenames we generate (basename form, e.g. `stop.sh`). */
+    filenames: Set<string>;
+}
+/** The refusal for a settings file that exists but does not parse; the file is never overwritten. */
+export declare function settingsNotParseable(settingsPath: string): CapabilityError;
+/**
+ * Is this settings entry one WE installed?
+ *
+ * Identity is *location + name*, not a bare basename: an entry is ours only if its
+ * command points at a script inside our hooks directory whose filename we generate.
+ * Matching a bare basename anywhere would misclassify — and silently delete — a user's
+ * own same-named hook in a different directory (e.g. `/home/me/scripts/stop.sh` colliding
+ * with our generated `stop.sh`). A user hook that merely mentions "vibes", or shares a
+ * filename from elsewhere, belongs to the user and must survive install and uninstall.
+ * An entry of any other shape is the user's.
+ */
+export declare function isManagedEntry(entry: ConfigValue, identity: ManagedHookIdentity): boolean;
+export interface RegisterResult {
+    settingsPath: string;
+    registered: string[];
+}
+/**
+ * Register hook scripts into a JSON settings file, preserving the user's own hooks.
+ * Re-registering is idempotent: our previous entries are replaced, not duplicated.
+ */
+export declare function registerHooksInJsonSettings(options: {
+    fs: ExternalFileSystem;
+    settingsPath: string;
+    /** event -> absolute path of the generated script */
+    scripts: Record<string, string>;
+    /** Target-native fields such as timeout/statusMessage/additionalContextLimit. */
+    handlerOptions?: Record<string, ConfigObject>;
+    /** location+name of the scripts we manage, so re-install replaces rather than stacks */
+    identity: ManagedHookIdentity;
+}): Promise<RegisterResult>;
+/** Remove only our entries from a JSON settings file; leave the user's hooks alone. */
+export declare function unregisterHooksFromJsonSettings(options: {
+    fs: ExternalFileSystem;
+    settingsPath: string;
+    identity: ManagedHookIdentity;
+}): Promise<RegisterResult>;
+/** JSON is the only settings format we can register into today. */
+export declare function canRegisterInSettings(settingsPath: string | undefined): settingsPath is string;
+//# sourceMappingURL=settings-registration.d.ts.map

package/dist/plugins/installers/hooks/settings-registration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings-registration.d.ts","sourceRoot":"","sources":["../../../../src/plugins/installers/hooks/settings-registration.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAGH,OAAO,EAAE,eAAe,EAA0C,MAAM,qBAAqB,CAAC;AAC9F,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAGvE,OAAO,EAON,KAAK,YAAY,EACjB,KAAK,WAAW,EAChB,MAAM,oBAAoB,CAAC;AAE5B,kDAAkD;AAClD,MAAM,WAAW,aAAa;IAC7B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,SAAS,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,CAAC,GAAG,EAAE,MAAM,GAAG,WAAW,CAAA;KAAE,CAAC,CAAC;CAC/E;AAED;;;GAGG;AACH,MAAM,WAAW,mBAAmB;IACnC,2DAA2D;IAC3D,QAAQ,EAAE,MAAM,CAAC;IACjB,uEAAuE;IACvE,SAAS,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;CACvB;AAED,qGAAqG;AACrG,wBAAgB,oBAAoB,CAAC,YAAY,EAAE,MAAM,GAAG,eAAe,CAM1E;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,mBAAmB,GAAG,OAAO,CAUzF;AAED,MAAM,WAAW,cAAc;IAC9B,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,EAAE,CAAC;CACrB;AAqBD;;;GAGG;AACH,wBAAsB,2BAA2B,CAAC,OAAO,EAAE;IAC1D,EAAE,EAAE,kBAAkB,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,qDAAqD;IACrD,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,iFAAiF;IACjF,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IAC9C,wFAAwF;IACxF,QAAQ,EAAE,mBAAmB,CAAC;CAC9B,GAAG,OAAO,CAAC,cAAc,CAAC,CAmB1B;AAED,uFAAuF;AACvF,wBAAsB,+BAA+B,CAAC,OAAO,EAAE;IAC9D,EAAE,EAAE,kBAAkB,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,mBAAmB,CAAC;CAC9B,GAAG,OAAO,CAAC,cAAc,CAAC,CAsB1B;AAED,mEAAmE;AACnE,wBAAgB,qBAAqB,CAAC,YAAY,EAAE,MAAM,GAAG,SAAS,GAAG,YAAY,IAAI,MAAM,CAE9F"}

package/dist/plugins/installers/hooks/settings-registration.js

@@ -0,0 +1,125 @@
+/**
+ * Hook settings registration — the half of "install" that was missing.
+ *
+ * Writing a delegator script to a hooks directory does NOT install a hook. A tool
+ * only runs hooks it has been *told about* in its settings file; a loose `.sh` on
+ * disk is inert. `ShellHooksInstaller` wrote the scripts, skipped registration, and
+ * still returned `success: true, "Installed N hooks"` — so `vibes dev external hooks
+ * install <tool>` reported a healthy projection that could never fire. That is
+ * a green light over a dead limb.
+ *
+ * Registration is settings-format-specific, and manifests declare wildly different
+ * settings files (`settings.local.json`, `config.toml`, `GEMINI.md`). This module owns
+ * the JSON case used by JSON-settings tools. Formats we cannot register are reported
+ * as unregistered — never as installed. The settings file is user data: entries of
+ * any shape that are not ours survive install and uninstall unchanged.
+ */
+import { basename, dirname } from '@vibesdotdev/filesystem';
+import { CapabilityError, CaughtFailureSchema, isCapabilityError } from '@vibesdotdev/kernel';
+import { readConfigText, writeConfigAtomically } from "../config-file.js";
+import { parseHostConfig } from "../../../detection/config-document.js";
+import { deleteOwn, isConfigObject, isConfigString, ownObject, ownValue, setOwn } from "../config-value.js";
+/** The refusal for a settings file that exists but does not parse; the file is never overwritten. */
+export function settingsNotParseable(settingsPath) {
+    return new CapabilityError(`${settingsPath} exists but is not valid JSON; refusing to overwrite it. Fix or remove the file and re-run.`, 'INVALID_INPUT', { reason: 'settings-not-parseable', retryable: false, details: { path: settingsPath } });
+}
+/**
+ * Is this settings entry one WE installed?
+ *
+ * Identity is *location + name*, not a bare basename: an entry is ours only if its
+ * command points at a script inside our hooks directory whose filename we generate.
+ * Matching a bare basename anywhere would misclassify — and silently delete — a user's
+ * own same-named hook in a different directory (e.g. `/home/me/scripts/stop.sh` colliding
+ * with our generated `stop.sh`). A user hook that merely mentions "vibes", or shares a
+ * filename from elsewhere, belongs to the user and must survive install and uninstall.
+ * An entry of any other shape is the user's.
+ */
+export function isManagedEntry(entry, identity) {
+    if (!isConfigObject(entry))
+        return false;
+    const hooks = ownValue(entry, 'hooks');
+    if (!Array.isArray(hooks))
+        return false;
+    return hooks.some((hook) => {
+        const command = isConfigObject(hook) ? ownValue(hook, 'command') : undefined;
+        if (!isConfigString(command) || !command.trim())
+            return false;
+        const path = command.trim();
+        return dirname(path) === identity.hooksDir && identity.filenames.has(basename(path));
+    });
+}
+/** The settings document, or `{}` when absent; a file that does not parse is refused `settings-not-parseable`. */
+async function readSettings(fs, settingsPath) {
+    const raw = await readConfigText(fs, settingsPath);
+    if (raw === null)
+        return null;
+    try {
+        return parseHostConfig(raw, settingsPath, 'json');
+    }
+    catch (error) {
+        const failure = CaughtFailureSchema.parse(error);
+        if (failure instanceof Error && isCapabilityError(failure) && failure.reason === 'host-config-invalid') {
+            throw settingsNotParseable(settingsPath);
+        }
+        throw error;
+    }
+}
+function serialize(settings) {
+    return `${JSON.stringify(settings, null, 2)}\n`;
+}
+/**
+ * Register hook scripts into a JSON settings file, preserving the user's own hooks.
+ * Re-registering is idempotent: our previous entries are replaced, not duplicated.
+ */
+export async function registerHooksInJsonSettings(options) {
+    const { fs, settingsPath, scripts, handlerOptions = {}, identity } = options;
+    const settings = (await readSettings(fs, settingsPath)) ?? {};
+    const hooks = {};
+    for (const [event, entries] of Object.entries(ownObject(settings, 'hooks') ?? {}))
+        setOwn(hooks, event, entries);
+    for (const [event, scriptPath] of Object.entries(scripts)) {
+        const existing = ownValue(hooks, event);
+        const userHooks = Array.isArray(existing) ? existing.filter((entry) => !isManagedEntry(entry, identity)) : [];
+        const handler = {};
+        for (const [key, value] of Object.entries(handlerOptions[event] ?? {}))
+            setOwn(handler, key, value);
+        handler.type = 'command';
+        handler.command = scriptPath;
+        setOwn(hooks, event, [...userHooks, { hooks: [handler] }]);
+    }
+    setOwn(settings, 'hooks', hooks);
+    await writeConfigAtomically(fs, settingsPath, serialize(settings));
+    return { settingsPath, registered: Object.keys(scripts) };
+}
+/** Remove only our entries from a JSON settings file; leave the user's hooks alone. */
+export async function unregisterHooksFromJsonSettings(options) {
+    const { fs, settingsPath, identity } = options;
+    const settings = await readSettings(fs, settingsPath);
+    const existing = settings ? ownObject(settings, 'hooks') : undefined;
+    if (!settings || !existing)
+        return { settingsPath, registered: [] };
+    const hooks = {};
+    const removed = [];
+    for (const [event, entries] of Object.entries(existing)) {
+        if (!Array.isArray(entries)) {
+            setOwn(hooks, event, entries);
+            continue;
+        }
+        const userHooks = entries.filter((entry) => !isManagedEntry(entry, identity));
+        if (userHooks.length !== entries.length)
+            removed.push(event);
+        if (userHooks.length > 0)
+            setOwn(hooks, event, userHooks);
+    }
+    if (Object.keys(hooks).length === 0)
+        deleteOwn(settings, 'hooks');
+    else
+        setOwn(settings, 'hooks', hooks);
+    await writeConfigAtomically(fs, settingsPath, serialize(settings));
+    return { settingsPath, registered: removed };
+}
+/** JSON is the only settings format we can register into today. */
+export function canRegisterInSettings(settingsPath) {
+    return Boolean(settingsPath && settingsPath.endsWith('.json'));
+}
+//# sourceMappingURL=settings-registration.js.map

package/dist/plugins/installers/hooks/settings-registration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings-registration.js","sourceRoot":"","sources":["../../../../src/plugins/installers/hooks/settings-registration.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAE9F,OAAO,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAC1E,OAAO,EAAE,eAAe,EAAE,MAAM,uCAAuC,CAAC;AACxE,OAAO,EACN,SAAS,EACT,cAAc,EACd,cAAc,EACd,SAAS,EACT,QAAQ,EACR,MAAM,EAGN,MAAM,oBAAoB,CAAC;AAmB5B,qGAAqG;AACrG,MAAM,UAAU,oBAAoB,CAAC,YAAoB;IACxD,OAAO,IAAI,eAAe,CACzB,GAAG,YAAY,6FAA6F,EAC5G,eAAe,EACf,EAAE,MAAM,EAAE,wBAAwB,EAAE,SAAS,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,EAAE,CACvF,CAAC;AACH,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,cAAc,CAAC,KAAkB,EAAE,QAA6B;IAC/E,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IACzC,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IACvC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IACxC,OAAO,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE;QAC1B,MAAM,OAAO,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QAC7E,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE;YAAE,OAAO,KAAK,CAAC;QAC9D,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;QAC5B,OAAO,OAAO,CAAC,IAAI,CAAC,KAAK,QAAQ,CAAC,QAAQ,IAAI,QAAQ,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC;IACtF,CAAC,CAAC,CAAC;AACJ,CAAC;AAOD,kHAAkH;AAClH,KAAK,UAAU,YAAY,CAAC,EAAsB,EAAE,YAAoB;IACvE,MAAM,GAAG,GAAG,MAAM,cAAc,CAAC,EAAE,EAAE,YAAY,CAAC,CAAC;IACnD,IAAI,GAAG,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAC9B,IAAI,CAAC;QACJ,OAAO,eAAe,CAAC,GAAG,EAAE,YAAY,EAAE,MAAM,CAAC,CAAC;IACnD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QAChB,MAAM,OAAO,GAAG,mBAAmB,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QACjD,IAAI,OAAO,YAAY,KAAK,IAAI,iBAAiB,CAAC,OAAO,CAAC,IAAI,OAAO,CAAC,MAAM,KAAK,qBAAqB,EAAE,CAAC;YACxG,MAAM,oBAAoB,CAAC,YAAY,CAAC,CAAC;QAC1C,CAAC;QACD,MAAM,KAAK,CAAC;IACb,CAAC;AACF,CAAC;AAED,SAAS,SAAS,CAAC,QAAsB;IACxC,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC;AACjD,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,2BAA2B,CAAC,OASjD;IACA,MAAM,EAAE,EAAE,EAAE,YAAY,EAAE,OAAO,EAAE,cAAc,GAAG,EAAE,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC;IAC7E,MAAM,QAAQ,GAAG,CAAC,MAAM,YAAY,CAAC,EAAE,EAAE,YAAY,CAAC,CAAC,IAAI,EAAE,CAAC;IAC9D,MAAM,KAAK,GAAiB,EAAE,CAAC;IAC/B,KAAK,MAAM,CAAC,KAAK,EAAE,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,QAAQ,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC;QAAE,MAAM,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;IAEjH,KAAK,MAAM,CAAC,KAAK,EAAE,UAAU,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QAC3D,MAAM,QAAQ,GAAG,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;QACxC,MAAM,SAAS,GAAG,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,cAAc,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAC9G,MAAM,OAAO,GAAiB,EAAE,CAAC;QACjC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,cAAc,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;YAAE,MAAM,CAAC,OAAO,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC;QACpG,OAAO,CAAC,IAAI,GAAG,SAAS,CAAC;QACzB,OAAO,CAAC,OAAO,GAAG,UAAU,CAAC;QAC7B,MAAM,CAAC,KAAK,EAAE,KAAK,EAAE,CAAC,GAAG,SAAS,EAAE,EAAE,KAAK,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC;IAC5D,CAAC;IAED,MAAM,CAAC,QAAQ,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;IACjC,MAAM,qBAAqB,CAAC,EAAE,EAAE,YAAY,EAAE,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC;IACnE,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;AAC3D,CAAC;AAED,uFAAuF;AACvF,MAAM,CAAC,KAAK,UAAU,+BAA+B,CAAC,OAIrD;IACA,MAAM,EAAE,EAAE,EAAE,YAAY,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC;IAC/C,MAAM,QAAQ,GAAG,MAAM,YAAY,CAAC,EAAE,EAAE,YAAY,CAAC,CAAC;IACtD,MAAM,QAAQ,GAAG,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IACrE,IAAI,CAAC,QAAQ,IAAI,CAAC,QAAQ;QAAE,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,EAAE,EAAE,CAAC;IAEpE,MAAM,KAAK,GAAiB,EAAE,CAAC;IAC/B,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,KAAK,MAAM,CAAC,KAAK,EAAE,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;QACzD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;YAC7B,MAAM,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;YAC9B,SAAS;QACV,CAAC;QACD,MAAM,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,cAAc,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC;QAC9E,IAAI,SAAS,CAAC,MAAM,KAAK,OAAO,CAAC,MAAM;YAAE,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC7D,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC;YAAE,MAAM,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC;IAC3D,CAAC;IAED,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,KAAK,CAAC;QAAE,SAAS,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;;QAC7D,MAAM,CAAC,QAAQ,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;IACtC,MAAM,qBAAqB,CAAC,EAAE,EAAE,YAAY,EAAE,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC;IACnE,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,OAAO,EAAE,CAAC;AAC9C,CAAC;AAED,mEAAmE;AACnE,MAAM,UAAU,qBAAqB,CAAC,YAAgC;IACrE,OAAO,OAAO,CAAC,YAAY,IAAI,YAAY,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC;AAChE,CAAC"}

package/dist/plugins/installers/hooks/shell-installer.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Shell Hooks Installer
+ *
+ * Installs shell-based hooks for manifest-described external tools.
+ * When the manifest declares a JSON settings file, scripts are also registered
+ * there — writing a `.sh` alone leaves hooks inert.
+ */
+import { type ExternalHostManifest } from '../../schemas/manifest.ts';
+import type { ExternalInstallRoots, ExternalInstallTarget, HooksInstaller, HooksGenerateOptions, HooksGenerateResult, HooksInstallOptions, HooksInstallResult, HooksUninstallOptions, InstallResult, HookTemplate } from '../types.ts';
+/**
+ * Shell-based hooks installer
+ */
+export declare class ShellHooksInstaller implements HooksInstaller {
+    readonly id = "shell-hooks";
+    generate(options: HooksGenerateOptions, roots: ExternalInstallRoots): Promise<HooksGenerateResult>;
+    install(options: HooksInstallOptions, roots: ExternalInstallTarget): Promise<HooksInstallResult>;
+    uninstall(manifest: ExternalHostManifest, global: boolean, roots: ExternalInstallTarget, options?: HooksUninstallOptions): Promise<InstallResult>;
+    getTemplates(manifest: ExternalHostManifest, vibesPath: string, roots: ExternalInstallRoots): HookTemplate[];
+    getHooksDir(manifest: ExternalHostManifest, global: boolean, roots: ExternalInstallRoots): string;
+}
+//# sourceMappingURL=shell-installer.d.ts.map

package/dist/plugins/installers/hooks/shell-installer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shell-installer.d.ts","sourceRoot":"","sources":["../../../../src/plugins/installers/hooks/shell-installer.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAUH,OAAO,EAA4B,KAAK,oBAAoB,EAAkB,MAAM,2BAA2B,CAAC;AAChH,OAAO,KAAK,EACX,oBAAoB,EACpB,qBAAqB,EACrB,cAAc,EACd,oBAAoB,EACpB,mBAAmB,EACnB,mBAAmB,EACnB,kBAAkB,EAClB,qBAAqB,EACrB,aAAa,EACb,YAAY,EACZ,MAAM,aAAa,CAAC;AA2GrB;;GAEG;AACH,qBAAa,mBAAoB,YAAW,cAAc;IACzD,QAAQ,CAAC,EAAE,iBAAiB;IAEtB,QAAQ,CACb,OAAO,EAAE,oBAAoB,EAC7B,KAAK,EAAE,oBAAoB,GACzB,OAAO,CAAC,mBAAmB,CAAC;IAiCzB,OAAO,CACZ,OAAO,EAAE,mBAAmB,EAC5B,KAAK,EAAE,qBAAqB,GAC1B,OAAO,CAAC,kBAAkB,CAAC;IAsIxB,SAAS,CACd,QAAQ,EAAE,oBAAoB,EAC9B,MAAM,EAAE,OAAO,EACf,KAAK,EAAE,qBAAqB,EAC5B,OAAO,CAAC,EAAE,qBAAqB,GAC7B,OAAO,CAAC,aAAa,CAAC;IA+CzB,YAAY,CACX,QAAQ,EAAE,oBAAoB,EAC9B,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,oBAAoB,GACzB,YAAY,EAAE;IAUjB,WAAW,CAAC,QAAQ,EAAE,oBAAoB,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,oBAAoB,GAAG,MAAM;CAGjG"}