@avantf/dsh-plugin-base 0.3.1

package/dist/internal.js

@@ -0,0 +1,18 @@
+/**
+ * Framework building blocks shared by the core and the entry points.
+ * @module internal
+ */
+export { defaultFs, exists, linkOrCopy } from './fs.js';
+export { defaultLock, pidIsAlive } from './lock.js';
+export { extractTarGz, safeEntryPath } from './tar.js';
+export { extractZip } from './zip.js';
+export { assertRange, compareVersions, parseRange, parseVersion, satisfies, satisfiesRange, selectVersion } from './semver.js';
+export { INSTALL_MANIFEST_FILE, MANIFEST_SCHEMA_VERSION, aliasLegacyManifest, decodeJson, encodeInstallManifest, readInstallManifest, } from './manifest.js';
+export { assertPackageName } from './package-name.js';
+export { sriOfSha256, verifyIntegrity } from './integrity.js';
+export { LAYOUT_SCHEMA_VERSION, STATUS_SCHEMA_VERSION, mergeRows, persistStatus, readDeclared, readLayout, readStatus, recordDeclared, writeLayout, } from './state.js';
+export { BUILTIN_KINDS, IMPLEMENTED_POLICY_KEYS, ITEM_FIELDS, MANIFEST_FIELDS, UNIMPLEMENTED_POLICY_KEYS, UNIMPLEMENTED_PROVISION_POLICY_KEYS, hasStarBranch, isNamespacedKind, lintManifest, lintManifestText, unknownFields, } from './lint.js';
+export { candidateUrls, downloadBytes, fetchImplOf, platformKey, readCapped, signalFor, verifySha256, DEFAULT_MAX_BYTES } from './net.js';
+export { CONTROL_DIR, assertSafeRelativePath, assertSafeRelativeRoot, controlRoot, declaredPath, layoutPath, lockPath, quarantineRoot, stagingDir, statusLockPath, statusPath, tempRoot, versionSegment, } from './layout.js';
+export { BOOTSTRAP_SUBPATH, FRAMEWORK_INLINING_BEACONS, FRAMEWORK_PACKAGE, MIN_INLINING_BEACONS, findFrameworkImports, findInliningBeacons, isBootstrapSpecifier, } from './artifact.js';
+//# sourceMappingURL=internal.js.map

package/dist/internal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"internal.js","sourceRoot":"","sources":["../src/internal.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,SAAS,CAAA;AACvD,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,WAAW,CAAA;AACnD,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AACtD,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAA;AAErC,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,UAAU,EAAE,YAAY,EAAE,SAAS,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAE9H,OAAO,EACL,qBAAqB,EACrB,uBAAuB,EACvB,mBAAmB,EACnB,UAAU,EACV,qBAAqB,EACrB,mBAAmB,GACpB,MAAM,eAAe,CAAA;AACtB,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAA;AACrD,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAA;AAC7D,OAAO,EACL,qBAAqB,EACrB,qBAAqB,EACrB,SAAS,EACT,aAAa,EACb,YAAY,EACZ,UAAU,EACV,UAAU,EACV,cAAc,EACd,WAAW,GACZ,MAAM,YAAY,CAAA;AAEnB,OAAO,EACL,aAAa,EACb,uBAAuB,EACvB,WAAW,EACX,eAAe,EACf,yBAAyB,EACzB,mCAAmC,EACnC,aAAa,EACb,gBAAgB,EAChB,YAAY,EACZ,gBAAgB,EAChB,aAAa,GACd,MAAM,WAAW,CAAA;AAElB,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,WAAW,EAAE,WAAW,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAA;AACzI,OAAO,EACL,WAAW,EACX,sBAAsB,EACtB,sBAAsB,EACtB,WAAW,EACX,YAAY,EACZ,UAAU,EACV,QAAQ,EACR,cAAc,EACd,UAAU,EACV,cAAc,EACd,UAAU,EACV,QAAQ,EACR,cAAc,GACf,MAAM,aAAa,CAAA;AACpB,OAAO,EACL,iBAAiB,EACjB,0BAA0B,EAC1B,iBAAiB,EACjB,oBAAoB,EACpB,oBAAoB,EACpB,mBAAmB,EACnB,oBAAoB,GACrB,MAAM,eAAe,CAAA"}

package/dist/kit/family.d.ts

