@vibesdotdev/pm 0.0.0-stage → 1.0.0-rc.3

package/dist/graph.js

@@ -0,0 +1,247 @@
+/**
+ * The PM graph of a runtime: its `pm/process`, `pm/resource` and `pm/preset`
+ * descriptors plus the host's declared `config.plugins.pm`.
+ *
+ * PM loads nothing (runtime-first; pm.md K1-K3, C1). The kernel's one
+ * discovery pass registers every `*.pm.{process,resource,preset}.ts` of the
+ * bound workspace's declared packages, and bootstrap projects the host's
+ * `vibes.config.*` `config.plugins.pm` onto the `plugins.pm` context. This
+ * module reads both from the runtime it is handed and derives preset
+ * membership. It reads no file, walks no directory and resolves no workspace.
+ * A discovered process's relative paths are relative to its own file: the
+ * kernel records which file registered each id (`runtime.discovered`), and
+ * the graph anchors them there, so a descriptor never computes its location.
+ *
+ * The one explicit file read is `pm register <path>` (C1: the isolation
+ * boundary for loading exactly one descriptor), owned by the CLI command
+ * (`cli/register-manifest.ts`), which admits it through {@link asManifest}.
+ */
+import * as z from 'zod/v4';
+import { CapabilityError, readPluginConfig, settle, valueFreeFailure } from '@vibesdotdev/kernel';
+import { anchorAtDeclaringFile, declaresRelativePath } from "./helpers/launch-custody.js";
+import { ProcessManifestSchema } from "./schemas/process.js";
+import { PM_PROCESS_SOURCE_KIND, PMDerivedManifestSchema } from "./schemas/process-source.js";
+import { PMPluginConfigSchema } from "./schemas/graph.js";
+export { PMBudgetSchema, PMPluginConfigSchema, PMRestartPolicySchema, PMSourceFailureSchema, PMSupervisionSchema } from "./schemas/graph.js";
+/** The plugin name whose `config.plugins.<name>` holds PM's declared manifest. */
+export const PM_PLUGIN_CONFIG_NAME = 'pm';
+const PM_DESCRIPTOR_KINDS = ['pm/process', 'pm/resource', 'pm/preset'];
+function dropKind(descriptor) {
+    const { kind: _kind, ...rest } = descriptor;
+    return rest;
+}
+/**
+ * The registry half: a runtime that does not compose the PM kinds is a
+ * composition defect and fails closed; it never reads as an empty workspace.
+ * Each process discovery registered has its relative paths anchored at the
+ * file it came from; a plugin-registered process has no file, so its relative
+ * paths stay for launch custody to anchor at the admitted root.
+ */
+function registeredDescriptors(runtime) {
+    const missing = PM_DESCRIPTOR_KINDS.filter((kind) => !runtime.hasKind(kind));
+    if (missing.length > 0) {
+        throw new CapabilityError(`PM descriptors cannot be read: this runtime does not register ${missing
+            .map((kind) => `'${kind}'`)
+            .join(', ')}. Compose the PM plugin (@vibesdotdev/pm/plugin).`, 'INTERNAL', { reason: 'dependency-absent', details: { kinds: missing } });
+    }
+    return {
+        configs: anchorDiscovered(runtime, runtime
+            .query('pm/process')
+            .enabled()
+            .descriptors()
+            .map(dropKind)),
+        resources: runtime
+            .query('pm/resource')
+            .enabled()
+            .descriptors()
+            .map(dropKind),
+        presets: runtime
+            .query('pm/preset')
+            .enabled()
+            .descriptors()
+            .map(dropKind)
+    };
+}
+/**
+ * Processes with a relative path anchored at the file discovery registered
+ * each from. Only those need the kernel's record (`runtime.discovered`); a
+ * runtime that cannot supply it cannot locate them and fails closed. A process
+ * the record does not name (a plugin's) is returned as declared.
+ */
+function anchorDiscovered(runtime, configs) {
+    if (!configs.some(declaresRelativePath))
+        return configs;
+    if (!runtime.discovered) {
+        throw new CapabilityError('PM cannot locate discovered process descriptors: this runtime does not expose which file registered each one.', 'INTERNAL', { reason: 'dependency-absent', details: { member: 'discovered' } });
+    }
+    const files = new Map(runtime.discovered('pm/process').map((entry) => [entry.id, entry.file]));
+    return configs.map((config) => {
+        const file = files.get(config.id);
+        return file === undefined ? config : anchorAtDeclaringFile(config, file);
+    });
+}
+/**
+ * Each preset's processes: the union of its explicit `processes` and every
+ * process whose own `presets` names it (the process opting in is canonical).
+ */
+export function derivePresetMembership(presets, configs) {
+    if (presets.length === 0)
+        return presets;
+    const byPreset = new Map();
+    for (const config of configs) {
+        for (const presetId of config.presets ?? []) {
+            let members = byPreset.get(presetId);
+            if (!members) {
+                members = new Set();
+                byPreset.set(presetId, members);
+            }
+            members.add(config.id);
+        }
+    }
+    return presets.map((preset) => ({
+        ...preset,
+        processes: [...new Set([...(preset.processes ?? []), ...(byPreset.get(preset.id) ?? [])])]
+    }));
+}
+/** Last wins: discovery first, then `config.plugins.pm`, so declared config overrides a discovered id. */
+function dedupeById(items) {
+    const byId = new Map();
+    for (const item of items)
+        byId.set(item.id, item);
+    return [...byId.values()];
+}
+function applyFilter(graph, filter) {
+    const tags = filter.tags ?? [];
+    const hasTag = (itemTags) => tags.some((tag) => (itemTags ?? []).includes(tag));
+    const configs = graph.configs.filter((config) => (!filter.scope || config.scope === filter.scope) && (tags.length === 0 || hasTag(config.tags)));
+    return {
+        ...graph,
+        configs,
+        processes: configs,
+        resources: tags.length === 0 ? graph.resources : graph.resources.filter((resource) => hasTag(resource.tags))
+    };
+}
+/**
+ * What every composed `pm/process-source` derives (processes and presets, parsed with PM's own manifest
+ * schema). A source is a plugin's derivation, not the host's declaration: one that cannot be read or
+ * derives an invalid manifest is a listed failure, and every other source's processes still read.
+ */
+async function derivedManifest(runtime) {
+    const merged = { processes: [], presets: [] };
+    const failures = [];
+    if (!runtime.hasKind(PM_PROCESS_SOURCE_KIND))
+        return { manifest: ProcessManifestSchema.parse(merged), failures };
+    const query = runtime.query(PM_PROCESS_SOURCE_KIND);
+    for (const descriptor of query.enabled().descriptors()) {
+        const read = await settle(async () => {
+            const source = await query.withId(descriptor.id).resolve();
+            // SAFETY: the host that composes PM passes the RuntimeRef a source reads units through; GraphRuntime is the subset of it this module reads.
+            const derived = await source.read(runtime);
+            // The whole result is validated alone (its processes and the units it names), so one invalid derivation fails only its own source.
+            const { failures: unread = [] } = PMDerivedManifestSchema.parse(derived);
+            return { derived, unread };
+        });
+        if (!read.ok) {
+            failures.push({ source: descriptor.id, failure: valueFreeFailure(read.cause) });
+            continue;
+        }
+        merged.processes.push(...(read.value.derived.processes ?? []));
+        merged.presets.push(...(read.value.derived.presets ?? []));
+        failures.push(...read.value.unread.map((entry) => ({ source: descriptor.id, unit: entry.unit, failure: entry.failure })));
+    }
+    return { manifest: ProcessManifestSchema.parse(merged), failures };
+}
+/**
+ * The PM graph of `runtime`: its registered PM descriptors, the processes its
+ * `pm/process-source`s derive, then the host's declared `config.plugins.pm`. An invalid declaration propagates
+ * (`plugin-config-invalid`); a source that cannot be read is listed in `sourceFailures` and the rest of the graph reads.
+ */
+export async function readPMGraph(runtime, filter = {}) {
+    const registered = registeredDescriptors(runtime);
+    const declared = await readPluginConfig(runtime, PM_PLUGIN_CONFIG_NAME, PMPluginConfigSchema);
+    const { manifest: derived, failures: sourceFailures } = await derivedManifest(runtime);
+    const sources = [];
+    if (registered.configs.length + registered.resources.length + registered.presets.length > 0) {
+        sources.push('runtime:discovery');
+    }
+    if ((derived.processes?.length ?? 0) + (derived.presets?.length ?? 0) > 0)
+        sources.push('pm/process-source');
+    if (declared)
+        sources.push(`config.plugins.${PM_PLUGIN_CONFIG_NAME}`);
+    const configs = dedupeById([...registered.configs, ...(derived.processes ?? []), ...(declared?.processes ?? [])]);
+    const resources = dedupeById([...registered.resources, ...(declared?.resources ?? [])]);
+    const presets = derivePresetMembership(dedupeById([...registered.presets, ...(derived.presets ?? []), ...(declared?.presets ?? [])]), configs);
+    const defaultPreset = declared?.defaultPreset ?? presets.find((preset) => preset.default)?.id;
+    // Filters apply after membership, so a filtered read keeps a consistent graph.
+    // `processes` aliases `configs` (applyFilter spreads it through), so both
+    // names stay defined on every read.
+    return applyFilter({ configs, processes: configs, resources, presets, defaultPreset, budget: declared?.budget ?? {}, sources, sourceFailures }, filter);
+}
+/**
+ * The declared budget of `runtime`'s host (`config.plugins.pm.budget`), read
+ * on its own so a manager outside a PM-composed host still reads it. Empty
+ * when none is declared; an invalid declaration fails `plugin-config-invalid`.
+ */
+export async function readPMBudget(runtime) {
+    return (await readPluginConfig(runtime, PM_PLUGIN_CONFIG_NAME, PMPluginConfigSchema))?.budget ?? {};
+}
+/** The declared supervision policy (`config.plugins.pm.supervision`); empty when none is declared. */
+export async function readPMSupervision(runtime) {
+    return (await readPluginConfig(runtime, PM_PLUGIN_CONFIG_NAME, PMPluginConfigSchema))?.supervision ?? {};
+}
+/**
+ * Resolve preset inheritance (`extends`): the parent's members are
+ * concatenated with the child's (deduplicated), the child wins on scalars.
+ */
+export function resolvePreset(preset, allPresets) {
+    if (!preset.extends)
+        return preset;
+    const presetMap = allPresets instanceof Map ? allPresets : new Map(allPresets.map((p) => [p.id, p]));
+    const parent = presetMap.get(preset.extends);
+    if (!parent) {
+        throw new CapabilityError(`Parent preset '${preset.extends}' (extended by '${preset.id}') is not declared.`, 'NOT_FOUND', { reason: 'pm-preset-not-found', details: { presetId: preset.extends, extendedBy: preset.id } });
+    }
+    const resolvedParent = resolvePreset(parent, presetMap);
+    const dedupe = (xs) => [...new Set(xs)];
+    return {
+        ...resolvedParent,
+        ...preset,
+        processes: dedupe([...(resolvedParent.processes ?? []), ...(preset.processes ?? [])]),
+        resources: dedupe([...(resolvedParent.resources ?? []), ...(preset.resources ?? [])]),
+        dependencies: dedupe([...(resolvedParent.dependencies ?? []), ...(preset.dependencies ?? [])])
+    };
+}
+/** The resolved preset `presetId` of `graph`, or `NOT_FOUND` `pm-preset-not-found`. */
+export function requirePreset(graph, presetId) {
+    const preset = graph.presets.find((candidate) => candidate.id === presetId);
+    if (!preset) {
+        throw new CapabilityError(`Preset '${presetId}' is not declared in this workspace.`, 'NOT_FOUND', {
+            reason: 'pm-preset-not-found',
+            recoveryHint: "Run 'vibes pm preset list' to see the declared presets.",
+            details: { presetId }
+        });
+    }
+    return resolvePreset(preset, graph.presets);
+}
+/** A `pm/*` descriptor: any object carrying one of the PM descriptor kinds. */
+const KindedDescriptorSchema = z.looseObject({ kind: z.enum(PM_DESCRIPTOR_KINDS) });
+/**
+ * A single `pm/*` descriptor becomes a one-item manifest; anything else (a
+ * manifest, or a value that is no descriptor) passes through untouched for the
+ * manifest schema to judge.
+ */
+export function asManifest(value) {
+    const descriptor = KindedDescriptorSchema.safeParse(value);
+    if (!descriptor.success)
+        return value;
+    const { kind, ...item } = descriptor.data;
+    switch (kind) {
+        case 'pm/process':
+            return { processes: [item] };
+        case 'pm/resource':
+            return { resources: [item] };
+        case 'pm/preset':
+            return { presets: [item] };
+    }
+}
+//# sourceMappingURL=graph.js.map

