@agimon-ai/doompi-core 0.0.1-alpha.70

package/dist/runtime-pi-extension.mjs

@@ -0,0 +1,242 @@
+import { DOOM_TOOL_OVERRIDES_SERVICE, requireDoomToolOverrides } from "./schemas/toolOverrides.mjs";
+import { DOOM_TOOL_SURFACE_SERVICE, requireDoomToolSurface } from "./schemas/toolSurface.mjs";
+import { connectDoomCordisHost } from "./runtime-cordis-host.mjs";
+import { DOOM_HELP_SERVICE, requireDoomHelpService } from "./schemas/help.mjs";
+import { createPluginLifecycle } from "./services/pluginLifecycle/index.mjs";
+//#region src/extensions/piExtension.ts
+function definePiExtension(definition, factory) {
+	const name = typeof definition === "string" ? definition : definition.name;
+	const install = async (context, pi, options, runtime) => {
+		const lifecycle = createPluginLifecycle((signal) => ({
+			context,
+			pi,
+			options,
+			runtime,
+			signal
+		}));
+		context.effect(() => () => lifecycle.dispose(), `${name}/lifecycle`);
+		const tool = (item, executionSignal) => {
+			if ("kind" in item && item.kind === "pi-tool") {
+				item.register(pi, executionSignal);
+				return;
+			}
+			if (!("kind" in item)) {
+				if (!executionSignal) {
+					pi.registerTool(item);
+					return;
+				}
+				pi.registerTool({
+					...item,
+					async execute(toolCallId, input, signal, update, context) {
+						const current = executionSignal();
+						current.throwIfAborted();
+						return item.execute(toolCallId, input, signal ? AbortSignal.any([signal, current]) : current, update, context);
+					}
+				});
+				return;
+			}
+			pi.registerTool({
+				...item.pi,
+				name: item.name,
+				label: item.label ?? item.name,
+				description: item.description,
+				parameters: item.parameters,
+				promptSnippet: item.promptSnippet,
+				promptGuidelines: item.promptGuidelines ? [...item.promptGuidelines] : void 0,
+				executionMode: item.executionMode === "serial" ? "sequential" : item.executionMode,
+				async execute(toolCallId, input, signal, update, execution) {
+					const current = executionSignal?.() ?? lifecycle.context.signal;
+					current.throwIfAborted();
+					const result = await item.execute(input, {
+						toolCallId,
+						cwd: execution.cwd,
+						signal: signal ? AbortSignal.any([signal, current]) : current,
+						update: (result) => update?.({
+							...result,
+							details: result.details
+						}),
+						notify: (request) => {
+							if (execution.hasUI) execution.ui.notify(request.body, request.level ?? "info");
+						}
+					});
+					return {
+						...result,
+						details: result.details
+					};
+				}
+			});
+		};
+		await lifecycle.mount(() => typeof definition === "string" ? factory(lifecycle.context) : definition, async (contributions) => {
+			for (const service of contributions.services ?? []) {
+				const fiber = context.plugin(service);
+				lifecycle.own(() => fiber.dispose());
+				await fiber;
+			}
+			const tools = contributions.tools;
+			if (tools && "snapshot" in tools) {
+				const registered = /* @__PURE__ */ new Map();
+				let disposed = false;
+				let subscribing = true;
+				let reconciling = false;
+				let pending = false;
+				const deactivate = () => {
+					for (const entry of registered.values()) {
+						entry.active?.abort();
+						entry.active = void 0;
+					}
+				};
+				lifecycle.own(() => {
+					disposed = true;
+					deactivate();
+				});
+				const reconcile = () => {
+					pending = true;
+					if (disposed || lifecycle.context.signal.aborted) {
+						deactivate();
+						return;
+					}
+					if (reconciling || subscribing) return;
+					reconciling = true;
+					try {
+						do {
+							pending = false;
+							const snapshot = tools.snapshot();
+							const names = /* @__PURE__ */ new Map();
+							for (const declaration of snapshot) {
+								if (names.has(declaration.name)) throw new Error(`Duplicate live tool name: ${declaration.name}`);
+								names.set(declaration.name, declaration);
+							}
+							for (const [name, entry] of registered) if (names.get(name) !== entry.declaration) {
+								entry.active?.abort();
+								entry.active = void 0;
+							}
+							for (const declaration of snapshot) {
+								let entry = registered.get(declaration.name);
+								if (entry && entry.declaration !== declaration) entry = void 0;
+								if (entry) {
+									entry.active ??= new AbortController();
+									continue;
+								}
+								entry = {
+									declaration,
+									active: new AbortController()
+								};
+								const current = entry;
+								registered.set(declaration.name, entry);
+								try {
+									tool(declaration, () => {
+										lifecycle.context.signal.throwIfAborted();
+										if (!current.active || disposed) throw new Error(`Tool ${declaration.name} is unavailable in this plugin generation.`);
+										return AbortSignal.any([lifecycle.context.signal, current.active.signal]);
+									});
+								} catch (error) {
+									registered.delete(declaration.name);
+									throw error;
+								}
+							}
+						} while (pending && !disposed);
+					} catch (error) {
+						deactivate();
+						throw error;
+					} finally {
+						reconciling = false;
+					}
+				};
+				const unsubscribe = tools.subscribe(() => {
+					try {
+						reconcile();
+					} catch {}
+				});
+				lifecycle.own(() => {
+					disposed = true;
+					deactivate();
+					unsubscribe();
+				});
+				subscribing = false;
+				reconcile();
+			} else for (const item of tools ?? []) tool(item);
+			for (const item of contributions.commands ?? []) {
+				if (!("kind" in item)) {
+					pi.registerCommand(...item);
+					continue;
+				}
+				pi.registerCommand(item.name, {
+					description: item.description,
+					async handler(args, execution) {
+						lifecycle.context.signal.throwIfAborted();
+						await item.execute(args, {
+							cwd: execution.cwd,
+							signal: lifecycle.context.signal,
+							notify: (request) => {
+								if (execution.hasUI) execution.ui.notify(request.body, request.level ?? "info");
+							}
+						});
+					}
+				});
+			}
+			const on = pi.on.bind(pi);
+			for (const [event, handler] of Object.entries(contributions.events ?? {})) on(event, handler);
+			for (const item of contributions.providers ?? []) pi.registerProvider(...item);
+			for (const item of contributions.messageRenderers ?? []) pi.registerMessageRenderer(...item);
+			for (const item of contributions.entryRenderers ?? []) pi.registerEntryRenderer(...item);
+			for (const item of contributions.markdownTransformers ?? []) pi.registerMarkdownTransformer(item);
+			for (const item of contributions.shortcuts ?? []) pi.registerShortcut(...item);
+			for (const item of contributions.flags ?? []) pi.registerFlag(...item);
+			const bind = (service, register) => {
+				const fiber = context.inject([service], register);
+				lifecycle.own(() => fiber.dispose());
+			};
+			if (contributions.resources?.length) bind(DOOM_HELP_SERVICE, (child) => {
+				for (const resource of contributions.resources) {
+					const handle = requireDoomHelpService(child).register(resource);
+					child.effect(() => () => handle.dispose());
+				}
+			});
+			if (contributions.toolRestrictions?.length) bind(DOOM_TOOL_SURFACE_SERVICE, (child) => {
+				for (const restriction of contributions.toolRestrictions) {
+					const handle = requireDoomToolSurface(child).register(restriction);
+					child.effect(() => () => handle.dispose());
+					const unsubscribe = restriction.subscribe?.(() => handle.update(restriction.restrict));
+					if (unsubscribe) child.effect(() => unsubscribe);
+				}
+			});
+			if (contributions.toolOverrides?.length) bind(DOOM_TOOL_OVERRIDES_SERVICE, (child) => {
+				for (const override of contributions.toolOverrides) {
+					const handle = requireDoomToolOverrides(child).claim(override);
+					child.effect(() => () => handle.dispose());
+					if (handle.granted) for (const replacement of override.replacements) tool(replacement);
+				}
+			});
+		});
+	};
+	const activate = async (pi, options) => {
+		const connection = await connectDoomCordisHost(pi, name);
+		const fiber = connection.root.plugin(async (context) => {
+			await install(context, pi, options, connection.runtime);
+		});
+		let completion;
+		const dispose = () => completion ??= (async () => {
+			try {
+				await fiber.dispose();
+			} finally {
+				await connection.dispose();
+			}
+		})();
+		try {
+			await fiber;
+			pi.on("session_shutdown", dispose);
+		} catch (error) {
+			try {
+				await dispose();
+			} catch (cleanupError) {
+				throw new AggregateError([error, cleanupError], `${name} startup and cleanup failed.`);
+			}
+			throw error;
+		}
+	};
+	return Object.assign(activate, { install });
+}
+//#endregion
+export { definePiExtension };
+
+//# sourceMappingURL=runtime-pi-extension.mjs.map