@@ -0,0 +1,52 @@
+/** `~/x` → `<home>/x`, `~` → `<home>`; anything else is used as given. */
+export declare function expandHome(path: string, home?: string): string;
+/** The family root: `$AVANTF_HOME` when set, else `~/.avantf/env`. */
+export declare function familyHome(env?: Record<string, string | undefined>): string;
+/** The managed external-binary root (`<family root>/tools`). */
+export declare function familyToolsDir(env?: Record<string, string | undefined>): string;
+/** The managed model-cache root (`<family root>/models`). */
+export declare function familyModelsDir(env?: Record<string, string | undefined>): string;
+/**
+ * The input to {@link resolveDataHome}: every value in a NAMED slot, never a position.
+ *
+ * The slots are the family's layers, and their meanings ARE the contract:
+ *
+ *  - `explicit` — layer ⑤, a caller's own value (the CLI's `--data-home`);
+ *  - `env` — layer ④, the environment map `$AVANTF_HOME` is read from; defaults to `process.env`;
+ *  - `configured` — layer ②, the resolved `common.dataHome` from configuration.
+ *
+ * The named shape is not decoration. Both implementations used to take three POSITIONAL arguments and
+ * disagreed about their order (this kit read `(explicit, env, common)`, the mem engine
+ * `(common, explicit)`), so "which slot does the profile's `dataHome` belong in?" — the one question
+ * that decides where the user's memory, knowledge and prompts live — was answerable only by reading
+ * the call site's argument order. `common.dataHome` carries a schema default and therefore ALWAYS
+ * holds a value: in the `explicit` slot it promotes layer ② above layer ④ and silently kills
+ * `$AVANTF_HOME` on that side of the family, which is how the same config came to resolve to two
+ * different directories. A named object makes that a type error instead of a diff nobody reads.
+ *
+ * This shape is the base interface type's `dataHomeInput` member; the two must stay identical.
+ */
+export interface DataHomeInput {
+    /** Layer ⑤: an explicit caller value; blank or omitted means "not given". */
+    readonly explicit?: string;
+    /** Layer ④: the environment map; defaults to `process.env`. */
+    readonly env?: Record<string, string | undefined>;
+    /** Layer ②: the configured `common.dataHome`; blank or omitted means "not configured". */
+    readonly configured?: string;
+}
+/**
+ * The data root: an explicit caller value (⑤) → `$AVANTF_HOME` (④) → the configured
+ * `common.dataHome` (②) → `~/.avantf`. That is the family's layer order (`mem/AGENTS.md`
+ * 「配置分层」: built-in → common.yaml → store → ENV → explicit), so the environment wins over the
+ * config file and an explicit argument wins over both.
+ *
+ * The configured value is a NAMED slot ({@link DataHomeInput}) for the reason recorded there: it
+ * always holds a value, so a positional API let a caller hand it to the `explicit` slot and make
+ * `$AVANTF_HOME` dead on one side of the family. The two implementations (this kit and
+ * `@avantf/mem-contract`) are pinned to the same answer by
+ * `mem/packages/plugin/test/family_pin.spec.ts`.
+ *
+ * `~/` (and a bare `~`) is expanded here so every caller agrees on one directory.
+ */
+export declare function resolveDataHome(input?: DataHomeInput): string;
+//# sourceMappingURL=family.d.ts.map

package/dist/kit/family.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"family.d.ts","sourceRoot":"","sources":["../../src/kit/family.ts"],"names":[],"mappings":"AAwBA,0EAA0E;AAC1E,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,MAAkB,GAAG,MAAM,CAGzE;AAED,sEAAsE;AACtE,wBAAgB,UAAU,CAAC,GAAG,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAe,GAAG,MAAM,CAGxF;AAED,gEAAgE;AAChE,wBAAgB,cAAc,CAAC,GAAG,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAe,GAAG,MAAM,CAE5F;AAED,6DAA6D;AAC7D,wBAAgB,eAAe,CAAC,GAAG,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAe,GAAG,MAAM,CAE7F;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,WAAW,aAAa;IAC5B,6EAA6E;IAC7E,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;IAC1B,+DAA+D;IAC/D,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAA;IACjD,0FAA0F;IAC1F,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAC7B;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,eAAe,CAAC,KAAK,GAAE,aAAkB,GAAG,MAAM,CAOjE"}

package/dist/kit/family.js