package/dist/graph.js.map

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

package/dist/helpers/failure.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Reading a captured failure (`utils/attempt.ts`): branch on its errno `code`,
+ * or throw it again exactly as it was thrown. Message text is never read.
+ */
+import type { CaughtFailure } from '@vibesdotdev/kernel';
+/** Whether the failure is an `Error` carrying exactly this errno-style `code` (`ENOENT`, `ESRCH`, `ECONNREFUSED`, ...). */
+export declare function hasErrno(failure: CaughtFailure, code: string): boolean;
+/** Throw a captured failure again: the `Error` itself, or the non-Error value that was thrown. */
+export declare function rethrowFailure(failure: CaughtFailure): never;
+//# sourceMappingURL=failure.d.ts.map

package/dist/helpers/failure.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"failure.d.ts","sourceRoot":"","sources":["../../src/helpers/failure.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAGzD,2HAA2H;AAC3H,wBAAgB,QAAQ,CAAC,OAAO,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAEtE;AAED,kGAAkG;AAClG,wBAAgB,cAAc,CAAC,OAAO,EAAE,aAAa,GAAG,KAAK,CAE5D"}

package/dist/helpers/failure.js

@@ -0,0 +1,10 @@
+import { hasErrnoCode } from "../utils/errno-failure.js";
+/** Whether the failure is an `Error` carrying exactly this errno-style `code` (`ENOENT`, `ESRCH`, `ECONNREFUSED`, ...). */
+export function hasErrno(failure, code) {
+    return hasErrnoCode(failure) && failure.code === code;
+}
+/** Throw a captured failure again: the `Error` itself, or the non-Error value that was thrown. */
+export function rethrowFailure(failure) {
+    throw failure instanceof Error ? failure : failure.value;
+}
+//# sourceMappingURL=failure.js.map