package/dist/runtime-pi-extension.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-pi-extension.mjs","names":[],"sources":["../src/extensions/piExtension.ts"],"sourcesContent":["import type { Context } from '@deepseek-ai/cordis';\nimport type { ExtensionAPI } from '@earendil-works/pi-coding-agent';\n\nimport { connectDoomCordisHost, type DoomCordisRuntimeService } from '../pi/cordisHost';\nimport { DOOM_HELP_SERVICE, requireDoomHelpService, type DoomHelpService } from '../schemas/help';\nimport type { PiToolDeclaration } from '../schemas/piTool';\nimport type { DoomPluginTool, DoomPluginCommand } from '../schemas/pluginContributions';\nimport {\n  DOOM_TOOL_OVERRIDES_SERVICE,\n  requireDoomToolOverrides,\n  type DoomToolOverrideClaim,\n} from '../schemas/toolOverrides';\nimport type { DoomToolRestrictionDefinition } from '../schemas/toolSurface';\nimport { DOOM_TOOL_SURFACE_SERVICE, requireDoomToolSurface } from '../schemas/toolSurface';\nimport { createPluginLifecycle, type PluginLifecycleHooks } from '../services/pluginLifecycle';\n\n/** Extract native overloads without copying Pi event payload or result contracts. */\ntype NativeEventOverloads = ExtensionAPI['on'] extends {\n  (event: infer E1 extends string, handler: infer H1): void;\n  (event: infer E2 extends string, handler: infer H2): void;\n  (event: infer E3 extends string, handler: infer H3): void;\n  (event: infer E4 extends string, handler: infer H4): void;\n  (event: infer E5 extends string, handler: infer H5): void;\n  (event: infer E6 extends string, handler: infer H6): void;\n  (event: infer E7 extends string, handler: infer H7): void;\n  (event: infer E8 extends string, handler: infer H8): void;\n  (event: infer E9 extends string, handler: infer H9): void;\n  (event: infer E10 extends string, handler: infer H10): void;\n  (event: infer E11 extends string, handler: infer H11): void;\n  (event: infer E12 extends string, handler: infer H12): void;\n  (event: infer E13 extends string, handler: infer H13): void;\n  (event: infer E14 extends string, handler: infer H14): void;\n  (event: infer E15 extends string, handler: infer H15): void;\n  (event: infer E16 extends string, handler: infer H16): void;\n  (event: infer E17 extends string, handler: infer H17): void;\n  (event: infer E18 extends string, handler: infer H18): void;\n  (event: infer E19 extends string, handler: infer H19): void;\n  (event: infer E20 extends string, handler: infer H20): void;\n  (event: infer E21 extends string, handler: infer H21): void;\n  (event: infer E22 extends string, handler: infer H22): void;\n  (event: infer E23 extends string, handler: infer H23): void;\n  (event: infer E24 extends string, handler: infer H24): void;\n  (event: infer E25 extends string, handler: infer H25): void;\n  (event: infer E26 extends string, handler: infer H26): void;\n  (event: infer E27 extends string, handler: infer H27): void;\n  (event: infer E28 extends string, handler: infer H28): void;\n  (event: infer E29 extends string, handler: infer H29): void;\n  (event: infer E30 extends string, handler: infer H30): void;\n  (event: infer E31 extends string, handler: infer H31): void;\n  (event: infer E32 extends string, handler: infer H32): void;\n  (event: infer E33 extends string, handler: infer H33): void;\n  (event: infer E34 extends string, handler: infer H34): void;\n  (event: infer E35 extends string, handler: infer H35): void;\n  (event: infer E36 extends string, handler: infer H36): void;\n  (event: infer E37 extends string, handler: infer H37): void;\n  (event: infer E38 extends string, handler: infer H38): void;\n  (event: infer E39 extends string, handler: infer H39): void;\n  (event: infer E40 extends string, handler: infer H40): void;\n}\n  ?\n      | [E1, H1]\n      | [E2, H2]\n      | [E3, H3]\n      | [E4, H4]\n      | [E5, H5]\n      | [E6, H6]\n      | [E7, H7]\n      | [E8, H8]\n      | [E9, H9]\n      | [E10, H10]\n      | [E11, H11]\n      | [E12, H12]\n      | [E13, H13]\n      | [E14, H14]\n      | [E15, H15]\n      | [E16, H16]\n      | [E17, H17]\n      | [E18, H18]\n      | [E19, H19]\n      | [E20, H20]\n      | [E21, H21]\n      | [E22, H22]\n      | [E23, H23]\n      | [E24, H24]\n      | [E25, H25]\n      | [E26, H26]\n      | [E27, H27]\n      | [E28, H28]\n      | [E29, H29]\n      | [E30, H30]\n      | [E31, H31]\n      | [E32, H32]\n      | [E33, H33]\n      | [E34, H34]\n      | [E35, H35]\n      | [E36, H36]\n      | [E37, H37]\n      | [E38, H38]\n      | [E39, H39]\n      | [E40, H40]\n  : never;\n\nexport type PiEventHandlers = {\n  readonly [Pair in NativeEventOverloads as Pair[0]]?: Pair[1];\n};\n\nexport interface PiPluginContext<TOptions = undefined> {\n  readonly context: Context;\n  readonly pi: ExtensionAPI;\n  readonly options: TOptions | undefined;\n  readonly runtime: DoomCordisRuntimeService | undefined;\n  readonly signal: AbortSignal;\n}\n\nexport type PiToolRestriction = DoomToolRestrictionDefinition;\n\nexport interface PiPluginTool extends DoomPluginTool {\n  readonly pi?: Pick<Parameters<ExtensionAPI['registerTool']>[0], 'renderShell' | 'renderCall' | 'renderResult'>;\n}\n\nexport interface PiToolOverride extends DoomToolOverrideClaim {\n  /** Contributions registered only while this provider owns the override. */\n  readonly tools: readonly string[];\n  readonly replacements: readonly (PiToolDeclaration | Parameters<ExtensionAPI['registerTool']>[0])[];\n}\n\nexport type PiToolContribution = PiPluginTool | PiToolDeclaration | Parameters<ExtensionAPI['registerTool']>[0];\n\n/** Snapshots reuse immutable declarations. A registered name cannot adopt a different declaration until remount. */\nexport interface PiToolCollection {\n  snapshot(): readonly PiToolContribution[];\n  subscribe(listener: () => void): () => void;\n}\n\nexport interface PiPluginContributions<TOptions = undefined> extends PluginLifecycleHooks<PiPluginContext<TOptions>> {\n  readonly services?: readonly Parameters<Context['plugin']>[0][];\n  readonly tools?: readonly PiToolContribution[] | PiToolCollection;\n  readonly commands?: readonly (DoomPluginCommand | readonly [...Parameters<ExtensionAPI['registerCommand']>])[];\n  readonly events?: PiEventHandlers;\n  readonly resources?: readonly Parameters<DoomHelpService['register']>[0][];\n  readonly toolRestrictions?: readonly PiToolRestriction[];\n  readonly toolOverrides?: readonly PiToolOverride[];\n  readonly providers?: readonly (readonly [...Parameters<ExtensionAPI['registerProvider']>])[];\n  readonly messageRenderers?: readonly (readonly [...Parameters<ExtensionAPI['registerMessageRenderer']>])[];\n  readonly entryRenderers?: readonly (readonly [...Parameters<ExtensionAPI['registerEntryRenderer']>])[];\n  readonly markdownTransformers?: readonly Parameters<ExtensionAPI['registerMarkdownTransformer']>[0][];\n  readonly shortcuts?: readonly (readonly [...Parameters<ExtensionAPI['registerShortcut']>])[];\n  readonly flags?: readonly (readonly [...Parameters<ExtensionAPI['registerFlag']>])[];\n}\n\nexport interface PiExtensionDefinition<TOptions = undefined> extends PiPluginContributions<TOptions> {\n  readonly name: string;\n}\n\nexport interface DefinedPiExtension<TOptions = undefined> {\n  (pi: ExtensionAPI, options?: TOptions): Promise<void>;\n  install(\n    this: void,\n    context: Context,\n    pi: ExtensionAPI,\n    options?: TOptions,\n    runtime?: DoomCordisRuntimeService,\n  ): Promise<void>;\n}\n\nexport function definePiExtension<TOptions = undefined>(\n  definition: PiExtensionDefinition<TOptions>,\n): DefinedPiExtension<TOptions>;\nexport function definePiExtension<TOptions = undefined>(\n  name: string,\n  factory: (\n    context: PiPluginContext<TOptions>,\n  ) => PiPluginContributions<TOptions> | Promise<PiPluginContributions<TOptions>>,\n): DefinedPiExtension<TOptions>;\nexport function definePiExtension<TOptions = undefined>(\n  definition: string | PiExtensionDefinition<TOptions>,\n  factory?: (\n    context: PiPluginContext<TOptions>,\n  ) => PiPluginContributions<TOptions> | Promise<PiPluginContributions<TOptions>>,\n): DefinedPiExtension<TOptions> {\n  const name = typeof definition === 'string' ? definition : definition.name;\n  const install = async (\n    context: Context,\n    pi: ExtensionAPI,\n    options?: TOptions,\n    runtime?: DoomCordisRuntimeService,\n  ): Promise<void> => {\n    const lifecycle = createPluginLifecycle((signal): PiPluginContext<TOptions> => ({\n      context,\n      pi,\n      options,\n      runtime,\n      signal,\n    }));\n    context.effect(() => () => lifecycle.dispose(), `${name}/lifecycle`);\n    const tool = (item: PiToolContribution, executionSignal?: () => AbortSignal): void => {\n      if ('kind' in item && item.kind === 'pi-tool') {\n        item.register(pi, executionSignal);\n        return;\n      }\n      if (!('kind' in item)) {\n        if (!executionSignal) {\n          pi.registerTool(item);\n          return;\n        }\n        pi.registerTool({\n          ...item,\n          async execute(toolCallId, input, signal, update, context) {\n            const current = executionSignal();\n            current.throwIfAborted();\n            return item.execute(\n              toolCallId,\n              input,\n              signal ? AbortSignal.any([signal, current]) : current,\n              update,\n              context,\n            );\n          },\n        });\n        return;\n      }\n      pi.registerTool({\n        ...item.pi,\n        name: item.name,\n        label: item.label ?? item.name,\n        description: item.description,\n        parameters: item.parameters,\n        promptSnippet: item.promptSnippet,\n        promptGuidelines: item.promptGuidelines ? [...item.promptGuidelines] : undefined,\n        executionMode: item.executionMode === 'serial' ? 'sequential' : item.executionMode,\n        async execute(toolCallId, input, signal, update, execution) {\n          const current = executionSignal?.() ?? lifecycle.context.signal;\n          current.throwIfAborted();\n          const result = await item.execute(input, {\n            toolCallId,\n            cwd: execution.cwd,\n            signal: signal ? AbortSignal.any([signal, current]) : current,\n            update: (result) => update?.({ ...result, details: result.details }),\n            notify: (request) => {\n              if (execution.hasUI) execution.ui.notify(request.body, request.level ?? 'info');\n            },\n          });\n          return { ...result, details: result.details };\n        },\n      });\n    };\n    await lifecycle.mount(\n      () => (typeof definition === 'string' ? factory!(lifecycle.context) : definition),\n      async (contributions) => {\n        for (const service of contributions.services ?? []) {\n          const fiber = context.plugin(service);\n          lifecycle.own(() => fiber.dispose());\n          await fiber;\n        }\n        const tools = contributions.tools;\n        if (tools && 'snapshot' in tools) {\n          const registered = new Map<string, { readonly declaration: PiToolContribution; active?: AbortController }>();\n          let disposed = false;\n          let subscribing = true;\n          let reconciling = false;\n          let pending = false;\n          const deactivate = (): void => {\n            for (const entry of registered.values()) {\n              entry.active?.abort();\n              entry.active = undefined;\n            }\n          };\n          lifecycle.own(() => {\n            disposed = true;\n            deactivate();\n          });\n          const reconcile = (): void => {\n            pending = true;\n            if (disposed || lifecycle.context.signal.aborted) {\n              deactivate();\n              return;\n            }\n            if (reconciling || subscribing) return;\n            reconciling = true;\n            try {\n              do {\n                pending = false;\n                const snapshot = tools.snapshot();\n                const names = new Map<string, PiToolContribution>();\n                for (const declaration of snapshot) {\n                  if (names.has(declaration.name)) throw new Error(`Duplicate live tool name: ${declaration.name}`);\n                  names.set(declaration.name, declaration);\n                }\n                for (const [name, entry] of registered) {\n                  if (names.get(name) !== entry.declaration) {\n                    entry.active?.abort();\n                    entry.active = undefined;\n                  }\n                }\n                for (const declaration of snapshot) {\n                  let entry = registered.get(declaration.name);\n                  if (entry && entry.declaration !== declaration) entry = undefined;\n                  if (entry) {\n                    entry.active ??= new AbortController();\n                    continue;\n                  }\n                  entry = { declaration, active: new AbortController() };\n                  const current = entry;\n                  registered.set(declaration.name, entry);\n                  try {\n                    tool(declaration, () => {\n                      lifecycle.context.signal.throwIfAborted();\n                      if (!current.active || disposed)\n                        throw new Error(`Tool ${declaration.name} is unavailable in this plugin generation.`);\n                      return AbortSignal.any([lifecycle.context.signal, current.active.signal]);\n                    });\n                  } catch (error) {\n                    registered.delete(declaration.name);\n                    throw error;\n                  }\n                }\n              } while (pending && !disposed);\n            } catch (error) {\n              deactivate();\n              throw error;\n            } finally {\n              reconciling = false;\n            }\n          };\n          const unsubscribe = tools.subscribe(() => {\n            try {\n              reconcile();\n            } catch {\n              /* An invalid update leaves registered tools unavailable. */\n            }\n          });\n          lifecycle.own(() => {\n            disposed = true;\n            deactivate();\n            unsubscribe();\n          });\n          subscribing = false;\n          reconcile();\n        } else {\n          for (const item of tools ?? []) tool(item);\n        }\n        for (const item of contributions.commands ?? []) {\n          if (!('kind' in item)) {\n            pi.registerCommand(...item);\n            continue;\n          }\n          pi.registerCommand(item.name, {\n            description: item.description,\n            async handler(args, execution) {\n              lifecycle.context.signal.throwIfAborted();\n              await item.execute(args, {\n                cwd: execution.cwd,\n                signal: lifecycle.context.signal,\n                notify: (request) => {\n                  if (execution.hasUI) execution.ui.notify(request.body, request.level ?? 'info');\n                },\n              });\n            },\n          });\n        }\n        // The public mapped handlers retain each native event's input and return type.\n        const on = pi.on.bind(pi) as (event: string, handler: unknown) => void;\n        for (const [event, handler] of Object.entries(contributions.events ?? {})) on(event, handler);\n        for (const item of contributions.providers ?? []) pi.registerProvider(...item);\n        for (const item of contributions.messageRenderers ?? []) pi.registerMessageRenderer(...item);\n        for (const item of contributions.entryRenderers ?? []) pi.registerEntryRenderer(...item);\n        for (const item of contributions.markdownTransformers ?? []) pi.registerMarkdownTransformer(item);\n        for (const item of contributions.shortcuts ?? []) pi.registerShortcut(...item);\n        for (const item of contributions.flags ?? []) pi.registerFlag(...item);\n        const bind = (service: string, register: (child: Context) => void): void => {\n          const fiber = context.inject([service], register);\n          lifecycle.own(() => fiber.dispose());\n        };\n        if (contributions.resources?.length)\n          bind(DOOM_HELP_SERVICE, (child) => {\n            for (const resource of contributions.resources!) {\n              const handle = requireDoomHelpService(child).register(resource);\n              child.effect(() => () => handle.dispose());\n            }\n          });\n        if (contributions.toolRestrictions?.length)\n          bind(DOOM_TOOL_SURFACE_SERVICE, (child) => {\n            for (const restriction of contributions.toolRestrictions!) {\n              const handle = requireDoomToolSurface(child).register(restriction);\n              child.effect(() => () => handle.dispose());\n              const unsubscribe = restriction.subscribe?.(() => handle.update(restriction.restrict));\n              if (unsubscribe) child.effect(() => unsubscribe);\n            }\n          });\n        if (contributions.toolOverrides?.length)\n          bind(DOOM_TOOL_OVERRIDES_SERVICE, (child) => {\n            for (const override of contributions.toolOverrides!) {\n              const handle = requireDoomToolOverrides(child).claim(override);\n              child.effect(() => () => handle.dispose());\n              if (handle.granted) for (const replacement of override.replacements) tool(replacement);\n            }\n          });\n      },\n    );\n  };\n  const activate = async (pi: ExtensionAPI, options?: TOptions): Promise<void> => {\n    const connection = await connectDoomCordisHost(pi, name);\n    const fiber = connection.root.plugin(async (context) => {\n      await install(context, pi, options, connection.runtime);\n    });\n    let completion: Promise<void> | undefined;\n    const dispose = (): Promise<void> =>\n      (completion ??= (async () => {\n        try {\n          await fiber.dispose();\n        } finally {\n          await connection.dispose();\n        }\n      })());\n    try {\n      await fiber;\n      pi.on('session_shutdown', dispose);\n    } catch (error) {\n      try {\n        await dispose();\n      } catch (cleanupError) {\n        throw new AggregateError([error, cleanupError], `${name} startup and cleanup failed.`);\n      }\n      throw error;\n    }\n  };\n  return Object.assign(activate, { install });\n}\n"],"mappings":"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"}

package/dist/runtime-pi-settings.cjs

@@ -0,0 +1,104 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_runtime = require("./_virtual/_rolldown/runtime.cjs");
+const require_runtime_json = require("./runtime-json.cjs");
+const require_doom_package = require("./doom-package.cjs");
+let node_path = require("node:path");
+node_path = require_runtime.__toESM(node_path, 1);
+let node_os = require("node:os");
+node_os = require_runtime.__toESM(node_os, 1);
+//#region src/services/piSettings/index.ts
+/**
+* Pi's user settings, as `doompi sync` maintains them.
+*
+* The Doom package is registered globally so a plain `pi` process can find the
+* lightweight package bootstrap before project resources are trusted. Sync owns
+* the extension registration, ambient-discovery filter, theme resource, selected default theme, and quiet-startup keys
+* while preserving every unrelated user setting.
+*/
+const PI_CODING_AGENT_DIR_ENV = "PI_CODING_AGENT_DIR";
+const PI_DIRECTORY = ".pi";
+const AGENT_DIRECTORY = "agent";
+const SETTINGS_FILE = "settings.json";
+const THEMES_DIRECTORY = "themes";
+const EXTENSIONS_KEY = "extensions";
+const THEMES_KEY = "themes";
+const THEME_KEY = "theme";
+const QUIET_STARTUP_KEY = "quietStartup";
+const HOME_ALIAS = "~";
+const HOME_ALIAS_PREFIX = "~/";
+/** The stable package entry Pi loads for every synced repository. */
+const DOOM_EXTENSION = require_doom_package.DOOM_PACKAGE_NAME;
+/** Suppresses Pi's ambient extension-directory scan while leaving explicit sources intact. */
+const AMBIENT_EXTENSION_FILTER = "!extensions/**";
+/** Pi's user configuration directory, honoring its documented override. */
+function piAgentDirectory(environment = process.env, homeDirectory = node_os.default.homedir()) {
+	const configured = environment[PI_CODING_AGENT_DIR_ENV]?.trim();
+	if (!configured) return node_path.default.join(homeDirectory, PI_DIRECTORY, AGENT_DIRECTORY);
+	if (configured === HOME_ALIAS) return homeDirectory;
+	if (configured.startsWith(HOME_ALIAS_PREFIX)) return node_path.default.join(homeDirectory, configured.slice(2));
+	return node_path.default.resolve(configured);
+}
+function piSettingsPath(agentDirectory) {
+	return node_path.default.join(agentDirectory, SETTINGS_FILE);
+}
+function piThemeDirectory(agentDirectory) {
+	return node_path.default.join(agentDirectory, THEMES_DIRECTORY);
+}
+function stringList(value) {
+	return Array.isArray(value) ? value.filter((entry) => typeof entry === "string") : [];
+}
+function settingsRelativePath(agentDirectory, target) {
+	const relative = node_path.default.relative(agentDirectory, target);
+	if (relative.startsWith("..") || node_path.default.isAbsolute(relative)) return target;
+	return relative.split(node_path.default.sep).join("/");
+}
+function isManagedExtension(value) {
+	const normalized = value.replaceAll("\\", "/");
+	return normalized === DOOM_EXTENSION || normalized === "!extensions/**";
+}
+function isLegacyDoomTheme(value, themeName) {
+	const normalized = value.replaceAll("\\", "/");
+	return normalized.endsWith(`/doom/${themeName}.json`) || normalized === `doom/${themeName}.json`;
+}
+/** Produces the user settings content for an update, without writing it. */
+function mergePiSettings(current, agentDirectory, update) {
+	const theme = settingsRelativePath(agentDirectory, update.themePath);
+	const extensions = [
+		DOOM_EXTENSION,
+		AMBIENT_EXTENSION_FILTER,
+		...stringList(current[EXTENSIONS_KEY]).filter((value) => !isManagedExtension(value))
+	];
+	const themes = [theme, ...stringList(current[THEMES_KEY]).filter((value) => value !== theme && !isLegacyDoomTheme(value, update.themeName))];
+	return {
+		...current,
+		[QUIET_STARTUP_KEY]: true,
+		[EXTENSIONS_KEY]: extensions,
+		[THEMES_KEY]: themes,
+		[THEME_KEY]: typeof current[THEME_KEY] === "string" ? current[THEME_KEY] : update.themeName
+	};
+}
+function readPiSettings(agentDirectory) {
+	const settings = require_runtime_json.readJson(piSettingsPath(agentDirectory));
+	return require_runtime_json.isRecord(settings) ? settings : {};
+}
+function serializePiSettings(settings) {
+	return `${JSON.stringify(settings, null, 2)}\n`;
+}
+/** Merges the Doom-owned keys into Pi's user settings file. */
+function writePiSettings(agentDirectory, update) {
+	const settingsPath = piSettingsPath(agentDirectory);
+	require_runtime_json.writeFileAtomic(settingsPath, serializePiSettings(mergePiSettings(readPiSettings(agentDirectory), agentDirectory, update)));
+	return settingsPath;
+}
+//#endregion
+exports.AMBIENT_EXTENSION_FILTER = AMBIENT_EXTENSION_FILTER;
+exports.DOOM_EXTENSION = DOOM_EXTENSION;
+exports.mergePiSettings = mergePiSettings;
+exports.piAgentDirectory = piAgentDirectory;
+exports.piSettingsPath = piSettingsPath;
+exports.piThemeDirectory = piThemeDirectory;
+exports.readPiSettings = readPiSettings;
+exports.serializePiSettings = serializePiSettings;
+exports.writePiSettings = writePiSettings;
+
+//# sourceMappingURL=runtime-pi-settings.cjs.map

package/dist/runtime-pi-settings.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-pi-settings.cjs","names":["DOOM_PACKAGE_NAME","os","path","readJson","isRecord"],"sources":["../src/services/piSettings/index.ts"],"sourcesContent":["import os from 'node:os';\nimport path from 'node:path';\n\nimport { DOOM_PACKAGE_NAME } from '../doomPackage';\nimport { isRecord, readJson, writeFileAtomic } from '../json';\nimport type { JsonObject } from '../json';\n\n/**\n * Pi's user settings, as `doompi sync` maintains them.\n *\n * The Doom package is registered globally so a plain `pi` process can find the\n * lightweight package bootstrap before project resources are trusted. Sync owns\n * the extension registration, ambient-discovery filter, theme resource, selected default theme, and quiet-startup keys\n * while preserving every unrelated user setting.\n */\n\nconst PI_CODING_AGENT_DIR_ENV = 'PI_CODING_AGENT_DIR';\nconst PI_DIRECTORY = '.pi';\nconst AGENT_DIRECTORY = 'agent';\nconst SETTINGS_FILE = 'settings.json';\nconst THEMES_DIRECTORY = 'themes';\nconst EXTENSIONS_KEY = 'extensions';\nconst THEMES_KEY = 'themes';\nconst THEME_KEY = 'theme';\nconst QUIET_STARTUP_KEY = 'quietStartup';\nconst HOME_ALIAS = '~';\nconst HOME_ALIAS_PREFIX = '~/';\n/** The stable package entry Pi loads for every synced repository. */\nexport const DOOM_EXTENSION = DOOM_PACKAGE_NAME;\n/** Suppresses Pi's ambient extension-directory scan while leaving explicit sources intact. */\nexport const AMBIENT_EXTENSION_FILTER = '!extensions/**';\nexport interface PiSettingsUpdate {\n  /** Absolute path to the synchronized user theme file. */\n  themePath: string;\n  themeName: string;\n}\n\n/** Pi's user configuration directory, honoring its documented override. */\nexport function piAgentDirectory(\n  environment: NodeJS.ProcessEnv = process.env,\n  homeDirectory: string = os.homedir(),\n): string {\n  const configured = environment[PI_CODING_AGENT_DIR_ENV]?.trim();\n  if (!configured) return path.join(homeDirectory, PI_DIRECTORY, AGENT_DIRECTORY);\n  if (configured === HOME_ALIAS) return homeDirectory;\n  if (configured.startsWith(HOME_ALIAS_PREFIX)) {\n    return path.join(homeDirectory, configured.slice(HOME_ALIAS_PREFIX.length));\n  }\n  return path.resolve(configured);\n}\n\nexport function piSettingsPath(agentDirectory: string): string {\n  return path.join(agentDirectory, SETTINGS_FILE);\n}\n\nexport function piThemeDirectory(agentDirectory: string): string {\n  return path.join(agentDirectory, THEMES_DIRECTORY);\n}\n\nfunction stringList(value: unknown): string[] {\n  return Array.isArray(value) ? value.filter((entry): entry is string => typeof entry === 'string') : [];\n}\n\nfunction settingsRelativePath(agentDirectory: string, target: string): string {\n  const relative = path.relative(agentDirectory, target);\n  if (relative.startsWith('..') || path.isAbsolute(relative)) return target;\n  return relative.split(path.sep).join('/');\n}\n\nfunction isManagedExtension(value: string): boolean {\n  const normalized = value.replaceAll('\\\\', '/');\n  return normalized === DOOM_EXTENSION || normalized === AMBIENT_EXTENSION_FILTER;\n}\n\nfunction isLegacyDoomTheme(value: string, themeName: string): boolean {\n  const normalized = value.replaceAll('\\\\', '/');\n  return normalized.endsWith(`/doom/${themeName}.json`) || normalized === `doom/${themeName}.json`;\n}\n\n/** Produces the user settings content for an update, without writing it. */\nexport function mergePiSettings(current: JsonObject, agentDirectory: string, update: PiSettingsUpdate): JsonObject {\n  const theme = settingsRelativePath(agentDirectory, update.themePath);\n  // First in the list, so the harness environment is hydrated before any\n  // extension a user added themselves runs. The filter affects only Pi's\n  // automatic extensions/** scan; explicit settings and CLI entries still load.\n  const extensions = [\n    DOOM_EXTENSION,\n    AMBIENT_EXTENSION_FILTER,\n    ...stringList(current[EXTENSIONS_KEY]).filter((value) => !isManagedExtension(value)),\n  ];\n  const themes = [\n    theme,\n    ...stringList(current[THEMES_KEY]).filter(\n      (value) => value !== theme && !isLegacyDoomTheme(value, update.themeName),\n    ),\n  ];\n  return {\n    ...current,\n    [QUIET_STARTUP_KEY]: true,\n    [EXTENSIONS_KEY]: extensions,\n    [THEMES_KEY]: themes,\n    // Only filled in when unset: a theme the user picked later is their choice,\n    // and re-imposing the Doom theme on every sync would silently undo it.\n    [THEME_KEY]: typeof current[THEME_KEY] === 'string' ? current[THEME_KEY] : update.themeName,\n  };\n}\n\nexport function readPiSettings(agentDirectory: string): JsonObject {\n  const settings = readJson(piSettingsPath(agentDirectory));\n  return isRecord(settings) ? settings : {};\n}\n\nexport function serializePiSettings(settings: JsonObject): string {\n  return `${JSON.stringify(settings, null, 2)}\\n`;\n}\n\n/** Merges the Doom-owned keys into Pi's user settings file. */\nexport function writePiSettings(agentDirectory: string, update: PiSettingsUpdate): string {\n  const settingsPath = piSettingsPath(agentDirectory);\n  writeFileAtomic(\n    settingsPath,\n    serializePiSettings(mergePiSettings(readPiSettings(agentDirectory), agentDirectory, update)),\n  );\n  return settingsPath;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;AAgBA,MAAM,0BAA0B;AAChC,MAAM,eAAe;AACrB,MAAM,kBAAkB;AACxB,MAAM,gBAAgB;AACtB,MAAM,mBAAmB;AACzB,MAAM,iBAAiB;AACvB,MAAM,aAAa;AACnB,MAAM,YAAY;AAClB,MAAM,oBAAoB;AAC1B,MAAM,aAAa;AACnB,MAAM,oBAAoB;;AAE1B,MAAa,iBAAiBA,qBAAAA;;AAE9B,MAAa,2BAA2B;;AAQxC,SAAgB,iBACd,cAAiC,QAAQ,KACzC,gBAAwBC,QAAAA,QAAG,QAAQ,GAC3B;CACR,MAAM,aAAa,YAAY,wBAAwB,EAAE,KAAK;CAC9D,IAAI,CAAC,YAAY,OAAOC,UAAAA,QAAK,KAAK,eAAe,cAAc,eAAe;CAC9E,IAAI,eAAe,YAAY,OAAO;CACtC,IAAI,WAAW,WAAW,iBAAiB,GACzC,OAAOA,UAAAA,QAAK,KAAK,eAAe,WAAW,MAAM,CAAwB,CAAC;CAE5E,OAAOA,UAAAA,QAAK,QAAQ,UAAU;AAChC;AAEA,SAAgB,eAAe,gBAAgC;CAC7D,OAAOA,UAAAA,QAAK,KAAK,gBAAgB,aAAa;AAChD;AAEA,SAAgB,iBAAiB,gBAAgC;CAC/D,OAAOA,UAAAA,QAAK,KAAK,gBAAgB,gBAAgB;AACnD;AAEA,SAAS,WAAW,OAA0B;CAC5C,OAAO,MAAM,QAAQ,KAAK,IAAI,MAAM,QAAQ,UAA2B,OAAO,UAAU,QAAQ,IAAI,CAAC;AACvG;AAEA,SAAS,qBAAqB,gBAAwB,QAAwB;CAC5E,MAAM,WAAWA,UAAAA,QAAK,SAAS,gBAAgB,MAAM;CACrD,IAAI,SAAS,WAAW,IAAI,KAAKA,UAAAA,QAAK,WAAW,QAAQ,GAAG,OAAO;CACnE,OAAO,SAAS,MAAMA,UAAAA,QAAK,GAAG,CAAC,CAAC,KAAK,GAAG;AAC1C;AAEA,SAAS,mBAAmB,OAAwB;CAClD,MAAM,aAAa,MAAM,WAAW,MAAM,GAAG;CAC7C,OAAO,eAAe,kBAAkB,eAAA;AAC1C;AAEA,SAAS,kBAAkB,OAAe,WAA4B;CACpE,MAAM,aAAa,MAAM,WAAW,MAAM,GAAG;CAC7C,OAAO,WAAW,SAAS,SAAS,UAAU,MAAM,KAAK,eAAe,QAAQ,UAAU;AAC5F;;AAGA,SAAgB,gBAAgB,SAAqB,gBAAwB,QAAsC;CACjH,MAAM,QAAQ,qBAAqB,gBAAgB,OAAO,SAAS;CAInE,MAAM,aAAa;EACjB;EACA;EACA,GAAG,WAAW,QAAQ,eAAe,CAAC,CAAC,QAAQ,UAAU,CAAC,mBAAmB,KAAK,CAAC;CACrF;CACA,MAAM,SAAS,CACb,OACA,GAAG,WAAW,QAAQ,WAAW,CAAC,CAAC,QAChC,UAAU,UAAU,SAAS,CAAC,kBAAkB,OAAO,OAAO,SAAS,CAC1E,CACF;CACA,OAAO;EACL,GAAG;GACF,oBAAoB;GACpB,iBAAiB;GACjB,aAAa;GAGb,YAAY,OAAO,QAAQ,eAAe,WAAW,QAAQ,aAAa,OAAO;CACpF;AACF;AAEA,SAAgB,eAAe,gBAAoC;CACjE,MAAM,WAAWC,qBAAAA,SAAS,eAAe,cAAc,CAAC;CACxD,OAAOC,qBAAAA,SAAS,QAAQ,IAAI,WAAW,CAAC;AAC1C;AAEA,SAAgB,oBAAoB,UAA8B;CAChE,OAAO,GAAG,KAAK,UAAU,UAAU,MAAM,CAAC,EAAE;AAC9C;;AAGA,SAAgB,gBAAgB,gBAAwB,QAAkC;CACxF,MAAM,eAAe,eAAe,cAAc;CAClD,qBAAA,gBACE,cACA,oBAAoB,gBAAgB,eAAe,cAAc,GAAG,gBAAgB,MAAM,CAAC,CAC7F;CACA,OAAO;AACT"}

package/dist/runtime-pi-settings.d.cts

@@ -0,0 +1,23 @@
+import { JsonObject } from "./runtime-json.cjs";
+//#region src/services/piSettings/index.d.ts
+/** The stable package entry Pi loads for every synced repository. */
+export declare const DOOM_EXTENSION = "@agimon-ai/doompi";
+/** Suppresses Pi's ambient extension-directory scan while leaving explicit sources intact. */
+export declare const AMBIENT_EXTENSION_FILTER = "!extensions/**";
+export interface PiSettingsUpdate {
+  /** Absolute path to the synchronized user theme file. */
+  themePath: string;
+  themeName: string;
+}
+/** Pi's user configuration directory, honoring its documented override. */
+export declare function piAgentDirectory(environment?: NodeJS.ProcessEnv, homeDirectory?: string): string;
+export declare function piSettingsPath(agentDirectory: string): string;
+export declare function piThemeDirectory(agentDirectory: string): string;
+/** Produces the user settings content for an update, without writing it. */
+export declare function mergePiSettings(current: JsonObject, agentDirectory: string, update: PiSettingsUpdate): JsonObject;
+export declare function readPiSettings(agentDirectory: string): JsonObject;
+export declare function serializePiSettings(settings: JsonObject): string;
+/** Merges the Doom-owned keys into Pi's user settings file. */
+export declare function writePiSettings(agentDirectory: string, update: PiSettingsUpdate): string;
+//#endregion
+//# sourceMappingURL=runtime-pi-settings.d.cts.map

package/dist/runtime-pi-settings.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-pi-settings.d.cts","names":[],"sources":["../src/services/piSettings/index.ts"],"mappings":";;;qBA4Ba;;qBAEA;iBACI;;EAEf;EACA;;;wBAIc,iBACd,cAAa,OAAO,YACpB;wBAWc,eAAe;wBAIf,iBAAiB;;wBAyBjB,gBAAgB,SAAS,YAAY,wBAAwB,QAAQ,mBAAmB;wBA2BxF,eAAe,yBAAyB;wBAKxC,oBAAoB,UAAU;;wBAK9B,gBAAgB,wBAAwB,QAAQ"}

package/dist/runtime-pi-settings.d.mts

@@ -0,0 +1,23 @@
+import { JsonObject } from "./runtime-json.mjs";
+//#region src/services/piSettings/index.d.ts
+/** The stable package entry Pi loads for every synced repository. */
+export declare const DOOM_EXTENSION = "@agimon-ai/doompi";
+/** Suppresses Pi's ambient extension-directory scan while leaving explicit sources intact. */
+export declare const AMBIENT_EXTENSION_FILTER = "!extensions/**";
+export interface PiSettingsUpdate {
+  /** Absolute path to the synchronized user theme file. */
+  themePath: string;
+  themeName: string;
+}
+/** Pi's user configuration directory, honoring its documented override. */
+export declare function piAgentDirectory(environment?: NodeJS.ProcessEnv, homeDirectory?: string): string;
+export declare function piSettingsPath(agentDirectory: string): string;
+export declare function piThemeDirectory(agentDirectory: string): string;
+/** Produces the user settings content for an update, without writing it. */
+export declare function mergePiSettings(current: JsonObject, agentDirectory: string, update: PiSettingsUpdate): JsonObject;
+export declare function readPiSettings(agentDirectory: string): JsonObject;
+export declare function serializePiSettings(settings: JsonObject): string;
+/** Merges the Doom-owned keys into Pi's user settings file. */
+export declare function writePiSettings(agentDirectory: string, update: PiSettingsUpdate): string;
+//#endregion
+//# sourceMappingURL=runtime-pi-settings.d.mts.map

package/dist/runtime-pi-settings.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-pi-settings.d.mts","names":[],"sources":["../src/services/piSettings/index.ts"],"mappings":";;;qBA4Ba;;qBAEA;iBACI;;EAEf;EACA;;;wBAIc,iBACd,cAAa,OAAO,YACpB;wBAWc,eAAe;wBAIf,iBAAiB;;wBAyBjB,gBAAgB,SAAS,YAAY,wBAAwB,QAAQ,mBAAmB;wBA2BxF,eAAe,yBAAyB;wBAKxC,oBAAoB,UAAU;;wBAK9B,gBAAgB,wBAAwB,QAAQ"}

package/dist/runtime-pi-settings.mjs

@@ -0,0 +1,92 @@
+import { isRecord, readJson, writeFileAtomic } from "./runtime-json.mjs";
+import { DOOM_PACKAGE_NAME } from "./doom-package.mjs";
+import path from "node:path";
+import os from "node:os";
+//#region src/services/piSettings/index.ts
+/**
+* Pi's user settings, as `doompi sync` maintains them.
+*
+* The Doom package is registered globally so a plain `pi` process can find the
+* lightweight package bootstrap before project resources are trusted. Sync owns
+* the extension registration, ambient-discovery filter, theme resource, selected default theme, and quiet-startup keys
+* while preserving every unrelated user setting.
+*/
+const PI_CODING_AGENT_DIR_ENV = "PI_CODING_AGENT_DIR";
+const PI_DIRECTORY = ".pi";
+const AGENT_DIRECTORY = "agent";
+const SETTINGS_FILE = "settings.json";
+const THEMES_DIRECTORY = "themes";
+const EXTENSIONS_KEY = "extensions";
+const THEMES_KEY = "themes";
+const THEME_KEY = "theme";
+const QUIET_STARTUP_KEY = "quietStartup";
+const HOME_ALIAS = "~";
+const HOME_ALIAS_PREFIX = "~/";
+/** The stable package entry Pi loads for every synced repository. */
+const DOOM_EXTENSION = DOOM_PACKAGE_NAME;
+/** Suppresses Pi's ambient extension-directory scan while leaving explicit sources intact. */
+const AMBIENT_EXTENSION_FILTER = "!extensions/**";
+/** Pi's user configuration directory, honoring its documented override. */
+function piAgentDirectory(environment = process.env, homeDirectory = os.homedir()) {
+	const configured = environment[PI_CODING_AGENT_DIR_ENV]?.trim();
+	if (!configured) return path.join(homeDirectory, PI_DIRECTORY, AGENT_DIRECTORY);
+	if (configured === HOME_ALIAS) return homeDirectory;
+	if (configured.startsWith(HOME_ALIAS_PREFIX)) return path.join(homeDirectory, configured.slice(2));
+	return path.resolve(configured);
+}
+function piSettingsPath(agentDirectory) {
+	return path.join(agentDirectory, SETTINGS_FILE);
+}
+function piThemeDirectory(agentDirectory) {
+	return path.join(agentDirectory, THEMES_DIRECTORY);
+}
+function stringList(value) {
+	return Array.isArray(value) ? value.filter((entry) => typeof entry === "string") : [];
+}
+function settingsRelativePath(agentDirectory, target) {
+	const relative = path.relative(agentDirectory, target);
+	if (relative.startsWith("..") || path.isAbsolute(relative)) return target;
+	return relative.split(path.sep).join("/");
+}
+function isManagedExtension(value) {
+	const normalized = value.replaceAll("\\", "/");
+	return normalized === DOOM_EXTENSION || normalized === "!extensions/**";
+}
+function isLegacyDoomTheme(value, themeName) {
+	const normalized = value.replaceAll("\\", "/");
+	return normalized.endsWith(`/doom/${themeName}.json`) || normalized === `doom/${themeName}.json`;
+}
+/** Produces the user settings content for an update, without writing it. */
+function mergePiSettings(current, agentDirectory, update) {
+	const theme = settingsRelativePath(agentDirectory, update.themePath);
+	const extensions = [
+		DOOM_EXTENSION,
+		AMBIENT_EXTENSION_FILTER,
+		...stringList(current[EXTENSIONS_KEY]).filter((value) => !isManagedExtension(value))
+	];
+	const themes = [theme, ...stringList(current[THEMES_KEY]).filter((value) => value !== theme && !isLegacyDoomTheme(value, update.themeName))];
+	return {
+		...current,
+		[QUIET_STARTUP_KEY]: true,
+		[EXTENSIONS_KEY]: extensions,
+		[THEMES_KEY]: themes,
+		[THEME_KEY]: typeof current[THEME_KEY] === "string" ? current[THEME_KEY] : update.themeName
+	};
+}
+function readPiSettings(agentDirectory) {
+	const settings = readJson(piSettingsPath(agentDirectory));
+	return isRecord(settings) ? settings : {};
+}
+function serializePiSettings(settings) {
+	return `${JSON.stringify(settings, null, 2)}\n`;
+}
+/** Merges the Doom-owned keys into Pi's user settings file. */
+function writePiSettings(agentDirectory, update) {
+	const settingsPath = piSettingsPath(agentDirectory);
+	writeFileAtomic(settingsPath, serializePiSettings(mergePiSettings(readPiSettings(agentDirectory), agentDirectory, update)));
+	return settingsPath;
+}
+//#endregion
+export { AMBIENT_EXTENSION_FILTER, DOOM_EXTENSION, mergePiSettings, piAgentDirectory, piSettingsPath, piThemeDirectory, readPiSettings, serializePiSettings, writePiSettings };
+
+//# sourceMappingURL=runtime-pi-settings.mjs.map

package/dist/runtime-pi-settings.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-pi-settings.mjs","names":[],"sources":["../src/services/piSettings/index.ts"],"sourcesContent":["import os from 'node:os';\nimport path from 'node:path';\n\nimport { DOOM_PACKAGE_NAME } from '../doomPackage';\nimport { isRecord, readJson, writeFileAtomic } from '../json';\nimport type { JsonObject } from '../json';\n\n/**\n * Pi's user settings, as `doompi sync` maintains them.\n *\n * The Doom package is registered globally so a plain `pi` process can find the\n * lightweight package bootstrap before project resources are trusted. Sync owns\n * the extension registration, ambient-discovery filter, theme resource, selected default theme, and quiet-startup keys\n * while preserving every unrelated user setting.\n */\n\nconst PI_CODING_AGENT_DIR_ENV = 'PI_CODING_AGENT_DIR';\nconst PI_DIRECTORY = '.pi';\nconst AGENT_DIRECTORY = 'agent';\nconst SETTINGS_FILE = 'settings.json';\nconst THEMES_DIRECTORY = 'themes';\nconst EXTENSIONS_KEY = 'extensions';\nconst THEMES_KEY = 'themes';\nconst THEME_KEY = 'theme';\nconst QUIET_STARTUP_KEY = 'quietStartup';\nconst HOME_ALIAS = '~';\nconst HOME_ALIAS_PREFIX = '~/';\n/** The stable package entry Pi loads for every synced repository. */\nexport const DOOM_EXTENSION = DOOM_PACKAGE_NAME;\n/** Suppresses Pi's ambient extension-directory scan while leaving explicit sources intact. */\nexport const AMBIENT_EXTENSION_FILTER = '!extensions/**';\nexport interface PiSettingsUpdate {\n  /** Absolute path to the synchronized user theme file. */\n  themePath: string;\n  themeName: string;\n}\n\n/** Pi's user configuration directory, honoring its documented override. */\nexport function piAgentDirectory(\n  environment: NodeJS.ProcessEnv = process.env,\n  homeDirectory: string = os.homedir(),\n): string {\n  const configured = environment[PI_CODING_AGENT_DIR_ENV]?.trim();\n  if (!configured) return path.join(homeDirectory, PI_DIRECTORY, AGENT_DIRECTORY);\n  if (configured === HOME_ALIAS) return homeDirectory;\n  if (configured.startsWith(HOME_ALIAS_PREFIX)) {\n    return path.join(homeDirectory, configured.slice(HOME_ALIAS_PREFIX.length));\n  }\n  return path.resolve(configured);\n}\n\nexport function piSettingsPath(agentDirectory: string): string {\n  return path.join(agentDirectory, SETTINGS_FILE);\n}\n\nexport function piThemeDirectory(agentDirectory: string): string {\n  return path.join(agentDirectory, THEMES_DIRECTORY);\n}\n\nfunction stringList(value: unknown): string[] {\n  return Array.isArray(value) ? value.filter((entry): entry is string => typeof entry === 'string') : [];\n}\n\nfunction settingsRelativePath(agentDirectory: string, target: string): string {\n  const relative = path.relative(agentDirectory, target);\n  if (relative.startsWith('..') || path.isAbsolute(relative)) return target;\n  return relative.split(path.sep).join('/');\n}\n\nfunction isManagedExtension(value: string): boolean {\n  const normalized = value.replaceAll('\\\\', '/');\n  return normalized === DOOM_EXTENSION || normalized === AMBIENT_EXTENSION_FILTER;\n}\n\nfunction isLegacyDoomTheme(value: string, themeName: string): boolean {\n  const normalized = value.replaceAll('\\\\', '/');\n  return normalized.endsWith(`/doom/${themeName}.json`) || normalized === `doom/${themeName}.json`;\n}\n\n/** Produces the user settings content for an update, without writing it. */\nexport function mergePiSettings(current: JsonObject, agentDirectory: string, update: PiSettingsUpdate): JsonObject {\n  const theme = settingsRelativePath(agentDirectory, update.themePath);\n  // First in the list, so the harness environment is hydrated before any\n  // extension a user added themselves runs. The filter affects only Pi's\n  // automatic extensions/** scan; explicit settings and CLI entries still load.\n  const extensions = [\n    DOOM_EXTENSION,\n    AMBIENT_EXTENSION_FILTER,\n    ...stringList(current[EXTENSIONS_KEY]).filter((value) => !isManagedExtension(value)),\n  ];\n  const themes = [\n    theme,\n    ...stringList(current[THEMES_KEY]).filter(\n      (value) => value !== theme && !isLegacyDoomTheme(value, update.themeName),\n    ),\n  ];\n  return {\n    ...current,\n    [QUIET_STARTUP_KEY]: true,\n    [EXTENSIONS_KEY]: extensions,\n    [THEMES_KEY]: themes,\n    // Only filled in when unset: a theme the user picked later is their choice,\n    // and re-imposing the Doom theme on every sync would silently undo it.\n    [THEME_KEY]: typeof current[THEME_KEY] === 'string' ? current[THEME_KEY] : update.themeName,\n  };\n}\n\nexport function readPiSettings(agentDirectory: string): JsonObject {\n  const settings = readJson(piSettingsPath(agentDirectory));\n  return isRecord(settings) ? settings : {};\n}\n\nexport function serializePiSettings(settings: JsonObject): string {\n  return `${JSON.stringify(settings, null, 2)}\\n`;\n}\n\n/** Merges the Doom-owned keys into Pi's user settings file. */\nexport function writePiSettings(agentDirectory: string, update: PiSettingsUpdate): string {\n  const settingsPath = piSettingsPath(agentDirectory);\n  writeFileAtomic(\n    settingsPath,\n    serializePiSettings(mergePiSettings(readPiSettings(agentDirectory), agentDirectory, update)),\n  );\n  return settingsPath;\n}\n"],"mappings":";;;;;;;;;;;;;AAgBA,MAAM,0BAA0B;AAChC,MAAM,eAAe;AACrB,MAAM,kBAAkB;AACxB,MAAM,gBAAgB;AACtB,MAAM,mBAAmB;AACzB,MAAM,iBAAiB;AACvB,MAAM,aAAa;AACnB,MAAM,YAAY;AAClB,MAAM,oBAAoB;AAC1B,MAAM,aAAa;AACnB,MAAM,oBAAoB;;AAE1B,MAAa,iBAAiB;;AAE9B,MAAa,2BAA2B;;AAQxC,SAAgB,iBACd,cAAiC,QAAQ,KACzC,gBAAwB,GAAG,QAAQ,GAC3B;CACR,MAAM,aAAa,YAAY,wBAAwB,EAAE,KAAK;CAC9D,IAAI,CAAC,YAAY,OAAO,KAAK,KAAK,eAAe,cAAc,eAAe;CAC9E,IAAI,eAAe,YAAY,OAAO;CACtC,IAAI,WAAW,WAAW,iBAAiB,GACzC,OAAO,KAAK,KAAK,eAAe,WAAW,MAAM,CAAwB,CAAC;CAE5E,OAAO,KAAK,QAAQ,UAAU;AAChC;AAEA,SAAgB,eAAe,gBAAgC;CAC7D,OAAO,KAAK,KAAK,gBAAgB,aAAa;AAChD;AAEA,SAAgB,iBAAiB,gBAAgC;CAC/D,OAAO,KAAK,KAAK,gBAAgB,gBAAgB;AACnD;AAEA,SAAS,WAAW,OAA0B;CAC5C,OAAO,MAAM,QAAQ,KAAK,IAAI,MAAM,QAAQ,UAA2B,OAAO,UAAU,QAAQ,IAAI,CAAC;AACvG;AAEA,SAAS,qBAAqB,gBAAwB,QAAwB;CAC5E,MAAM,WAAW,KAAK,SAAS,gBAAgB,MAAM;CACrD,IAAI,SAAS,WAAW,IAAI,KAAK,KAAK,WAAW,QAAQ,GAAG,OAAO;CACnE,OAAO,SAAS,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,GAAG;AAC1C;AAEA,SAAS,mBAAmB,OAAwB;CAClD,MAAM,aAAa,MAAM,WAAW,MAAM,GAAG;CAC7C,OAAO,eAAe,kBAAkB,eAAA;AAC1C;AAEA,SAAS,kBAAkB,OAAe,WAA4B;CACpE,MAAM,aAAa,MAAM,WAAW,MAAM,GAAG;CAC7C,OAAO,WAAW,SAAS,SAAS,UAAU,MAAM,KAAK,eAAe,QAAQ,UAAU;AAC5F;;AAGA,SAAgB,gBAAgB,SAAqB,gBAAwB,QAAsC;CACjH,MAAM,QAAQ,qBAAqB,gBAAgB,OAAO,SAAS;CAInE,MAAM,aAAa;EACjB;EACA;EACA,GAAG,WAAW,QAAQ,eAAe,CAAC,CAAC,QAAQ,UAAU,CAAC,mBAAmB,KAAK,CAAC;CACrF;CACA,MAAM,SAAS,CACb,OACA,GAAG,WAAW,QAAQ,WAAW,CAAC,CAAC,QAChC,UAAU,UAAU,SAAS,CAAC,kBAAkB,OAAO,OAAO,SAAS,CAC1E,CACF;CACA,OAAO;EACL,GAAG;GACF,oBAAoB;GACpB,iBAAiB;GACjB,aAAa;GAGb,YAAY,OAAO,QAAQ,eAAe,WAAW,QAAQ,aAAa,OAAO;CACpF;AACF;AAEA,SAAgB,eAAe,gBAAoC;CACjE,MAAM,WAAW,SAAS,eAAe,cAAc,CAAC;CACxD,OAAO,SAAS,QAAQ,IAAI,WAAW,CAAC;AAC1C;AAEA,SAAgB,oBAAoB,UAA8B;CAChE,OAAO,GAAG,KAAK,UAAU,UAAU,MAAM,CAAC,EAAE;AAC9C;;AAGA,SAAgB,gBAAgB,gBAAwB,QAAkC;CACxF,MAAM,eAAe,eAAe,cAAc;CAClD,gBACE,cACA,oBAAoB,gBAAgB,eAAe,cAAc,GAAG,gBAAgB,MAAM,CAAC,CAC7F;CACA,OAAO;AACT"}