@@ -0,0 +1,65 @@
+/**
+ * The family's path conventions — ONE definition of two directories that four modules used to spell
+ * out independently (`@avantf/mem-contract`, `@avantf/mem-provision`, `@avantf/mem`'s config paths
+ * and the work plugin's prompt layer). They are part of the kit because a change to either convention
+ * must be fixable with one base release.
+ *
+ * TWO ROOTS, and they are deliberately different. Confusing them is the bug this module documents:
+ *
+ *  - the **family root** (`familyHome`) is where the environment framework installs what it manages:
+ *    `$AVANTF_HOME` when set, else `~/.avantf/env`. Tools live in `<family root>/tools`, model
+ *    weights in `<family root>/models`.
+ *  - the **data root** (`resolveDataHome`) is where a plugin keeps the user's OWN data and editable
+ *    text: `memory/`, `knowledge/`, `configs/*.yaml`, `prompts/*.md`. Precedence is an explicit caller
+ *    value (⑤) → `$AVANTF_HOME` (④) → the configured `dataHome` (②) → `~/.avantf`.
+ *
+ * Setting `$AVANTF_HOME` therefore redirects BOTH a deployment's data and its managed resources under
+ * one prefix — which is what a sandbox or a test needs — while the unset default keeps them apart
+ * (`~/.avantf` for data, `~/.avantf/env` for resources).
+ *
+ * @module @avantf/dsh-plugin-base/kit/family
+ */
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+/** `~/x` → `<home>/x`, `~` → `<home>`; anything else is used as given. */
+export function expandHome(path, home = homedir()) {
+    if (path === '~')
+        return home;
+    return path.startsWith('~/') ? join(home, path.slice(2)) : path;
+}
+/** The family root: `$AVANTF_HOME` when set, else `~/.avantf/env`. */
+export function familyHome(env = process.env) {
+    const configured = env['AVANTF_HOME']?.trim() ?? '';
+    return configured !== '' ? expandHome(configured) : join(homedir(), '.avantf', 'env');
+}
+/** The managed external-binary root (`<family root>/tools`). */
+export function familyToolsDir(env = process.env) {
+    return join(familyHome(env), 'tools');
+}
+/** The managed model-cache root (`<family root>/models`). */
+export function familyModelsDir(env = process.env) {
+    return join(familyHome(env), 'models');
+}
+/**
+ * The data root: an explicit caller value (⑤) → `$AVANTF_HOME` (④) → the configured
+ * `common.dataHome` (②) → `~/.avantf`. That is the family's layer order (`mem/AGENTS.md`
+ * 「配置分层」: built-in → common.yaml → store → ENV → explicit), so the environment wins over the
+ * config file and an explicit argument wins over both.
+ *
+ * The configured value is a NAMED slot ({@link DataHomeInput}) for the reason recorded there: it
+ * always holds a value, so a positional API let a caller hand it to the `explicit` slot and make
+ * `$AVANTF_HOME` dead on one side of the family. The two implementations (this kit and
+ * `@avantf/mem-contract`) are pinned to the same answer by
+ * `mem/packages/plugin/test/family_pin.spec.ts`.
+ *
+ * `~/` (and a bare `~`) is expanded here so every caller agrees on one directory.
+ */
+export function resolveDataHome(input = {}) {
+    const layer5 = input.explicit?.trim() ?? '';
+    const env = input.env ?? process.env;
+    const fromEnv = env['AVANTF_HOME']?.trim() ?? '';
+    const layer2 = input.configured?.trim() ?? '';
+    const base = layer5 !== '' ? layer5 : fromEnv !== '' ? fromEnv : layer2 !== '' ? layer2 : '~/.avantf';
+    return expandHome(base);
+}
+//# sourceMappingURL=family.js.map

package/dist/kit/family.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"family.js","sourceRoot":"","sources":["../../src/kit/family.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAA;AACjC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAEhC,0EAA0E;AAC1E,MAAM,UAAU,UAAU,CAAC,IAAY,EAAE,OAAe,OAAO,EAAE;IAC/D,IAAI,IAAI,KAAK,GAAG;QAAE,OAAO,IAAI,CAAA;IAC7B,OAAO,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAA;AACjE,CAAC;AAED,sEAAsE;AACtE,MAAM,UAAU,UAAU,CAAC,MAA0C,OAAO,CAAC,GAAG;IAC9E,MAAM,UAAU,GAAG,GAAG,CAAC,aAAa,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAA;IACnD,OAAO,UAAU,KAAK,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,KAAK,CAAC,CAAA;AACvF,CAAC;AAED,gEAAgE;AAChE,MAAM,UAAU,cAAc,CAAC,MAA0C,OAAO,CAAC,GAAG;IAClF,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC,CAAA;AACvC,CAAC;AAED,6DAA6D;AAC7D,MAAM,UAAU,eAAe,CAAC,MAA0C,OAAO,CAAC,GAAG;IACnF,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,QAAQ,CAAC,CAAA;AACxC,CAAC;AA+BD;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,eAAe,CAAC,QAAuB,EAAE;IACvD,MAAM,MAAM,GAAG,KAAK,CAAC,QAAQ,EAAE,IAAI,EAAE,IAAI,EAAE,CAAA;IAC3C,MAAM,GAAG,GAAG,KAAK,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,CAAA;IACpC,MAAM,OAAO,GAAG,GAAG,CAAC,aAAa,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAA;IAChD,MAAM,MAAM,GAAG,KAAK,CAAC,UAAU,EAAE,IAAI,EAAE,IAAI,EAAE,CAAA;IAC7C,MAAM,IAAI,GAAG,MAAM,KAAK,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,KAAK,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,KAAK,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,WAAW,CAAA;IACrG,OAAO,UAAU,CAAC,IAAI,CAAC,CAAA;AACzB,CAAC"}

package/dist/kit/index.d.ts

@@ -0,0 +1,26 @@
+/**
+ * The shared KIT: pure, DSH-free helpers used by the family's DSH plugins.
+ *
+ * This is NOT a package. It is a source area INSIDE the one published base package
+ * (`@avantf/dsh-plugin-base`), and that is the whole point: fixing or extending a shared helper must
+ * be possible with ONE base release, without rebuilding or republishing any plugin. Plugins
+ * therefore never inline this code — they load the base at startup through the inlined bootstrap
+ * (the only vendored piece) and take these capabilities off the loaded module at runtime:
+ *
+ *  - prompt file reading/writing (`PromptFiles`),
+ *  - the plugin logger (`createPluginLogger`),
+ *  - the family path conventions (`familyHome` / `familyToolsDir` / `familyModelsDir` /
+ *    `resolveDataHome` / `expandHome`),
+ *  - the Typert wire conventions (`strictCodec` / endpoint and field symbols).
+ *
+ * When the base is unavailable, every consumer degrades instead of failing: the prompt layer falls
+ * back to the plugin's OWN built-in default bodies, the compatibility gate logs its `compat:`
+ * WARNING and is skipped, and the plugin mounts in full. See the root `AGENTS.md`.
+ *
+ * @module @avantf/dsh-plugin-base/kit
+ */
+export * from './prompt_files.js';
+export * from './logger.js';
+export * from './typert.js';
+export * from './family.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/kit/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/kit/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,cAAc,mBAAmB,CAAA;AACjC,cAAc,aAAa,CAAA;AAC3B,cAAc,aAAa,CAAA;AAC3B,cAAc,aAAa,CAAA"}

