@nextclaw/service 0.2.12 → 0.2.14

package/dist/utils/service-port-probe.utils.js

@@ -0,0 +1,166 @@
+import { resolveUiApiBase, resolveUiConfig } from "./cli.utils.js";
+import { managedServiceStateStore } from "../stores/managed-service-state.store.js";
+import { APP_NAME, loadConfig } from "@nextclaw/core";
+import { createServer } from "node:net";
+import { request } from "node:http";
+import { request as request$1 } from "node:https";
+//#region src/utils/service-port-probe.utils.ts
+function getHeaderValue(headers, key) {
+	const value = headers[key];
+	if (typeof value === "string") {
+		const normalized = value.trim();
+		return normalized.length > 0 ? normalized : null;
+	}
+	if (Array.isArray(value)) {
+		const joined = value.map((item) => item.trim()).filter(Boolean).join(", ");
+		return joined.length > 0 ? joined : null;
+	}
+	return null;
+}
+function formatProbeBodySnippet(raw, maxLength = 180) {
+	const normalized = raw.replace(/\s+/g, " ").trim();
+	if (!normalized) return null;
+	const clipped = normalized.length > maxLength ? `${normalized.slice(0, maxLength)}...` : normalized;
+	return JSON.stringify(clipped);
+}
+async function checkPortAvailability(params) {
+	return await new Promise((resolve) => {
+		const server = createServer();
+		server.once("error", (error) => {
+			resolve({
+				available: false,
+				detail: `bind failed on ${params.host}:${params.port} (${String(error)})`
+			});
+		});
+		server.listen(params.port, params.host, () => {
+			server.close(() => {
+				resolve({
+					available: true,
+					detail: `bind ok on ${params.host}:${params.port}`
+				});
+			});
+		});
+	});
+}
+async function probeHealthEndpoint(healthUrl) {
+	let parsed;
+	try {
+		parsed = new URL(healthUrl);
+	} catch {
+		return {
+			healthy: false,
+			error: "invalid health URL"
+		};
+	}
+	const requestImpl = parsed.protocol === "https:" ? request$1 : request;
+	return await new Promise((resolve) => {
+		const req = requestImpl({
+			protocol: parsed.protocol,
+			hostname: parsed.hostname,
+			port: parsed.port ? Number(parsed.port) : parsed.protocol === "https:" ? 443 : 80,
+			method: "GET",
+			path: `${parsed.pathname}${parsed.search}`,
+			timeout: 1e3,
+			headers: { Accept: "application/json" }
+		}, (res) => {
+			const chunks = [];
+			res.on("data", (chunk) => {
+				if (typeof chunk === "string") {
+					chunks.push(Buffer.from(chunk));
+					return;
+				}
+				chunks.push(chunk);
+			});
+			res.on("end", () => {
+				const responseText = Buffer.concat(chunks).toString("utf-8");
+				if ((res.statusCode ?? 0) < 200 || (res.statusCode ?? 0) >= 300) {
+					const serverHeader = getHeaderValue(res.headers, "server");
+					const contentType = getHeaderValue(res.headers, "content-type");
+					const bodySnippet = formatProbeBodySnippet(responseText);
+					const details = [`http ${res.statusCode ?? "unknown"}`];
+					if (serverHeader) details.push(`server=${serverHeader}`);
+					if (contentType) details.push(`content-type=${contentType}`);
+					if (bodySnippet) details.push(`body=${bodySnippet}`);
+					resolve({
+						healthy: false,
+						error: details.join("; ")
+					});
+					return;
+				}
+				try {
+					const payload = JSON.parse(responseText);
+					if (!(payload?.ok === true && payload?.data?.status === "ok")) {
+						resolve({
+							healthy: false,
+							error: "health payload not ok"
+						});
+						return;
+					}
+					resolve({
+						healthy: true,
+						error: null
+					});
+				} catch {
+					resolve({
+						healthy: false,
+						error: "invalid health JSON response"
+					});
+				}
+			});
+		});
+		req.on("timeout", () => {
+			req.destroy(/* @__PURE__ */ new Error("probe timeout"));
+		});
+		req.on("error", (error) => {
+			resolve({
+				healthy: false,
+				error: error.message || String(error)
+			});
+		});
+		req.end();
+	});
+}
+async function inspectUiTarget(params) {
+	const { checkPortAvailabilityFn, healthUrl, host, port, probeHealthEndpointFn } = params;
+	const availability = await (checkPortAvailabilityFn ?? checkPortAvailability)({
+		host,
+		port
+	});
+	if (availability.available) return {
+		state: "available",
+		availabilityDetail: availability.detail,
+		probeError: null
+	};
+	const probe = await (probeHealthEndpointFn ?? probeHealthEndpoint)(healthUrl);
+	if (probe.healthy) return {
+		state: "healthy-existing",
+		availabilityDetail: availability.detail,
+		probeError: null
+	};
+	return {
+		state: "occupied-unhealthy",
+		availabilityDetail: availability.detail,
+		probeError: probe.error
+	};
+}
+async function describeUnmanagedHealthyTargetMessage(params) {
+	const uiConfig = resolveUiConfig(loadConfig(), params.uiOverrides);
+	const healthUrl = `${resolveUiApiBase(uiConfig.host, uiConfig.port)}/api/health`;
+	if ((await inspectUiTarget({
+		host: uiConfig.host,
+		port: uiConfig.port,
+		healthUrl,
+		checkPortAvailabilityFn: params.checkPortAvailabilityFn,
+		probeHealthEndpointFn: params.probeHealthEndpointFn
+	})).state !== "healthy-existing") return null;
+	return [
+		`Target UI health: ${healthUrl}`,
+		`A healthy ${APP_NAME} service is already responding on this port, but it is not tracked by ${managedServiceStateStore.path}.`,
+		`${APP_NAME} restart only stops the background service recorded in managed state; it will not auto-kill Docker or other external listeners.`,
+		`Fix: stop that external service first or rerun with --ui-port <port>.`
+	].join("\n");
+}
+//#endregion
+export { checkPortAvailability, describeUnmanagedHealthyTargetMessage, inspectUiTarget, probeHealthEndpoint };
+
+//# sourceMappingURL=service-port-probe.utils.js.map