package/dist/helpers/failure.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"failure.js","sourceRoot":"","sources":["../../src/helpers/failure.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAEzD,2HAA2H;AAC3H,MAAM,UAAU,QAAQ,CAAC,OAAsB,EAAE,IAAY;IAC5D,OAAO,YAAY,CAAC,OAAO,CAAC,IAAI,OAAO,CAAC,IAAI,KAAK,IAAI,CAAC;AACvD,CAAC;AAED,kGAAkG;AAClG,MAAM,UAAU,cAAc,CAAC,OAAsB;IACpD,MAAM,OAAO,YAAY,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC;AAC1D,CAAC"}

package/dist/helpers/launch-custody.d.ts

@@ -0,0 +1,16 @@
+import { type ProcessConfig } from '../schemas/process.ts';
+/** Whether `config` declares a relative `cwd`, `preBuild.cwd` or `build.cwd`: what {@link anchorAtDeclaringFile} anchors. */
+export declare function declaresRelativePath(config: Pick<ProcessConfig, 'cwd' | 'preBuild' | 'build'>): boolean;
+/**
+ * A process declared in `file` (a discovered descriptor, or a module `pm
+ * register` read), its relative `cwd`, `preBuild.cwd` and `build.cwd`
+ * anchored at that file's directory. A descriptor never computes its own
+ * location, so `cwd: '.'` names the directory it sits in. An absolute path
+ * stays; an omitted `cwd` stays omitted, so launch custody binds it to the
+ * admitted root. Paths the child derives from its cwd (a relative
+ * `--config`, a relative `file:` database URL) resolve there in turn.
+ */
+export declare function anchorAtDeclaringFile<T extends Pick<ProcessConfig, 'cwd' | 'preBuild' | 'build'>>(config: T, file: string): T;
+export declare function bindProcessLaunchCustody(config: ProcessConfig, workspaceRoot: string): ProcessConfig;
+export declare function launchCustodyNeedsPersist(registered: ProcessConfig | undefined, bound: ProcessConfig): boolean;
+//# sourceMappingURL=launch-custody.d.ts.map