package/dist/kit/index.js

@@ -0,0 +1,26 @@
+/**
+ * The shared KIT: pure, DSH-free helpers used by the family's DSH plugins.
+ *
+ * This is NOT a package. It is a source area INSIDE the one published base package
+ * (`@avantf/dsh-plugin-base`), and that is the whole point: fixing or extending a shared helper must
+ * be possible with ONE base release, without rebuilding or republishing any plugin. Plugins
+ * therefore never inline this code — they load the base at startup through the inlined bootstrap
+ * (the only vendored piece) and take these capabilities off the loaded module at runtime:
+ *
+ *  - prompt file reading/writing (`PromptFiles`),
+ *  - the plugin logger (`createPluginLogger`),
+ *  - the family path conventions (`familyHome` / `familyToolsDir` / `familyModelsDir` /
+ *    `resolveDataHome` / `expandHome`),
+ *  - the Typert wire conventions (`strictCodec` / endpoint and field symbols).
+ *
+ * When the base is unavailable, every consumer degrades instead of failing: the prompt layer falls
+ * back to the plugin's OWN built-in default bodies, the compatibility gate logs its `compat:`
+ * WARNING and is skipped, and the plugin mounts in full. See the root `AGENTS.md`.
+ *
+ * @module @avantf/dsh-plugin-base/kit
+ */
+export * from './prompt_files.js';
+export * from './logger.js';
+export * from './typert.js';
+export * from './family.js';
+//# sourceMappingURL=index.js.map

package/dist/kit/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/kit/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,cAAc,mBAAmB,CAAA;AACjC,cAAc,aAAa,CAAA;AAC3B,cAAc,aAAa,CAAA;AAC3B,cAAc,aAAa,CAAA"}

package/dist/kit/logger.d.ts

@@ -0,0 +1,41 @@
+/**
+ * The plugin log sink — ONE implementation for every plugin in the family.
+ *
+ * It merges the two loggers the plugins used to carry separately:
+ *
+ *  - the memory side's `createConsoleLogger(prefix)` (`@avantf/mem-contract`): a stable
+ *    `[avantf-mem] LEVEL message` line on STDERR, because the CLI and the MCP server own stdout for
+ *    JSON / JSON-RPC;
+ *  - the work side's `createLogger(host, sink)`: the same stderr line, PLUS a mirror into the host's
+ *    `ctx.logger` (`ctx.logger` alone never reaches the terminal).
+ *
+ * Both planes are kept, and each is independently injectable so a spec can assert the lines. Nothing
+ * here throws: a logging failure must never take down the engine it is describing, so the host
+ * mirror is wrapped and the sink is the caller's responsibility.
+ *
+ * @module @avantf/dsh-plugin-base/kit/logger
+ */
+/** One leveled log sink. */
+export interface PluginLogger {
+    info(message: string): void;
+    warn(message: string): void;
+    error(message: string): void;
+}
+/** The `ctx.logger` slice a plugin mirrors into; every method is optional. */
+export type PluginLoggerHost = Partial<PluginLogger>;
+export interface PluginLoggerOptions {
+    /** The stable token every line starts with, e.g. `[avantf-mem]`. */
+    readonly prefix: string;
+    /** The host logger to mirror into, when there is one. */
+    readonly host?: PluginLoggerHost;
+    /** Where the stderr line lands; defaults to `console.error` (stdout stays free). */
+    readonly sink?: (line: string) => void;
+}
+/**
+ * Build a plugin logger.
+ *
+ * @param options - the prefix, an optional host mirror, an optional sink override.
+ * @returns the leveled logger.
+ */
+export declare function createPluginLogger(options: PluginLoggerOptions): PluginLogger;
+//# sourceMappingURL=logger.d.ts.map

package/dist/kit/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/kit/logger.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,4BAA4B;AAC5B,MAAM,WAAW,YAAY;IAC3B,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3B,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3B,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;CAC7B;AAED,8EAA8E;AAC9E,MAAM,MAAM,gBAAgB,GAAG,OAAO,CAAC,YAAY,CAAC,CAAA;AAEpD,MAAM,WAAW,mBAAmB;IAClC,oEAAoE;IACpE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,yDAAyD;IACzD,QAAQ,CAAC,IAAI,CAAC,EAAE,gBAAgB,CAAA;IAChC,oFAAoF;IACpF,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;CACvC;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,mBAAmB,GAAG,YAAY,CAgB7E"}

package/dist/kit/logger.js