package/dist/utils/service-port-probe.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"service-port-probe.utils.js","names":["createNetServer","httpsRequest","httpRequest"],"sources":["../../src/utils/service-port-probe.utils.ts"],"sourcesContent":["import { APP_NAME, loadConfig, type Config } from \"@nextclaw/core\";\nimport { request as httpRequest } from \"node:http\";\nimport { request as httpsRequest } from \"node:https\";\nimport { createServer as createNetServer } from \"node:net\";\nimport { resolveUiApiBase, resolveUiConfig } from \"@nextclaw-service/utils/cli.utils.js\";\nimport { managedServiceStateStore } from \"@nextclaw-service/stores/managed-service-state.store.js\";\n\nfunction getHeaderValue(headers: Record<string, string | string[] | undefined>, key: string): string | null {\n  const value = headers[key];\n  if (typeof value === \"string\") {\n    const normalized = value.trim();\n    return normalized.length > 0 ? normalized : null;\n  }\n  if (Array.isArray(value)) {\n    const joined = value.map((item) => item.trim()).filter(Boolean).join(\", \");\n    return joined.length > 0 ? joined : null;\n  }\n  return null;\n}\n\nfunction formatProbeBodySnippet(raw: string, maxLength = 180): string | null {\n  const normalized = raw.replace(/\\s+/g, \" \").trim();\n  if (!normalized) {\n    return null;\n  }\n  const clipped = normalized.length > maxLength ? `${normalized.slice(0, maxLength)}...` : normalized;\n  return JSON.stringify(clipped);\n}\n\nexport async function checkPortAvailability(params: {\n  host: string;\n  port: number;\n}): Promise<{ available: boolean; detail: string }> {\n  return await new Promise((resolve) => {\n    const server = createNetServer();\n    server.once(\"error\", (error) => {\n      resolve({\n        available: false,\n        detail: `bind failed on ${params.host}:${params.port} (${String(error)})`\n      });\n    });\n    server.listen(params.port, params.host, () => {\n      server.close(() => {\n        resolve({\n          available: true,\n          detail: `bind ok on ${params.host}:${params.port}`\n        });\n      });\n    });\n  });\n}\n\nexport async function probeHealthEndpoint(healthUrl: string): Promise<{ healthy: boolean; error: string | null }> {\n  let parsed: URL;\n  try {\n    parsed = new URL(healthUrl);\n  } catch {\n    return { healthy: false, error: \"invalid health URL\" };\n  }\n\n  const requestImpl = parsed.protocol === \"https:\" ? httpsRequest : httpRequest;\n  return await new Promise((resolve) => {\n    const req = requestImpl(\n      {\n        protocol: parsed.protocol,\n        hostname: parsed.hostname,\n        port: parsed.port ? Number(parsed.port) : parsed.protocol === \"https:\" ? 443 : 80,\n        method: \"GET\",\n        path: `${parsed.pathname}${parsed.search}`,\n        timeout: 1000,\n        headers: { Accept: \"application/json\" }\n      },\n      (res) => {\n        const chunks: Buffer[] = [];\n        res.on(\"data\", (chunk) => {\n          if (typeof chunk === \"string\") {\n            chunks.push(Buffer.from(chunk));\n            return;\n          }\n          chunks.push(chunk);\n        });\n        res.on(\"end\", () => {\n          const responseText = Buffer.concat(chunks).toString(\"utf-8\");\n          if ((res.statusCode ?? 0) < 200 || (res.statusCode ?? 0) >= 300) {\n            const serverHeader = getHeaderValue(res.headers, \"server\");\n            const contentType = getHeaderValue(res.headers, \"content-type\");\n            const bodySnippet = formatProbeBodySnippet(responseText);\n            const details = [`http ${res.statusCode ?? \"unknown\"}`];\n            if (serverHeader) {\n              details.push(`server=${serverHeader}`);\n            }\n            if (contentType) {\n              details.push(`content-type=${contentType}`);\n            }\n            if (bodySnippet) {\n              details.push(`body=${bodySnippet}`);\n            }\n            resolve({ healthy: false, error: details.join(\"; \") });\n            return;\n          }\n\n          try {\n            const payload = JSON.parse(responseText) as {\n              ok?: boolean;\n              data?: { status?: string };\n            };\n            const healthy = payload?.ok === true && payload?.data?.status === \"ok\";\n            if (!healthy) {\n              resolve({ healthy: false, error: \"health payload not ok\" });\n              return;\n            }\n            resolve({ healthy: true, error: null });\n          } catch {\n            resolve({ healthy: false, error: \"invalid health JSON response\" });\n          }\n        });\n      }\n    );\n\n    req.on(\"timeout\", () => {\n      req.destroy(new Error(\"probe timeout\"));\n    });\n    req.on(\"error\", (error) => {\n      resolve({ healthy: false, error: error.message || String(error) });\n    });\n    req.end();\n  });\n}\n\nexport type UiTargetProbeResult =\n  | {\n      state: \"available\";\n      availabilityDetail: string;\n      probeError: null;\n    }\n  | {\n      state: \"healthy-existing\";\n      availabilityDetail: string;\n      probeError: null;\n    }\n  | {\n      state: \"occupied-unhealthy\";\n      availabilityDetail: string;\n      probeError: string | null;\n    };\n\nexport async function inspectUiTarget(params: {\n  host: string;\n  port: number;\n  healthUrl: string;\n  checkPortAvailabilityFn?: typeof checkPortAvailability;\n  probeHealthEndpointFn?: typeof probeHealthEndpoint;\n}): Promise<UiTargetProbeResult> {\n  const { checkPortAvailabilityFn, healthUrl, host, port, probeHealthEndpointFn } = params;\n  const availability = await (checkPortAvailabilityFn ?? checkPortAvailability)({\n    host,\n    port\n  });\n  if (availability.available) {\n    return {\n      state: \"available\",\n      availabilityDetail: availability.detail,\n      probeError: null\n    };\n  }\n\n  const probe = await (probeHealthEndpointFn ?? probeHealthEndpoint)(healthUrl);\n  if (probe.healthy) {\n    return {\n      state: \"healthy-existing\",\n      availabilityDetail: availability.detail,\n      probeError: null\n    };\n  }\n\n  return {\n    state: \"occupied-unhealthy\",\n    availabilityDetail: availability.detail,\n    probeError: probe.error\n  };\n}\n\nexport async function describeUnmanagedHealthyTargetMessage(params: {\n  uiOverrides: Partial<Config[\"ui\"]>;\n  checkPortAvailabilityFn?: typeof checkPortAvailability;\n  probeHealthEndpointFn?: typeof probeHealthEndpoint;\n}): Promise<string | null> {\n  const config = loadConfig();\n  const uiConfig = resolveUiConfig(config, params.uiOverrides);\n  const uiUrl = resolveUiApiBase(uiConfig.host, uiConfig.port);\n  const healthUrl = `${uiUrl}/api/health`;\n  const target = await inspectUiTarget({\n    host: uiConfig.host,\n    port: uiConfig.port,\n    healthUrl,\n    checkPortAvailabilityFn: params.checkPortAvailabilityFn,\n    probeHealthEndpointFn: params.probeHealthEndpointFn\n  });\n  if (target.state !== \"healthy-existing\") {\n    return null;\n  }\n\n  return [\n    `Target UI health: ${healthUrl}`,\n    `A healthy ${APP_NAME} service is already responding on this port, but it is not tracked by ${managedServiceStateStore.path}.`,\n    `${APP_NAME} restart only stops the background service recorded in managed state; it will not auto-kill Docker or other external listeners.`,\n    `Fix: stop that external service first or rerun with --ui-port <port>.`\n  ].join(\"\\n\");\n}\n"],"mappings":"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"}

