@dev-sergeev/datalab-kit 0.1.2 → 0.1.4

package/node_modules/@zigai/pi-extension-settings/dist/json-value.d.ts

@@ -0,0 +1,18 @@
+export type JsonPrimitive = boolean | null | number | string;
+export type JsonValue = JsonPrimitive | JsonArray | JsonObject;
+export interface JsonArray extends ReadonlyArray<JsonValue> {
+    readonly [index: number]: JsonValue;
+}
+export interface JsonObject {
+    readonly [key: string]: JsonValue;
+}
+export declare const JsonValueSchema: import("typebox").TUnsafe<JsonValue>;
+export declare function isJsonBoolean(value: JsonValue | undefined): value is boolean;
+export declare function isJsonNumber(value: JsonValue | undefined): value is number;
+export declare function isJsonString(value: JsonValue | undefined): value is string;
+export declare function isJsonArray(value: JsonValue | undefined): value is JsonArray;
+export declare function isJsonObject(value: JsonValue | undefined): value is JsonObject;
+export declare function cloneJson<Value extends JsonValue>(value: Value): Value;
+export declare function parseJson(text: string): JsonValue | undefined;
+export declare function formatJson(value: JsonValue): string;
+//# sourceMappingURL=json-value.d.ts.map

package/node_modules/@zigai/pi-extension-settings/dist/json-value.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-value.d.ts","sourceRoot":"","sources":["../src/json-value.ts"],"names":[],"mappings":"AAiBA,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,IAAI,GAAG,MAAM,GAAG,MAAM,CAAC;AAE7D,MAAM,MAAM,SAAS,GAAG,aAAa,GAAG,SAAS,GAAG,UAAU,CAAC;AAE/D,MAAM,WAAW,SAAU,SAAQ,aAAa,CAAC,SAAS,CAAC;IACvD,QAAQ,EAAE,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;CACvC;AAED,MAAM,WAAW,UAAU;IACvB,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC;CACrC;AAgBD,eAAO,MAAM,eAAe,sCAc3B,CAAC;AAMF,wBAAgB,aAAa,CAAC,KAAK,EAAE,SAAS,GAAG,SAAS,GAAG,KAAK,IAAI,OAAO,CAE5E;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,SAAS,GAAG,SAAS,GAAG,KAAK,IAAI,MAAM,CAE1E;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,SAAS,GAAG,SAAS,GAAG,KAAK,IAAI,MAAM,CAE1E;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,SAAS,GAAG,SAAS,GAAG,KAAK,IAAI,SAAS,CAE5E;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,SAAS,GAAG,SAAS,GAAG,KAAK,IAAI,UAAU,CAE9E;AAED,wBAAgB,SAAS,CAAC,KAAK,SAAS,SAAS,EAAE,KAAK,EAAE,KAAK,GAAG,KAAK,CAEtE;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,CAM7D;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM,CAEnD"}

package/node_modules/@zigai/pi-extension-settings/dist/json-value.js

@@ -0,0 +1,56 @@
+import { Typebox, Value } from "./typebox-runtime.js";
+const { Array: ArrayType, Boolean: BooleanType, Cyclic, Null, Number: NumberType, Record: RecordType, Ref, Refine, String: StringType, Union, Unknown, Unsafe, } = Typebox;
+const JsonObjectCandidateSchema = RecordType(StringType(), Unknown());
+function isPlainJsonObject(value) {
+    if (!Value.Check(JsonObjectCandidateSchema, value))
+        return false;
+    const prototype = Reflect.getPrototypeOf(value);
+    return ((prototype === Object.prototype || prototype === null) &&
+        Object.getOwnPropertySymbols(value).length === 0);
+}
+// SAFETY: TypeBox widens deeply recursive Cyclic static types. This schema exactly mirrors the
+// JsonValue recursion, rejects non-plain and symbol-keyed objects, and Value.Parse validates every
+// nested value before it receives the JsonValue type.
+export const JsonValueSchema = Unsafe(Cyclic({
+    JsonValue: Union([
+        Null(),
+        BooleanType(),
+        NumberType(),
+        StringType(),
+        ArrayType(Ref("JsonValue")),
+        Refine(RecordType(StringType(), Ref("JsonValue")), isPlainJsonObject),
+    ]),
+}, "JsonValue"));
+const JsonBooleanSchema = BooleanType();
+const JsonNumberSchema = NumberType();
+const JsonStringSchema = StringType();
+export function isJsonBoolean(value) {
+    return Value.Check(JsonBooleanSchema, value);
+}
+export function isJsonNumber(value) {
+    return Value.Check(JsonNumberSchema, value);
+}
+export function isJsonString(value) {
+    return Value.Check(JsonStringSchema, value);
+}
+export function isJsonArray(value) {
+    return Array.isArray(value);
+}
+export function isJsonObject(value) {
+    return value !== undefined && isPlainJsonObject(value);
+}
+export function cloneJson(value) {
+    return structuredClone(value);
+}
+export function parseJson(text) {
+    try {
+        return Value.Parse(JsonValueSchema, JSON.parse(text));
+    }
+    catch {
+        return undefined;
+    }
+}
+export function formatJson(value) {
+    return `${JSON.stringify(value, undefined, 2)}\n`;
+}
+//# sourceMappingURL=json-value.js.map