@@ -0,0 +1,42 @@
+/**
+ * The plugin log sink — ONE implementation for every plugin in the family.
+ *
+ * It merges the two loggers the plugins used to carry separately:
+ *
+ *  - the memory side's `createConsoleLogger(prefix)` (`@avantf/mem-contract`): a stable
+ *    `[avantf-mem] LEVEL message` line on STDERR, because the CLI and the MCP server own stdout for
+ *    JSON / JSON-RPC;
+ *  - the work side's `createLogger(host, sink)`: the same stderr line, PLUS a mirror into the host's
+ *    `ctx.logger` (`ctx.logger` alone never reaches the terminal).
+ *
+ * Both planes are kept, and each is independently injectable so a spec can assert the lines. Nothing
+ * here throws: a logging failure must never take down the engine it is describing, so the host
+ * mirror is wrapped and the sink is the caller's responsibility.
+ *
+ * @module @avantf/dsh-plugin-base/kit/logger
+ */
+/**
+ * Build a plugin logger.
+ *
+ * @param options - the prefix, an optional host mirror, an optional sink override.
+ * @returns the leveled logger.
+ */
+export function createPluginLogger(options) {
+    const { prefix, host } = options;
+    const sink = options.sink ?? ((line) => { console.error(line); });
+    const emit = (level, message) => {
+        sink(`${prefix} ${level.toUpperCase()} ${message}`);
+        try {
+            host?.[level]?.(`${prefix} ${message}`);
+        }
+        catch {
+            // A logging failure must never take down the engine it is describing.
+        }
+    };
+    return {
+        info: (message) => { emit('info', message); },
+        warn: (message) => { emit('warn', message); },
+        error: (message) => { emit('error', message); },
+    };
+}
+//# sourceMappingURL=logger.js.map

package/dist/kit/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/kit/logger.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAqBH;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAAC,OAA4B;IAC7D,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,OAAO,CAAA;IAChC,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,CAAC,CAAC,IAAY,EAAQ,EAAE,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA,CAAC,CAAC,CAAC,CAAA;IAC9E,MAAM,IAAI,GAAG,CAAC,KAAgC,EAAE,OAAe,EAAQ,EAAE;QACvE,IAAI,CAAC,GAAG,MAAM,IAAI,KAAK,CAAC,WAAW,EAAE,IAAI,OAAO,EAAE,CAAC,CAAA;QACnD,IAAI,CAAC;YACH,IAAI,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,GAAG,MAAM,IAAI,OAAO,EAAE,CAAC,CAAA;QACzC,CAAC;QAAC,MAAM,CAAC;YACP,sEAAsE;QACxE,CAAC;IACH,CAAC,CAAA;IACD,OAAO;QACL,IAAI,EAAE,CAAC,OAAO,EAAE,EAAE,GAAG,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA,CAAC,CAAC;QAC5C,IAAI,EAAE,CAAC,OAAO,EAAE,EAAE,GAAG,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA,CAAC,CAAC;QAC5C,KAAK,EAAE,CAAC,OAAO,EAAE,EAAE,GAAG,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAA,CAAC,CAAC;KAC/C,CAAA;AACH,CAAC"}

package/dist/kit/prompt_files.d.ts