package/dist/utils/startup-trace.utils.d.ts

@@ -0,0 +1,8 @@
+//#region src/utils/startup-trace.utils.d.ts
+type TraceFields = Record<string, string | number | boolean | null | undefined>;
+declare function logStartupTrace(step: string, fields?: TraceFields): void;
+declare function measureStartupSync<T>(step: string, fn: () => T, fields?: TraceFields): T;
+declare function measureStartupAsync<T>(step: string, fn: () => Promise<T>, fields?: TraceFields): Promise<T>;
+//#endregion
+export { logStartupTrace, measureStartupAsync, measureStartupSync };
+//# sourceMappingURL=startup-trace.utils.d.ts.map

package/dist/utils/startup-trace.utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"startup-trace.utils.d.ts","names":[],"sources":["../../src/utils/startup-trace.utils.ts"],"mappings":";KAGK,WAAA,GAAc,MAAA;AAAA,iBAYH,eAAA,CAAgB,IAAA,UAAc,MAAA,GAAS,WAAA;AAAA,iBAQvC,kBAAA,GAAA,CAAsB,IAAA,UAAc,EAAA,QAAU,CAAA,EAAG,MAAA,GAAS,WAAA,GAAc,CAAA;AAAA,iBAYlE,mBAAA,GAAA,CAAuB,IAAA,UAAc,EAAA,QAAU,OAAA,CAAQ,CAAA,GAAI,MAAA,GAAS,WAAA,GAAc,OAAA,CAAQ,CAAA"}

package/dist/utils/startup-trace.utils.js

@@ -0,0 +1,39 @@
+//#region src/utils/startup-trace.utils.ts
+const STARTUP_TRACE_ENABLED = process.env.NEXTCLAW_STARTUP_TRACE === "1";
+const STARTUP_TRACE_ORIGIN_MS = Date.now();
+function formatFields(fields) {
+	if (!fields) return "";
+	const parts = Object.entries(fields).filter(([, value]) => value !== void 0).map(([key, value]) => `${key}=${String(value)}`);
+	return parts.length > 0 ? ` ${parts.join(" ")}` : "";
+}
+function logStartupTrace(step, fields) {
+	if (!STARTUP_TRACE_ENABLED) return;
+	const elapsedMs = Date.now() - STARTUP_TRACE_ORIGIN_MS;
+	console.log(`[startup-trace] +${elapsedMs}ms ${step}${formatFields(fields)}`);
+}
+function measureStartupSync(step, fn, fields) {
+	const startedAt = Date.now();
+	try {
+		return fn();
+	} finally {
+		logStartupTrace(step, {
+			...fields,
+			duration_ms: Date.now() - startedAt
+		});
+	}
+}
+async function measureStartupAsync(step, fn, fields) {
+	const startedAt = Date.now();
+	try {
+		return await fn();
+	} finally {
+		logStartupTrace(step, {
+			...fields,
+			duration_ms: Date.now() - startedAt
+		});
+	}
+}
+//#endregion
+export { logStartupTrace, measureStartupAsync, measureStartupSync };
+
+//# sourceMappingURL=startup-trace.utils.js.map

package/dist/utils/startup-trace.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"startup-trace.utils.js","names":[],"sources":["../../src/utils/startup-trace.utils.ts"],"sourcesContent":["const STARTUP_TRACE_ENABLED = process.env.NEXTCLAW_STARTUP_TRACE === \"1\";\nconst STARTUP_TRACE_ORIGIN_MS = Date.now();\n\ntype TraceFields = Record<string, string | number | boolean | null | undefined>;\n\nfunction formatFields(fields: TraceFields | undefined): string {\n  if (!fields) {\n    return \"\";\n  }\n  const parts = Object.entries(fields)\n    .filter(([, value]) => value !== undefined)\n    .map(([key, value]) => `${key}=${String(value)}`);\n  return parts.length > 0 ? ` ${parts.join(\" \")}` : \"\";\n}\n\nexport function logStartupTrace(step: string, fields?: TraceFields): void {\n  if (!STARTUP_TRACE_ENABLED) {\n    return;\n  }\n  const elapsedMs = Date.now() - STARTUP_TRACE_ORIGIN_MS;\n  console.log(`[startup-trace] +${elapsedMs}ms ${step}${formatFields(fields)}`);\n}\n\nexport function measureStartupSync<T>(step: string, fn: () => T, fields?: TraceFields): T {\n  const startedAt = Date.now();\n  try {\n    return fn();\n  } finally {\n    logStartupTrace(step, {\n      ...fields,\n      duration_ms: Date.now() - startedAt,\n    });\n  }\n}\n\nexport async function measureStartupAsync<T>(step: string, fn: () => Promise<T>, fields?: TraceFields): Promise<T> {\n  const startedAt = Date.now();\n  try {\n    return await fn();\n  } finally {\n    logStartupTrace(step, {\n      ...fields,\n      duration_ms: Date.now() - startedAt,\n    });\n  }\n}\n"],"mappings":";AAAA,MAAM,wBAAwB,QAAQ,IAAI,2BAA2B;AACrE,MAAM,0BAA0B,KAAK,KAAK;AAI1C,SAAS,aAAa,QAAyC;AAC7D,KAAI,CAAC,OACH,QAAO;CAET,MAAM,QAAQ,OAAO,QAAQ,OAAO,CACjC,QAAQ,GAAG,WAAW,UAAU,KAAA,EAAU,CAC1C,KAAK,CAAC,KAAK,WAAW,GAAG,IAAI,GAAG,OAAO,MAAM,GAAG;AACnD,QAAO,MAAM,SAAS,IAAI,IAAI,MAAM,KAAK,IAAI,KAAK;;AAGpD,SAAgB,gBAAgB,MAAc,QAA4B;AACxE,KAAI,CAAC,sBACH;CAEF,MAAM,YAAY,KAAK,KAAK,GAAG;AAC/B,SAAQ,IAAI,oBAAoB,UAAU,KAAK,OAAO,aAAa,OAAO,GAAG;;AAG/E,SAAgB,mBAAsB,MAAc,IAAa,QAAyB;CACxF,MAAM,YAAY,KAAK,KAAK;AAC5B,KAAI;AACF,SAAO,IAAI;WACH;AACR,kBAAgB,MAAM;GACpB,GAAG;GACH,aAAa,KAAK,KAAK,GAAG;GAC3B,CAAC;;;AAIN,eAAsB,oBAAuB,MAAc,IAAsB,QAAkC;CACjH,MAAM,YAAY,KAAK,KAAK;AAC5B,KAAI;AACF,SAAO,MAAM,IAAI;WACT;AACR,kBAAgB,MAAM;GACpB,GAAG;GACH,aAAa,KAAK,KAAK,GAAG;GAC3B,CAAC"}