package/dist/helpers/launch-custody.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"launch-custody.d.ts","sourceRoot":"","sources":["../../src/helpers/launch-custody.ts"],"names":[],"mappings":"AACA,OAAO,EAAuB,KAAK,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAiChF,6HAA6H;AAC7H,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,IAAI,CAAC,aAAa,EAAE,KAAK,GAAG,UAAU,GAAG,OAAO,CAAC,GAAG,OAAO,CAEvG;AAED;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CAAC,CAAC,SAAS,IAAI,CAAC,aAAa,EAAE,KAAK,GAAG,UAAU,GAAG,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,CAAC,CAW7H;AAmBD,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,GAAG,aAAa,CA4BpG;AAED,wBAAgB,yBAAyB,CACxC,UAAU,EAAE,aAAa,GAAG,SAAS,EACrC,KAAK,EAAE,aAAa,GAClB,OAAO,CAIT"}

package/dist/helpers/launch-custody.js

@@ -0,0 +1,117 @@
+import { admittedWorkspaceIdentity } from "../admission.js";
+import { ProcessConfigSchema } from "../schemas/process.js";
+/** POSIX, drive-letter or UNC absolute. Pure string work. */
+function isAbsolutePath(path) {
+    return path.startsWith('/') || /^[A-Za-z]:[\\/]/.test(path) || path.startsWith('\\\\');
+}
+/**
+ * A declared cwd anchored at an absolute `base` (the admitted root, or the
+ * directory of the file that declared it): absolute stays, relative joins the
+ * base with `.`/`..` normalized. Pure string work, so a manager on any host
+ * binds the same launch fact.
+ */
+function anchorCwd(cwd, base) {
+    if (cwd === undefined)
+        return undefined;
+    if (isAbsolutePath(cwd))
+        return cwd;
+    const separator = /^[A-Za-z]:/.test(base) ? '\\' : '/';
+    const segments = [];
+    for (const segment of `${base}/${cwd}`.split(/[\\/]+/)) {
+        if (segment === '' || segment === '.')
+            continue;
+        if (segment === '..') {
+            if (segments.length > (/^[A-Za-z]:$/.test(segments[0] ?? '') ? 1 : 0))
+                segments.pop();
+        }
+        else
+            segments.push(segment);
+    }
+    return separator === '/' ? `/${segments.join('/')}` : segments.join('\\');
+}
+/** The directory holding `file`, either separator. Pure string work, like {@link anchorCwd}. */
+function directoryOf(file) {
+    const index = Math.max(file.lastIndexOf('/'), file.lastIndexOf('\\'));
+    return index <= 0 ? file.slice(0, index + 1) : file.slice(0, index);
+}
+/** Whether `config` declares a relative `cwd`, `preBuild.cwd` or `build.cwd`: what {@link anchorAtDeclaringFile} anchors. */
+export function declaresRelativePath(config) {
+    return [config.cwd, config.preBuild?.cwd, config.build?.cwd].some((path) => path !== undefined && !isAbsolutePath(path));
+}
+/**
+ * A process declared in `file` (a discovered descriptor, or a module `pm
+ * register` read), its relative `cwd`, `preBuild.cwd` and `build.cwd`
+ * anchored at that file's directory. A descriptor never computes its own
+ * location, so `cwd: '.'` names the directory it sits in. An absolute path
+ * stays; an omitted `cwd` stays omitted, so launch custody binds it to the
+ * admitted root. Paths the child derives from its cwd (a relative
+ * `--config`, a relative `file:` database URL) resolve there in turn.
+ */
+export function anchorAtDeclaringFile(config, file) {
+    const directory = directoryOf(file);
+    const cwd = anchorCwd(config.cwd, directory);
+    const preBuildCwd = anchorCwd(config.preBuild?.cwd, directory);
+    const buildCwd = anchorCwd(config.build?.cwd, directory);
+    if (cwd === config.cwd && preBuildCwd === config.preBuild?.cwd && buildCwd === config.build?.cwd)
+        return config;
+    const anchored = { ...config };
+    if (cwd !== undefined)
+        anchored.cwd = cwd;
+    if (config.preBuild && preBuildCwd !== undefined)
+        anchored.preBuild = { ...config.preBuild, cwd: preBuildCwd };
+    if (config.build && buildCwd !== undefined)
+        anchored.build = { ...config.build, cwd: buildCwd };
+    return anchored;
+}
+/**
+ * Bind a declared process to PM's admitted workspace, the spawn fact
+ * (compiled products must not freeze the build machine):
+ * - an omitted `cwd` is the admitted root; a relative `cwd` (and a relative
+ *   `preBuild.cwd` / `build.cwd`) is resolved against it, never against the
+ *   daemon's own working directory;
+ * - an omitted `VIBES_WORKSPACE_PATH` is the admitted root;
+ * - a declared host re-entry without `--workspace-root` gets that argv so the
+ *   child binds the admitted workspace (the kernel ignores `VIBES_WORKSPACE_PATH`).
+ */
+function withWorkspaceRootArgv(args, workspacePath) {
+    const current = args ? [...args] : [];
+    if (current.includes('--workspace-root'))
+        return current;
+    return ['--workspace-root', workspacePath, ...current];
+}
+export function bindProcessLaunchCustody(config, workspaceRoot) {
+    const workspacePath = admittedWorkspaceIdentity(workspaceRoot).workspacePath;
+    const cwd = anchorCwd(config.cwd, workspacePath) ?? workspacePath;
+    const preBuildCwd = anchorCwd(config.preBuild?.cwd, workspacePath);
+    const buildCwd = anchorCwd(config.build?.cwd, workspacePath);
+    const args = config.selfSpawn
+        ? withWorkspaceRootArgv(config.args, workspacePath)
+        : config.args;
+    const unchanged = cwd === config.cwd &&
+        preBuildCwd === config.preBuild?.cwd &&
+        buildCwd === config.build?.cwd &&
+        args === config.args &&
+        config.env?.VIBES_WORKSPACE_PATH !== undefined;
+    if (unchanged)
+        return config;
+    const bound = { ...config, cwd };
+    if (args)
+        bound.args = args;
+    if (config.preBuild) {
+        bound.preBuild = preBuildCwd ? { ...config.preBuild, cwd: preBuildCwd } : { ...config.preBuild };
+    }
+    if (config.build) {
+        bound.build = buildCwd ? { ...config.build, cwd: buildCwd } : { ...config.build };
+    }
+    bound.env = {
+        ...config.env,
+        VIBES_WORKSPACE_PATH: config.env?.VIBES_WORKSPACE_PATH ?? workspacePath
+    };
+    return ProcessConfigSchema.parse(bound);
+}
+export function launchCustodyNeedsPersist(registered, bound) {
+    return registered?.cwd !== bound.cwd
+        || registered?.env?.VIBES_WORKSPACE_PATH !== bound.env?.VIBES_WORKSPACE_PATH
+        || JSON.stringify(registered?.args ?? []) !== JSON.stringify(bound.args ?? []);
+}
+//# sourceMappingURL=launch-custody.js.map