@@ -0,0 +1,90 @@
+/**
+ * User-editable prompt text: one `.md` per prompt section, in the family's shared prompt directory
+ * (`<data home>/prompts`, where each plugin owns a prefix — `mem-*` in the memory plugin, `work-*`
+ * in the work engine).
+ *
+ * This lived, byte-for-byte identical except for its header comment, in BOTH plugins
+ * (`@avantf/dsh-mem`'s and `@avantf/dsh-work`'s `packages/plugin/src/prompt_files.ts`) — the copy
+ * was deliberate while the two were separate repositories with no shared family package, and the two
+ * headers said "if a third consumer appears, hoist it into one shared package rather than copy it
+ * again". The merge into one workspace is that moment: it now lives in the base
+ * (`@avantf/dsh-plugin-base/kit`), and a plugin takes it off the base module at RUNTIME, loaded by
+ * the inlined bootstrap. It is deliberately NOT inlined into a plugin bundle: a fix to the shared
+ * prompt layer must ship as ONE base release, with no rebuild or republish of any plugin. When the
+ * base is absent, the plugin degrades instead of failing — the prompt layer is unavailable and the
+ * plugin uses its OWN built-in default bodies (the defaults are the plugin's content, not a copy of
+ * this module).
+ *
+ * Every prompt section a plugin contributes has the SAME lifecycle — the file has to exist, a
+ * missing or blank one is filled with the built-in default, and what is on disk wins on the next
+ * start — so that flow lives here ONCE instead of once per section next to each default string. The
+ * caller owns the manifest (file name, which section it feeds, the default body); this owns HOW the
+ * file is materialized and read, the same division of labour `GitRepo` (in the engine) uses for the
+ * on-disk artifacts it versions without knowing what they are.
+ *
+ * THREE PROPERTIES ARE LOAD-BEARING, and they are why this is not `readFileSync` at each call site:
+ *
+ *  - **It never throws.** A read-only data home, a directory sitting where a file should be, a
+ *    permission error — none of them may keep a plugin from mounting, because a throwing `apply`
+ *    fails the whole `dsh web` boot (measured). Every failure warns and falls back to the default
+ *    text, the same rule `IngestResult.file_error` follows for the managed document copy.
+ *  - **It never overwrites what the user wrote.** Only a missing file or a blank one is written; one
+ *    visible character makes the file the user's, including a wrong one.
+ *  - **The file IS the prompt.** Its whole body is injected (outer whitespace trimmed, BOM stripped,
+ *    CRLF normalized). There is no frontmatter, no marker and no header comment to strip — a comment
+ *    would be injected into the model's prompt too, so the default files carry none, and the
+ *    documentation for them lives in DESIGN and the README.
+ */
+export interface PromptFileSpec {
+    /** File name inside the prompt directory; it is also the handle used in log lines. */
+    readonly file: string;
+    /** Written when the file is missing or blank; also the text used when the disk is unusable. */
+    readonly fallback: string;
+}
+export interface LoadedPromptText {
+    readonly file: string;
+    readonly path: string;
+    /** The text to inject: the file's body, or the fallback when the file could not be used. */
+    readonly text: string;
+    /**
+     * `file` — read from disk and used as-is.
+     * `default` — the default was used, either because it was just written (missing/blank) or because
+     * the file could not be read/created. `wrote` says which.
+     */
+    readonly source: 'file' | 'default';
+    /** True when this call created or filled the file. */
+    readonly wrote: boolean;
+}
+/** The filesystem slice this module uses; injectable so its specs need no real directory. */
+export interface PromptFilesIo {
+    exists(path: string): boolean;
+    read(path: string): string;
+    /** Must land atomically (temp file + rename), so a crash cannot leave a half-written prompt. */
+    write(path: string, text: string): void;
+    ensureDir(path: string): void;
+}
+/** Structurally what a plugin logger already is; declared locally to keep this module dependency-free. */
+export interface PromptFilesLogger {
+    info(message: string): void;
+    warn(message: string): void;
+}
+export interface PromptFilesOptions {
+    /** Directory holding one `.md` per section. Created when missing. */
+    readonly dir: string;
+    readonly logger?: PromptFilesLogger;
+    /** Overridable for tests; defaults to the real filesystem. */
+    readonly io?: PromptFilesIo;
+}
+export declare class PromptFiles {
+    readonly dir: string;
+    private readonly logger;
+    private readonly io;
+    constructor(options: PromptFilesOptions);
+    /**
+     * Ensure every spec's file exists with content, then return the text to inject. Ordered like the
+     * manifest, so the caller can zip the result back onto its sections.
+     */
+    load(specs: readonly PromptFileSpec[]): readonly LoadedPromptText[];
+    private loadOne;
+}
+//# sourceMappingURL=prompt_files.d.ts.map

package/dist/kit/prompt_files.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt_files.d.ts","sourceRoot":"","sources":["../../src/kit/prompt_files.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,MAAM,WAAW,cAAc;IAC7B,sFAAsF;IACtF,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,+FAA+F;IAC/F,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;CAC1B;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,4FAA4F;IAC5F,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB;;;;OAIG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAA;IACnC,sDAAsD;IACtD,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAA;CACxB;AAED,6FAA6F;AAC7F,MAAM,WAAW,aAAa;IAC5B,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAA;IAC7B,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAA;IAC1B,gGAAgG;IAChG,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;IACvC,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;CAC9B;AAED,0GAA0G;AAC1G,MAAM,WAAW,iBAAiB;IAChC,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3B,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;CAC5B;AAED,MAAM,WAAW,kBAAkB;IACjC,qEAAqE;IACrE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,MAAM,CAAC,EAAE,iBAAiB,CAAA;IACnC,8DAA8D;IAC9D,QAAQ,CAAC,EAAE,CAAC,EAAE,aAAa,CAAA;CAC5B;AA6DD,qBAAa,WAAW;IACtB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA+B;IACtD,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAe;gBAEtB,OAAO,EAAE,kBAAkB;IAMvC;;;OAGG;IACH,IAAI,CAAC,KAAK,EAAE,SAAS,cAAc,EAAE,GAAG,SAAS,gBAAgB,EAAE;IAkBnE,OAAO,CAAC,OAAO;CAwBhB"}

package/dist/kit/prompt_files.js