package/node_modules/@zigai/pi-extension-settings/dist/json-value.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-value.js","sourceRoot":"","sources":["../src/json-value.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAEtD,MAAM,EACF,KAAK,EAAE,SAAS,EAChB,OAAO,EAAE,WAAW,EACpB,MAAM,EACN,IAAI,EACJ,MAAM,EAAE,UAAU,EAClB,MAAM,EAAE,UAAU,EAClB,GAAG,EACH,MAAM,EACN,MAAM,EAAE,UAAU,EAClB,KAAK,EACL,OAAO,EACP,MAAM,GACT,GAAG,OAAO,CAAC;AAcZ,MAAM,yBAAyB,GAAG,UAAU,CAAC,UAAU,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;AAEtE,SAAS,iBAAiB,CAAC,KAAgB;IACvC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,yBAAyB,EAAE,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IACjE,MAAM,SAAS,GAAG,OAAO,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;IAChD,OAAO,CACH,CAAC,SAAS,KAAK,MAAM,CAAC,SAAS,IAAI,SAAS,KAAK,IAAI,CAAC;QACtD,MAAM,CAAC,qBAAqB,CAAC,KAAK,CAAC,CAAC,MAAM,KAAK,CAAC,CACnD,CAAC;AACN,CAAC;AAED,+FAA+F;AAC/F,mGAAmG;AACnG,sDAAsD;AACtD,MAAM,CAAC,MAAM,eAAe,GAAG,MAAM,CACjC,MAAM,CACF;IACI,SAAS,EAAE,KAAK,CAAC;QACb,IAAI,EAAE;QACN,WAAW,EAAE;QACb,UAAU,EAAE;QACZ,UAAU,EAAE;QACZ,SAAS,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;QAC3B,MAAM,CAAC,UAAU,CAAC,UAAU,EAAE,EAAE,GAAG,CAAC,WAAW,CAAC,CAAC,EAAE,iBAAiB,CAAC;KACxE,CAAC;CACL,EACD,WAAW,CACd,CACJ,CAAC;AAEF,MAAM,iBAAiB,GAAG,WAAW,EAAE,CAAC;AACxC,MAAM,gBAAgB,GAAG,UAAU,EAAE,CAAC;AACtC,MAAM,gBAAgB,GAAG,UAAU,EAAE,CAAC;AAEtC,MAAM,UAAU,aAAa,CAAC,KAA4B;IACtD,OAAO,KAAK,CAAC,KAAK,CAAC,iBAAiB,EAAE,KAAK,CAAC,CAAC;AACjD,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,KAA4B;IACrD,OAAO,KAAK,CAAC,KAAK,CAAC,gBAAgB,EAAE,KAAK,CAAC,CAAC;AAChD,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,KAA4B;IACrD,OAAO,KAAK,CAAC,KAAK,CAAC,gBAAgB,EAAE,KAAK,CAAC,CAAC;AAChD,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,KAA4B;IACpD,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAChC,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,KAA4B;IACrD,OAAO,KAAK,KAAK,SAAS,IAAI,iBAAiB,CAAC,KAAK,CAAC,CAAC;AAC3D,CAAC;AAED,MAAM,UAAU,SAAS,CAA0B,KAAY;IAC3D,OAAO,eAAe,CAAC,KAAK,CAAC,CAAC;AAClC,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,IAAY;IAClC,IAAI,CAAC;QACD,OAAO,KAAK,CAAC,KAAK,CAAC,eAAe,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;IAC1D,CAAC;IAAC,MAAM,CAAC;QACL,OAAO,SAAS,CAAC;IACrB,CAAC;AACL,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,KAAgB;IACvC,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC,IAAI,CAAC;AACtD,CAAC","sourcesContent":["import { Typebox, Value } from \"./typebox-runtime.ts\";\n\nconst {\n    Array: ArrayType,\n    Boolean: BooleanType,\n    Cyclic,\n    Null,\n    Number: NumberType,\n    Record: RecordType,\n    Ref,\n    Refine,\n    String: StringType,\n    Union,\n    Unknown,\n    Unsafe,\n} = Typebox;\n\nexport type JsonPrimitive = boolean | null | number | string;\n\nexport type JsonValue = JsonPrimitive | JsonArray | JsonObject;\n\nexport interface JsonArray extends ReadonlyArray<JsonValue> {\n    readonly [index: number]: JsonValue;\n}\n\nexport interface JsonObject {\n    readonly [key: string]: JsonValue;\n}\n\nconst JsonObjectCandidateSchema = RecordType(StringType(), Unknown());\n\nfunction isPlainJsonObject(value: JsonValue): value is JsonObject {\n    if (!Value.Check(JsonObjectCandidateSchema, value)) return false;\n    const prototype = Reflect.getPrototypeOf(value);\n    return (\n        (prototype === Object.prototype || prototype === null) &&\n        Object.getOwnPropertySymbols(value).length === 0\n    );\n}\n\n// SAFETY: TypeBox widens deeply recursive Cyclic static types. This schema exactly mirrors the\n// JsonValue recursion, rejects non-plain and symbol-keyed objects, and Value.Parse validates every\n// nested value before it receives the JsonValue type.\nexport const JsonValueSchema = Unsafe<JsonValue>(\n    Cyclic(\n        {\n            JsonValue: Union([\n                Null(),\n                BooleanType(),\n                NumberType(),\n                StringType(),\n                ArrayType(Ref(\"JsonValue\")),\n                Refine(RecordType(StringType(), Ref(\"JsonValue\")), isPlainJsonObject),\n            ]),\n        },\n        \"JsonValue\",\n    ),\n);\n\nconst JsonBooleanSchema = BooleanType();\nconst JsonNumberSchema = NumberType();\nconst JsonStringSchema = StringType();\n\nexport function isJsonBoolean(value: JsonValue | undefined): value is boolean {\n    return Value.Check(JsonBooleanSchema, value);\n}\n\nexport function isJsonNumber(value: JsonValue | undefined): value is number {\n    return Value.Check(JsonNumberSchema, value);\n}\n\nexport function isJsonString(value: JsonValue | undefined): value is string {\n    return Value.Check(JsonStringSchema, value);\n}\n\nexport function isJsonArray(value: JsonValue | undefined): value is JsonArray {\n    return Array.isArray(value);\n}\n\nexport function isJsonObject(value: JsonValue | undefined): value is JsonObject {\n    return value !== undefined && isPlainJsonObject(value);\n}\n\nexport function cloneJson<Value extends JsonValue>(value: Value): Value {\n    return structuredClone(value);\n}\n\nexport function parseJson(text: string): JsonValue | undefined {\n    try {\n        return Value.Parse(JsonValueSchema, JSON.parse(text));\n    } catch {\n        return undefined;\n    }\n}\n\nexport function formatJson(value: JsonValue): string {\n    return `${JSON.stringify(value, undefined, 2)}\\n`;\n}\n"]}

package/node_modules/@zigai/pi-extension-settings/dist/paths.d.ts

@@ -0,0 +1,11 @@
+export declare const EXTENSION_SETTINGS_DIRECTORY = "extension-settings";
+export declare const EXTENSION_SETTINGS_SCHEMA_DIRECTORY = "schemas";
+export type ExtensionSettingsPaths = {
+    readonly configPath: string;
+    readonly schemaPath: string;
+    readonly schemaReference: string;
+};
+export declare function resolveGlobalSettingsPaths(agentDir: string, settingsId: string): ExtensionSettingsPaths;
+export declare function resolveProjectSettingsPaths(cwd: string, configDirName: string, settingsId: string): ExtensionSettingsPaths;
+export declare function defaultGlobalSettingsDisplayPath(settingsId: string): string;
+//# sourceMappingURL=paths.d.ts.map