package/dist/utils/top-level-nextclaw-command-env.utils.d.ts

@@ -0,0 +1,5 @@
+//#region src/utils/top-level-nextclaw-command-env.utils.d.ts
+declare function createTopLevelNextclawCommandEnv(baseEnv?: NodeJS.ProcessEnv, extraEnv?: NodeJS.ProcessEnv): NodeJS.ProcessEnv;
+//#endregion
+export { createTopLevelNextclawCommandEnv };
+//# sourceMappingURL=top-level-nextclaw-command-env.utils.d.ts.map

package/dist/utils/top-level-nextclaw-command-env.utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"top-level-nextclaw-command-env.utils.d.ts","names":[],"sources":["../../src/utils/top-level-nextclaw-command-env.utils.ts"],"mappings":";iBAOgB,gCAAA,CACd,OAAA,GAAS,MAAA,CAAO,UAAA,EAChB,QAAA,GAAU,MAAA,CAAO,UAAA,GAChB,MAAA,CAAO,UAAA"}

package/dist/utils/top-level-nextclaw-command-env.utils.js

@@ -0,0 +1,12 @@
+import { createExternalCommandEnv } from "@nextclaw/core";
+//#region src/utils/top-level-nextclaw-command-env.utils.ts
+const NEXTCLAW_RUNTIME_BUNDLE_ENV_KEYS = ["NEXTCLAW_RUNTIME_BUNDLE_CHILD", "NEXTCLAW_DISABLE_RUNTIME_BUNDLE_LAUNCHER"];
+function createTopLevelNextclawCommandEnv(baseEnv = process.env, extraEnv = {}) {
+	const env = createExternalCommandEnv(baseEnv, extraEnv);
+	for (const key of NEXTCLAW_RUNTIME_BUNDLE_ENV_KEYS) delete env[key];
+	return env;
+}
+//#endregion
+export { createTopLevelNextclawCommandEnv };
+
+//# sourceMappingURL=top-level-nextclaw-command-env.utils.js.map

package/dist/utils/top-level-nextclaw-command-env.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"top-level-nextclaw-command-env.utils.js","names":[],"sources":["../../src/utils/top-level-nextclaw-command-env.utils.ts"],"sourcesContent":["import { createExternalCommandEnv } from \"@nextclaw/core\";\n\nconst NEXTCLAW_RUNTIME_BUNDLE_ENV_KEYS = [\n  \"NEXTCLAW_RUNTIME_BUNDLE_CHILD\",\n  \"NEXTCLAW_DISABLE_RUNTIME_BUNDLE_LAUNCHER\",\n] as const;\n\nexport function createTopLevelNextclawCommandEnv(\n  baseEnv: NodeJS.ProcessEnv = process.env,\n  extraEnv: NodeJS.ProcessEnv = {},\n): NodeJS.ProcessEnv {\n  const env = createExternalCommandEnv(baseEnv, extraEnv);\n  for (const key of NEXTCLAW_RUNTIME_BUNDLE_ENV_KEYS) {\n    delete env[key];\n  }\n  return env;\n}\n"],"mappings":";;AAEA,MAAM,mCAAmC,CACvC,iCACA,2CACD;AAED,SAAgB,iCACd,UAA6B,QAAQ,KACrC,WAA8B,EAAE,EACb;CACnB,MAAM,MAAM,yBAAyB,SAAS,SAAS;AACvD,MAAK,MAAM,OAAO,iCAChB,QAAO,IAAI;AAEb,QAAO"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nextclaw/service",
-  "version": "0.2.12",
+  "version": "0.2.14",
   "private": false,
   "description": "NextClaw long-running service host and runtime lifecycle.",
   "type": "module",
@@ -42,31 +42,31 @@
     "chokidar": "^3.6.0",
     "commander": "^12.1.0",
     "jszip": "^3.10.1",
