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

package/dist/runtimeLogSinkTelemetry.cjs

@@ -0,0 +1,102 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+//#region src/services/logSinkTelemetry/index.ts
+const MAX_PENDING_EVENTS = 64;
+const SERVICE_NAME = "doom-pi";
+const PACKAGE_NAME = "@agimon-ai/doompi";
+const HARNESS_EVENT = {
+	cliFailed: "doom_pi.cli_failed",
+	contextBuildFailed: "doom_pi.context_build_failed",
+	resourceCollectionFailed: "doom_pi.resource_collection_failed",
+	configLoadFailed: "doom_pi.config_load_failed",
+	launchFailed: "doom_pi.launch_failed",
+	compatibilityLaunchFailed: "doom_pi.compatibility_launch_failed",
+	harnessStateParseFailed: "doom_pi.harness_state_parse_failed",
+	hookFailed: "doom_pi.hook_failed",
+	hookRegistryReadFailed: "doom_pi.hook_registry_read_failed",
+	personaReadFailed: "doom_pi.persona_read_failed",
+	styleSystemRenderFailed: "doom_pi.style_system_render_failed",
+	majorModeUnavailable: "doom_pi.major_mode_unavailable",
+	profileLoadFailed: "doom_pi.profile_load_failed",
+	launchCompleted: "doom_pi.launch_completed",
+	projectTrustResolved: "doom_pi.project_trust_resolved",
+	majorModeSwitched: "doom_pi.major_mode_switched",
+	profileApplied: "doom_pi.profile_applied"
+};
+function createHarnessTelemetry(options = {}) {
+	let telemetryPromise;
+	const pendingEvents = [];
+	let pendingEventDropReported = false;
+	const telemetry = () => {
+		telemetryPromise ??= import("@agimon-ai/doompi-telemetry").then(({ createDoomTelemetry }) => createDoomTelemetry({
+			serviceName: SERVICE_NAME,
+			packageName: PACKAGE_NAME,
+			cwd: options.cwd,
+			workspaceRoot: options.workspaceRoot,
+			env: options.env,
+			telemetryFactory: options.telemetryFactory,
+			warn: options.warn,
+			enableLogs: true,
+			enableTraces: true
+		}));
+		return telemetryPromise;
+	};
+	const drainEvents = async (loaded) => {
+		for (const pending of pendingEvents.splice(0)) await loaded.recordEvent(pending.event, pending.attributes);
+	};
+	return {
+		recordError: async (event, error, attributes) => {
+			const loaded = await telemetry();
+			await drainEvents(loaded);
+			await loaded.recordError(event, error, attributes);
+		},
+		recordWarning: async (event, error, attributes) => {
+			const loaded = await telemetry();
+			await drainEvents(loaded);
+			await loaded.recordWarning(event, error, attributes);
+		},
+		recordEvent: async (event, attributes) => {
+			if (options.deferSpans && !telemetryPromise) {
+				if (pendingEvents.length < MAX_PENDING_EVENTS) pendingEvents.push({
+					event,
+					attributes
+				});
+				else if (!pendingEventDropReported) {
+					pendingEventDropReported = true;
+					try {
+						(options.warn ?? ((message) => process.emitWarning(message)))("Doom telemetry deferred event limit reached; later events were dropped.");
+					} catch {}
+				}
+				return;
+			}
+			await (await telemetry()).recordEvent(event, attributes);
+		},
+		runInSpan: (name, attributes, callback) => {
+			if (options.deferSpans && !telemetryPromise) return callback();
+			return telemetry().then((loaded) => loaded.runInSpan(name, attributes, callback));
+		},
+		flush: async () => {
+			if (!telemetryPromise && pendingEvents.length === 0) return;
+			const loaded = await telemetry();
+			await drainEvents(loaded);
+			await loaded.flush();
+		},
+		shutdown: async () => {
+			if (!telemetryPromise && pendingEvents.length === 0) return;
+			const loaded = await telemetry();
+			await drainEvents(loaded);
+			await loaded.shutdown();
+		}
+	};
+}
+function toFailureReporter(telemetry) {
+	return {
+		error: (event, error, attributes) => void telemetry.recordError(event, error, attributes),
+		warn: (event, error, attributes) => void telemetry.recordWarning(event, error, attributes)
+	};
+}
+//#endregion
+exports.HARNESS_EVENT = HARNESS_EVENT;
+exports.createHarnessTelemetry = createHarnessTelemetry;
+exports.toFailureReporter = toFailureReporter;
+
+//# sourceMappingURL=runtimeLogSinkTelemetry.cjs.map