package/node_modules/@zigai/pi-extension-settings/dist/paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../src/paths.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,4BAA4B,uBAAuB,CAAC;AACjE,eAAO,MAAM,mCAAmC,YAAY,CAAC;AAE7D,MAAM,MAAM,sBAAsB,GAAG;IACjC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;CACpC,CAAC;AAEF,wBAAgB,0BAA0B,CACtC,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,GACnB,sBAAsB,CAWxB;AAED,wBAAgB,2BAA2B,CACvC,GAAG,EAAE,MAAM,EACX,aAAa,EAAE,MAAM,EACrB,UAAU,EAAE,MAAM,GACnB,sBAAsB,CAWxB;AAED,wBAAgB,gCAAgC,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAE3E"}

package/node_modules/@zigai/pi-extension-settings/dist/paths.js

@@ -0,0 +1,23 @@
+import { join } from "node:path";
+export const EXTENSION_SETTINGS_DIRECTORY = "extension-settings";
+export const EXTENSION_SETTINGS_SCHEMA_DIRECTORY = "schemas";
+export function resolveGlobalSettingsPaths(agentDir, settingsId) {
+    const settingsDirectory = join(agentDir, EXTENSION_SETTINGS_DIRECTORY);
+    return {
+        configPath: join(settingsDirectory, `${settingsId}.json`),
+        schemaPath: join(settingsDirectory, EXTENSION_SETTINGS_SCHEMA_DIRECTORY, `${settingsId}.schema.json`),
+        schemaReference: `./${EXTENSION_SETTINGS_SCHEMA_DIRECTORY}/${settingsId}.schema.json`,
+    };
+}
+export function resolveProjectSettingsPaths(cwd, configDirName, settingsId) {
+    const settingsDirectory = join(cwd, configDirName, EXTENSION_SETTINGS_DIRECTORY);
+    return {
+        configPath: join(settingsDirectory, `${settingsId}.json`),
+        schemaPath: join(settingsDirectory, EXTENSION_SETTINGS_SCHEMA_DIRECTORY, `${settingsId}.schema.json`),
+        schemaReference: `./${EXTENSION_SETTINGS_SCHEMA_DIRECTORY}/${settingsId}.schema.json`,
+    };
+}
+export function defaultGlobalSettingsDisplayPath(settingsId) {
+    return `~/.pi/agent/${EXTENSION_SETTINGS_DIRECTORY}/${settingsId}.json`;
+}
+//# sourceMappingURL=paths.js.map

package/node_modules/@zigai/pi-extension-settings/dist/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../src/paths.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,MAAM,CAAC,MAAM,4BAA4B,GAAG,oBAAoB,CAAC;AACjE,MAAM,CAAC,MAAM,mCAAmC,GAAG,SAAS,CAAC;AAQ7D,MAAM,UAAU,0BAA0B,CACtC,QAAgB,EAChB,UAAkB;IAElB,MAAM,iBAAiB,GAAG,IAAI,CAAC,QAAQ,EAAE,4BAA4B,CAAC,CAAC;IACvE,OAAO;QACH,UAAU,EAAE,IAAI,CAAC,iBAAiB,EAAE,GAAG,UAAU,OAAO,CAAC;QACzD,UAAU,EAAE,IAAI,CACZ,iBAAiB,EACjB,mCAAmC,EACnC,GAAG,UAAU,cAAc,CAC9B;QACD,eAAe,EAAE,KAAK,mCAAmC,IAAI,UAAU,cAAc;KACxF,CAAC;AACN,CAAC;AAED,MAAM,UAAU,2BAA2B,CACvC,GAAW,EACX,aAAqB,EACrB,UAAkB;IAElB,MAAM,iBAAiB,GAAG,IAAI,CAAC,GAAG,EAAE,aAAa,EAAE,4BAA4B,CAAC,CAAC;IACjF,OAAO;QACH,UAAU,EAAE,IAAI,CAAC,iBAAiB,EAAE,GAAG,UAAU,OAAO,CAAC;QACzD,UAAU,EAAE,IAAI,CACZ,iBAAiB,EACjB,mCAAmC,EACnC,GAAG,UAAU,cAAc,CAC9B;QACD,eAAe,EAAE,KAAK,mCAAmC,IAAI,UAAU,cAAc;KACxF,CAAC;AACN,CAAC;AAED,MAAM,UAAU,gCAAgC,CAAC,UAAkB;IAC/D,OAAO,eAAe,4BAA4B,IAAI,UAAU,OAAO,CAAC;AAC5E,CAAC","sourcesContent":["import { join } from \"node:path\";\n\nexport const EXTENSION_SETTINGS_DIRECTORY = \"extension-settings\";\nexport const EXTENSION_SETTINGS_SCHEMA_DIRECTORY = \"schemas\";\n\nexport type ExtensionSettingsPaths = {\n    readonly configPath: string;\n    readonly schemaPath: string;\n    readonly schemaReference: string;\n};\n\nexport function resolveGlobalSettingsPaths(\n    agentDir: string,\n    settingsId: string,\n): ExtensionSettingsPaths {\n    const settingsDirectory = join(agentDir, EXTENSION_SETTINGS_DIRECTORY);\n    return {\n        configPath: join(settingsDirectory, `${settingsId}.json`),\n        schemaPath: join(\n            settingsDirectory,\n            EXTENSION_SETTINGS_SCHEMA_DIRECTORY,\n            `${settingsId}.schema.json`,\n        ),\n        schemaReference: `./${EXTENSION_SETTINGS_SCHEMA_DIRECTORY}/${settingsId}.schema.json`,\n    };\n}\n\nexport function resolveProjectSettingsPaths(\n    cwd: string,\n    configDirName: string,\n    settingsId: string,\n): ExtensionSettingsPaths {\n    const settingsDirectory = join(cwd, configDirName, EXTENSION_SETTINGS_DIRECTORY);\n    return {\n        configPath: join(settingsDirectory, `${settingsId}.json`),\n        schemaPath: join(\n            settingsDirectory,\n            EXTENSION_SETTINGS_SCHEMA_DIRECTORY,\n            `${settingsId}.schema.json`,\n        ),\n        schemaReference: `./${EXTENSION_SETTINGS_SCHEMA_DIRECTORY}/${settingsId}.schema.json`,\n    };\n}\n\nexport function defaultGlobalSettingsDisplayPath(settingsId: string): string {\n    return `~/.pi/agent/${EXTENSION_SETTINGS_DIRECTORY}/${settingsId}.json`;\n}\n"]}