-    "@nextclaw/channel-extension-dingtalk": "0.1.16",
-    "@nextclaw/channel-extension-email": "0.1.16",
-    "@nextclaw/channel-extension-discord": "0.1.16",
-    "@nextclaw/channel-extension-feishu": "0.1.23",
-    "@nextclaw/channel-extension-qq": "0.1.20",
-    "@nextclaw/channel-extension-slack": "0.1.16",
-    "@nextclaw/channel-extension-wecom": "0.1.16",
-    "@nextclaw/channel-extension-weixin": "0.1.27",
-    "@nextclaw/channel-extension-telegram": "0.1.16",
-    "@nextclaw/core": "0.14.2",
-    "@nextclaw/client-sdk": "0.4.1",
-    "@nextclaw/channel-extension-whatsapp": "0.1.16",
-    "@nextclaw/ncp": "0.6.1",
-    "@nextclaw/kernel": "0.4.2",
-    "@nextclaw/mcp": "0.2.12",
-    "@nextclaw/ncp-mcp": "0.1.107",
-    "@nextclaw/ncp-agent-runtime": "0.3.42",
-    "@nextclaw/nextclaw-hermes-acp-bridge": "0.2.11",
-    "@nextclaw/nextclaw-ncp-runtime-http-client": "0.2.11",
-    "@nextclaw/runtime": "0.3.12",
-    "@nextclaw/ncp-toolkit": "0.5.36",
-    "@nextclaw/shared": "0.2.11",
-    "@nextclaw/remote": "0.2.12",
-    "@nextclaw/server": "0.14.2",
-    "@nextclaw/nextclaw-ncp-runtime-stdio-client": "0.2.11"
+    "@nextclaw/channel-extension-dingtalk": "0.1.18",
+    "@nextclaw/channel-extension-email": "0.1.18",
+    "@nextclaw/channel-extension-discord": "0.1.18",
+    "@nextclaw/channel-extension-feishu": "0.1.25",
+    "@nextclaw/channel-extension-qq": "0.1.22",
+    "@nextclaw/channel-extension-telegram": "0.1.18",
+    "@nextclaw/channel-extension-slack": "0.1.18",
+    "@nextclaw/channel-extension-wecom": "0.1.18",
+    "@nextclaw/channel-extension-weixin": "0.1.29",
+    "@nextclaw/core": "0.14.4",
+    "@nextclaw/channel-extension-whatsapp": "0.1.18",
+    "@nextclaw/client-sdk": "0.4.3",
+    "@nextclaw/kernel": "0.5.0",
+    "@nextclaw/ncp": "0.6.3",
+    "@nextclaw/mcp": "0.2.14",
+    "@nextclaw/ncp-mcp": "0.1.109",
+    "@nextclaw/ncp-toolkit": "0.5.38",
+    "@nextclaw/nextclaw-ncp-runtime-http-client": "0.2.13",
+    "@nextclaw/ncp-agent-runtime": "0.3.44",
+    "@nextclaw/nextclaw-hermes-acp-bridge": "0.2.13",
+    "@nextclaw/server": "0.14.4",
+    "@nextclaw/nextclaw-ncp-runtime-stdio-client": "0.2.13",
+    "@nextclaw/remote": "0.2.14",
+    "@nextclaw/runtime": "0.3.14",
+    "@nextclaw/shared": "0.3.0"
   },
   "devDependencies": {
     "@types/node": "^20.17.6",

package/dist/cli/commands/agent/agent-runtime.utils.d.ts

@@ -1,15 +0,0 @@
-import { AgentRuntimeSessionTypeDescribeParams, AgentRuntimeSessionTypeOption } from "@nextclaw/kernel";
-
-//#region src/cli/commands/agent/agent-runtime.utils.d.ts
-type AgentRuntimeListEntry = AgentRuntimeSessionTypeOption & {
-  default: boolean;
-  source: "builtin";
-};
-type AgentRuntimeListResult = {
-  defaultRuntime: string;
-  runtimes: AgentRuntimeListEntry[];
-};
-declare function listAvailableAgentRuntimes(params?: AgentRuntimeSessionTypeDescribeParams): Promise<AgentRuntimeListResult>;
-//#endregion
-export { AgentRuntimeListEntry, AgentRuntimeListResult, listAvailableAgentRuntimes };
-//# sourceMappingURL=agent-runtime.utils.d.ts.map

package/dist/cli/commands/agent/agent-runtime.utils.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"agent-runtime.utils.d.ts","names":[],"sources":["../../../../src/cli/commands/agent/agent-runtime.utils.ts"],"mappings":";;;KAYY,qBAAA,GAAwB,6BAAA;EAClC,OAAA;EACA,MAAA;AAAA;AAAA,KAGU,sBAAA;EACV,cAAA;EACA,QAAA,EAAU,qBAAA;AAAA;AAAA,iBAOU,0BAAA,CACpB,MAAA,GAAS,qCAAA,GACR,OAAA,CAAQ,sBAAA"}

package/dist/cli/commands/agent/agent-runtime.utils.js

@@ -1,43 +0,0 @@
-import { loadConfig } from "@nextclaw/core";
-import { AgentRuntimeRegistry, BuiltinNarpRuntimeProviderService, DEFAULT_AGENT_RUNTIME_ENTRY_ID, resolveAgentRuntimeEntries } from "@nextclaw/kernel";
-//#region src/cli/commands/agent/agent-runtime.utils.ts
-function createUnusedRuntime(_params) {
-	throw new Error("runtime creation is not available during runtime listing");
-}
-async function listAvailableAgentRuntimes(params) {
-	const config = loadConfig();
-	const runtimeRegistry = new AgentRuntimeRegistry();
-	const runtimeSourceByKind = /* @__PURE__ */ new Map();
-	const runtimeSourceByEntryId = /* @__PURE__ */ new Map();
-	runtimeRegistry.register({
-		kind: DEFAULT_AGENT_RUNTIME_ENTRY_ID,
-		label: "Native",
-		createRuntime: createUnusedRuntime
-	});
-	runtimeSourceByKind.set(DEFAULT_AGENT_RUNTIME_ENTRY_ID, { source: "builtin" });
-	for (const provider of new BuiltinNarpRuntimeProviderService({ loadConfig: () => config }).createProviders()) runtimeRegistry.register(provider);
-	runtimeSourceByKind.set("narp-http", { source: "builtin" });
-	runtimeSourceByKind.set("narp-stdio", { source: "builtin" });
-	const resolvedEntries = resolveAgentRuntimeEntries({ config });
-	runtimeRegistry.applyEntries(resolvedEntries);
-	for (const entry of resolvedEntries.entries) {
-		const source = runtimeSourceByKind.get(entry.type);
-		runtimeSourceByEntryId.set(entry.id, source ?? { source: "builtin" });
-	}
-	const listed = await runtimeRegistry.listSessionTypes(params);
-	return {
-		defaultRuntime: listed.defaultType,
-		runtimes: listed.options.map((runtime) => {
-			const source = runtimeSourceByEntryId.get(runtime.value);
-			return {
-				...runtime,
-				default: runtime.value === listed.defaultType,
-				source: source?.source ?? "builtin"
-			};
-		})
-	};
-}
-//#endregion
-export { listAvailableAgentRuntimes };
-
-//# sourceMappingURL=agent-runtime.utils.js.map