@@ -0,0 +1,121 @@
+import { existsSync, mkdirSync, readFileSync, readdirSync, renameSync, rmSync, statSync, writeFileSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+/** The temp files {@link nodeIo.write} leaves beside a prompt file, and the age past which one
+ *  certainly belongs to a writer that will never rename it. Same discipline as the provisioner's
+ *  `fs.ts`, which sweeps `.atomic-*` the same way. */
+const TEMP_SUFFIX = /\.tmp-\d+$/;
+const STALE_TEMP_MS = 5 * 60_000;
+/** Best-effort removal of dead sibling temps, so a crash never leaves litter in the user's own
+ *  `prompts/` directory — that directory is theirs (hand-edited files live in it), not ours. */
+function sweepStaleTemps(dir, keep) {
+    let entries;
+    try {
+        entries = readdirSync(dir);
+    }
+    catch {
+        return;
+    }
+    const now = Date.now();
+    for (const entry of entries) {
+        if (!TEMP_SUFFIX.test(entry))
+            continue;
+        const candidate = join(dir, entry);
+        if (candidate === keep)
+            continue;
+        try {
+            if (now - statSync(candidate).mtimeMs > STALE_TEMP_MS)
+                rmSync(candidate, { force: true });
+        }
+        catch {
+            // A temp that vanished under us is already gone.
+        }
+    }
+}
+const nodeIo = {
+    exists: (path) => existsSync(path),
+    read: (path) => readFileSync(path, 'utf8'),
+    write: (path, text) => {
+        const tmp = `${path}.tmp-${String(process.pid)}`;
+        // Write-then-rename so a reader never sees a half-written prompt. A crash in between used to
+        // leave `.tmp-<pid>` behind FOREVER: sweep the dead ones first, and drop this one if the rename
+        // is the step that fails (a directory sitting where the file belongs is the everyday case).
+        sweepStaleTemps(dirname(path), tmp);
+        try {
+            writeFileSync(tmp, text, 'utf8');
+            renameSync(tmp, path);
+        }
+        catch (error) {
+            rmSync(tmp, { force: true });
+            throw error;
+        }
+    },
+    ensureDir: (path) => {
+        mkdirSync(path, { recursive: true });
+    },
+};
+/** BOM off, CRLF in, outer whitespace off: what the file means, not what the editor left behind. */
+function normalize(text) {
+    return text.replace(/^\uFEFF/, '').replace(/\r\n?/gu, '\n').trim();
+}
+function reason(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+export class PromptFiles {
+    dir;
+    logger;
+    io;
+    constructor(options) {
+        this.dir = options.dir;
+        this.logger = options.logger;
+        this.io = options.io ?? nodeIo;
+    }
+    /**
+     * Ensure every spec's file exists with content, then return the text to inject. Ordered like the
+     * manifest, so the caller can zip the result back onto its sections.
+     */
+    load(specs) {
+        const fallbackOf = (spec) => ({
+            file: spec.file,
+            path: join(this.dir, spec.file),
+            text: normalize(spec.fallback),
+            source: 'default',
+            wrote: false,
+        });
+        try {
+            this.io.ensureDir(this.dir);
+        }
+        catch (error) {
+            // One warning for the directory, not one per file: the cause is the same for all of them.
+            this.logger?.warn(`prompt directory ${this.dir} is unusable (${reason(error)}); using the built-in prompts`);
+            return specs.map(fallbackOf);
+        }
+        return specs.map((spec) => this.loadOne(spec));
+    }
+    loadOne(spec) {
+        const path = join(this.dir, spec.file);
+        const fallback = normalize(spec.fallback);
+        const failed = (error) => {
+            this.logger?.warn(`prompt file ${path} is unusable (${reason(error)}); using the built-in default`);
+            return { file: spec.file, path, text: fallback, source: 'default', wrote: false };
+        };
+        try {
+            if (this.io.exists(path)) {
+                const text = normalize(this.io.read(path));
+                // A file the user edited is used verbatim — including one we would word differently.
+                if (text !== '')
+                    return { file: spec.file, path, text, source: 'file', wrote: false };
+                // Blank is not an edit, it is an unfinished one: fill it (the caller's own rule).
+                this.io.write(path, `${fallback}\n`);
+                this.logger?.info(`prompt file was blank and has been filled: ${path}`);
+                return { file: spec.file, path, text: fallback, source: 'default', wrote: true };
+            }
+            this.io.write(path, `${fallback}\n`);
+            this.logger?.info(`prompt file created: ${path}`);
+            return { file: spec.file, path, text: fallback, source: 'default', wrote: true };
+        }
+        catch (error) {
+            return failed(error);
+        }
+    }
+}
+//# sourceMappingURL=prompt_files.js.map

package/dist/kit/prompt_files.js.map

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

package/dist/kit/typert.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Typert wire conventions shared by the family's plugins.
+ *
+ * A DSH plugin's Remote face is hand-written here (the Typert generator runs only inside the harness
+ * workspace), and both plugins independently arrived at the same conventions. The GENERATOR-level
+ * parts live here once; the descriptor assembly stays per plugin because the two really differ (the
+ * work engine adds `stream`/cancellation methods, the memory plugin has a `parameter()` helper with
+ * `acceptsUndefined`). Only the genuinely identical part is hoisted — a fake abstraction with a bag
+ * of switches would be worse than the duplication it removes.
+ *
+ * The type-symbol convention is `<package>#<namespace>/<method>:<field>`; the probe, the runtime
+ * registry and the report all key off it, so it must not drift between the two plugins.
+ *
+ * @module @avantf/dsh-plugin-base/kit/typert
+ */
+import type { ZodType } from 'zod';
+/**
+ * One `strict` codec: the schema plus the symbol the generator would name.
+ *
+ * Carries BOTH members on purpose. The host's validator moved from `codec.schema.parse` (dsh 0.1.5)
+ * to `codec.create()` (0.1.6), and each generation checks only its own — so a codec missing one of
+ * them makes a healthy host read as an incompatible one, and the failure shows up as a REFUSED mount
+ * rather than as a missing neighbour. Measured on the memory plugin first; the work copy had drifted
+ * to the one-member shape and was fixed to match. Do not "simplify" this back.
+ */
+export interface StrictCodec {
+    readonly mode: 'strict';
+    readonly typeSymbol: string;
+    readonly schema: ZodType;
+    readonly create: () => ZodType;
+}
+/** Build one strict codec; `typeSymbol` is the `<package>#<namespace>/<method>:<field>` name. */
+export declare function strictCodec(schema: ZodType, typeSymbol: string): StrictCodec;
+/** The invocation id of one method: `<package>#<namespace>/<method>`. */
+export declare function endpointId(pkg: string, namespace: string, method: string): string;
+/** The type symbol of one field of one method. */
+export declare function fieldSymbol(pkg: string, namespace: string, method: string, field: string): string;
+/** The type symbol of a method's result. */
+export declare function resultSymbol(pkg: string, namespace: string, method: string): string;
+//# sourceMappingURL=typert.d.ts.map

package/dist/kit/typert.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"typert.d.ts","sourceRoot":"","sources":["../../src/kit/typert.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,KAAK,CAAA;AAElC;;;;;;;;GAQG;AACH,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAA;IACvB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAA;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,OAAO,CAAA;CAC/B;AAED,iGAAiG;AACjG,wBAAgB,WAAW,CAAC,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,GAAG,WAAW,CAE5E;AAED,yEAAyE;AACzE,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAEjF;AAED,kDAAkD;AAClD,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAEjG;AAED,4CAA4C;AAC5C,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAEnF"}

package/dist/kit/typert.js

@@ -0,0 +1,17 @@
+/** Build one strict codec; `typeSymbol` is the `<package>#<namespace>/<method>:<field>` name. */
+export function strictCodec(schema, typeSymbol) {
+    return { mode: 'strict', typeSymbol, schema, create: () => schema };
+}
+/** The invocation id of one method: `<package>#<namespace>/<method>`. */
+export function endpointId(pkg, namespace, method) {
+    return `${pkg}#${namespace}/${method}`;
+}
+/** The type symbol of one field of one method. */
+export function fieldSymbol(pkg, namespace, method, field) {
+    return `${endpointId(pkg, namespace, method)}:${field}`;
+}
+/** The type symbol of a method's result. */
+export function resultSymbol(pkg, namespace, method) {
+    return fieldSymbol(pkg, namespace, method, 'result');
+}
+//# sourceMappingURL=typert.js.map

package/dist/kit/typert.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"typert.js","sourceRoot":"","sources":["../../src/kit/typert.ts"],"names":[],"mappings":"AAiCA,iGAAiG;AACjG,MAAM,UAAU,WAAW,CAAC,MAAe,EAAE,UAAkB;IAC7D,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,MAAM,EAAE,CAAA;AACrE,CAAC;AAED,yEAAyE;AACzE,MAAM,UAAU,UAAU,CAAC,GAAW,EAAE,SAAiB,EAAE,MAAc;IACvE,OAAO,GAAG,GAAG,IAAI,SAAS,IAAI,MAAM,EAAE,CAAA;AACxC,CAAC;AAED,kDAAkD;AAClD,MAAM,UAAU,WAAW,CAAC,GAAW,EAAE,SAAiB,EAAE,MAAc,EAAE,KAAa;IACvF,OAAO,GAAG,UAAU,CAAC,GAAG,EAAE,SAAS,EAAE,MAAM,CAAC,IAAI,KAAK,EAAE,CAAA;AACzD,CAAC;AAED,4CAA4C;AAC5C,MAAM,UAAU,YAAY,CAAC,GAAW,EAAE,SAAiB,EAAE,MAAc;IACzE,OAAO,WAAW,CAAC,GAAG,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAA;AACtD,CAAC"}