package/node_modules/@zigai/pi-extension-settings/dist/pi-host-paths.d.ts

@@ -0,0 +1,5 @@
+/** Pi's public project configuration directory for the supported upstream runtime. */
+export declare const PI_CONFIG_DIR_NAME = ".pi";
+/** Resolves Pi's agent directory without evaluating the full coding-agent runtime graph. */
+export declare function getPiAgentDir(env?: NodeJS.ProcessEnv, homeDirectory?: string): string;
+//# sourceMappingURL=pi-host-paths.d.ts.map

package/node_modules/@zigai/pi-extension-settings/dist/pi-host-paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pi-host-paths.d.ts","sourceRoot":"","sources":["../src/pi-host-paths.ts"],"names":[],"mappings":"AAGA,sFAAsF;AACtF,eAAO,MAAM,kBAAkB,QAAQ,CAAC;AAIxC,4FAA4F;AAC5F,wBAAgB,aAAa,CACzB,GAAG,GAAE,MAAM,CAAC,UAAwB,EACpC,aAAa,GAAE,MAAkB,GAClC,MAAM,CAeR"}

package/node_modules/@zigai/pi-extension-settings/dist/pi-host-paths.js

@@ -0,0 +1,21 @@
+import { homedir } from "node:os";
+import { join } from "node:path";
+/** Pi's public project configuration directory for the supported upstream runtime. */
+export const PI_CONFIG_DIR_NAME = ".pi";
+const PI_AGENT_DIR_ENV = "PI_CODING_AGENT_DIR";
+/** Resolves Pi's agent directory without evaluating the full coding-agent runtime graph. */
+export function getPiAgentDir(env = process.env, homeDirectory = homedir()) {
+    const configured = env[PI_AGENT_DIR_ENV];
+    if (configured === undefined || configured.length === 0) {
+        return join(homeDirectory, PI_CONFIG_DIR_NAME, "agent");
+    }
+    if (configured === "~") {
+        return homeDirectory;
+    }
+    if (configured.startsWith("~/") ||
+        (process.platform === "win32" && configured.startsWith("~\\"))) {
+        return join(homeDirectory, configured.slice(2));
+    }
+    return configured;
+}
+//# sourceMappingURL=pi-host-paths.js.map

package/node_modules/@zigai/pi-extension-settings/dist/pi-host-paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pi-host-paths.js","sourceRoot":"","sources":["../src/pi-host-paths.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,sFAAsF;AACtF,MAAM,CAAC,MAAM,kBAAkB,GAAG,KAAK,CAAC;AAExC,MAAM,gBAAgB,GAAG,qBAAqB,CAAC;AAE/C,4FAA4F;AAC5F,MAAM,UAAU,aAAa,CACzB,MAAyB,OAAO,CAAC,GAAG,EACpC,gBAAwB,OAAO,EAAE;IAEjC,MAAM,UAAU,GAAG,GAAG,CAAC,gBAAgB,CAAC,CAAC;IACzC,IAAI,UAAU,KAAK,SAAS,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtD,OAAO,IAAI,CAAC,aAAa,EAAE,kBAAkB,EAAE,OAAO,CAAC,CAAC;IAC5D,CAAC;IACD,IAAI,UAAU,KAAK,GAAG,EAAE,CAAC;QACrB,OAAO,aAAa,CAAC;IACzB,CAAC;IACD,IACI,UAAU,CAAC,UAAU,CAAC,IAAI,CAAC;QAC3B,CAAC,OAAO,CAAC,QAAQ,KAAK,OAAO,IAAI,UAAU,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,EAChE,CAAC;QACC,OAAO,IAAI,CAAC,aAAa,EAAE,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IACpD,CAAC;IACD,OAAO,UAAU,CAAC;AACtB,CAAC","sourcesContent":["import { homedir } from \"node:os\";\nimport { join } from \"node:path\";\n\n/** Pi's public project configuration directory for the supported upstream runtime. */\nexport const PI_CONFIG_DIR_NAME = \".pi\";\n\nconst PI_AGENT_DIR_ENV = \"PI_CODING_AGENT_DIR\";\n\n/** Resolves Pi's agent directory without evaluating the full coding-agent runtime graph. */\nexport function getPiAgentDir(\n    env: NodeJS.ProcessEnv = process.env,\n    homeDirectory: string = homedir(),\n): string {\n    const configured = env[PI_AGENT_DIR_ENV];\n    if (configured === undefined || configured.length === 0) {\n        return join(homeDirectory, PI_CONFIG_DIR_NAME, \"agent\");\n    }\n    if (configured === \"~\") {\n        return homeDirectory;\n    }\n    if (\n        configured.startsWith(\"~/\") ||\n        (process.platform === \"win32\" && configured.startsWith(\"~\\\\\"))\n    ) {\n        return join(homeDirectory, configured.slice(2));\n    }\n    return configured;\n}\n"]}

package/node_modules/@zigai/pi-extension-settings/dist/pi.d.ts