package/dist/cli/commands/agent/agent-runtime.utils.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"agent-runtime.utils.js","names":[],"sources":["../../../../src/cli/commands/agent/agent-runtime.utils.ts"],"sourcesContent":["import { loadConfig } from \"@nextclaw/core\";\nimport type { NcpAgentRuntime } from \"@nextclaw/ncp\";\nimport type { RuntimeFactoryParams } from \"@nextclaw/ncp-toolkit\";\nimport {\n  AgentRuntimeRegistry,\n  BuiltinNarpRuntimeProviderService,\n  DEFAULT_AGENT_RUNTIME_ENTRY_ID,\n  resolveAgentRuntimeEntries,\n  type AgentRuntimeSessionTypeDescribeParams,\n  type AgentRuntimeSessionTypeOption,\n} from \"@nextclaw/kernel\";\n\nexport type AgentRuntimeListEntry = AgentRuntimeSessionTypeOption & {\n  default: boolean;\n  source: \"builtin\";\n};\n\nexport type AgentRuntimeListResult = {\n  defaultRuntime: string;\n  runtimes: AgentRuntimeListEntry[];\n};\n\nfunction createUnusedRuntime(_params: RuntimeFactoryParams): NcpAgentRuntime {\n  throw new Error(\"runtime creation is not available during runtime listing\");\n}\n\nexport async function listAvailableAgentRuntimes(\n  params?: AgentRuntimeSessionTypeDescribeParams,\n): Promise<AgentRuntimeListResult> {\n  const config = loadConfig();\n  const runtimeRegistry = new AgentRuntimeRegistry();\n  const runtimeSourceByKind = new Map<string, {\n    source: \"builtin\";\n  }>();\n  const runtimeSourceByEntryId = new Map<string, {\n    source: \"builtin\";\n  }>();\n\n  runtimeRegistry.register({\n    kind: DEFAULT_AGENT_RUNTIME_ENTRY_ID,\n    label: \"Native\",\n    createRuntime: createUnusedRuntime,\n  });\n  runtimeSourceByKind.set(DEFAULT_AGENT_RUNTIME_ENTRY_ID, {\n    source: \"builtin\",\n  });\n  for (const provider of new BuiltinNarpRuntimeProviderService({ loadConfig: () => config }).createProviders()) {\n    runtimeRegistry.register(provider);\n  }\n  runtimeSourceByKind.set(\"narp-http\", {\n    source: \"builtin\",\n  });\n  runtimeSourceByKind.set(\"narp-stdio\", {\n    source: \"builtin\",\n  });\n\n  const resolvedEntries = resolveAgentRuntimeEntries({\n    config,\n  });\n  runtimeRegistry.applyEntries(resolvedEntries);\n  for (const entry of resolvedEntries.entries) {\n    const source = runtimeSourceByKind.get(entry.type);\n    runtimeSourceByEntryId.set(entry.id, source ?? {\n      source: \"builtin\",\n    });\n  }\n\n  const listed = await runtimeRegistry.listSessionTypes(params);\n  return {\n    defaultRuntime: listed.defaultType,\n    runtimes: listed.options.map((runtime) => {\n      const source = runtimeSourceByEntryId.get(runtime.value);\n      return {\n        ...runtime,\n        default: runtime.value === listed.defaultType,\n        source: source?.source ?? \"builtin\",\n      };\n    }),\n  };\n}\n"],"mappings":";;;AAsBA,SAAS,oBAAoB,SAAgD;AAC3E,OAAM,IAAI,MAAM,2DAA2D;;AAG7E,eAAsB,2BACpB,QACiC;CACjC,MAAM,SAAS,YAAY;CAC3B,MAAM,kBAAkB,IAAI,sBAAsB;CAClD,MAAM,sCAAsB,IAAI,KAE5B;CACJ,MAAM,yCAAyB,IAAI,KAE/B;AAEJ,iBAAgB,SAAS;EACvB,MAAM;EACN,OAAO;EACP,eAAe;EAChB,CAAC;AACF,qBAAoB,IAAI,gCAAgC,EACtD,QAAQ,WACT,CAAC;AACF,MAAK,MAAM,YAAY,IAAI,kCAAkC,EAAE,kBAAkB,QAAQ,CAAC,CAAC,iBAAiB,CAC1G,iBAAgB,SAAS,SAAS;AAEpC,qBAAoB,IAAI,aAAa,EACnC,QAAQ,WACT,CAAC;AACF,qBAAoB,IAAI,cAAc,EACpC,QAAQ,WACT,CAAC;CAEF,MAAM,kBAAkB,2BAA2B,EACjD,QACD,CAAC;AACF,iBAAgB,aAAa,gBAAgB;AAC7C,MAAK,MAAM,SAAS,gBAAgB,SAAS;EAC3C,MAAM,SAAS,oBAAoB,IAAI,MAAM,KAAK;AAClD,yBAAuB,IAAI,MAAM,IAAI,UAAU,EAC7C,QAAQ,WACT,CAAC;;CAGJ,MAAM,SAAS,MAAM,gBAAgB,iBAAiB,OAAO;AAC7D,QAAO;EACL,gBAAgB,OAAO;EACvB,UAAU,OAAO,QAAQ,KAAK,YAAY;GACxC,MAAM,SAAS,uBAAuB,IAAI,QAAQ,MAAM;AACxD,UAAO;IACL,GAAG;IACH,SAAS,QAAQ,UAAU,OAAO;IAClC,QAAQ,QAAQ,UAAU;IAC3B;IACD;EACH"}

package/dist/cli/commands/agent/cli-agent-runner.utils.d.ts

@@ -1,14 +0,0 @@
-import { AgentCommandOptions } from "../../../shared/types/cli.types.js";
-import { Config } from "@nextclaw/core";
-import { NextclawKernel } from "@nextclaw/kernel";
-
-//#region src/cli/commands/agent/cli-agent-runner.utils.d.ts
-declare function runCliAgentCommand(params: {
-  logo: string;
-  opts: AgentCommandOptions;
-  config: Config;
-  kernel: NextclawKernel;
-}): Promise<void>;
-//#endregion
-export { runCliAgentCommand };
-//# sourceMappingURL=cli-agent-runner.utils.d.ts.map

package/dist/cli/commands/agent/cli-agent-runner.utils.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"cli-agent-runner.utils.d.ts","names":[],"sources":["../../../../src/cli/commands/agent/cli-agent-runner.utils.ts"],"mappings":";;;;;iBAoFsB,kBAAA,CAAmB,MAAA;EACvC,IAAA;EACA,IAAA,EAAM,mBAAA;EACN,MAAA,EAAQ,MAAA;EACR,MAAA,EAAQ,cAAA;AAAA,IACN,OAAA"}

package/dist/cli/commands/agent/cli-agent-runner.utils.js