package/dist/layout.d.ts

@@ -0,0 +1,28 @@
+/** The control-plane directory name under `home`. */
+export declare const CONTROL_DIR = ".envinit";
+/** Default path budget before the version segment switches to a short hash. */
+export declare const DEFAULT_MAX_PATH = 200;
+export declare function controlRoot(home: string): string;
+export declare function lockPath(home: string): string;
+export declare function statusLockPath(home: string): string;
+export declare function layoutPath(home: string): string;
+export declare function statusPath(home: string): string;
+export declare function declaredPath(home: string): string;
+export declare function tempRoot(home: string): string;
+export declare function quarantineRoot(home: string): string;
+/**
+ * A staging directory for one install attempt under {@link tempRoot}.
+ * `sequence` must be monotonic per process.
+ */
+export declare function stagingDir(home: string, itemId: string, sequence: number): string;
+/** A quarantine directory for one bad version directory. */
+export declare function quarantineDir(home: string, sequence: number): string;
+/** Is `child` inside `parent` (or equal to it)? Both are absolute and already normalised. */
+export declare function isInside(parent: string, child: string): boolean;
+/** Reject a `target.root` that is absolute or escapes `home` (`invalid-option`). */
+export declare function assertSafeRelativeRoot(root: string): void;
+/** Reject a provider-supplied relative path that is absolute or escapes its root. */
+export declare function assertSafeRelativePath(path: string): void;
+/** The version segment: the version, or a short hash when the path is too long. */
+export declare function versionSegment(home: string, targetRoot: string, name: string, version: string, maxPathLength?: number): string;
+//# sourceMappingURL=layout.d.ts.map