@@ -0,0 +1,106 @@
+import type { ExtensionContext } from "@earendil-works/pi-coding-agent";
+import type { TObject } from "typebox";
+import type { ExtensionSettingsDefinition } from "./definition.ts";
+import { type BundledSchemaSource, type LoadedSettings, type SettingsDiagnostic, type SettingsDiagnosticCode } from "./settings-loader.ts";
+import type { PiSettingsRevision } from "./settings-revision.ts";
+import type { PiSettingsUpdateIssue, PiSettingsUpdateScope, UpdatePiExtensionSettingsOptions, UpdatePiExtensionSettingsResult } from "./settings-transaction.ts";
+/**
+ * Portion of Pi's extension context required to locate and authorize project settings.
+ *
+ * Pass the current `ExtensionContext` directly; callers do not need to construct this object.
+ */
+export type PiSettingsContext = Pick<ExtensionContext, "cwd" | "isProjectTrusted">;
+/** Options for {@link loadPiExtensionSettings}. */
+export type LoadPiExtensionSettingsOptions = {
+    /** Generated schema bundled with the extension package. */
+    readonly bundledSchema: BundledSchemaSource;
+};
+/**
+ * Settings resolution result returned by {@link loadPiExtensionSettings}.
+ *
+ * @template Schema The TypeBox object schema from the supplied extension definition.
+ */
+export type LoadedPiExtensionSettings<Schema extends TObject> = LoadedSettings<Schema>;
+export type { BundledSchemaSource, PiSettingsRevision, PiSettingsUpdateIssue, PiSettingsUpdateScope, SettingsDiagnostic, SettingsDiagnosticCode, UpdatePiExtensionSettingsOptions, UpdatePiExtensionSettingsResult, };
+/**
+ * Returns the absolute global settings path for an extension.
+ *
+ * The path is `<getAgentDir()>/extension-settings/<extensionId>.json`. This function does not access
+ * the filesystem.
+ *
+ * @param extensionId The definition ID used in the settings filename.
+ */
+export declare function getPiGlobalSettingsPath(extensionId: string): string;
+/**
+ * Returns the absolute project-settings path for an extension.
+ *
+ * The path is `<cwd>/<CONFIG_DIR_NAME>/extension-settings/<extensionId>.json`. This function does
+ * not check project trust or access the filesystem.
+ *
+ * @param extensionId The definition ID used in the settings filename.
+ * @param cwd The project directory, normally `ctx.cwd`.
+ */
+export declare function getPiProjectSettingsPath(extensionId: string, cwd: string): string;
+/**
+ * Loads an extension's resolved settings using Pi's standard directories and trust state.
+ *
+ * Resolution starts with schema defaults, recursively merges the global layer, then recursively
+ * merges the project layer only when Pi reports the project as trusted. Arrays and scalar values
+ * replace earlier values. Unreadable, malformed, invalid, or undecodable layers are ignored and
+ * reported in `diagnostics`.
+ *
+ * Loading is synchronous. When the bundled schema matches the definition, the function atomically
+ * installs the editor schema and creates the global settings file if it does not exist. Existing
+ * settings files are never overwritten, and project settings files are never created.
+ *
+ * Keep this call out of module import and the extension factory. Cache its result once per session
+ * and invoke it from the first lifecycle callback that needs settings. If enabled behavior must
+ * begin during `session_start`, that handler is the correct first-use boundary.
+ *
+ * @template Schema The TypeBox object schema used to infer the decoded `settings` value.
+ * @param definition A validated definition created by `defineExtensionSettings`.
+ * @param context The current Pi extension context.
+ * @param options The generated schema bundled with the extension.
+ * @returns Decoded settings, encoded layers, source revisions, paths, installation state, and diagnostics.
+ * @throws If a custom TypeBox transform decoder throws while decoding the resolved settings.
+ *
+ * @example
+ * ```ts
+ * import { loadPiExtensionSettings } from "@zigai/pi-extension-settings/pi";
+ * import settingsDefinition from "./settings.ts";
+ *
+ * const loaded = loadPiExtensionSettings(settingsDefinition, ctx, {
+ *   bundledSchema: {
+ *     kind: "url",
+ *     url: new URL("../config.schema.json", import.meta.url),
+ *   },
+ * });
+ * ```
+ */
+export declare function loadPiExtensionSettings<const Schema extends TObject>(definition: ExtensionSettingsDefinition<Schema>, context: PiSettingsContext, options: LoadPiExtensionSettingsOptions): LoadedPiExtensionSettings<Schema>;
+/**
+ * Transactionally updates an extension's encoded global or project settings layer.
+ *
+ * The latest layer is read, validated, cloned, and passed once to `options.update` while the target
+ * settings sources are protected by Pi's in-process mutation queue and a cooperative inter-process
+ * lock. The returned layer is validated both independently and after resolution over defaults and
+ * earlier layers, then atomically published. Existing malformed or invalid settings are never
+ * overwritten.
+ *
+ * Call `loadPiExtensionSettings` before updating so the generated editor schema is installed and
+ * verified for the active definition.
+ *
+ * Pass `expectedRevision` for snapshot-based editors that must reject changes made after opening.
+ * Omit it for semantic updates that should apply to the latest valid layer. Project updates are
+ * blocked unless Pi reports the project as trusted; calling this function is an explicit write and
+ * may create a missing trusted-project settings file.
+ *
+ * @template Schema The TypeBox object schema from the supplied extension definition.
+ * @param definition A validated definition created by `defineExtensionSettings`.
+ * @param context The current Pi extension context used for paths and project trust.
+ * @param options Scope, optional optimistic revision, and synchronous encoded-layer updater.
+ * @returns A typed update outcome; filesystem and validation failures do not expose settings values.
+ * @throws The original error when `options.update` throws an `Error`.
+ */
+export declare function updatePiExtensionSettings<const Schema extends TObject>(definition: ExtensionSettingsDefinition<Schema>, context: PiSettingsContext, options: UpdatePiExtensionSettingsOptions<Schema>): Promise<UpdatePiExtensionSettingsResult>;
+//# sourceMappingURL=pi.d.ts.map

package/node_modules/@zigai/pi-extension-settings/dist/pi.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pi.d.ts","sourceRoot":"","sources":["../src/pi.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AACxE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAEvC,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,iBAAiB,CAAC;AAGnE,OAAO,EAEH,KAAK,mBAAmB,EACxB,KAAK,cAAc,EACnB,KAAK,kBAAkB,EACvB,KAAK,sBAAsB,EAC9B,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AACjE,OAAO,KAAK,EACR,qBAAqB,EACrB,qBAAqB,EACrB,gCAAgC,EAChC,+BAA+B,EAClC,MAAM,2BAA2B,CAAC;AAEnC;;;;GAIG;AACH,MAAM,MAAM,iBAAiB,GAAG,IAAI,CAAC,gBAAgB,EAAE,KAAK,GAAG,kBAAkB,CAAC,CAAC;AAEnF,mDAAmD;AACnD,MAAM,MAAM,8BAA8B,GAAG;IACzC,2DAA2D;IAC3D,QAAQ,CAAC,aAAa,EAAE,mBAAmB,CAAC;CAC/C,CAAC;AAEF;;;;GAIG;AACH,MAAM,MAAM,yBAAyB,CAAC,MAAM,SAAS,OAAO,IAAI,cAAc,CAAC,MAAM,CAAC,CAAC;AACvF,YAAY,EACR,mBAAmB,EACnB,kBAAkB,EAClB,qBAAqB,EACrB,qBAAqB,EACrB,kBAAkB,EAClB,sBAAsB,EACtB,gCAAgC,EAChC,+BAA+B,GAClC,CAAC;AAEF;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAEnE;AAED;;;;;;;;GAQG;AACH,wBAAgB,wBAAwB,CAAC,WAAW,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAEjF;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,CAAC,MAAM,SAAS,OAAO,EAChE,UAAU,EAAE,2BAA2B,CAAC,MAAM,CAAC,EAC/C,OAAO,EAAE,iBAAiB,EAC1B,OAAO,EAAE,8BAA8B,GACxC,yBAAyB,CAAC,MAAM,CAAC,CAUnC;AAoBD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAsB,yBAAyB,CAAC,KAAK,CAAC,MAAM,SAAS,OAAO,EACxE,UAAU,EAAE,2BAA2B,CAAC,MAAM,CAAC,EAC/C,OAAO,EAAE,iBAAiB,EAC1B,OAAO,EAAE,gCAAgC,CAAC,MAAM,CAAC,GAClD,OAAO,CAAC,+BAA+B,CAAC,CAuB1C"}