@@ -1,94 +0,0 @@
-import { printAgentResponse, prompt } from "../../../shared/utils/cli.utils.js";
-import { getDataDir } from "@nextclaw/core";
-import { AgentRunClient, dispatchPromptOverNcp } from "@nextclaw/kernel";
-import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
-import { join, resolve } from "node:path";
-import { createInterface } from "node:readline";
-//#region src/cli/commands/agent/cli-agent-runner.utils.ts
-const EXIT_COMMANDS = new Set([
-	"exit",
-	"quit",
-	"/exit",
-	"/quit",
-	":q"
-]);
-function createCliHistoryInterface() {
-	const historyFile = join(getDataDir(), "history", "cli_history");
-	mkdirSync(resolve(historyFile, ".."), { recursive: true });
-	const history = existsSync(historyFile) ? readFileSync(historyFile, "utf-8").split("\n").filter(Boolean) : [];
-	const rl = createInterface({
-		input: process.stdin,
-		output: process.stdout
-	});
-	rl.on("close", () => {
-		writeFileSync(historyFile, history.concat(rl.history ?? []).join("\n"));
-		process.exit(0);
-	});
-	return rl;
-}
-async function sendCliPrompt(params) {
-	try {
-		printAgentResponse(await dispatchPromptOverNcp(params));
-		return true;
-	} catch (error) {
-		const message = error instanceof Error ? error.message : String(error ?? "Unknown error");
-		console.error(`Error: ${message.trim() || "Unknown error"}`);
-		return false;
-	}
-}
-async function runCliInteractiveLoop(params) {
-	const { agentRunClient, config, logo, metadata, sessionKey } = params;
-	console.log(`${logo} Interactive mode (type exit or Ctrl+C to quit)\n`);
-	const rl = createCliHistoryInterface();
-	while (true) {
-		const trimmed = (await prompt(rl, "You: ")).trim();
-		if (!trimmed) continue;
-		if (EXIT_COMMANDS.has(trimmed.toLowerCase())) {
-			rl.close();
-			break;
-		}
-		await sendCliPrompt({
-			config,
-			agentRunClient,
-			sessionKey,
-			content: trimmed,
-			metadata
-		});
-	}
-}
-async function runCliAgentCommand(params) {
-	const { config, kernel, logo, opts } = params;
-	await kernel.extensions.load({ config });
-	await kernel.start();
-	try {
-		const agentRunClient = new AgentRunClient({
-			eventBus: kernel.eventBus,
-			ingress: kernel.ingress
-		});
-		const sessionKey = opts.session ?? "cli:default";
-		const sharedMetadata = typeof opts.model === "string" && opts.model.trim() ? { model: opts.model.trim() } : {};
-		if (opts.message) {
-			if (!await sendCliPrompt({
-				config,
-				agentRunClient,
-				sessionKey,
-				content: opts.message,
-				metadata: sharedMetadata
-			})) process.exitCode = 1;
-			return;
-		}
-		await runCliInteractiveLoop({
-			logo,
-			config,
-			agentRunClient,
-			sessionKey,
-			metadata: sharedMetadata
-		});
-	} finally {
-		await kernel.dispose();
-	}
-}
-//#endregion
-export { runCliAgentCommand };
-
-//# sourceMappingURL=cli-agent-runner.utils.js.map

package/dist/cli/commands/agent/cli-agent-runner.utils.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"cli-agent-runner.utils.js","names":[],"sources":["../../../../src/cli/commands/agent/cli-agent-runner.utils.ts"],"sourcesContent":["import {\n  getDataDir,\n  type Config,\n} from \"@nextclaw/core\";\nimport {\n  AgentRunClient,\n  dispatchPromptOverNcp,\n  type DirectPromptDispatchParams,\n  type NextclawKernel,\n} from \"@nextclaw/kernel\";\nimport { existsSync, mkdirSync, readFileSync, writeFileSync } from \"node:fs\";\nimport { join, resolve } from \"node:path\";\nimport { createInterface } from \"node:readline\";\nimport type { AgentCommandOptions } from \"@nextclaw-service/shared/types/cli.types.js\";\nimport { printAgentResponse, prompt } from \"@nextclaw-service/shared/utils/cli.utils.js\";\n\nconst EXIT_COMMANDS = new Set([\"exit\", \"quit\", \"/exit\", \"/quit\", \":q\"]);\ntype CliPromptParams = Pick<DirectPromptDispatchParams, \"agentRunClient\" | \"config\" | \"content\" | \"metadata\" | \"sessionKey\">;\n\nfunction createCliHistoryInterface() {\n  const historyFile = join(getDataDir(), \"history\", \"cli_history\");\n  mkdirSync(resolve(historyFile, \"..\"), { recursive: true });\n\n  const history = existsSync(historyFile)\n    ? readFileSync(historyFile, \"utf-8\").split(\"\\n\").filter(Boolean)\n    : [];\n  const rl = createInterface({\n    input: process.stdin,\n    output: process.stdout,\n  });\n  rl.on(\"close\", () => {\n    const merged = history.concat(\n      (rl as unknown as { history: string[] }).history ?? [],\n    );\n    writeFileSync(historyFile, merged.join(\"\\n\"));\n    process.exit(0);\n  });\n\n  return rl;\n}\n\nasync function sendCliPrompt(params: CliPromptParams): Promise<boolean> {\n  try {\n    const response = await dispatchPromptOverNcp(params);\n    printAgentResponse(response);\n    return true;\n  } catch (error) {\n    const message = error instanceof Error ? error.message : String(error ?? \"Unknown error\");\n    console.error(`Error: ${message.trim() || \"Unknown error\"}`);\n    return false;\n  }\n}\n\nasync function runCliInteractiveLoop(params: {\n  logo: string;\n  config: Config;\n  agentRunClient: AgentRunClient;\n  sessionKey: string;\n  metadata: Record<string, unknown>;\n}): Promise<void> {\n  const { agentRunClient, config, logo, metadata, sessionKey } = params;\n  console.log(`${logo} Interactive mode (type exit or Ctrl+C to quit)\\n`);\n  const rl = createCliHistoryInterface();\n\n  while (true) {\n    const line = await prompt(rl, \"You: \");\n    const trimmed = line.trim();\n    if (!trimmed) {\n      continue;\n    }\n    if (EXIT_COMMANDS.has(trimmed.toLowerCase())) {\n      rl.close();\n      break;\n    }\n    await sendCliPrompt({\n      config,\n      agentRunClient,\n      sessionKey,\n      content: trimmed,\n      metadata,\n    });\n  }\n}\n\nexport async function runCliAgentCommand(params: {\n  logo: string;\n  opts: AgentCommandOptions;\n  config: Config;\n  kernel: NextclawKernel;\n}): Promise<void> {\n  const {\n    config,\n    kernel,\n    logo,\n    opts,\n  } = params;\n  await kernel.extensions.load({ config });\n  await kernel.start();\n\n  try {\n    const agentRunClient = new AgentRunClient({\n      eventBus: kernel.eventBus,\n      ingress: kernel.ingress,\n    });\n    const sessionKey = opts.session ?? \"cli:default\";\n    const sharedMetadata = typeof opts.model === \"string\" && opts.model.trim()\n      ? { model: opts.model.trim() }\n      : {};\n\n    if (opts.message) {\n      const success = await sendCliPrompt({\n        config,\n        agentRunClient,\n        sessionKey,\n        content: opts.message,\n        metadata: sharedMetadata,\n      });\n      if (!success) {\n        process.exitCode = 1;\n      }\n      return;\n    }\n\n    await runCliInteractiveLoop({\n      logo,\n      config,\n      agentRunClient,\n      sessionKey,\n      metadata: sharedMetadata,\n    });\n  } finally {\n    await kernel.dispose();\n  }\n}\n"],"mappings":";;;;;;;AAgBA,MAAM,gBAAgB,IAAI,IAAI;CAAC;CAAQ;CAAQ;CAAS;CAAS;CAAK,CAAC;AAGvE,SAAS,4BAA4B;CACnC,MAAM,cAAc,KAAK,YAAY,EAAE,WAAW,cAAc;AAChE,WAAU,QAAQ,aAAa,KAAK,EAAE,EAAE,WAAW,MAAM,CAAC;CAE1D,MAAM,UAAU,WAAW,YAAY,GACnC,aAAa,aAAa,QAAQ,CAAC,MAAM,KAAK,CAAC,OAAO,QAAQ,GAC9D,EAAE;CACN,MAAM,KAAK,gBAAgB;EACzB,OAAO,QAAQ;EACf,QAAQ,QAAQ;EACjB,CAAC;AACF,IAAG,GAAG,eAAe;AAInB,gBAAc,aAHC,QAAQ,OACpB,GAAwC,WAAW,EAAE,CACvD,CACiC,KAAK,KAAK,CAAC;AAC7C,UAAQ,KAAK,EAAE;GACf;AAEF,QAAO;;AAGT,eAAe,cAAc,QAA2C;AACtE,KAAI;AAEF,qBADiB,MAAM,sBAAsB,OAAO,CACxB;AAC5B,SAAO;UACA,OAAO;EACd,MAAM,UAAU,iBAAiB,QAAQ,MAAM,UAAU,OAAO,SAAS,gBAAgB;AACzF,UAAQ,MAAM,UAAU,QAAQ,MAAM,IAAI,kBAAkB;AAC5D,SAAO;;;AAIX,eAAe,sBAAsB,QAMnB;CAChB,MAAM,EAAE,gBAAgB,QAAQ,MAAM,UAAU,eAAe;AAC/D,SAAQ,IAAI,GAAG,KAAK,mDAAmD;CACvE,MAAM,KAAK,2BAA2B;AAEtC,QAAO,MAAM;EAEX,MAAM,WADO,MAAM,OAAO,IAAI,QAAQ,EACjB,MAAM;AAC3B,MAAI,CAAC,QACH;AAEF,MAAI,cAAc,IAAI,QAAQ,aAAa,CAAC,EAAE;AAC5C,MAAG,OAAO;AACV;;AAEF,QAAM,cAAc;GAClB;GACA;GACA;GACA,SAAS;GACT;GACD,CAAC;;;AAIN,eAAsB,mBAAmB,QAKvB;CAChB,MAAM,EACJ,QACA,QACA,MACA,SACE;AACJ,OAAM,OAAO,WAAW,KAAK,EAAE,QAAQ,CAAC;AACxC,OAAM,OAAO,OAAO;AAEpB,KAAI;EACF,MAAM,iBAAiB,IAAI,eAAe;GACxC,UAAU,OAAO;GACjB,SAAS,OAAO;GACjB,CAAC;EACF,MAAM,aAAa,KAAK,WAAW;EACnC,MAAM,iBAAiB,OAAO,KAAK,UAAU,YAAY,KAAK,MAAM,MAAM,GACtE,EAAE,OAAO,KAAK,MAAM,MAAM,EAAE,GAC5B,EAAE;AAEN,MAAI,KAAK,SAAS;AAQhB,OAAI,CAPY,MAAM,cAAc;IAClC;IACA;IACA;IACA,SAAS,KAAK;IACd,UAAU;IACX,CAAC,CAEA,SAAQ,WAAW;AAErB;;AAGF,QAAM,sBAAsB;GAC1B;GACA;GACA;GACA;GACA,UAAU;GACX,CAAC;WACM;AACR,QAAM,OAAO,SAAS"}

