@xopcai/xopc 0.0.86 → 0.0.88

package/dist/src/config/voice.js

@@ -1,270 +1,36 @@
-import { OPENAI_TTS_MODELS, OPENAI_TTS_VOICES } from "../voice/tts/providers/openai-speech.js";
-import "../voice/tts/index.js";
+import { listVoiceProviderMetadata } from "../voice/metadata/registry.js";
+import "../voice/metadata/index.js";
 //#region src/config/voice.ts
-/**
-* Voice (STT/TTS) Model Configuration
-*
-* This module provides available STT/TTS models for the UI.
-* Models can be extended via config file or environment variables.
-*/
-const DEFAULT_STT_ALIBABA = [
-	{
-		id: "paraformer-v2",
-		name: "Paraformer v2 (Recommended)"
-	},
-	{
-		id: "paraformer-v1",
-		name: "Paraformer v1"
-	},
-	{
-		id: "paraformer-8k-v1",
-		name: "Paraformer 8k v1 (Phone)"
-	},
-	{
-		id: "paraformer-mtl-v1",
-		name: "Paraformer MTL v1 (Multilingual)"
-	}
-];
-const DEFAULT_STT_OPENAI = [{
-	id: "whisper-1",
-	name: "Whisper-1"
-}];
-const DEFAULT_TTS_OPENAI = OPENAI_TTS_MODELS.map((id) => ({
-	id,
-	name: id === "tts-1" ? "TTS-1 (Fast)" : id === "tts-1-hd" ? "TTS-1 HD (High Quality)" : id === "gpt-4o-mini-tts" ? "GPT-4o Mini TTS (Latest)" : id
-}));
-const DEFAULT_TTS_ALIBABA = [
-	{
-		id: "qwen-tts",
-		name: "Qwen TTS (Recommended)"
-	},
-	{
-		id: "qwen-tts-realtime",
-		name: "Qwen TTS Realtime"
-	},
-	{
-		id: "qwen3-tts-flash",
-		name: "Qwen3 TTS Flash"
-	},
-	{
-		id: "qwen3-tts-instruct-flash",
-		name: "Qwen3 TTS Instruct Flash"
-	}
-];
-const DEFAULT_TTS_EDGE = [{
-	id: "edge-default",
-	name: "Edge TTS (Free)"
-}];
-const DEFAULT_TTS_MINIMAX = [
-	{
-		id: "speech-2.8-hd",
-		name: "Speech 2.8 HD (Recommended)"
-	},
-	{
-		id: "speech-2.8-turbo",
-		name: "Speech 2.8 Turbo (Fast)"
-	},
-	{
-		id: "speech-2.6-hd",
-		name: "Speech 2.6 HD"
-	},
-	{
-		id: "speech-2.6-turbo",
-		name: "Speech 2.6 Turbo"
-	},
-	{
-		id: "speech-02-hd",
-		name: "Speech 02 HD"
-	},
-	{
-		id: "speech-02-turbo",
-		name: "Speech 02 Turbo"
-	}
-];
-const DEFAULT_TTS_VOICES_ALIBABA = [
-	{
-		id: "Cherry",
-		name: "Cherry"
-	},
-	{
-		id: "longxiaochun",
-		name: "Long Xiao Chun (龙小春)"
-	},
-	{
-		id: "longcheng",
-		name: "Long Cheng (龙呈)"
-	},
-	{
-		id: "xiaogang",
-		name: "Xiao Gang (小刚)"
-	},
-	{
-		id: "xiaoxian",
-		name: "Xiao Xian (小娴)"
-	}
-];
-const DEFAULT_TTS_VOICES_OPENAI = OPENAI_TTS_VOICES.map((id) => ({
-	id,
-	name: id.charAt(0).toUpperCase() + id.slice(1)
-}));
-const DEFAULT_TTS_VOICES_MINIMAX = [
-	{
-		id: "male-qn-qingse",
-		name: "Male Qingse (青涩男声)"
-	},
-	{
-		id: "male-qn-jingying",
-		name: "Male Jingying (精英男声)"
-	},
-	{
-		id: "male-qn-badao",
-		name: "Male Badao (霸道男声)"
-	},
-	{
-		id: "male-qn-daxuesheng",
-		name: "Male Daxuesheng (大学生男声)"
-	},
-	{
-		id: "female-shaonv",
-		name: "Female Shaonv (少女音)"
-	},
-	{
-		id: "female-yujie",
-		name: "Female Yujie (御姐音)"
-	},
-	{
-		id: "female-chengshu",
-		name: "Female Chengshu (成熟女声)"
-	},
-	{
-		id: "female-tianmei",
-		name: "Female Tianmei (甜美女声)"
-	},
-	{
-		id: "audiobook_male_1",
-		name: "Audiobook Male 1"
-	},
-	{
-		id: "audiobook_male_2",
-		name: "Audiobook Male 2"
-	},
-	{
-		id: "audiobook_female_1",
-		name: "Audiobook Female 1"
-	},
-	{
-		id: "audiobook_female_2",
-		name: "Audiobook Female 2"
-	},
-	{
-		id: "presenter_male",
-		name: "Presenter Male"
-	},
-	{
-		id: "presenter_female",
-		name: "Presenter Female"
-	}
-];
-const DEFAULT_TTS_VOICES_EDGE = [
-	{
-		id: "en-US-MichelleNeural",
-		name: "Michelle (US English, Female)"
-	},
-	{
-		id: "en-US-JennyNeural",
-		name: "Jenny (US English, Female)"
-	},
-	{
-		id: "en-US-GuyNeural",
-		name: "Guy (US English, Male)"
-	},
-	{
-		id: "en-GB-SoniaNeural",
-		name: "Sonia (UK English, Female)"
-	},
-	{
-		id: "en-GB-RyanNeural",
-		name: "Ryan (UK English, Male)"
-	},
-	{
-		id: "zh-CN-XiaoxiaoNeural",
-		name: "晓晓 (中文, 女声)"
-	},
-	{
-		id: "zh-CN-YunyangNeural",
-		name: "云扬 (中文, 男声)"
-	},
-	{
-		id: "zh-CN-XiaoyiNeural",
-		name: "晓伊 (中文, 女声)"
-	},
-	{
-		id: "ja-JP-NanamiNeural",
-		name: "七海 (日本語, 女性)"
-	},
-	{
-		id: "de-DE-KatjaNeural",
-		name: "Katja (Deutsch, Weiblich)"
-	},
-	{
-		id: "fr-FR-DeniseNeural",
-		name: "Denise (Français, Féminin)"
-	},
-	{
-		id: "es-ES-ElviraNeural",
-		name: "Elvira (Español, Femenino)"
-	}
-];
+function toVoiceModels(values) {
+	return (values ?? []).map((value) => ({
+		id: value.id,
+		name: value.name,
+		...value.description ? { description: value.description } : {}
+	}));
+}
 function getVoiceModelsConfig() {
-	return {
-		stt: {
-			alibaba: DEFAULT_STT_ALIBABA,
-			openai: DEFAULT_STT_OPENAI
-		},
-		tts: {
-			alibaba: DEFAULT_TTS_ALIBABA,
-			openai: DEFAULT_TTS_OPENAI,
-			edge: DEFAULT_TTS_EDGE,
-			minimax: DEFAULT_TTS_MINIMAX
-		},
-		ttsVoices: {
-			alibaba: DEFAULT_TTS_VOICES_ALIBABA,
-			openai: DEFAULT_TTS_VOICES_OPENAI,
-			edge: DEFAULT_TTS_VOICES_EDGE,
-			minimax: DEFAULT_TTS_VOICES_MINIMAX
-		}
+	const config = {
+		stt: {},
+		tts: {},
+		ttsVoices: {}
 	};
+	for (const metadata of listVoiceProviderMetadata()) {
+		if (metadata.capability === "stt") {
+			config.stt[metadata.id] = toVoiceModels(metadata.models);
+			continue;
+		}
+		config.tts[metadata.id] = toVoiceModels(metadata.models);
+		config.ttsVoices[metadata.id] = toVoiceModels(metadata.voices);
+	}
+	return config;
 }
-/**
-* Get available TTS providers for UI
-*/
 function getTTSProviders() {
-	return [
-		{
-			id: "openai",
-			name: "OpenAI",
-			description: "High quality, multiple voices"
-		},
-		{
-			id: "alibaba",
-			name: "Alibaba",
-			description: "Qwen TTS, good for Chinese"
-		},
-		{
-			id: "minimax",
-			name: "MiniMax",
-			description: "High quality, 40+ languages"
-		},
-		{
-			id: "edge",
-			name: "Microsoft Edge",
-			description: "Free, 100+ voices, multi-language"
-		}
-	];
+	return listVoiceProviderMetadata("tts").map((metadata) => ({
+		id: metadata.id,
+		name: metadata.displayName,
+		...metadata.description ? { description: metadata.description } : {}
+	}));
 }
-/**
-* Get TTS trigger modes for UI
-*/
 function getTTSTriggerModes() {
 	return [
 		{

package/dist/src/config/voice.js.map

@@ -1 +1 @@
-{"version":3,"file":"voice.js","names":[],"sources":["../../../src/config/voice.ts"],"sourcesContent":["/**\n * Voice (STT/TTS) Model Configuration\n *\n * This module provides available STT/TTS models for the UI.\n * Models can be extended via config file or environment variables.\n */\n\nimport { OPENAI_TTS_MODELS, OPENAI_TTS_VOICES } from '../voice/tts/index.js';\n\nexport interface VoiceModel {\n  id: string;\n  name: string;\n  description?: string;\n}\n\nexport interface VoiceModelsConfig {\n  stt: {\n    alibaba: VoiceModel[];\n    openai: VoiceModel[];\n  };\n  tts: {\n    alibaba: VoiceModel[];\n    openai: VoiceModel[];\n    edge: VoiceModel[];\n    minimax: VoiceModel[];\n  };\n  ttsVoices: {\n    alibaba: VoiceModel[];\n    openai: VoiceModel[];\n    edge: VoiceModel[];\n    minimax: VoiceModel[];\n  };\n}\n\n// Default STT models\nconst DEFAULT_STT_ALIBABA: VoiceModel[] = [\n  { id: 'paraformer-v2', name: 'Paraformer v2 (Recommended)' },\n  { id: 'paraformer-v1', name: 'Paraformer v1' },\n  { id: 'paraformer-8k-v1', name: 'Paraformer 8k v1 (Phone)' },\n  { id: 'paraformer-mtl-v1', name: 'Paraformer MTL v1 (Multilingual)' },\n];\n\nconst DEFAULT_STT_OPENAI: VoiceModel[] = [\n  { id: 'whisper-1', name: 'Whisper-1' },\n];\n\n// Default TTS models - dynamically from TTS module\nconst DEFAULT_TTS_OPENAI: VoiceModel[] = OPENAI_TTS_MODELS.map(id => ({\n  id,\n  name: id === 'tts-1' ? 'TTS-1 (Fast)' :\n        id === 'tts-1-hd' ? 'TTS-1 HD (High Quality)' :\n        id === 'gpt-4o-mini-tts' ? 'GPT-4o Mini TTS (Latest)' :\n        id,\n}));\n\nconst DEFAULT_TTS_ALIBABA: VoiceModel[] = [\n  { id: 'qwen-tts', name: 'Qwen TTS (Recommended)' },\n  { id: 'qwen-tts-realtime', name: 'Qwen TTS Realtime' },\n  { id: 'qwen3-tts-flash', name: 'Qwen3 TTS Flash' },\n  { id: 'qwen3-tts-instruct-flash', name: 'Qwen3 TTS Instruct Flash' },\n];\n\nconst DEFAULT_TTS_EDGE: VoiceModel[] = [\n  { id: 'edge-default', name: 'Edge TTS (Free)' },\n];\n\nconst DEFAULT_TTS_MINIMAX: VoiceModel[] = [\n  { id: 'speech-2.8-hd', name: 'Speech 2.8 HD (Recommended)' },\n  { id: 'speech-2.8-turbo', name: 'Speech 2.8 Turbo (Fast)' },\n  { id: 'speech-2.6-hd', name: 'Speech 2.6 HD' },\n  { id: 'speech-2.6-turbo', name: 'Speech 2.6 Turbo' },\n  { id: 'speech-02-hd', name: 'Speech 02 HD' },\n  { id: 'speech-02-turbo', name: 'Speech 02 Turbo' },\n];\n\n// Default TTS voices\nconst DEFAULT_TTS_VOICES_ALIBABA: VoiceModel[] = [\n  { id: 'Cherry', name: 'Cherry' },\n  { id: 'longxiaochun', name: 'Long Xiao Chun (龙小春)' },\n  { id: 'longcheng', name: 'Long Cheng (龙呈)' },\n  { id: 'xiaogang', name: 'Xiao Gang (小刚)' },\n  { id: 'xiaoxian', name: 'Xiao Xian (小娴)' },\n];\n\nconst DEFAULT_TTS_VOICES_OPENAI: VoiceModel[] = OPENAI_TTS_VOICES.map(id => ({\n  id,\n  name: id.charAt(0).toUpperCase() + id.slice(1),\n}));\n\n// Edge TTS popular voices\nconst DEFAULT_TTS_VOICES_MINIMAX: VoiceModel[] = [\n  { id: 'male-qn-qingse', name: 'Male Qingse (青涩男声)' },\n  { id: 'male-qn-jingying', name: 'Male Jingying (精英男声)' },\n  { id: 'male-qn-badao', name: 'Male Badao (霸道男声)' },\n  { id: 'male-qn-daxuesheng', name: 'Male Daxuesheng (大学生男声)' },\n  { id: 'female-shaonv', name: 'Female Shaonv (少女音)' },\n  { id: 'female-yujie', name: 'Female Yujie (御姐音)' },\n  { id: 'female-chengshu', name: 'Female Chengshu (成熟女声)' },\n  { id: 'female-tianmei', name: 'Female Tianmei (甜美女声)' },\n  { id: 'audiobook_male_1', name: 'Audiobook Male 1' },\n  { id: 'audiobook_male_2', name: 'Audiobook Male 2' },\n  { id: 'audiobook_female_1', name: 'Audiobook Female 1' },\n  { id: 'audiobook_female_2', name: 'Audiobook Female 2' },\n  { id: 'presenter_male', name: 'Presenter Male' },\n  { id: 'presenter_female', name: 'Presenter Female' },\n];\n\nconst DEFAULT_TTS_VOICES_EDGE: VoiceModel[] = [\n  { id: 'en-US-MichelleNeural', name: 'Michelle (US English, Female)' },\n  { id: 'en-US-JennyNeural', name: 'Jenny (US English, Female)' },\n  { id: 'en-US-GuyNeural', name: 'Guy (US English, Male)' },\n  { id: 'en-GB-SoniaNeural', name: 'Sonia (UK English, Female)' },\n  { id: 'en-GB-RyanNeural', name: 'Ryan (UK English, Male)' },\n  { id: 'zh-CN-XiaoxiaoNeural', name: '晓晓 (中文, 女声)' },\n  { id: 'zh-CN-YunyangNeural', name: '云扬 (中文, 男声)' },\n  { id: 'zh-CN-XiaoyiNeural', name: '晓伊 (中文, 女声)' },\n  { id: 'ja-JP-NanamiNeural', name: '七海 (日本語, 女性)' },\n  { id: 'de-DE-KatjaNeural', name: 'Katja (Deutsch, Weiblich)' },\n  { id: 'fr-FR-DeniseNeural', name: 'Denise (Français, Féminin)' },\n  { id: 'es-ES-ElviraNeural', name: 'Elvira (Español, Femenino)' },\n];\n\nexport function getVoiceModelsConfig(): VoiceModelsConfig {\n  return {\n    stt: {\n      alibaba: DEFAULT_STT_ALIBABA,\n      openai: DEFAULT_STT_OPENAI,\n    },\n    tts: {\n      alibaba: DEFAULT_TTS_ALIBABA,\n      openai: DEFAULT_TTS_OPENAI,\n      edge: DEFAULT_TTS_EDGE,\n      minimax: DEFAULT_TTS_MINIMAX,\n    },\n    ttsVoices: {\n      alibaba: DEFAULT_TTS_VOICES_ALIBABA,\n      openai: DEFAULT_TTS_VOICES_OPENAI,\n      edge: DEFAULT_TTS_VOICES_EDGE,\n      minimax: DEFAULT_TTS_VOICES_MINIMAX,\n    },\n  };\n}\n\n/**\n * Get available TTS providers for UI\n */\nexport function getTTSProviders(): Array<{ id: string; name: string; description?: string }> {\n  return [\n    { id: 'openai', name: 'OpenAI', description: 'High quality, multiple voices' },\n    { id: 'alibaba', name: 'Alibaba', description: 'Qwen TTS, good for Chinese' },\n    { id: 'minimax', name: 'MiniMax', description: 'High quality, 40+ languages' },\n    { id: 'edge', name: 'Microsoft Edge', description: 'Free, 100+ voices, multi-language' },\n  ];\n}\n\n/**\n * Get TTS trigger modes for UI\n */\nexport function getTTSTriggerModes(): Array<{ id: string; name: string; description: string }> {\n  return [\n    { id: 'off', name: 'Disabled', description: 'TTS is completely disabled' },\n    { id: 'always', name: 'Always', description: 'Apply TTS to all messages' },\n    { id: 'inbound', name: 'Inbound Audio', description: 'Only when user sends voice message' },\n    { id: 'tagged', name: 'Tagged', description: 'Only when [[tts]] directive is used' },\n  ];\n}\n"],"mappings":"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"}
+{"version":3,"file":"voice.js","names":[],"sources":["../../../src/config/voice.ts"],"sourcesContent":["import { listVoiceProviderMetadata } from '../voice/metadata/index.js';\n\nexport interface VoiceModel {\n  id: string;\n  name: string;\n  description?: string;\n}\n\nexport interface VoiceModelsConfig {\n  stt: Record<string, VoiceModel[]>;\n  tts: Record<string, VoiceModel[]>;\n  ttsVoices: Record<string, VoiceModel[]>;\n}\n\nfunction toVoiceModels(values: VoiceModel[] | undefined): VoiceModel[] {\n  return (values ?? []).map((value) => ({\n    id: value.id,\n    name: value.name,\n    ...(value.description ? { description: value.description } : {}),\n  }));\n}\n\nexport function getVoiceModelsConfig(): VoiceModelsConfig {\n  const config: VoiceModelsConfig = { stt: {}, tts: {}, ttsVoices: {} };\n  for (const metadata of listVoiceProviderMetadata()) {\n    if (metadata.capability === 'stt') {\n      config.stt[metadata.id] = toVoiceModels(metadata.models);\n      continue;\n    }\n    config.tts[metadata.id] = toVoiceModels(metadata.models);\n    config.ttsVoices[metadata.id] = toVoiceModels(metadata.voices);\n  }\n  return config;\n}\n\nexport function getTTSProviders(): Array<{ id: string; name: string; description?: string }> {\n  return listVoiceProviderMetadata('tts').map((metadata) => ({\n    id: metadata.id,\n    name: metadata.displayName,\n    ...(metadata.description ? { description: metadata.description } : {}),\n  }));\n}\n\nexport function getTTSTriggerModes(): Array<{ id: string; name: string; description: string }> {\n  return [\n    { id: 'off', name: 'Disabled', description: 'TTS is completely disabled' },\n    { id: 'always', name: 'Always', description: 'Apply TTS to all messages' },\n    { id: 'inbound', name: 'Inbound Audio', description: 'Only when user sends voice message' },\n    { id: 'tagged', name: 'Tagged', description: 'Only when [[tts]] directive is used' },\n  ];\n}\n"],"mappings":";;;AAcA,SAAS,cAAc,QAAgD;AACrE,SAAQ,UAAU,EAAE,EAAE,KAAK,WAAW;EACpC,IAAI,MAAM;EACV,MAAM,MAAM;EACZ,GAAI,MAAM,cAAc,EAAE,aAAa,MAAM,aAAa,GAAG,EAAE;EAChE,EAAE;;AAGL,SAAgB,uBAA0C;CACxD,MAAM,SAA4B;EAAE,KAAK,EAAE;EAAE,KAAK,EAAE;EAAE,WAAW,EAAE;EAAE;AACrE,MAAK,MAAM,YAAY,2BAA2B,EAAE;AAClD,MAAI,SAAS,eAAe,OAAO;AACjC,UAAO,IAAI,SAAS,MAAM,cAAc,SAAS,OAAO;AACxD;;AAEF,SAAO,IAAI,SAAS,MAAM,cAAc,SAAS,OAAO;AACxD,SAAO,UAAU,SAAS,MAAM,cAAc,SAAS,OAAO;;AAEhE,QAAO;;AAGT,SAAgB,kBAA6E;AAC3F,QAAO,0BAA0B,MAAM,CAAC,KAAK,cAAc;EACzD,IAAI,SAAS;EACb,MAAM,SAAS;EACf,GAAI,SAAS,cAAc,EAAE,aAAa,SAAS,aAAa,GAAG,EAAE;EACtE,EAAE;;AAGL,SAAgB,qBAA+E;AAC7F,QAAO;EACL;GAAE,IAAI;GAAO,MAAM;GAAY,aAAa;GAA8B;EAC1E;GAAE,IAAI;GAAU,MAAM;GAAU,aAAa;GAA6B;EAC1E;GAAE,IAAI;GAAW,MAAM;GAAiB,aAAa;GAAsC;EAC3F;GAAE,IAAI;GAAU,MAAM;GAAU,aAAa;GAAuC;EACrF"}

package/dist/src/config/workspace-path-helpers.d.ts

@@ -4,8 +4,7 @@
  *
  * Lives in this file rather than `./schema.js` because schema.ts is the leaf
  * type module — letting it import agent-scope creates a circular cycle
- * (`schema → agent-scope → schema`). Callers import via the `./index.js`
- * barrel; backward-compat re-export keeps existing call sites working.
+ * (`schema → agent-scope → schema`). Callers import via the `./index.js` barrel.
  */
 import type { Config } from './schema.js';
 /**

package/dist/src/config/workspace-path-helpers.js.map

@@ -1 +1 @@
-{"version":3,"file":"workspace-path-helpers.js","names":[],"sources":["../../../src/config/workspace-path-helpers.ts"],"sourcesContent":["/**\n * Workspace-path domain helpers that need both `Config` (from `./schema.js`)\n * and agent-scope helpers (from `../agent/agent-scope.js`).\n *\n * Lives in this file rather than `./schema.js` because schema.ts is the leaf\n * type module — letting it import agent-scope creates a circular cycle\n * (`schema → agent-scope → schema`). Callers import via the `./index.js`\n * barrel; backward-compat re-export keeps existing call sites working.\n */\n\nimport { getDefaultWorkspacePath } from '../agent/agent-scope.js';\nimport type { Config } from './schema.js';\n\n/**\n * Default agent's resolved Markdown workspace root\n * (`resolveAgentWorkspaceDir` for the default agent id).\n */\nexport function getWorkspacePath(config: Config): string {\n  return getDefaultWorkspacePath(config);\n}\n"],"mappings":";;kBAUkE;;;;;AAOlE,SAAgB,iBAAiB,QAAwB;AACvD,QAAO,wBAAwB,OAAO"}
+{"version":3,"file":"workspace-path-helpers.js","names":[],"sources":["../../../src/config/workspace-path-helpers.ts"],"sourcesContent":["/**\n * Workspace-path domain helpers that need both `Config` (from `./schema.js`)\n * and agent-scope helpers (from `../agent/agent-scope.js`).\n *\n * Lives in this file rather than `./schema.js` because schema.ts is the leaf\n * type module — letting it import agent-scope creates a circular cycle\n * (`schema → agent-scope → schema`). Callers import via the `./index.js` barrel.\n */\n\nimport { getDefaultWorkspacePath } from '../agent/agent-scope.js';\nimport type { Config } from './schema.js';\n\n/**\n * Default agent's resolved Markdown workspace root\n * (`resolveAgentWorkspaceDir` for the default agent id).\n */\nexport function getWorkspacePath(config: Config): string {\n  return getDefaultWorkspacePath(config);\n}\n"],"mappings":";;kBASkE;;;;;AAOlE,SAAgB,iBAAiB,QAAwB;AACvD,QAAO,wBAAwB,OAAO"}

package/dist/src/config/workspace-path.js

@@ -1,6 +1,6 @@
 import { __esmMin } from "../../_virtual/_rolldown/runtime.js";
-import { homedir } from "node:os";
 import { parse, resolve } from "node:path";
+import { homedir } from "node:os";
 //#region src/config/workspace-path.ts
 /** Expand leading `~` to the user home directory. */
 function expandWorkspacePathString(raw) {

package/dist/src/cron/executor.js

@@ -1,7 +1,7 @@
-import { init_agent_scope, normalizeAgentId } from "../agent/agent-scope.js";
-import { buildSessionKey, init_session_key } from "../routing/session-key.js";
 import { createLogger } from "../utils/logger/index.js";
 import { init_logger } from "../utils/logger.js";
+import { init_agent_scope, normalizeAgentId } from "../agent/agent-scope.js";
+import { buildSessionKey, init_session_key } from "../routing/session-key.js";
 import { bundledChannelPlugins } from "../generated/bundled-channel-plugins.js";
 import { shouldSilence, stripHeartbeatToken } from "../heartbeat/tokens.js";
 import { getChannelPlugin, listChannelPlugins, syncChannelPluginsFromManager } from "../channels/plugins/registry.js";

package/dist/src/cron/persistence.js

@@ -1,6 +1,6 @@
+import { init_write_file_atomic, writeTextAtomic } from "../infra/write-file-atomic.js";
 import { createLogger } from "../utils/logger/index.js";
 import { init_logger } from "../utils/logger.js";
-import { init_write_file_atomic, writeTextAtomic } from "../infra/write-file-atomic.js";
 import { JobDataSchema } from "./validation.js";
 import { access, readFile } from "fs/promises";
 //#region src/cron/persistence.ts

package/dist/src/cron/run-log-store.js

@@ -1,8 +1,8 @@
 import { createLogger } from "../utils/logger/index.js";
 import { init_logger } from "../utils/logger.js";
 import { init_paths, resolveCronRunsDir } from "../config/paths.js";
-import { join } from "path";
 import { appendFile, mkdir, readFile, readdir, unlink, writeFile } from "fs/promises";
+import { join } from "path";
 //#region src/cron/run-log-store.ts
 init_paths();
 init_logger();

package/dist/src/daemon/constants.js

@@ -1,5 +1,5 @@
-import os from "node:os";
 import path from "node:path";
+import os from "node:os";
 //#region src/daemon/constants.ts
 /**
 * Daemon Constants - Service labels, paths, and configuration values

package/dist/src/daemon/install-plan.js

@@ -2,9 +2,9 @@ import { PACKAGE_VERSION, init_package_version } from "../package-version.js";
 import { createLogger } from "../utils/logger/index.js";
 import { init_logger } from "../utils/logger.js";
 import { SERVICE_VERSION_ENV_KEY, formatGatewayServiceDescription } from "./constants.js";
-import { homedir } from "node:os";
-import path from "node:path";
 import { existsSync } from "node:fs";
+import path from "node:path";
+import { homedir } from "node:os";
 //#region src/daemon/install-plan.ts
 /**
 * Install Plan Builder - Build gateway installation configuration
@@ -34,8 +34,32 @@ function isSEABinary() {
 function resolveEntryPoint() {
 	if (isSEABinary()) return process.execPath;
 	const thisDir = path.dirname(new URL(import.meta.url).pathname);
+	const sourceEntryPoint = path.join(thisDir, "..", "cli", "bin.ts");
+	if (existsSync(sourceEntryPoint)) return sourceEntryPoint;
 	return path.join(thisDir, "..", "cli", "bin.js");
 }
+function resolveServiceNodeArgs() {
+	const serviceNodeArgs = [];
+	const skipValueFlags = new Set([
+		"-e",
+		"--eval",
+		"-p",
+		"--print",
+		"--test-name-pattern"
+	]);
+	for (let index = 0; index < process.execArgv.length; index += 1) {
+		const arg = process.execArgv[index];
+		if (!arg) continue;
+		if (arg.startsWith("--inspect") || arg.startsWith("--debug")) continue;
+		if (skipValueFlags.has(arg)) {
+			index += 1;
+			continue;
+		}
+		if ([...skipValueFlags].some((flag) => arg.startsWith(`${flag}=`))) continue;
+		serviceNodeArgs.push(arg);
+	}
+	return serviceNodeArgs;
+}
 function buildGatewayInstallPlan(params) {
 	const configPath = resolveDefaultConfigPath();
 	const workspace = resolveDefaultWorkspace();
@@ -49,7 +73,7 @@ function buildGatewayInstallPlan(params) {
 		params.port.toString()
 	];
 	else {
-		const nodeArgs = process.execArgv.filter((arg) => !arg.startsWith("--inspect") && !arg.startsWith("--debug"));
+		const nodeArgs = resolveServiceNodeArgs();
 		const entryPoint = resolveEntryPoint();
 		programArguments = [
 			process.execPath,

package/dist/src/daemon/install-plan.js.map

@@ -1 +1 @@
-{"version":3,"file":"install-plan.js","names":[],"sources":["../../../src/daemon/install-plan.ts"],"sourcesContent":["/**\n * Install Plan Builder - Build gateway installation configuration\n *\n * Aligned with OpenClaw: adds XOPC_SERVICE_VERSION, StandardOut/ErrorPath,\n * supports binary runtime detection, and --foreground arg passing.\n */\n\nimport { existsSync } from 'node:fs';\nimport path from 'node:path';\nimport { homedir } from 'node:os';\nimport { createLogger } from '../utils/logger.js';\nimport { SERVICE_VERSION_ENV_KEY, formatGatewayServiceDescription } from './constants.js';\nimport { PACKAGE_VERSION } from '../package-version.js';\nimport type { GatewayServiceInstallArgs, GatewayServiceEnv } from './types.js';\n\nconst log = createLogger('InstallPlan');\n\nexport interface InstallPlan {\n  programArguments: string[];\n  workingDirectory: string;\n  environment: Record<string, string>;\n  description: string;\n}\n\n// ─── Path Resolution ───\n\nfunction resolveDefaultConfigPath(): string {\n  const envConfig = process.env.XOPC_CONFIG || process.env.XOPC_CONFIG_PATH;\n  if (envConfig) return envConfig;\n  return path.join(homedir(), '.xopc', 'xopc.json');\n}\n\nfunction resolveDefaultWorkspace(): string {\n  const envWorkspace = process.env.XOPC_WORKSPACE;\n  if (envWorkspace) return envWorkspace;\n  return path.join(homedir(), '.xopc', 'workspace');\n}\n\nfunction resolveLogDir(): string {\n  return path.join(homedir(), '.xopc', 'logs');\n}\n\n// ─── Binary Detection ───\n\nfunction isSEABinary(): boolean {\n  // Node.js SEA (Single Executable Application) detection\n  return !!(process as NodeJS.Process & { pkg?: unknown }).pkg ||\n    process.execPath.endsWith('xopc') ||\n    process.execPath.endsWith('xopc.exe');\n}\n\nfunction resolveEntryPoint(): string {\n  if (isSEABinary()) {\n    return process.execPath;\n  }\n  // Must match package.json \"bin\" (cli/bin.js). index.js only exports runCli and exits\n  // immediately when executed directly — systemd/LaunchAgent need the real entry.\n  const thisDir = path.dirname(new URL(import.meta.url).pathname);\n  return path.join(thisDir, '..', 'cli', 'bin.js');\n}\n\n// ─── Plan Builder ───\n\nexport function buildGatewayInstallPlan(params: {\n  port: number;\n  bind?: import('../config/schema.js').GatewayBindMode;\n  token?: string;\n  env?: GatewayServiceEnv;\n  runtime?: 'node' | 'binary';\n  version?: string;\n}): InstallPlan {\n  const configPath = resolveDefaultConfigPath();\n  const workspace = resolveDefaultWorkspace();\n  const version = params.version || PACKAGE_VERSION;\n\n  // Determine program + arguments\n  let programArguments: string[];\n\n  if (params.runtime === 'binary' || isSEABinary()) {\n    // SEA binary: direct execution\n    const binaryPath = process.execPath;\n    programArguments = [binaryPath, 'gateway', '--foreground', '--port', params.port.toString()];\n  } else {\n    // Node.js runtime\n    const nodeArgs = process.execArgv.filter(\n      (arg) => !arg.startsWith('--inspect') && !arg.startsWith('--debug'),\n    );\n    const entryPoint = resolveEntryPoint();\n    programArguments = [\n      process.execPath,\n      ...nodeArgs,\n      entryPoint,\n      'gateway',\n      '--foreground',\n      '--port', params.port.toString(),\n    ];\n  }\n\n  if (params.bind && params.bind !== 'loopback') {\n    programArguments.push('--bind', params.bind);\n  }\n\n  // Build environment\n  const environment: Record<string, string> = {\n    XOPC_CONFIG: configPath,\n    XOPC_WORKSPACE: workspace,\n    XOPC_LOG_LEVEL: process.env.XOPC_LOG_LEVEL || 'info',\n    XOPC_LOG_FILE: 'true',\n    XOPC_LOG_CONSOLE: 'false',\n    XOPC_LOG_DIR: resolveLogDir(),\n    [SERVICE_VERSION_ENV_KEY]: version,\n    XOPC_SERVICE_MARKER: '1',\n  };\n\n  if (params.token) {\n    environment.XOPC_GATEWAY_TOKEN = params.token;\n  }\n\n  // Copy relevant API key env vars\n  const relevantEnvVars = [\n    'OPENAI_API_KEY',\n    'ANTHROPIC_API_KEY',\n    'GOOGLE_API_KEY',\n    'BRAVE_API_KEY',\n    'DASHSCOPE_API_KEY',\n    'XOPC_LOG_RETENTION_DAYS',\n  ];\n\n  for (const key of relevantEnvVars) {\n    if (process.env[key]) {\n      environment[key] = process.env[key]!;\n    }\n  }\n\n  // Add custom env from params (non-XOPC keys only; XOPC keys already handled)\n  if (params.env) {\n    for (const [key, value] of Object.entries(params.env)) {\n      if (value !== undefined && !key.startsWith('XOPC_')) {\n        environment[key] = value;\n      }\n    }\n  }\n\n  // Service description\n  const profile = params.env?.XOPC_PROFILE?.trim() || undefined;\n  const description = formatGatewayServiceDescription({ profile, version });\n\n  log.info({\n    programArguments: programArguments.slice(0, 3),\n    envKeys: Object.keys(environment),\n    version,\n  }, 'Built gateway install plan');\n\n  return {\n    programArguments,\n    workingDirectory: path.dirname(configPath),\n    environment,\n    description,\n  };\n}\n\n// ─── Install Args Builder ───\n\nexport function buildGatewayInstallArgs(params: {\n  port: number;\n  bind?: import('../config/schema.js').GatewayBindMode;\n  token?: string;\n  env?: GatewayServiceEnv;\n  runtime?: 'node' | 'binary';\n  version?: string;\n}): GatewayServiceInstallArgs {\n  const plan = buildGatewayInstallPlan(params);\n\n  return {\n    env: params.env || process.env,\n    programArguments: plan.programArguments,\n    workingDirectory: plan.workingDirectory,\n    environment: plan.environment,\n    description: plan.description,\n  };\n}\n\n// ─── Validation ───\n\n/** Check if the program in an install plan still exists on disk */\nexport function validateInstallPlanProgram(programArguments: string[]): boolean {\n  if (programArguments.length === 0) return false;\n  const program = programArguments[0];\n  return existsSync(program);\n}\n"],"mappings":";;;;;;;;;;;;;;aAUkD;sBAEM;AAGxD,MAAM,MAAM,aAAa,cAAc;AAWvC,SAAS,2BAAmC;CAC1C,MAAM,YAAY,QAAQ,IAAI,eAAe,QAAQ,IAAI;AACzD,KAAI,UAAW,QAAO;AACtB,QAAO,KAAK,KAAK,SAAS,EAAE,SAAS,YAAY;;AAGnD,SAAS,0BAAkC;CACzC,MAAM,eAAe,QAAQ,IAAI;AACjC,KAAI,aAAc,QAAO;AACzB,QAAO,KAAK,KAAK,SAAS,EAAE,SAAS,YAAY;;AAGnD,SAAS,gBAAwB;AAC/B,QAAO,KAAK,KAAK,SAAS,EAAE,SAAS,OAAO;;AAK9C,SAAS,cAAuB;AAE9B,QAAO,CAAC,CAAE,QAA+C,OACvD,QAAQ,SAAS,SAAS,OAAO,IACjC,QAAQ,SAAS,SAAS,WAAW;;AAGzC,SAAS,oBAA4B;AACnC,KAAI,aAAa,CACf,QAAO,QAAQ;CAIjB,MAAM,UAAU,KAAK,QAAQ,IAAI,IAAI,OAAO,KAAK,IAAI,CAAC,SAAS;AAC/D,QAAO,KAAK,KAAK,SAAS,MAAM,OAAO,SAAS;;AAKlD,SAAgB,wBAAwB,QAOxB;CACd,MAAM,aAAa,0BAA0B;CAC7C,MAAM,YAAY,yBAAyB;CAC3C,MAAM,UAAU,OAAO,WAAW;CAGlC,IAAI;AAEJ,KAAI,OAAO,YAAY,YAAY,aAAa,CAG9C,oBAAmB;EADA,QAAQ;EACK;EAAW;EAAgB;EAAU,OAAO,KAAK,UAAU;EAAC;MACvF;EAEL,MAAM,WAAW,QAAQ,SAAS,QAC/B,QAAQ,CAAC,IAAI,WAAW,YAAY,IAAI,CAAC,IAAI,WAAW,UAAU,CACpE;EACD,MAAM,aAAa,mBAAmB;AACtC,qBAAmB;GACjB,QAAQ;GACR,GAAG;GACH;GACA;GACA;GACA;GAAU,OAAO,KAAK,UAAU;GACjC;;AAGH,KAAI,OAAO,QAAQ,OAAO,SAAS,WACjC,kBAAiB,KAAK,UAAU,OAAO,KAAK;CAI9C,MAAM,cAAsC;EAC1C,aAAa;EACb,gBAAgB;EAChB,gBAAgB,QAAQ,IAAI,kBAAkB;EAC9C,eAAe;EACf,kBAAkB;EAClB,cAAc,eAAe;GAC5B,0BAA0B;EAC3B,qBAAqB;EACtB;AAED,KAAI,OAAO,MACT,aAAY,qBAAqB,OAAO;AAa1C,MAAK,MAAM,OAAO;EARhB;EACA;EACA;EACA;EACA;EACA;EAG+B,CAC/B,KAAI,QAAQ,IAAI,KACd,aAAY,OAAO,QAAQ,IAAI;AAKnC,KAAI,OAAO;OACJ,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,OAAO,IAAI,CACnD,KAAI,UAAU,KAAA,KAAa,CAAC,IAAI,WAAW,QAAQ,CACjD,aAAY,OAAO;;CAOzB,MAAM,cAAc,gCAAgC;EAAE,SADtC,OAAO,KAAK,cAAc,MAAM,IAAI,KAAA;EACW;EAAS,CAAC;AAEzE,KAAI,KAAK;EACP,kBAAkB,iBAAiB,MAAM,GAAG,EAAE;EAC9C,SAAS,OAAO,KAAK,YAAY;EACjC;EACD,EAAE,6BAA6B;AAEhC,QAAO;EACL;EACA,kBAAkB,KAAK,QAAQ,WAAW;EAC1C;EACA;EACD;;AAKH,SAAgB,wBAAwB,QAOV;CAC5B,MAAM,OAAO,wBAAwB,OAAO;AAE5C,QAAO;EACL,KAAK,OAAO,OAAO,QAAQ;EAC3B,kBAAkB,KAAK;EACvB,kBAAkB,KAAK;EACvB,aAAa,KAAK;EAClB,aAAa,KAAK;EACnB;;;AAMH,SAAgB,2BAA2B,kBAAqC;AAC9E,KAAI,iBAAiB,WAAW,EAAG,QAAO;CAC1C,MAAM,UAAU,iBAAiB;AACjC,QAAO,WAAW,QAAQ"}
+{"version":3,"file":"install-plan.js","names":[],"sources":["../../../src/daemon/install-plan.ts"],"sourcesContent":["/**\n * Install Plan Builder - Build gateway installation configuration\n *\n * Aligned with OpenClaw: adds XOPC_SERVICE_VERSION, StandardOut/ErrorPath,\n * supports binary runtime detection, and --foreground arg passing.\n */\n\nimport { existsSync } from 'node:fs';\nimport path from 'node:path';\nimport { homedir } from 'node:os';\nimport { createLogger } from '../utils/logger.js';\nimport { SERVICE_VERSION_ENV_KEY, formatGatewayServiceDescription } from './constants.js';\nimport { PACKAGE_VERSION } from '../package-version.js';\nimport type { GatewayServiceInstallArgs, GatewayServiceEnv } from './types.js';\n\nconst log = createLogger('InstallPlan');\n\nexport interface InstallPlan {\n  programArguments: string[];\n  workingDirectory: string;\n  environment: Record<string, string>;\n  description: string;\n}\n\n// ─── Path Resolution ───\n\nfunction resolveDefaultConfigPath(): string {\n  const envConfig = process.env.XOPC_CONFIG || process.env.XOPC_CONFIG_PATH;\n  if (envConfig) return envConfig;\n  return path.join(homedir(), '.xopc', 'xopc.json');\n}\n\nfunction resolveDefaultWorkspace(): string {\n  const envWorkspace = process.env.XOPC_WORKSPACE;\n  if (envWorkspace) return envWorkspace;\n  return path.join(homedir(), '.xopc', 'workspace');\n}\n\nfunction resolveLogDir(): string {\n  return path.join(homedir(), '.xopc', 'logs');\n}\n\n// ─── Binary Detection ───\n\nfunction isSEABinary(): boolean {\n  // Node.js SEA (Single Executable Application) detection\n  return !!(process as NodeJS.Process & { pkg?: unknown }).pkg ||\n    process.execPath.endsWith('xopc') ||\n    process.execPath.endsWith('xopc.exe');\n}\n\nfunction resolveEntryPoint(): string {\n  if (isSEABinary()) {\n    return process.execPath;\n  }\n  // Must match package.json \"bin\" in built packages, while source/dev runs use bin.ts.\n  // index.js only exports runCli and exits immediately when executed directly.\n  const thisDir = path.dirname(new URL(import.meta.url).pathname);\n  const sourceEntryPoint = path.join(thisDir, '..', 'cli', 'bin.ts');\n  if (existsSync(sourceEntryPoint)) {\n    return sourceEntryPoint;\n  }\n  return path.join(thisDir, '..', 'cli', 'bin.js');\n}\n\nfunction resolveServiceNodeArgs(): string[] {\n  const serviceNodeArgs: string[] = [];\n  const skipValueFlags = new Set(['-e', '--eval', '-p', '--print', '--test-name-pattern']);\n\n  for (let index = 0; index < process.execArgv.length; index += 1) {\n    const arg = process.execArgv[index];\n    if (!arg) continue;\n    if (arg.startsWith('--inspect') || arg.startsWith('--debug')) continue;\n    if (skipValueFlags.has(arg)) {\n      index += 1;\n      continue;\n    }\n    if ([...skipValueFlags].some((flag) => arg.startsWith(`${flag}=`))) continue;\n    serviceNodeArgs.push(arg);\n  }\n\n  return serviceNodeArgs;\n}\n\n// ─── Plan Builder ───\n\nexport function buildGatewayInstallPlan(params: {\n  port: number;\n  bind?: import('../config/schema.js').GatewayBindMode;\n  token?: string;\n  env?: GatewayServiceEnv;\n  runtime?: 'node' | 'binary';\n  version?: string;\n}): InstallPlan {\n  const configPath = resolveDefaultConfigPath();\n  const workspace = resolveDefaultWorkspace();\n  const version = params.version || PACKAGE_VERSION;\n\n  // Determine program + arguments\n  let programArguments: string[];\n\n  if (params.runtime === 'binary' || isSEABinary()) {\n    // SEA binary: direct execution\n    const binaryPath = process.execPath;\n    programArguments = [binaryPath, 'gateway', '--foreground', '--port', params.port.toString()];\n  } else {\n    // Node.js runtime\n    const nodeArgs = resolveServiceNodeArgs();\n    const entryPoint = resolveEntryPoint();\n    programArguments = [\n      process.execPath,\n      ...nodeArgs,\n      entryPoint,\n      'gateway',\n      '--foreground',\n      '--port', params.port.toString(),\n    ];\n  }\n\n  if (params.bind && params.bind !== 'loopback') {\n    programArguments.push('--bind', params.bind);\n  }\n\n  // Build environment\n  const environment: Record<string, string> = {\n    XOPC_CONFIG: configPath,\n    XOPC_WORKSPACE: workspace,\n    XOPC_LOG_LEVEL: process.env.XOPC_LOG_LEVEL || 'info',\n    XOPC_LOG_FILE: 'true',\n    XOPC_LOG_CONSOLE: 'false',\n    XOPC_LOG_DIR: resolveLogDir(),\n    [SERVICE_VERSION_ENV_KEY]: version,\n    XOPC_SERVICE_MARKER: '1',\n  };\n\n  if (params.token) {\n    environment.XOPC_GATEWAY_TOKEN = params.token;\n  }\n\n  // Copy relevant API key env vars\n  const relevantEnvVars = [\n    'OPENAI_API_KEY',\n    'ANTHROPIC_API_KEY',\n    'GOOGLE_API_KEY',\n    'BRAVE_API_KEY',\n    'DASHSCOPE_API_KEY',\n    'XOPC_LOG_RETENTION_DAYS',\n  ];\n\n  for (const key of relevantEnvVars) {\n    if (process.env[key]) {\n      environment[key] = process.env[key]!;\n    }\n  }\n\n  // Add custom env from params (non-XOPC keys only; XOPC keys already handled)\n  if (params.env) {\n    for (const [key, value] of Object.entries(params.env)) {\n      if (value !== undefined && !key.startsWith('XOPC_')) {\n        environment[key] = value;\n      }\n    }\n  }\n\n  // Service description\n  const profile = params.env?.XOPC_PROFILE?.trim() || undefined;\n  const description = formatGatewayServiceDescription({ profile, version });\n\n  log.info({\n    programArguments: programArguments.slice(0, 3),\n    envKeys: Object.keys(environment),\n    version,\n  }, 'Built gateway install plan');\n\n  return {\n    programArguments,\n    workingDirectory: path.dirname(configPath),\n    environment,\n    description,\n  };\n}\n\n// ─── Install Args Builder ───\n\nexport function buildGatewayInstallArgs(params: {\n  port: number;\n  bind?: import('../config/schema.js').GatewayBindMode;\n  token?: string;\n  env?: GatewayServiceEnv;\n  runtime?: 'node' | 'binary';\n  version?: string;\n}): GatewayServiceInstallArgs {\n  const plan = buildGatewayInstallPlan(params);\n\n  return {\n    env: params.env || process.env,\n    programArguments: plan.programArguments,\n    workingDirectory: plan.workingDirectory,\n    environment: plan.environment,\n    description: plan.description,\n  };\n}\n\n// ─── Validation ───\n\n/** Check if the program in an install plan still exists on disk */\nexport function validateInstallPlanProgram(programArguments: string[]): boolean {\n  if (programArguments.length === 0) return false;\n  const program = programArguments[0];\n  return existsSync(program);\n}\n"],"mappings":"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"}

package/dist/src/daemon/launchd.d.ts

@@ -10,5 +10,13 @@
  */
 import type { GatewayService, GatewayServiceEnv } from './types.js';
 export declare function resolveLaunchAgentPlistPath(env?: GatewayServiceEnv): string;
+export declare function buildLaunchAgentPlist(params: {
+    label: string;
+    programArguments: string[];
+    workingDirectory?: string;
+    environment: Record<string, string>;
+    stdoutPath?: string;
+    stderrPath?: string;
+}): string;
 export declare function isLaunchdAvailable(): boolean;
 export declare const launchdService: GatewayService;

package/dist/src/daemon/launchd.js

@@ -1,10 +1,10 @@
 import { createLogger } from "../utils/logger/index.js";
 import { init_logger } from "../utils/logger.js";
 import { resolveGatewayLaunchAgentLabel, resolveLaunchAgentPlistPath as resolveLaunchAgentPlistPath$1 } from "./constants.js";
-import os from "node:os";
-import path from "node:path";
 import { existsSync } from "node:fs";
 import { mkdir, readFile, rm, writeFile } from "node:fs/promises";
+import path from "node:path";
+import os from "node:os";
 import { spawn, spawnSync } from "node:child_process";
 //#region src/daemon/launchd.ts
 /**
@@ -71,10 +71,7 @@ ${envDict}
 	plist += `    <key>RunAtLoad</key>
     <true/>
     <key>KeepAlive</key>
-    <dict>
-        <key>SuccessfulExit</key>
-        <false/>
-    </dict>
+    <true/>
     <key>ThrottleInterval</key>
     <integer>10</integer>
     <key>ExitTimeOut</key>
@@ -220,15 +217,11 @@ const launchdService = {
 			log.info("LaunchAgent stopped and disabled (plist removed)");
 		} else {
 			try {
-				await launchctlExec([
-					"kill",
-					"SIGTERM",
-					serviceTarget
-				]);
+				await launchctlExec(["bootout", serviceTarget]);
 			} catch {
-				log.debug("LaunchAgent kill SIGTERM failed (may not be running)");
+				log.debug("LaunchAgent bootout failed (may not be loaded)");
 			}
-			log.info("LaunchAgent stop signal sent");
+			log.info("LaunchAgent stopped and unloaded");
 		}
 	},
 	async restart(args) {
@@ -300,6 +293,6 @@ const launchdService = {
 	}
 };
 //#endregion
-export { isLaunchdAvailable, launchdService, resolveLaunchAgentPlistPath };
+export { buildLaunchAgentPlist, isLaunchdAvailable, launchdService, resolveLaunchAgentPlistPath };
 
 //# sourceMappingURL=launchd.js.map