package/dist/helpers/launch-custody.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"launch-custody.js","sourceRoot":"","sources":["../../src/helpers/launch-custody.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,MAAM,iBAAiB,CAAC;AAC5D,OAAO,EAAE,mBAAmB,EAAsB,MAAM,uBAAuB,CAAC;AAEhF,6DAA6D;AAC7D,SAAS,cAAc,CAAC,IAAY;IACnC,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;AACxF,CAAC;AAED;;;;;GAKG;AACH,SAAS,SAAS,CAAC,GAAuB,EAAE,IAAY;IACvD,IAAI,GAAG,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IACxC,IAAI,cAAc,CAAC,GAAG,CAAC;QAAE,OAAO,GAAG,CAAC;IACpC,MAAM,SAAS,GAAG,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC;IACvD,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,KAAK,MAAM,OAAO,IAAI,GAAG,IAAI,IAAI,GAAG,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC;QACxD,IAAI,OAAO,KAAK,EAAE,IAAI,OAAO,KAAK,GAAG;YAAE,SAAS;QAChD,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;YACtB,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,aAAa,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;gBAAE,QAAQ,CAAC,GAAG,EAAE,CAAC;QACvF,CAAC;;YAAM,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC/B,CAAC;IACD,OAAO,SAAS,KAAK,GAAG,CAAC,CAAC,CAAC,IAAI,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC3E,CAAC;AAED,gGAAgG;AAChG,SAAS,WAAW,CAAC,IAAY;IAChC,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,EAAE,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC;IACtE,OAAO,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;AACrE,CAAC;AAED,6HAA6H;AAC7H,MAAM,UAAU,oBAAoB,CAAC,MAAyD;IAC7F,OAAO,CAAC,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,QAAQ,EAAE,GAAG,EAAE,MAAM,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,KAAK,SAAS,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC;AAC1H,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,qBAAqB,CAA8D,MAAS,EAAE,IAAY;IACzH,MAAM,SAAS,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;IACpC,MAAM,GAAG,GAAG,SAAS,CAAC,MAAM,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;IAC7C,MAAM,WAAW,GAAG,SAAS,CAAC,MAAM,CAAC,QAAQ,EAAE,GAAG,EAAE,SAAS,CAAC,CAAC;IAC/D,MAAM,QAAQ,GAAG,SAAS,CAAC,MAAM,CAAC,KAAK,EAAE,GAAG,EAAE,SAAS,CAAC,CAAC;IACzD,IAAI,GAAG,KAAK,MAAM,CAAC,GAAG,IAAI,WAAW,KAAK,MAAM,CAAC,QAAQ,EAAE,GAAG,IAAI,QAAQ,KAAK,MAAM,CAAC,KAAK,EAAE,GAAG;QAAE,OAAO,MAAM,CAAC;IAChH,MAAM,QAAQ,GAAM,EAAE,GAAG,MAAM,EAAE,CAAC;IAClC,IAAI,GAAG,KAAK,SAAS;QAAE,QAAQ,CAAC,GAAG,GAAG,GAAG,CAAC;IAC1C,IAAI,MAAM,CAAC,QAAQ,IAAI,WAAW,KAAK,SAAS;QAAE,QAAQ,CAAC,QAAQ,GAAG,EAAE,GAAG,MAAM,CAAC,QAAQ,EAAE,GAAG,EAAE,WAAW,EAAE,CAAC;IAC/G,IAAI,MAAM,CAAC,KAAK,IAAI,QAAQ,KAAK,SAAS;QAAE,QAAQ,CAAC,KAAK,GAAG,EAAE,GAAG,MAAM,CAAC,KAAK,EAAE,GAAG,EAAE,QAAQ,EAAE,CAAC;IAChG,OAAO,QAAQ,CAAC;AACjB,CAAC;AAED;;;;;;;;;GASG;AAEH,SAAS,qBAAqB,CAAC,IAAmC,EAAE,aAAqB;IACxF,MAAM,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACtC,IAAI,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAC;QAAE,OAAO,OAAO,CAAC;IACzD,OAAO,CAAC,kBAAkB,EAAE,aAAa,EAAE,GAAG,OAAO,CAAC,CAAC;AACxD,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,MAAqB,EAAE,aAAqB;IACpF,MAAM,aAAa,GAAG,yBAAyB,CAAC,aAAa,CAAC,CAAC,aAAa,CAAC;IAC7E,MAAM,GAAG,GAAG,SAAS,CAAC,MAAM,CAAC,GAAG,EAAE,aAAa,CAAC,IAAI,aAAa,CAAC;IAClE,MAAM,WAAW,GAAG,SAAS,CAAC,MAAM,CAAC,QAAQ,EAAE,GAAG,EAAE,aAAa,CAAC,CAAC;IACnE,MAAM,QAAQ,GAAG,SAAS,CAAC,MAAM,CAAC,KAAK,EAAE,GAAG,EAAE,aAAa,CAAC,CAAC;IAC7D,MAAM,IAAI,GAAG,MAAM,CAAC,SAAS;QAC5B,CAAC,CAAC,qBAAqB,CAAC,MAAM,CAAC,IAAI,EAAE,aAAa,CAAC;QACnD,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC;IACf,MAAM,SAAS,GACd,GAAG,KAAK,MAAM,CAAC,GAAG;QAClB,WAAW,KAAK,MAAM,CAAC,QAAQ,EAAE,GAAG;QACpC,QAAQ,KAAK,MAAM,CAAC,KAAK,EAAE,GAAG;QAC9B,IAAI,KAAK,MAAM,CAAC,IAAI;QACpB,MAAM,CAAC,GAAG,EAAE,oBAAoB,KAAK,SAAS,CAAC;IAChD,IAAI,SAAS;QAAE,OAAO,MAAM,CAAC;IAC7B,MAAM,KAAK,GAAkB,EAAE,GAAG,MAAM,EAAE,GAAG,EAAE,CAAC;IAChD,IAAI,IAAI;QAAE,KAAK,CAAC,IAAI,GAAG,IAAI,CAAC;IAC5B,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;QACrB,KAAK,CAAC,QAAQ,GAAG,WAAW,CAAC,CAAC,CAAC,EAAE,GAAG,MAAM,CAAC,QAAQ,EAAE,GAAG,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,MAAM,CAAC,QAAQ,EAAE,CAAC;IAClG,CAAC;IACD,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;QAClB,KAAK,CAAC,KAAK,GAAG,QAAQ,CAAC,CAAC,CAAC,EAAE,GAAG,MAAM,CAAC,KAAK,EAAE,GAAG,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,MAAM,CAAC,KAAK,EAAE,CAAC;IACnF,CAAC;IACD,KAAK,CAAC,GAAG,GAAG;QACX,GAAG,MAAM,CAAC,GAAG;QACb,oBAAoB,EAAE,MAAM,CAAC,GAAG,EAAE,oBAAoB,IAAI,aAAa;KACvE,CAAC;IACF,OAAO,mBAAmB,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;AACzC,CAAC;AAED,MAAM,UAAU,yBAAyB,CACxC,UAAqC,EACrC,KAAoB;IAEpB,OAAO,UAAU,EAAE,GAAG,KAAK,KAAK,CAAC,GAAG;WAChC,UAAU,EAAE,GAAG,EAAE,oBAAoB,KAAK,KAAK,CAAC,GAAG,EAAE,oBAAoB;WACzE,IAAI,CAAC,SAAS,CAAC,UAAU,EAAE,IAAI,IAAI,EAAE,CAAC,KAAK,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;AACjF,CAAC"}