package/dist/cli/commands/agent/index.d.ts

@@ -1,3 +0,0 @@
-import { runCliAgentCommand } from "./cli-agent-runner.utils.js";
-import { AgentCommands } from "./services/agent-commands.service.js";
-export { AgentCommands, runCliAgentCommand };

package/dist/cli/commands/agent/index.js

@@ -1,3 +0,0 @@
-import { AgentCommands } from "./services/agent-commands.service.js";
-import { runCliAgentCommand } from "./cli-agent-runner.utils.js";
-export { AgentCommands, runCliAgentCommand };

package/dist/cli/commands/agent/services/agent-commands.service.d.ts

@@ -1,18 +0,0 @@
-import { AgentsListCommandOptions, AgentsNewCommandOptions, AgentsRemoveCommandOptions, AgentsRuntimesCommandOptions, AgentsUpdateCommandOptions } from "../../../../shared/types/cli.types.js";
-
-//#region src/cli/commands/agent/services/agent-commands.service.d.ts
-declare class AgentCommands {
-  private readonly deps;
-  constructor(deps: {
-    initializeAgentHomeDirectory: (homeDirectory: string) => void;
-  });
-  list: (opts?: AgentsListCommandOptions) => void;
-  runtimes: (opts?: AgentsRuntimesCommandOptions) => Promise<void>;
-  create: (agentId: string, opts?: AgentsNewCommandOptions) => Promise<void>;
-  update: (agentId: string, opts?: AgentsUpdateCommandOptions) => Promise<void>;
-  remove: (agentId: string, opts?: AgentsRemoveCommandOptions) => Promise<void>;
-  private toAgentListEntry;
-}
-//#endregion
-export { AgentCommands };
-//# sourceMappingURL=agent-commands.service.d.ts.map

package/dist/cli/commands/agent/services/agent-commands.service.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"agent-commands.service.d.ts","names":[],"sources":["../../../../../src/cli/commands/agent/services/agent-commands.service.ts"],"mappings":";;;cAYa,aAAA;EAAA,iBACkB,IAAA;cAAA,IAAA;IAC3B,4BAAA,GAA+B,aAAA;EAAA;EAGjC,IAAA,GAAQ,IAAA,GAAM,wBAAA;EAkBd,QAAA,GAAkB,IAAA,GAAM,4BAAA,KAAoC,OAAA;EAyB5D,MAAA,GAAgB,OAAA,UAAiB,IAAA,GAAM,uBAAA,KAA+B,OAAA;EA4BtE,MAAA,GAAgB,OAAA,UAAiB,IAAA,GAAM,0BAAA,KAAkC,OAAA;EAsBzE,MAAA,GAAgB,OAAA,UAAiB,IAAA,GAAM,0BAAA,KAAkC,OAAA;EAAA,QAkBjE,gBAAA;AAAA"}