package/node_modules/@zigai/pi-extension-settings/dist/pi.js

@@ -0,0 +1,122 @@
+import { getPiAgentDir, PI_CONFIG_DIR_NAME } from "./pi-host-paths.js";
+import { resolveGlobalSettingsPaths, resolveProjectSettingsPaths } from "./paths.js";
+import { loadSettings, } from "./settings-loader.js";
+/**
+ * Returns the absolute global settings path for an extension.
+ *
+ * The path is `<getAgentDir()>/extension-settings/<extensionId>.json`. This function does not access
+ * the filesystem.
+ *
+ * @param extensionId The definition ID used in the settings filename.
+ */
+export function getPiGlobalSettingsPath(extensionId) {
+    return resolveGlobalSettingsPaths(getPiAgentDir(), extensionId).configPath;
+}
+/**
+ * Returns the absolute project-settings path for an extension.
+ *
+ * The path is `<cwd>/<CONFIG_DIR_NAME>/extension-settings/<extensionId>.json`. This function does
+ * not check project trust or access the filesystem.
+ *
+ * @param extensionId The definition ID used in the settings filename.
+ * @param cwd The project directory, normally `ctx.cwd`.
+ */
+export function getPiProjectSettingsPath(extensionId, cwd) {
+    return resolveProjectSettingsPaths(cwd, PI_CONFIG_DIR_NAME, extensionId).configPath;
+}
+/**
+ * Loads an extension's resolved settings using Pi's standard directories and trust state.
+ *
+ * Resolution starts with schema defaults, recursively merges the global layer, then recursively
+ * merges the project layer only when Pi reports the project as trusted. Arrays and scalar values
+ * replace earlier values. Unreadable, malformed, invalid, or undecodable layers are ignored and
+ * reported in `diagnostics`.
+ *
+ * Loading is synchronous. When the bundled schema matches the definition, the function atomically
+ * installs the editor schema and creates the global settings file if it does not exist. Existing
+ * settings files are never overwritten, and project settings files are never created.
+ *
+ * Keep this call out of module import and the extension factory. Cache its result once per session
+ * and invoke it from the first lifecycle callback that needs settings. If enabled behavior must
+ * begin during `session_start`, that handler is the correct first-use boundary.
+ *
+ * @template Schema The TypeBox object schema used to infer the decoded `settings` value.
+ * @param definition A validated definition created by `defineExtensionSettings`.
+ * @param context The current Pi extension context.
+ * @param options The generated schema bundled with the extension.
+ * @returns Decoded settings, encoded layers, source revisions, paths, installation state, and diagnostics.
+ * @throws If a custom TypeBox transform decoder throws while decoding the resolved settings.
+ *
+ * @example
+ * ```ts
+ * import { loadPiExtensionSettings } from "@zigai/pi-extension-settings/pi";
+ * import settingsDefinition from "./settings.ts";
+ *
+ * const loaded = loadPiExtensionSettings(settingsDefinition, ctx, {
+ *   bundledSchema: {
+ *     kind: "url",
+ *     url: new URL("../config.schema.json", import.meta.url),
+ *   },
+ * });
+ * ```
+ */
+export function loadPiExtensionSettings(definition, context, options) {
+    return loadSettings(definition, {
+        agentDir: getPiAgentDir(),
+        bundledSchema: options.bundledSchema,
+        project: {
+            cwd: context.cwd,
+            configDirName: PI_CONFIG_DIR_NAME,
+            trusted: context.isProjectTrusted(),
+        },
+    });
+}
+async function withFileMutationQueues(paths, operation, withFileMutationQueue, index = 0) {
+    const path = paths[index];
+    if (path === undefined)
+        return operation();
+    return withFileMutationQueue(path, () => withFileMutationQueues(paths, operation, withFileMutationQueue, index + 1));
+}
+/**
+ * Transactionally updates an extension's encoded global or project settings layer.
+ *
+ * The latest layer is read, validated, cloned, and passed once to `options.update` while the target
+ * settings sources are protected by Pi's in-process mutation queue and a cooperative inter-process
+ * lock. The returned layer is validated both independently and after resolution over defaults and
+ * earlier layers, then atomically published. Existing malformed or invalid settings are never
+ * overwritten.
+ *
+ * Call `loadPiExtensionSettings` before updating so the generated editor schema is installed and
+ * verified for the active definition.
+ *
+ * Pass `expectedRevision` for snapshot-based editors that must reject changes made after opening.
+ * Omit it for semantic updates that should apply to the latest valid layer. Project updates are
+ * blocked unless Pi reports the project as trusted; calling this function is an explicit write and
+ * may create a missing trusted-project settings file.
+ *
+ * @template Schema The TypeBox object schema from the supplied extension definition.
+ * @param definition A validated definition created by `defineExtensionSettings`.
+ * @param context The current Pi extension context used for paths and project trust.
+ * @param options Scope, optional optimistic revision, and synchronous encoded-layer updater.
+ * @returns A typed update outcome; filesystem and validation failures do not expose settings values.
+ * @throws The original error when `options.update` throws an `Error`.
+ */
+export async function updatePiExtensionSettings(definition, context, options) {
+    // Read-only consumers should not initialize the lock library or its process signal handlers.
+    const [{ updateSettingsTransaction }, { withFileMutationQueue }] = await Promise.all([
+        import("./settings-transaction.js"),
+        import("@earendil-works/pi-coding-agent"),
+    ]);
+    const global = resolveGlobalSettingsPaths(getPiAgentDir(), definition.id);
+    const project = resolveProjectSettingsPaths(context.cwd, PI_CONFIG_DIR_NAME, definition.id);
+    const projectTrusted = context.isProjectTrusted();
+    const paths = options.scope === "global"
+        ? [global.configPath]
+        : [global.configPath, project.configPath].sort();
+    return withFileMutationQueues(paths, () => updateSettingsTransaction(definition, {
+        ...options,
+        paths: { global, project },
+        projectTrusted,
+    }), withFileMutationQueue);
+}
+//# sourceMappingURL=pi.js.map