package/dist/helpers/launch-identity.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Launch identity and the daemon's process pool.
+ *
+ * A running process is idempotent only when it is the process the caller
+ * would launch now. This matters for durable daemons after an application
+ * update: the process id and socket can stay stable while the executable
+ * moves from an older source checkout to the newly bundled CLI.
+ */
+import { type ProcessConfig } from '../schemas/process.ts';
+/** Restore only fields still equal to the saved prepared value; edits remain visible. */
+export declare function processLaunchDeclaration(config: ProcessConfig): ProcessConfig;
+export declare function processLaunchIdentity(config: ProcessConfig): string;
+export declare function processLaunchIdentityChanged(current: ProcessConfig | undefined, next: ProcessConfig): boolean;
+/**
+ * The daemon's process pool: the configs it stored (ad-hoc registrations and
+ * launch records, including split-repository dependencies), overlaid by the
+ * declared graph, which wins by id.
+ */
+export declare function mergeProcessPool(stored: readonly ProcessConfig[], declared: readonly ProcessConfig[]): ProcessConfig[];
+//# sourceMappingURL=launch-identity.d.ts.map

package/dist/helpers/launch-identity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"launch-identity.d.ts","sourceRoot":"","sources":["../../src/helpers/launch-identity.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAQH,OAAO,EAA6B,KAAK,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAkCtF,yFAAyF;AACzF,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,aAAa,GAAG,aAAa,CAc7E;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM,CAEnE;AAED,wBAAgB,4BAA4B,CAAC,OAAO,EAAE,aAAa,GAAG,SAAS,EAAE,IAAI,EAAE,aAAa,GAAG,OAAO,CAE7G;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,SAAS,aAAa,EAAE,EAAE,QAAQ,EAAE,SAAS,aAAa,EAAE,GAAG,aAAa,EAAE,CAItH"}