package/dist/runtimeLogSinkTelemetry.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtimeLogSinkTelemetry.cjs","names":[],"sources":["../src/services/logSinkTelemetry/index.ts"],"sourcesContent":["import type { DoomTelemetry, DoomTelemetryOptions } from '@agimon-ai/doompi-telemetry';\n\nconst MAX_PENDING_EVENTS = 64;\nconst SERVICE_NAME = 'doom-pi';\nconst PACKAGE_NAME = '@agimon-ai/doompi';\n\nexport const HARNESS_EVENT = {\n  cliFailed: 'doom_pi.cli_failed',\n  contextBuildFailed: 'doom_pi.context_build_failed',\n  resourceCollectionFailed: 'doom_pi.resource_collection_failed',\n  configLoadFailed: 'doom_pi.config_load_failed',\n  launchFailed: 'doom_pi.launch_failed',\n  compatibilityLaunchFailed: 'doom_pi.compatibility_launch_failed',\n  harnessStateParseFailed: 'doom_pi.harness_state_parse_failed',\n  hookFailed: 'doom_pi.hook_failed',\n  hookRegistryReadFailed: 'doom_pi.hook_registry_read_failed',\n  personaReadFailed: 'doom_pi.persona_read_failed',\n  styleSystemRenderFailed: 'doom_pi.style_system_render_failed',\n  majorModeUnavailable: 'doom_pi.major_mode_unavailable',\n  profileLoadFailed: 'doom_pi.profile_load_failed',\n  launchCompleted: 'doom_pi.launch_completed',\n  projectTrustResolved: 'doom_pi.project_trust_resolved',\n  majorModeSwitched: 'doom_pi.major_mode_switched',\n  profileApplied: 'doom_pi.profile_applied',\n} as const;\n\nexport type HarnessEventName = (typeof HARNESS_EVENT)[keyof typeof HARNESS_EVENT];\nexport type HarnessEventAttributes = Record<string, string | number | boolean>;\nexport type HarnessErrorSink = (event: HarnessEventName, error: unknown, attributes?: HarnessEventAttributes) => void;\n\nexport interface HarnessFailureReporter {\n  error: HarnessErrorSink;\n  warn: HarnessErrorSink;\n}\n\nexport interface HarnessTelemetryOptions {\n  cwd?: string;\n  workspaceRoot?: string;\n  env?: NodeJS.ProcessEnv;\n  telemetryFactory?: NonNullable<DoomTelemetryOptions['telemetryFactory']>;\n  warn?: (message: string) => void;\n  /** Run startup callbacks before loading the telemetry backend. */\n  deferSpans?: boolean;\n}\n\nexport interface HarnessTelemetry {\n  recordError(event: HarnessEventName, error: unknown, attributes?: HarnessEventAttributes): Promise<void>;\n  recordWarning(event: HarnessEventName, error: unknown, attributes?: HarnessEventAttributes): Promise<void>;\n  recordEvent(event: HarnessEventName, attributes?: HarnessEventAttributes): Promise<void>;\n  runInSpan<T>(name: string, attributes: HarnessEventAttributes, callback: () => Promise<T>): Promise<T>;\n  flush(): Promise<void>;\n  shutdown(): Promise<void>;\n}\n\nexport function createHarnessTelemetry(options: HarnessTelemetryOptions = {}): HarnessTelemetry {\n  let telemetryPromise: Promise<DoomTelemetry> | undefined;\n  const pendingEvents: Array<{ event: HarnessEventName; attributes?: HarnessEventAttributes }> = [];\n  let pendingEventDropReported = false;\n  const telemetry = (): Promise<DoomTelemetry> => {\n    telemetryPromise ??= import('@agimon-ai/doompi-telemetry').then(({ createDoomTelemetry }) =>\n      createDoomTelemetry({\n        serviceName: SERVICE_NAME,\n        packageName: PACKAGE_NAME,\n        cwd: options.cwd,\n        workspaceRoot: options.workspaceRoot,\n        env: options.env,\n        telemetryFactory: options.telemetryFactory,\n        warn: options.warn,\n        enableLogs: true,\n        enableTraces: true,\n      }),\n    );\n    return telemetryPromise;\n  };\n  const drainEvents = async (loaded: DoomTelemetry): Promise<void> => {\n    for (const pending of pendingEvents.splice(0)) {\n      await loaded.recordEvent(pending.event, pending.attributes);\n    }\n  };\n  return {\n    recordError: async (event, error, attributes) => {\n      const loaded = await telemetry();\n      await drainEvents(loaded);\n      await loaded.recordError(event, error, attributes);\n    },\n    recordWarning: async (event, error, attributes) => {\n      const loaded = await telemetry();\n      await drainEvents(loaded);\n      await loaded.recordWarning(event, error, attributes);\n    },\n    recordEvent: async (event, attributes) => {\n      if (options.deferSpans && !telemetryPromise) {\n        if (pendingEvents.length < MAX_PENDING_EVENTS) pendingEvents.push({ event, attributes });\n        else if (!pendingEventDropReported) {\n          pendingEventDropReported = true;\n          try {\n            const reportWarning = options.warn ?? ((message: string) => process.emitWarning(message));\n            reportWarning('Doom telemetry deferred event limit reached; later events were dropped.');\n          } catch {\n            // Telemetry warnings must not interrupt launcher startup.\n          }\n        }\n        return;\n      }\n      await (await telemetry()).recordEvent(event, attributes);\n    },\n    runInSpan: (name, attributes, callback) => {\n      // The launcher opts into this path for pre-spawn preparation. Lifecycle\n      // events remain buffered until flush; failures still initialize the real\n      // sink immediately so diagnostics are not lost.\n      if (options.deferSpans && !telemetryPromise) return callback();\n      return telemetry().then((loaded) => loaded.runInSpan(name, attributes, callback));\n    },\n    flush: async () => {\n      if (!telemetryPromise && pendingEvents.length === 0) return;\n      const loaded = await telemetry();\n      await drainEvents(loaded);\n      await loaded.flush();\n    },\n    shutdown: async () => {\n      if (!telemetryPromise && pendingEvents.length === 0) return;\n      const loaded = await telemetry();\n      await drainEvents(loaded);\n      await loaded.shutdown();\n    },\n  };\n}\n\nexport function toFailureReporter(telemetry: HarnessTelemetry): HarnessFailureReporter {\n  return {\n    error: (event, error, attributes) => void telemetry.recordError(event, error, attributes),\n    warn: (event, error, attributes) => void telemetry.recordWarning(event, error, attributes),\n  };\n}\n"],"mappings":";;AAEA,MAAM,qBAAqB;AAC3B,MAAM,eAAe;AACrB,MAAM,eAAe;AAErB,MAAa,gBAAgB;CAC3B,WAAW;CACX,oBAAoB;CACpB,0BAA0B;CAC1B,kBAAkB;CAClB,cAAc;CACd,2BAA2B;CAC3B,yBAAyB;CACzB,YAAY;CACZ,wBAAwB;CACxB,mBAAmB;CACnB,yBAAyB;CACzB,sBAAsB;CACtB,mBAAmB;CACnB,iBAAiB;CACjB,sBAAsB;CACtB,mBAAmB;CACnB,gBAAgB;AAClB;AA8BA,SAAgB,uBAAuB,UAAmC,CAAC,GAAqB;CAC9F,IAAI;CACJ,MAAM,gBAAyF,CAAC;CAChG,IAAI,2BAA2B;CAC/B,MAAM,kBAA0C;EAC9C,qBAAqB,OAAO,8BAA8B,CAAC,MAAM,EAAE,0BACjE,oBAAoB;GAClB,aAAa;GACb,aAAa;GACb,KAAK,QAAQ;GACb,eAAe,QAAQ;GACvB,KAAK,QAAQ;GACb,kBAAkB,QAAQ;GAC1B,MAAM,QAAQ;GACd,YAAY;GACZ,cAAc;EAChB,CAAC,CACH;EACA,OAAO;CACT;CACA,MAAM,cAAc,OAAO,WAAyC;EAClE,KAAK,MAAM,WAAW,cAAc,OAAO,CAAC,GAC1C,MAAM,OAAO,YAAY,QAAQ,OAAO,QAAQ,UAAU;CAE9D;CACA,OAAO;EACL,aAAa,OAAO,OAAO,OAAO,eAAe;GAC/C,MAAM,SAAS,MAAM,UAAU;GAC/B,MAAM,YAAY,MAAM;GACxB,MAAM,OAAO,YAAY,OAAO,OAAO,UAAU;EACnD;EACA,eAAe,OAAO,OAAO,OAAO,eAAe;GACjD,MAAM,SAAS,MAAM,UAAU;GAC/B,MAAM,YAAY,MAAM;GACxB,MAAM,OAAO,cAAc,OAAO,OAAO,UAAU;EACrD;EACA,aAAa,OAAO,OAAO,eAAe;GACxC,IAAI,QAAQ,cAAc,CAAC,kBAAkB;IAC3C,IAAI,cAAc,SAAS,oBAAoB,cAAc,KAAK;KAAE;KAAO;IAAW,CAAC;SAClF,IAAI,CAAC,0BAA0B;KAClC,2BAA2B;KAC3B,IAAI;MAEF,CADsB,QAAQ,UAAU,YAAoB,QAAQ,YAAY,OAAO,GAAA,CACzE,yEAAyE;KACzF,QAAQ,CAER;IACF;IACA;GACF;GACA,OAAO,MAAM,UAAU,EAAA,CAAG,YAAY,OAAO,UAAU;EACzD;EACA,YAAY,MAAM,YAAY,aAAa;GAIzC,IAAI,QAAQ,cAAc,CAAC,kBAAkB,OAAO,SAAS;GAC7D,OAAO,UAAU,CAAC,CAAC,MAAM,WAAW,OAAO,UAAU,MAAM,YAAY,QAAQ,CAAC;EAClF;EACA,OAAO,YAAY;GACjB,IAAI,CAAC,oBAAoB,cAAc,WAAW,GAAG;GACrD,MAAM,SAAS,MAAM,UAAU;GAC/B,MAAM,YAAY,MAAM;GACxB,MAAM,OAAO,MAAM;EACrB;EACA,UAAU,YAAY;GACpB,IAAI,CAAC,oBAAoB,cAAc,WAAW,GAAG;GACrD,MAAM,SAAS,MAAM,UAAU;GAC/B,MAAM,YAAY,MAAM;GACxB,MAAM,OAAO,SAAS;EACxB;CACF;AACF;AAEA,SAAgB,kBAAkB,WAAqD;CACrF,OAAO;EACL,QAAQ,OAAO,OAAO,eAAe,KAAK,UAAU,YAAY,OAAO,OAAO,UAAU;EACxF,OAAO,OAAO,OAAO,eAAe,KAAK,UAAU,cAAc,OAAO,OAAO,UAAU;CAC3F;AACF"}

package/dist/runtimeLogSinkTelemetry.d.mts

@@ -0,0 +1,49 @@
+import { DoomTelemetryOptions } from "@agimon-ai/doompi-telemetry";
+//#region src/services/logSinkTelemetry/index.d.ts
+export declare const HARNESS_EVENT: {
+  readonly cliFailed: 'doom_pi.cli_failed';
+  readonly contextBuildFailed: 'doom_pi.context_build_failed';
+  readonly resourceCollectionFailed: 'doom_pi.resource_collection_failed';
+  readonly configLoadFailed: 'doom_pi.config_load_failed';
+  readonly launchFailed: 'doom_pi.launch_failed';
+  readonly compatibilityLaunchFailed: 'doom_pi.compatibility_launch_failed';
+  readonly harnessStateParseFailed: 'doom_pi.harness_state_parse_failed';
+  readonly hookFailed: 'doom_pi.hook_failed';
+  readonly hookRegistryReadFailed: 'doom_pi.hook_registry_read_failed';
+  readonly personaReadFailed: 'doom_pi.persona_read_failed';
+  readonly styleSystemRenderFailed: 'doom_pi.style_system_render_failed';
+  readonly majorModeUnavailable: 'doom_pi.major_mode_unavailable';
+  readonly profileLoadFailed: 'doom_pi.profile_load_failed';
+  readonly launchCompleted: 'doom_pi.launch_completed';
+  readonly projectTrustResolved: 'doom_pi.project_trust_resolved';
+  readonly majorModeSwitched: 'doom_pi.major_mode_switched';
+  readonly profileApplied: 'doom_pi.profile_applied';
+};
+export type HarnessEventName = (typeof HARNESS_EVENT)[keyof typeof HARNESS_EVENT];
+export type HarnessEventAttributes = Record<string, string | number | boolean>;
+export type HarnessErrorSink = (event: HarnessEventName, error: unknown, attributes?: HarnessEventAttributes) => void;
+export interface HarnessFailureReporter {
+  error: HarnessErrorSink;
+  warn: HarnessErrorSink;
+}
+export interface HarnessTelemetryOptions {
+  cwd?: string;
+  workspaceRoot?: string;
+  env?: NodeJS.ProcessEnv;
+  telemetryFactory?: NonNullable<DoomTelemetryOptions['telemetryFactory']>;
+  warn?: (message: string) => void;
+  /** Run startup callbacks before loading the telemetry backend. */
+  deferSpans?: boolean;
+}
+export interface HarnessTelemetry {
+  recordError(event: HarnessEventName, error: unknown, attributes?: HarnessEventAttributes): Promise<void>;
+  recordWarning(event: HarnessEventName, error: unknown, attributes?: HarnessEventAttributes): Promise<void>;
+  recordEvent(event: HarnessEventName, attributes?: HarnessEventAttributes): Promise<void>;
+  runInSpan<T>(name: string, attributes: HarnessEventAttributes, callback: () => Promise<T>): Promise<T>;
+  flush(): Promise<void>;
+  shutdown(): Promise<void>;
+}
+export declare function createHarnessTelemetry(options?: HarnessTelemetryOptions): HarnessTelemetry;
+export declare function toFailureReporter(telemetry: HarnessTelemetry): HarnessFailureReporter;
+//#endregion
+//# sourceMappingURL=runtimeLogSinkTelemetry.d.mts.map

package/dist/runtimeLogSinkTelemetry.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtimeLogSinkTelemetry.d.mts","names":[],"sources":["../src/services/logSinkTelemetry/index.ts"],"mappings":";;qBAMa;WACX;WACA;WACA;WACA;WACA;WACA;WACA;WACA;WACA;WACA;WACA;WACA;WACA;WACA;WACA;WACA;WACA;;YAGU,2BAA2B,4BAA4B;YACvD,yBAAyB;YACzB,oBAAoB,OAAO,kBAAkB,gBAAgB,aAAa;iBAErE;EACf,OAAO;EACP,MAAM;;iBAGS;EACf;EACA;EACA,MAAM,OAAO;EACb,mBAAmB,YAAY;EAC/B,QAAQ;;EAER;;iBAGe;EACf,YAAY,OAAO,kBAAkB,gBAAgB,aAAa,yBAAyB;EAC3F,cAAc,OAAO,kBAAkB,gBAAgB,aAAa,yBAAyB;EAC7F,YAAY,OAAO,kBAAkB,aAAa,yBAAyB;EAC3E,UAAU,GAAG,cAAc,YAAY,wBAAwB,gBAAgB,QAAQ,KAAK,QAAQ;EACpG,SAAS;EACT,YAAY;;wBAGE,uBAAuB,UAAS,0BAA+B;wBA0E/D,kBAAkB,WAAW,mBAAmB"}

package/dist/runtimeLogSinkTelemetry.mjs

@@ -0,0 +1,99 @@
+//#region src/services/logSinkTelemetry/index.ts
+const MAX_PENDING_EVENTS = 64;
+const SERVICE_NAME = "doom-pi";
+const PACKAGE_NAME = "@agimon-ai/doompi";
+const HARNESS_EVENT = {
+	cliFailed: "doom_pi.cli_failed",
+	contextBuildFailed: "doom_pi.context_build_failed",
+	resourceCollectionFailed: "doom_pi.resource_collection_failed",
+	configLoadFailed: "doom_pi.config_load_failed",
+	launchFailed: "doom_pi.launch_failed",
+	compatibilityLaunchFailed: "doom_pi.compatibility_launch_failed",
+	harnessStateParseFailed: "doom_pi.harness_state_parse_failed",
+	hookFailed: "doom_pi.hook_failed",
+	hookRegistryReadFailed: "doom_pi.hook_registry_read_failed",
+	personaReadFailed: "doom_pi.persona_read_failed",
+	styleSystemRenderFailed: "doom_pi.style_system_render_failed",
+	majorModeUnavailable: "doom_pi.major_mode_unavailable",
+	profileLoadFailed: "doom_pi.profile_load_failed",
+	launchCompleted: "doom_pi.launch_completed",
+	projectTrustResolved: "doom_pi.project_trust_resolved",
+	majorModeSwitched: "doom_pi.major_mode_switched",
+	profileApplied: "doom_pi.profile_applied"
+};
+function createHarnessTelemetry(options = {}) {
+	let telemetryPromise;
+	const pendingEvents = [];
+	let pendingEventDropReported = false;
+	const telemetry = () => {
+		telemetryPromise ??= import("@agimon-ai/doompi-telemetry").then(({ createDoomTelemetry }) => createDoomTelemetry({
+			serviceName: SERVICE_NAME,
+			packageName: PACKAGE_NAME,
+			cwd: options.cwd,
+			workspaceRoot: options.workspaceRoot,
+			env: options.env,
+			telemetryFactory: options.telemetryFactory,
+			warn: options.warn,
+			enableLogs: true,
+			enableTraces: true
+		}));
+		return telemetryPromise;
+	};
+	const drainEvents = async (loaded) => {
+		for (const pending of pendingEvents.splice(0)) await loaded.recordEvent(pending.event, pending.attributes);
+	};
+	return {
+		recordError: async (event, error, attributes) => {
+			const loaded = await telemetry();
+			await drainEvents(loaded);
+			await loaded.recordError(event, error, attributes);
+		},
+		recordWarning: async (event, error, attributes) => {
+			const loaded = await telemetry();
+			await drainEvents(loaded);
+			await loaded.recordWarning(event, error, attributes);
+		},
+		recordEvent: async (event, attributes) => {
+			if (options.deferSpans && !telemetryPromise) {
+				if (pendingEvents.length < MAX_PENDING_EVENTS) pendingEvents.push({
+					event,
+					attributes
+				});
+				else if (!pendingEventDropReported) {
+					pendingEventDropReported = true;
+					try {
+						(options.warn ?? ((message) => process.emitWarning(message)))("Doom telemetry deferred event limit reached; later events were dropped.");
+					} catch {}
+				}
+				return;
+			}
+			await (await telemetry()).recordEvent(event, attributes);
+		},
+		runInSpan: (name, attributes, callback) => {
+			if (options.deferSpans && !telemetryPromise) return callback();
+			return telemetry().then((loaded) => loaded.runInSpan(name, attributes, callback));
+		},
+		flush: async () => {
+			if (!telemetryPromise && pendingEvents.length === 0) return;
+			const loaded = await telemetry();
+			await drainEvents(loaded);
+			await loaded.flush();
+		},
+		shutdown: async () => {
+			if (!telemetryPromise && pendingEvents.length === 0) return;
+			const loaded = await telemetry();
+			await drainEvents(loaded);
+			await loaded.shutdown();
+		}
+	};
+}
+function toFailureReporter(telemetry) {
+	return {
+		error: (event, error, attributes) => void telemetry.recordError(event, error, attributes),
+		warn: (event, error, attributes) => void telemetry.recordWarning(event, error, attributes)
+	};
+}
+//#endregion
+export { HARNESS_EVENT, createHarnessTelemetry, toFailureReporter };
+
+//# sourceMappingURL=runtimeLogSinkTelemetry.mjs.map

package/dist/runtimeLogSinkTelemetry.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtimeLogSinkTelemetry.mjs","names":[],"sources":["../src/services/logSinkTelemetry/index.ts"],"sourcesContent":["import type { DoomTelemetry, DoomTelemetryOptions } from '@agimon-ai/doompi-telemetry';\n\nconst MAX_PENDING_EVENTS = 64;\nconst SERVICE_NAME = 'doom-pi';\nconst PACKAGE_NAME = '@agimon-ai/doompi';\n\nexport const HARNESS_EVENT = {\n  cliFailed: 'doom_pi.cli_failed',\n  contextBuildFailed: 'doom_pi.context_build_failed',\n  resourceCollectionFailed: 'doom_pi.resource_collection_failed',\n  configLoadFailed: 'doom_pi.config_load_failed',\n  launchFailed: 'doom_pi.launch_failed',\n  compatibilityLaunchFailed: 'doom_pi.compatibility_launch_failed',\n  harnessStateParseFailed: 'doom_pi.harness_state_parse_failed',\n  hookFailed: 'doom_pi.hook_failed',\n  hookRegistryReadFailed: 'doom_pi.hook_registry_read_failed',\n  personaReadFailed: 'doom_pi.persona_read_failed',\n  styleSystemRenderFailed: 'doom_pi.style_system_render_failed',\n  majorModeUnavailable: 'doom_pi.major_mode_unavailable',\n  profileLoadFailed: 'doom_pi.profile_load_failed',\n  launchCompleted: 'doom_pi.launch_completed',\n  projectTrustResolved: 'doom_pi.project_trust_resolved',\n  majorModeSwitched: 'doom_pi.major_mode_switched',\n  profileApplied: 'doom_pi.profile_applied',\n} as const;\n\nexport type HarnessEventName = (typeof HARNESS_EVENT)[keyof typeof HARNESS_EVENT];\nexport type HarnessEventAttributes = Record<string, string | number | boolean>;\nexport type HarnessErrorSink = (event: HarnessEventName, error: unknown, attributes?: HarnessEventAttributes) => void;\n\nexport interface HarnessFailureReporter {\n  error: HarnessErrorSink;\n  warn: HarnessErrorSink;\n}\n\nexport interface HarnessTelemetryOptions {\n  cwd?: string;\n  workspaceRoot?: string;\n  env?: NodeJS.ProcessEnv;\n  telemetryFactory?: NonNullable<DoomTelemetryOptions['telemetryFactory']>;\n  warn?: (message: string) => void;\n  /** Run startup callbacks before loading the telemetry backend. */\n  deferSpans?: boolean;\n}\n\nexport interface HarnessTelemetry {\n  recordError(event: HarnessEventName, error: unknown, attributes?: HarnessEventAttributes): Promise<void>;\n  recordWarning(event: HarnessEventName, error: unknown, attributes?: HarnessEventAttributes): Promise<void>;\n  recordEvent(event: HarnessEventName, attributes?: HarnessEventAttributes): Promise<void>;\n  runInSpan<T>(name: string, attributes: HarnessEventAttributes, callback: () => Promise<T>): Promise<T>;\n  flush(): Promise<void>;\n  shutdown(): Promise<void>;\n}\n\nexport function createHarnessTelemetry(options: HarnessTelemetryOptions = {}): HarnessTelemetry {\n  let telemetryPromise: Promise<DoomTelemetry> | undefined;\n  const pendingEvents: Array<{ event: HarnessEventName; attributes?: HarnessEventAttributes }> = [];\n  let pendingEventDropReported = false;\n  const telemetry = (): Promise<DoomTelemetry> => {\n    telemetryPromise ??= import('@agimon-ai/doompi-telemetry').then(({ createDoomTelemetry }) =>\n      createDoomTelemetry({\n        serviceName: SERVICE_NAME,\n        packageName: PACKAGE_NAME,\n        cwd: options.cwd,\n        workspaceRoot: options.workspaceRoot,\n        env: options.env,\n        telemetryFactory: options.telemetryFactory,\n        warn: options.warn,\n        enableLogs: true,\n        enableTraces: true,\n      }),\n    );\n    return telemetryPromise;\n  };\n  const drainEvents = async (loaded: DoomTelemetry): Promise<void> => {\n    for (const pending of pendingEvents.splice(0)) {\n      await loaded.recordEvent(pending.event, pending.attributes);\n    }\n  };\n  return {\n    recordError: async (event, error, attributes) => {\n      const loaded = await telemetry();\n      await drainEvents(loaded);\n      await loaded.recordError(event, error, attributes);\n    },\n    recordWarning: async (event, error, attributes) => {\n      const loaded = await telemetry();\n      await drainEvents(loaded);\n      await loaded.recordWarning(event, error, attributes);\n    },\n    recordEvent: async (event, attributes) => {\n      if (options.deferSpans && !telemetryPromise) {\n        if (pendingEvents.length < MAX_PENDING_EVENTS) pendingEvents.push({ event, attributes });\n        else if (!pendingEventDropReported) {\n          pendingEventDropReported = true;\n          try {\n            const reportWarning = options.warn ?? ((message: string) => process.emitWarning(message));\n            reportWarning('Doom telemetry deferred event limit reached; later events were dropped.');\n          } catch {\n            // Telemetry warnings must not interrupt launcher startup.\n          }\n        }\n        return;\n      }\n      await (await telemetry()).recordEvent(event, attributes);\n    },\n    runInSpan: (name, attributes, callback) => {\n      // The launcher opts into this path for pre-spawn preparation. Lifecycle\n      // events remain buffered until flush; failures still initialize the real\n      // sink immediately so diagnostics are not lost.\n      if (options.deferSpans && !telemetryPromise) return callback();\n      return telemetry().then((loaded) => loaded.runInSpan(name, attributes, callback));\n    },\n    flush: async () => {\n      if (!telemetryPromise && pendingEvents.length === 0) return;\n      const loaded = await telemetry();\n      await drainEvents(loaded);\n      await loaded.flush();\n    },\n    shutdown: async () => {\n      if (!telemetryPromise && pendingEvents.length === 0) return;\n      const loaded = await telemetry();\n      await drainEvents(loaded);\n      await loaded.shutdown();\n    },\n  };\n}\n\nexport function toFailureReporter(telemetry: HarnessTelemetry): HarnessFailureReporter {\n  return {\n    error: (event, error, attributes) => void telemetry.recordError(event, error, attributes),\n    warn: (event, error, attributes) => void telemetry.recordWarning(event, error, attributes),\n  };\n}\n"],"mappings":";AAEA,MAAM,qBAAqB;AAC3B,MAAM,eAAe;AACrB,MAAM,eAAe;AAErB,MAAa,gBAAgB;CAC3B,WAAW;CACX,oBAAoB;CACpB,0BAA0B;CAC1B,kBAAkB;CAClB,cAAc;CACd,2BAA2B;CAC3B,yBAAyB;CACzB,YAAY;CACZ,wBAAwB;CACxB,mBAAmB;CACnB,yBAAyB;CACzB,sBAAsB;CACtB,mBAAmB;CACnB,iBAAiB;CACjB,sBAAsB;CACtB,mBAAmB;CACnB,gBAAgB;AAClB;AA8BA,SAAgB,uBAAuB,UAAmC,CAAC,GAAqB;CAC9F,IAAI;CACJ,MAAM,gBAAyF,CAAC;CAChG,IAAI,2BAA2B;CAC/B,MAAM,kBAA0C;EAC9C,qBAAqB,OAAO,8BAA8B,CAAC,MAAM,EAAE,0BACjE,oBAAoB;GAClB,aAAa;GACb,aAAa;GACb,KAAK,QAAQ;GACb,eAAe,QAAQ;GACvB,KAAK,QAAQ;GACb,kBAAkB,QAAQ;GAC1B,MAAM,QAAQ;GACd,YAAY;GACZ,cAAc;EAChB,CAAC,CACH;EACA,OAAO;CACT;CACA,MAAM,cAAc,OAAO,WAAyC;EAClE,KAAK,MAAM,WAAW,cAAc,OAAO,CAAC,GAC1C,MAAM,OAAO,YAAY,QAAQ,OAAO,QAAQ,UAAU;CAE9D;CACA,OAAO;EACL,aAAa,OAAO,OAAO,OAAO,eAAe;GAC/C,MAAM,SAAS,MAAM,UAAU;GAC/B,MAAM,YAAY,MAAM;GACxB,MAAM,OAAO,YAAY,OAAO,OAAO,UAAU;EACnD;EACA,eAAe,OAAO,OAAO,OAAO,eAAe;GACjD,MAAM,SAAS,MAAM,UAAU;GAC/B,MAAM,YAAY,MAAM;GACxB,MAAM,OAAO,cAAc,OAAO,OAAO,UAAU;EACrD;EACA,aAAa,OAAO,OAAO,eAAe;GACxC,IAAI,QAAQ,cAAc,CAAC,kBAAkB;IAC3C,IAAI,cAAc,SAAS,oBAAoB,cAAc,KAAK;KAAE;KAAO;IAAW,CAAC;SAClF,IAAI,CAAC,0BAA0B;KAClC,2BAA2B;KAC3B,IAAI;MAEF,CADsB,QAAQ,UAAU,YAAoB,QAAQ,YAAY,OAAO,GAAA,CACzE,yEAAyE;KACzF,QAAQ,CAER;IACF;IACA;GACF;GACA,OAAO,MAAM,UAAU,EAAA,CAAG,YAAY,OAAO,UAAU;EACzD;EACA,YAAY,MAAM,YAAY,aAAa;GAIzC,IAAI,QAAQ,cAAc,CAAC,kBAAkB,OAAO,SAAS;GAC7D,OAAO,UAAU,CAAC,CAAC,MAAM,WAAW,OAAO,UAAU,MAAM,YAAY,QAAQ,CAAC;EAClF;EACA,OAAO,YAAY;GACjB,IAAI,CAAC,oBAAoB,cAAc,WAAW,GAAG;GACrD,MAAM,SAAS,MAAM,UAAU;GAC/B,MAAM,YAAY,MAAM;GACxB,MAAM,OAAO,MAAM;EACrB;EACA,UAAU,YAAY;GACpB,IAAI,CAAC,oBAAoB,cAAc,WAAW,GAAG;GACrD,MAAM,SAAS,MAAM,UAAU;GAC/B,MAAM,YAAY,MAAM;GACxB,MAAM,OAAO,SAAS;EACxB;CACF;AACF;AAEA,SAAgB,kBAAkB,WAAqD;CACrF,OAAO;EACL,QAAQ,OAAO,OAAO,eAAe,KAAK,UAAU,YAAY,OAAO,OAAO,UAAU;EACxF,OAAO,OAAO,OAAO,eAAe,KAAK,UAAU,cAAc,OAAO,OAAO,UAAU;CAC3F;AACF"}

package/dist/runtimePiExtension.cjs

@@ -0,0 +1,339 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_toolOverrides = require("./src/schemas/toolOverrides.cjs");
+const require_toolSurface = require("./src/schemas/toolSurface.cjs");
+const require_runtimeCordisHost = require("./runtimeCordisHost.cjs");
+const require_help = require("./src/schemas/help.cjs");
+const require_index = require("./src/services/pluginLifecycle/index.cjs");
+//#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 = require_index.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 ?? {})) lifecycle.own(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(require_help.DOOM_HELP_SERVICE, (child) => {
+				for (const resource of contributions.resources) {
+					const handle = require_help.requireDoomHelpService(child).register(resource);
+					child.effect(() => () => handle.dispose());
+				}
+			});
+			if (contributions.toolRestrictions?.length) bind(require_toolSurface.DOOM_TOOL_SURFACE_SERVICE, (child) => {
+				for (const restriction of contributions.toolRestrictions) {
+					const handle = require_toolSurface.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(require_toolOverrides.DOOM_TOOL_OVERRIDES_SERVICE, (child) => {
+				for (const override of contributions.toolOverrides) {
+					const handle = require_toolOverrides.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 require_runtimeCordisHost.connectDoomCordisHost(pi, name);
+		const fiber = connection.root.plugin(async (context) => {
+			await install(context, pi, options, connection.runtime);
+		});
+		let completion;
+		let unsubscribeShutdown;
+		const dispose = () => completion ??= (async () => {
+			try {
+				unsubscribeShutdown?.();
+				unsubscribeShutdown = void 0;
+				await fiber.dispose();
+			} finally {
+				await connection.dispose();
+			}
+		})();
+		try {
+			await fiber;
+			const shutdownRegistration = pi.on("session_shutdown", dispose);
+			if (typeof shutdownRegistration === "function") unsubscribeShutdown = shutdownRegistration;
+		} catch (error) {
+			try {
+				await dispose();
+			} catch (cleanupError) {
+				throw new AggregateError([error, cleanupError], `${name} startup and cleanup failed.`);
+			}
+			throw error;
+		}
+	};
+	return Object.assign(activate, { install });
+}
+/**
+* `(frontend)/tool/<name>.cli.tsx`. The filename names the tool these draw.
+*
+* Generic over the tool's schema, because a renderer reads the call it is
+* drawing: state the parameter type and `renderResult` sees the real arguments
+* instead of `unknown`, which is what the single-file version got for free.
+*/
+function definePiToolRenderer(file) {
+	return file;
+}
+/** `(frontend)/tool/<name>.cli.tsx` when the renderer needs mount context. */
+function defineCliToolRenderer(file) {
+	return file;
+}
+/**
+* `(frontend)/message/<name>.cli.tsx`. A renderer for one custom message type.
+*
+* The type is stated rather than derived from the filename, because it is a
+* protocol constant shared with whatever emits the message. A path-derived
+* name would silently stop matching the moment either side was renamed.
+*/
+function defineMessageRenderer(messageType, render) {
+	return [messageType, render];
+}
+/**
+* Attaches a presentation file's renderers to the tool its filename names.
+*
+* Three tool shapes reach a contribution array and each carries renderers in a
+* different place, so a generated entry cannot spell this merge itself. A
+* native Pi definition takes them at the top level, the portable shape nests
+* them under `pi`, and `definePiTool` owns its own registration, so that one
+* is reached by narrowing the host it registers against. `register` asks for
+* nothing but `registerTool`, which is what makes the last case a two-line
+* shim rather than a proxy over the whole extension API.
+*/
+function withPiRenderers(tool, renderers) {
+	if (!("kind" in tool)) return {
+		...tool,
+		...renderers
+	};
+	if (tool.kind !== "pi-tool") return {
+		...tool,
+		pi: {
+			...tool.pi,
+			...renderers
+		}
+	};
+	return {
+		...tool,
+		register(pi, executionSignal) {
+			tool.register({ registerTool: (definition) => pi.registerTool({
+				...definition,
+				...renderers
+			}) }, executionSignal);
+		}
+	};
+}
+/**
+* Splits routed tool files into the two arrays the Pi host keeps apart.
+*
+* A tool that replaces a name Pi already ships is not a second registration,
+* it is a claim the override service arbitrates, and only the winner
+* registers. The folder convention keeps both in `tool/`, because from the
+* author's side both are "this package provides grep"; which one it is lives
+* in the value, through `definePiTool(definition, { overrides: true })`.
+*
+* A generated entry therefore cannot decide this from the path, and calls
+* this instead. Every static claim from one package is one atomic set, which
+* is what the override service expects. A live collection stays intact so its
+* subscription continues to drive registration changes.
+*/
+function piToolContributions(source, items) {
+	if (!Array.isArray(items)) return { tools: items };
+	const added = [];
+	const claimed = [];
+	for (const item of items) if ("kind" in item && item.kind === "pi-tool" && item.overrides === true) claimed.push(item);
+	else added.push(item);
+	if (claimed.length === 0) return { tools: added };
+	return {
+		tools: added,
+		toolOverrides: [{
+			source,
+			tools: claimed.map((item) => item.name),
+			replacements: claimed
+		}]
+	};
+}
+//#endregion
+exports.defineCliToolRenderer = defineCliToolRenderer;
+exports.defineMessageRenderer = defineMessageRenderer;
+exports.definePiExtension = definePiExtension;
+exports.definePiToolRenderer = definePiToolRenderer;
+exports.piToolContributions = piToolContributions;
+exports.withPiRenderers = withPiRenderers;
+
+//# sourceMappingURL=runtimePiExtension.cjs.map