package/node_modules/@zigai/pi-extension-settings/dist/pi.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pi.js","sourceRoot":"","sources":["../src/pi.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACvE,OAAO,EAAE,0BAA0B,EAAE,2BAA2B,EAAE,MAAM,YAAY,CAAC;AACrF,OAAO,EACH,YAAY,GAKf,MAAM,sBAAsB,CAAC;AAuC9B;;;;;;;GAOG;AACH,MAAM,UAAU,uBAAuB,CAAC,WAAmB;IACvD,OAAO,0BAA0B,CAAC,aAAa,EAAE,EAAE,WAAW,CAAC,CAAC,UAAU,CAAC;AAC/E,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,wBAAwB,CAAC,WAAmB,EAAE,GAAW;IACrE,OAAO,2BAA2B,CAAC,GAAG,EAAE,kBAAkB,EAAE,WAAW,CAAC,CAAC,UAAU,CAAC;AACxF,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,MAAM,UAAU,uBAAuB,CACnC,UAA+C,EAC/C,OAA0B,EAC1B,OAAuC;IAEvC,OAAO,YAAY,CAAC,UAAU,EAAE;QAC5B,QAAQ,EAAE,aAAa,EAAE;QACzB,aAAa,EAAE,OAAO,CAAC,aAAa;QACpC,OAAO,EAAE;YACL,GAAG,EAAE,OAAO,CAAC,GAAG;YAChB,aAAa,EAAE,kBAAkB;YACjC,OAAO,EAAE,OAAO,CAAC,gBAAgB,EAAE;SACtC;KACJ,CAAC,CAAC;AACP,CAAC;AAOD,KAAK,UAAU,sBAAsB,CACjC,KAAwB,EACxB,SAAgC,EAChC,qBAAwC,EACxC,KAAK,GAAG,CAAC;IAET,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC;IAC1B,IAAI,IAAI,KAAK,SAAS;QAAE,OAAO,SAAS,EAAE,CAAC;IAC3C,OAAO,qBAAqB,CAAC,IAAI,EAAE,GAAG,EAAE,CACpC,sBAAsB,CAAC,KAAK,EAAE,SAAS,EAAE,qBAAqB,EAAE,KAAK,GAAG,CAAC,CAAC,CAC7E,CAAC;AACN,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAC3C,UAA+C,EAC/C,OAA0B,EAC1B,OAAiD;IAEjD,6FAA6F;IAC7F,MAAM,CAAC,EAAE,yBAAyB,EAAE,EAAE,EAAE,qBAAqB,EAAE,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QACjF,MAAM,CAAC,2BAA2B,CAAC;QACnC,MAAM,CAAC,iCAAiC,CAAC;KAC5C,CAAC,CAAC;IACH,MAAM,MAAM,GAAG,0BAA0B,CAAC,aAAa,EAAE,EAAE,UAAU,CAAC,EAAE,CAAC,CAAC;IAC1E,MAAM,OAAO,GAAG,2BAA2B,CAAC,OAAO,CAAC,GAAG,EAAE,kBAAkB,EAAE,UAAU,CAAC,EAAE,CAAC,CAAC;IAC5F,MAAM,cAAc,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAClD,MAAM,KAAK,GACP,OAAO,CAAC,KAAK,KAAK,QAAQ;QACtB,CAAC,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC;QACrB,CAAC,CAAC,CAAC,MAAM,CAAC,UAAU,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC,IAAI,EAAE,CAAC;IACzD,OAAO,sBAAsB,CACzB,KAAK,EACL,GAAG,EAAE,CACD,yBAAyB,CAAC,UAAU,EAAE;QAClC,GAAG,OAAO;QACV,KAAK,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE;QAC1B,cAAc;KACjB,CAAC,EACN,qBAAqB,CACxB,CAAC;AACN,CAAC","sourcesContent":["import type { ExtensionContext } from \"@earendil-works/pi-coding-agent\";\nimport type { TObject } from \"typebox\";\n\nimport type { ExtensionSettingsDefinition } from \"./definition.ts\";\nimport { getPiAgentDir, PI_CONFIG_DIR_NAME } from \"./pi-host-paths.ts\";\nimport { resolveGlobalSettingsPaths, resolveProjectSettingsPaths } from \"./paths.ts\";\nimport {\n    loadSettings,\n    type BundledSchemaSource,\n    type LoadedSettings,\n    type SettingsDiagnostic,\n    type SettingsDiagnosticCode,\n} from \"./settings-loader.ts\";\nimport type { PiSettingsRevision } from \"./settings-revision.ts\";\nimport type {\n    PiSettingsUpdateIssue,\n    PiSettingsUpdateScope,\n    UpdatePiExtensionSettingsOptions,\n    UpdatePiExtensionSettingsResult,\n} from \"./settings-transaction.ts\";\n\n/**\n * Portion of Pi's extension context required to locate and authorize project settings.\n *\n * Pass the current `ExtensionContext` directly; callers do not need to construct this object.\n */\nexport type PiSettingsContext = Pick<ExtensionContext, \"cwd\" | \"isProjectTrusted\">;\n\n/** Options for {@link loadPiExtensionSettings}. */\nexport type LoadPiExtensionSettingsOptions = {\n    /** Generated schema bundled with the extension package. */\n    readonly bundledSchema: BundledSchemaSource;\n};\n\n/**\n * Settings resolution result returned by {@link loadPiExtensionSettings}.\n *\n * @template Schema The TypeBox object schema from the supplied extension definition.\n */\nexport type LoadedPiExtensionSettings<Schema extends TObject> = LoadedSettings<Schema>;\nexport type {\n    BundledSchemaSource,\n    PiSettingsRevision,\n    PiSettingsUpdateIssue,\n    PiSettingsUpdateScope,\n    SettingsDiagnostic,\n    SettingsDiagnosticCode,\n    UpdatePiExtensionSettingsOptions,\n    UpdatePiExtensionSettingsResult,\n};\n\n/**\n * Returns the absolute global settings path for an extension.\n *\n * The path is `<getAgentDir()>/extension-settings/<extensionId>.json`. This function does not access\n * the filesystem.\n *\n * @param extensionId The definition ID used in the settings filename.\n */\nexport function getPiGlobalSettingsPath(extensionId: string): string {\n    return resolveGlobalSettingsPaths(getPiAgentDir(), extensionId).configPath;\n}\n\n/**\n * Returns the absolute project-settings path for an extension.\n *\n * The path is `<cwd>/<CONFIG_DIR_NAME>/extension-settings/<extensionId>.json`. This function does\n * not check project trust or access the filesystem.\n *\n * @param extensionId The definition ID used in the settings filename.\n * @param cwd The project directory, normally `ctx.cwd`.\n */\nexport function getPiProjectSettingsPath(extensionId: string, cwd: string): string {\n    return resolveProjectSettingsPaths(cwd, PI_CONFIG_DIR_NAME, extensionId).configPath;\n}\n\n/**\n * Loads an extension's resolved settings using Pi's standard directories and trust state.\n *\n * Resolution starts with schema defaults, recursively merges the global layer, then recursively\n * merges the project layer only when Pi reports the project as trusted. Arrays and scalar values\n * replace earlier values. Unreadable, malformed, invalid, or undecodable layers are ignored and\n * reported in `diagnostics`.\n *\n * Loading is synchronous. When the bundled schema matches the definition, the function atomically\n * installs the editor schema and creates the global settings file if it does not exist. Existing\n * settings files are never overwritten, and project settings files are never created.\n *\n * Keep this call out of module import and the extension factory. Cache its result once per session\n * and invoke it from the first lifecycle callback that needs settings. If enabled behavior must\n * begin during `session_start`, that handler is the correct first-use boundary.\n *\n * @template Schema The TypeBox object schema used to infer the decoded `settings` value.\n * @param definition A validated definition created by `defineExtensionSettings`.\n * @param context The current Pi extension context.\n * @param options The generated schema bundled with the extension.\n * @returns Decoded settings, encoded layers, source revisions, paths, installation state, and diagnostics.\n * @throws If a custom TypeBox transform decoder throws while decoding the resolved settings.\n *\n * @example\n * ```ts\n * import { loadPiExtensionSettings } from \"@zigai/pi-extension-settings/pi\";\n * import settingsDefinition from \"./settings.ts\";\n *\n * const loaded = loadPiExtensionSettings(settingsDefinition, ctx, {\n *   bundledSchema: {\n *     kind: \"url\",\n *     url: new URL(\"../config.schema.json\", import.meta.url),\n *   },\n * });\n * ```\n */\nexport function loadPiExtensionSettings<const Schema extends TObject>(\n    definition: ExtensionSettingsDefinition<Schema>,\n    context: PiSettingsContext,\n    options: LoadPiExtensionSettingsOptions,\n): LoadedPiExtensionSettings<Schema> {\n    return loadSettings(definition, {\n        agentDir: getPiAgentDir(),\n        bundledSchema: options.bundledSchema,\n        project: {\n            cwd: context.cwd,\n            configDirName: PI_CONFIG_DIR_NAME,\n            trusted: context.isProjectTrusted(),\n        },\n    });\n}\n\ntype FileMutationQueue = <Result>(\n    path: string,\n    operation: () => Promise<Result>,\n) => Promise<Result>;\n\nasync function withFileMutationQueues<Result>(\n    paths: readonly string[],\n    operation: () => Promise<Result>,\n    withFileMutationQueue: FileMutationQueue,\n    index = 0,\n): Promise<Result> {\n    const path = paths[index];\n    if (path === undefined) return operation();\n    return withFileMutationQueue(path, () =>\n        withFileMutationQueues(paths, operation, withFileMutationQueue, index + 1),\n    );\n}\n\n/**\n * Transactionally updates an extension's encoded global or project settings layer.\n *\n * The latest layer is read, validated, cloned, and passed once to `options.update` while the target\n * settings sources are protected by Pi's in-process mutation queue and a cooperative inter-process\n * lock. The returned layer is validated both independently and after resolution over defaults and\n * earlier layers, then atomically published. Existing malformed or invalid settings are never\n * overwritten.\n *\n * Call `loadPiExtensionSettings` before updating so the generated editor schema is installed and\n * verified for the active definition.\n *\n * Pass `expectedRevision` for snapshot-based editors that must reject changes made after opening.\n * Omit it for semantic updates that should apply to the latest valid layer. Project updates are\n * blocked unless Pi reports the project as trusted; calling this function is an explicit write and\n * may create a missing trusted-project settings file.\n *\n * @template Schema The TypeBox object schema from the supplied extension definition.\n * @param definition A validated definition created by `defineExtensionSettings`.\n * @param context The current Pi extension context used for paths and project trust.\n * @param options Scope, optional optimistic revision, and synchronous encoded-layer updater.\n * @returns A typed update outcome; filesystem and validation failures do not expose settings values.\n * @throws The original error when `options.update` throws an `Error`.\n */\nexport async function updatePiExtensionSettings<const Schema extends TObject>(\n    definition: ExtensionSettingsDefinition<Schema>,\n    context: PiSettingsContext,\n    options: UpdatePiExtensionSettingsOptions<Schema>,\n): Promise<UpdatePiExtensionSettingsResult> {\n    // Read-only consumers should not initialize the lock library or its process signal handlers.\n    const [{ updateSettingsTransaction }, { withFileMutationQueue }] = await Promise.all([\n        import(\"./settings-transaction.ts\"),\n        import(\"@earendil-works/pi-coding-agent\"),\n    ]);\n    const global = resolveGlobalSettingsPaths(getPiAgentDir(), definition.id);\n    const project = resolveProjectSettingsPaths(context.cwd, PI_CONFIG_DIR_NAME, definition.id);\n    const projectTrusted = context.isProjectTrusted();\n    const paths =\n        options.scope === \"global\"\n            ? [global.configPath]\n            : [global.configPath, project.configPath].sort();\n    return withFileMutationQueues(\n        paths,\n        () =>\n            updateSettingsTransaction(definition, {\n                ...options,\n                paths: { global, project },\n                projectTrusted,\n            }),\n        withFileMutationQueue,\n    );\n}\n"]}