package/dist/helpers/launch-identity.js

@@ -0,0 +1,70 @@
+/**
+ * Launch identity and the daemon's process pool.
+ *
+ * A running process is idempotent only when it is the process the caller
+ * would launch now. This matters for durable daemons after an application
+ * update: the process id and socket can stay stable while the executable
+ * moves from an older source checkout to the newly bundled CLI.
+ */
+import * as z from 'zod/v4';
+import { isJsonObject, JsonValueFromReaderSchema } from '@vibesdotdev/kernel/schemas/json';
+import { ProcessLaunchInputsSchema } from "../schemas/process.js";
+/**
+ * Canonical JSON form for identity comparison: object keys sorted with
+ * localeCompare at every depth, array (argv) order preserved. Branches only
+ * on the parsed JSON domain (null check + Array.isArray), never on `typeof`.
+ */
+function canonicalize(value) {
+    if (isJsonObject(value)) {
+        return Object.fromEntries(Object.entries(value)
+            .sort(([left], [right]) => left.localeCompare(right))
+            .map(([key, child]) => [key, canonicalize(child)]));
+    }
+    if (Array.isArray(value))
+        return value.map(canonicalize);
+    return value;
+}
+/** Stable canonical text of one launch-input field, parsed at the JSON value boundary. */
+function canonicalField(value) {
+    if (value === undefined)
+        return undefined;
+    return JSON.stringify(canonicalize(JsonValueFromReaderSchema.parse(value)));
+}
+/** Stable canonical text of a whole launch-inputs record, with argv and env normalized. */
+function canonicalInputs(inputs) {
+    const filled = { ...inputs, args: inputs.args ?? [], env: inputs.env ?? {} };
+    return JSON.stringify(canonicalize(JsonValueFromReaderSchema.parse(filled)));
+}
+/** Restore only fields still equal to the saved prepared value; edits remain visible. */
+export function processLaunchDeclaration(config) {
+    const provenance = config.launchProvenance;
+    if (!provenance)
+        return config;
+    const inputs = ProcessLaunchInputsSchema.parse(config);
+    const preparedByField = new Map(Object.entries(provenance.prepared));
+    const declarationByField = new Map(Object.entries(provenance.declaration));
+    const restored = Object.fromEntries(Object.entries(inputs).map(([key, value]) => {
+        const prepared = preparedByField.get(key);
+        return [key, prepared !== undefined && canonicalField(value) === canonicalField(prepared)
+                ? declarationByField.get(key) : value];
+    }));
+    return { ...config, ...restored, launchProvenance: undefined };
+}
+export function processLaunchIdentity(config) {
+    return canonicalInputs(ProcessLaunchInputsSchema.parse(processLaunchDeclaration(config)));
+}
+export function processLaunchIdentityChanged(current, next) {
+    return !current || processLaunchIdentity(current) !== processLaunchIdentity(next);
+}
+/**
+ * The daemon's process pool: the configs it stored (ad-hoc registrations and
+ * launch records, including split-repository dependencies), overlaid by the
+ * declared graph, which wins by id.
+ */
+export function mergeProcessPool(stored, declared) {
+    const byId = new Map(stored.map((config) => [config.id, config]));
+    for (const config of declared)
+        byId.set(config.id, config);
+    return [...byId.values()];
+}
+//# sourceMappingURL=launch-identity.js.map

package/dist/helpers/launch-identity.js.map

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

package/dist/helpers/managed-http-origin.d.ts

@@ -0,0 +1,4 @@
+import type { ProcessConfig } from '../schemas/process.ts';
+/** The registered process owns its HTTP authority; callers invent no host or port. */
+export declare function resolveManagedHttpOrigin(config: ProcessConfig): string | null;
+//# sourceMappingURL=managed-http-origin.d.ts.map

package/dist/helpers/managed-http-origin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"managed-http-origin.d.ts","sourceRoot":"","sources":["../../src/helpers/managed-http-origin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAE3D,sFAAsF;AACtF,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM,GAAG,IAAI,CAK7E"}

package/dist/helpers/managed-http-origin.js

@@ -0,0 +1,9 @@
+/** The registered process owns its HTTP authority; callers invent no host or port. */
+export function resolveManagedHttpOrigin(config) {
+    const endpoint = config.healthCheck?.endpoint;
+    if (config.healthCheck?.type !== 'http' || !endpoint || !URL.canParse(endpoint))
+        return null;
+    const url = new URL(endpoint);
+    return url.protocol === 'http:' || url.protocol === 'https:' ? url.origin : null;
+}
+//# sourceMappingURL=managed-http-origin.js.map

package/dist/helpers/managed-http-origin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"managed-http-origin.js","sourceRoot":"","sources":["../../src/helpers/managed-http-origin.ts"],"names":[],"mappings":"AAEA,sFAAsF;AACtF,MAAM,UAAU,wBAAwB,CAAC,MAAqB;IAC7D,MAAM,QAAQ,GAAG,MAAM,CAAC,WAAW,EAAE,QAAQ,CAAC;IAC9C,IAAI,MAAM,CAAC,WAAW,EAAE,IAAI,KAAK,MAAM,IAAI,CAAC,QAAQ,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC;QAAE,OAAO,IAAI,CAAC;IAC7F,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,CAAC;IAC9B,OAAO,GAAG,CAAC,QAAQ,KAAK,OAAO,IAAI,GAAG,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC;AAClF,CAAC"}

package/dist/helpers/managed-process-admission.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Admitting and restarting one registered process through PM, shared by the
+ * daemon-module context (PM's own manager, in the daemon) and the runtime
+ * daemon supervisor (PM's client, in any other process). Both narrow PM to the
+ * calls below, so a caller can restart a process PM registered but cannot
+ * register commands or reach unrelated processes.
+ */
+import { CapabilityError } from '@vibesdotdev/kernel';
+import type { StartOptions, StopOptions } from '../interface.ts';
+import type { PMProcessAdmissionReceipt } from '../kinds/daemon-module.kind.ts';
+import type { ProcessConfig, ProcessState } from '../schemas/process.ts';
+/** Bound on a declared readiness check after a start or restart. */
+export declare const MANAGED_PROCESS_READY_TIMEOUT_MS = 45000;
+/** PM's process authority a managed restart uses: its manager in the daemon, its client elsewhere. */
+export interface ManagedProcessAuthority {
+    getConfig(processId: string): Promise<ProcessConfig | undefined>;
+    start(config: ProcessConfig, options?: StartOptions): Promise<ProcessState>;
+    getStatus(processId: string): Promise<ProcessState | undefined>;
+    stop(processId: string, options?: StopOptions): Promise<void>;
+    restart(processId: string, options?: StartOptions): Promise<ProcessState>;
+}
+export declare function processNotRegistered(processId: string): CapabilityError;
+/** Start options that await the process's declared readiness, when it declares one. */
+export declare function readinessStartOptions(config: ProcessConfig): StartOptions;
+/**
+ * The admission receipt for a state PM returned, or the typed refusal: the
+ * process did not enter `running`, or it declares a readiness check it did
+ * not pass.
+ */
+export declare function admittedProcessReceipt(processId: string, config: ProcessConfig, state: ProcessState): PMProcessAdmissionReceipt;
+/** The pid of a registered process's live run, or `null` when PM tracks no running run. */
+export declare function managedProcessPid(pm: ManagedProcessAuthority, processId: string): Promise<number | null>;
+/**
+ * Restart a registered process through PM: PM stops its tracked run (if one
+ * is live) and starts a fresh one, awaiting declared readiness. `force` kills
+ * the live run outright first (PM's own restart stops gracefully). The process
+ * stays PM's: its record, auto-restart and logs carry over to the new run.
+ */
+export declare function restartManagedProcess(pm: ManagedProcessAuthority, processId: string, options?: {
+    force?: boolean;
+}): Promise<PMProcessAdmissionReceipt>;
+/**
+ * Start a registered process through PM unless it already runs (PM's start is
+ * idempotent and serialized per process), awaiting declared readiness.
+ */
+export declare function ensureManagedProcess(pm: ManagedProcessAuthority, processId: string): Promise<PMProcessAdmissionReceipt>;
+/**
+ * Stop a registered process's live run through PM, on purpose: PM records the
+ * run stopped by its own stop command, so it does not auto-restart it. A
+ * process PM does not track as running has nothing to stop.
+ */
+export declare function stopManagedProcess(pm: ManagedProcessAuthority, processId: string, options?: {
+    force?: boolean;
+}): Promise<void>;
+//# sourceMappingURL=managed-process-admission.d.ts.map

package/dist/helpers/managed-process-admission.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"managed-process-admission.d.ts","sourceRoot":"","sources":["../../src/helpers/managed-process-admission.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AACjE,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,gCAAgC,CAAC;AAChF,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAEzE,oEAAoE;AACpE,eAAO,MAAM,gCAAgC,QAAS,CAAC;AAEvD,sGAAsG;AACtG,MAAM,WAAW,uBAAuB;IACvC,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,SAAS,CAAC,CAAC;IACjE,KAAK,CAAC,MAAM,EAAE,aAAa,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IAC5E,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,SAAS,CAAC,CAAC;IAChE,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9D,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;CAC1E;AAED,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,eAAe,CAKvE;AAED,uFAAuF;AACvF,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,aAAa,GAAG,YAAY,CAGzE;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CACrC,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,aAAa,EACrB,KAAK,EAAE,YAAY,GACjB,yBAAyB,CAkB3B;AAED,2FAA2F;AAC3F,wBAAsB,iBAAiB,CAAC,EAAE,EAAE,uBAAuB,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAM9G;AAED;;;;;GAKG;AACH,wBAAsB,qBAAqB,CAC1C,EAAE,EAAE,uBAAuB,EAC3B,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAA;CAAO,GAC/B,OAAO,CAAC,yBAAyB,CAAC,CAWpC;AAED;;;GAGG;AACH,wBAAsB,oBAAoB,CAAC,EAAE,EAAE,uBAAuB,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,yBAAyB,CAAC,CAM7H;AAED;;;;GAIG;AACH,wBAAsB,kBAAkB,CACvC,EAAE,EAAE,uBAAuB,EAC3B,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAA;CAAO,GAC/B,OAAO,CAAC,IAAI,CAAC,CAQf"}