@nextclaw/service 0.2.13 → 0.2.14

package/dist/services/gateway/service-bootstrap-status.service.js

@@ -0,0 +1,144 @@
+//#region src/services/gateway/service-bootstrap-status.service.ts
+function now() {
+	return (/* @__PURE__ */ new Date()).toISOString();
+}
+var ServiceBootstrapStatusStore = class {
+	state = {
+		phase: "kernel-starting",
+		ncpAgent: { state: "pending" },
+		extensionLoading: {
+			state: "pending",
+			loadedExtensionCount: 0,
+			totalExtensionCount: 0
+		},
+		channels: {
+			state: "pending",
+			enabled: []
+		},
+		remote: { state: "pending" }
+	};
+	getStatus() {
+		return {
+			...this.state,
+			ncpAgent: { ...this.state.ncpAgent },
+			extensionLoading: { ...this.state.extensionLoading },
+			channels: {
+				...this.state.channels,
+				enabled: [...this.state.channels.enabled]
+			},
+			remote: { ...this.state.remote }
+		};
+	}
+	markShellReady() {
+		this.state.phase = "shell-ready";
+		this.state.shellReadyAt = this.state.shellReadyAt ?? now();
+	}
+	markNcpAgentRunning() {
+		this.state.ncpAgent = {
+			state: "running",
+			startedAt: this.state.ncpAgent.startedAt ?? now(),
+			completedAt: void 0,
+			error: void 0
+		};
+	}
+	markNcpAgentReady() {
+		this.state.ncpAgent = {
+			state: "ready",
+			startedAt: this.state.ncpAgent.startedAt ?? now(),
+			completedAt: now(),
+			error: void 0
+		};
+	}
+	markNcpAgentError(error) {
+		this.state.ncpAgent = {
+			state: "error",
+			startedAt: this.state.ncpAgent.startedAt ?? now(),
+			completedAt: now(),
+			error
+		};
+	}
+	markExtensionLoadingRunning(params) {
+		this.state.phase = "hydrating-capabilities";
+		this.state.extensionLoading = {
+			...this.state.extensionLoading,
+			state: "running",
+			loadedExtensionCount: 0,
+			totalExtensionCount: params.totalExtensionCount,
+			startedAt: this.state.extensionLoading.startedAt ?? now(),
+			completedAt: void 0,
+			error: void 0
+		};
+	}
+	markExtensionLoadingProgress(params) {
+		this.state.extensionLoading = {
+			...this.state.extensionLoading,
+			state: "running",
+			loadedExtensionCount: params.loadedExtensionCount,
+			totalExtensionCount: params.totalExtensionCount ?? this.state.extensionLoading.totalExtensionCount
+		};
+	}
+	markExtensionLoadingReady(params) {
+		this.state.extensionLoading = {
+			...this.state.extensionLoading,
+			state: "ready",
+			loadedExtensionCount: params.loadedExtensionCount,
+			totalExtensionCount: params.totalExtensionCount,
+			completedAt: now(),
+			error: void 0
+		};
+	}
+	markExtensionLoadingError(error) {
+		this.state.phase = "error";
+		this.state.lastError = error;
+		this.state.extensionLoading = {
+			...this.state.extensionLoading,
+			state: "error",
+			completedAt: now(),
+			error
+		};
+	}
+	markChannelsPending() {
+		this.state.channels = {
+			state: "pending",
+			enabled: []
+		};
+	}
+	markChannelsReady(enabled) {
+		this.state.channels = {
+			state: "ready",
+			enabled: [...enabled]
+		};
+		if (this.state.extensionLoading.state === "ready") {
+			this.state.phase = "ready";
+			this.state.lastError = void 0;
+		}
+	}
+	markChannelsError(error) {
+		this.state.phase = "error";
+		this.state.lastError = error;
+		this.state.channels = {
+			state: "error",
+			enabled: [...this.state.channels.enabled],
+			error
+		};
+	}
+	setRemoteState(state, message) {
+		this.state.remote = {
+			state,
+			...message ? { message } : {}
+		};
+	}
+	syncRemoteRuntimeState(runtime) {
+		const message = runtime.lastError?.trim() || void 0;
+		const state = runtime.state === "connected" ? "ready" : runtime.state === "disabled" ? "disabled" : runtime.state === "error" && message?.includes("already owned") ? "conflict" : runtime.state === "error" ? "error" : "pending";
+		this.setRemoteState(state, message);
+	}
+	markError(error) {
+		this.state.phase = "error";
+		this.state.lastError = error;
+	}
+};
+//#endregion
+export { ServiceBootstrapStatusStore };
+
+//# sourceMappingURL=service-bootstrap-status.service.js.map

package/dist/services/gateway/service-bootstrap-status.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"service-bootstrap-status.service.js","names":[],"sources":["../../../src/services/gateway/service-bootstrap-status.service.ts"],"sourcesContent":["import type { BootstrapRemoteState, BootstrapStatusView } from \"@nextclaw/server\";\nimport type { RemoteRuntimeState } from \"@nextclaw/remote\";\n\nfunction now(): string {\n  return new Date().toISOString();\n}\n\nexport class ServiceBootstrapStatusStore {\n  private state: BootstrapStatusView = {\n    phase: \"kernel-starting\",\n    ncpAgent: {\n      state: \"pending\",\n    },\n    extensionLoading: {\n      state: \"pending\",\n      loadedExtensionCount: 0,\n      totalExtensionCount: 0\n    },\n    channels: {\n      state: \"pending\",\n      enabled: []\n    },\n    remote: {\n      state: \"pending\"\n    }\n  };\n\n  getStatus(): BootstrapStatusView {\n    return {\n      ...this.state,\n      ncpAgent: { ...this.state.ncpAgent },\n      extensionLoading: { ...this.state.extensionLoading },\n      channels: {\n        ...this.state.channels,\n        enabled: [...this.state.channels.enabled]\n      },\n      remote: { ...this.state.remote }\n    };\n  }\n\n  markShellReady(): void {\n    this.state.phase = \"shell-ready\";\n    this.state.shellReadyAt = this.state.shellReadyAt ?? now();\n  }\n\n  markNcpAgentRunning(): void {\n    this.state.ncpAgent = {\n      state: \"running\",\n      startedAt: this.state.ncpAgent.startedAt ?? now(),\n      completedAt: undefined,\n      error: undefined\n    };\n  }\n\n  markNcpAgentReady(): void {\n    this.state.ncpAgent = {\n      state: \"ready\",\n      startedAt: this.state.ncpAgent.startedAt ?? now(),\n      completedAt: now(),\n      error: undefined\n    };\n  }\n\n  markNcpAgentError(error: string): void {\n    this.state.ncpAgent = {\n      state: \"error\",\n      startedAt: this.state.ncpAgent.startedAt ?? now(),\n      completedAt: now(),\n      error\n    };\n  }\n\n  markExtensionLoadingRunning(params: {\n    totalExtensionCount: number;\n  }): void {\n    this.state.phase = \"hydrating-capabilities\";\n    this.state.extensionLoading = {\n      ...this.state.extensionLoading,\n      state: \"running\",\n      loadedExtensionCount: 0,\n      totalExtensionCount: params.totalExtensionCount,\n      startedAt: this.state.extensionLoading.startedAt ?? now(),\n      completedAt: undefined,\n      error: undefined\n    };\n  }\n\n  markExtensionLoadingProgress(params: {\n    loadedExtensionCount: number;\n    totalExtensionCount?: number;\n  }): void {\n    this.state.extensionLoading = {\n      ...this.state.extensionLoading,\n      state: \"running\",\n      loadedExtensionCount: params.loadedExtensionCount,\n      totalExtensionCount: params.totalExtensionCount ?? this.state.extensionLoading.totalExtensionCount\n    };\n  }\n\n  markExtensionLoadingReady(params: {\n    loadedExtensionCount: number;\n    totalExtensionCount: number;\n  }): void {\n    this.state.extensionLoading = {\n      ...this.state.extensionLoading,\n      state: \"ready\",\n      loadedExtensionCount: params.loadedExtensionCount,\n      totalExtensionCount: params.totalExtensionCount,\n      completedAt: now(),\n      error: undefined\n    };\n  }\n\n  markExtensionLoadingError(error: string): void {\n    this.state.phase = \"error\";\n    this.state.lastError = error;\n    this.state.extensionLoading = {\n      ...this.state.extensionLoading,\n      state: \"error\",\n      completedAt: now(),\n      error\n    };\n  }\n\n  markChannelsPending(): void {\n    this.state.channels = {\n      state: \"pending\",\n      enabled: []\n    };\n  }\n\n  markChannelsReady(enabled: string[]): void {\n    this.state.channels = {\n      state: \"ready\",\n      enabled: [...enabled]\n    };\n    if (this.state.extensionLoading.state === \"ready\") {\n      this.state.phase = \"ready\";\n      this.state.lastError = undefined;\n    }\n  }\n\n  markChannelsError(error: string): void {\n    this.state.phase = \"error\";\n    this.state.lastError = error;\n    this.state.channels = {\n      state: \"error\",\n      enabled: [...this.state.channels.enabled],\n      error\n    };\n  }\n\n  setRemoteState(state: BootstrapRemoteState, message?: string): void {\n    this.state.remote = {\n      state,\n      ...(message ? { message } : {})\n    };\n  }\n\n  syncRemoteRuntimeState(runtime: RemoteRuntimeState): void {\n    const message = runtime.lastError?.trim() || undefined;\n    const state =\n      runtime.state === \"connected\" ? \"ready\"\n        : runtime.state === \"disabled\" ? \"disabled\"\n          : runtime.state === \"error\" && message?.includes(\"already owned\") ? \"conflict\"\n            : runtime.state === \"error\" ? \"error\"\n              : \"pending\";\n    this.setRemoteState(state, message);\n  }\n\n  markError(error: string): void {\n    this.state.phase = \"error\";\n    this.state.lastError = error;\n  }\n}\n"],"mappings":"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"}

package/dist/services/gateway/service-startup-support.service.d.ts

@@ -0,0 +1,35 @@
+import { Config } from "@nextclaw/core";
+import { AutomationManager } from "@nextclaw/kernel";
+import { RemoteServiceModule } from "@nextclaw/remote";
+import { FSWatcher } from "chokidar";
+
+//#region src/services/gateway/service-startup-support.service.d.ts
+type GatewayRuntimeSupportServiceParams = {
+  automation: AutomationManager;
+  remoteModule: RemoteServiceModule | null;
+  watchConfigFile: () => void;
+  watcherRegistry: ServiceFileWatcherRegistry;
+};
+declare class GatewayRuntimeSupportService {
+  private readonly params;
+  constructor(params: GatewayRuntimeSupportServiceParams);
+  start: () => Promise<void>;
+  private watchCronStoreFile;
+}
+declare function watchServiceConfigFile(params: {
+  configPath: string;
+  watcherRegistry: ServiceFileWatcherRegistry;
+  scheduleReload: (reason: string) => void;
+}): void;
+declare class ServiceFileWatcherRegistry {
+  private readonly watchers;
+  readonly remember: (watcher: FSWatcher) => void;
+  readonly clear: () => Promise<void>;
+}
+declare function markLocalUiRuntimeIfStarted(params: {
+  uiStartup: unknown | null | undefined;
+  uiConfig: Pick<Config["ui"], "host" | "port">;
+}): void;
+//#endregion
+export { GatewayRuntimeSupportService, ServiceFileWatcherRegistry, markLocalUiRuntimeIfStarted, watchServiceConfigFile };
+//# sourceMappingURL=service-startup-support.service.d.ts.map

package/dist/services/gateway/service-startup-support.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service-startup-support.service.d.ts","names":[],"sources":["../../../src/services/gateway/service-startup-support.service.ts"],"mappings":";;;;;;KAOK,kCAAA;EACH,UAAA,EAAY,iBAAA;EACZ,YAAA,EAAc,mBAAA;EACd,eAAA;EACA,eAAA,EAAiB,0BAAA;AAAA;AAAA,cAGN,4BAAA;EAAA,iBACkB,MAAA;cAAA,MAAA,EAAQ,kCAAA;EAErC,KAAA,QAAkB,OAAA;EAAA,QAiBV,kBAAA;AAAA;AAAA,iBAuBM,sBAAA,CAAuB,MAAA;EACrC,UAAA;EACA,eAAA,EAAiB,0BAAA;EACjB,cAAA,GAAiB,MAAA;AAAA;AAAA,cA0BN,0BAAA;EAAA,iBACM,QAAA;EAAA,SAER,QAAA,GAAY,OAAA,EAAS,SAAA;EAAA,SAIrB,KAAA,QAAkB,OAAA;AAAA;AAAA,iBAYb,2BAAA,CAA4B,MAAA;EAC1C,SAAA;EACA,QAAA,EAAU,IAAA,CAAK,MAAA;AAAA"}

package/dist/services/gateway/service-startup-support.service.js

@@ -0,0 +1,83 @@
+import { localUiRuntimeStore } from "../../stores/local-ui-runtime.store.js";
+import { resolve } from "node:path";
+import chokidar from "chokidar";
+//#region src/services/gateway/service-startup-support.service.ts
+var GatewayRuntimeSupportService = class {
+	constructor(params) {
+		this.params = params;
+	}
+	start = async () => {
+		const { automation, remoteModule, watchConfigFile, watcherRegistry } = this.params;
+		const cronJobs = automation.status().jobs;
+		if (cronJobs > 0) console.log(`✓ Cron: ${cronJobs} scheduled jobs`);
+		remoteModule?.start();
+		watchConfigFile();
+		await automation.start();
+		watcherRegistry.remember(this.watchCronStoreFile());
+	};
+	watchCronStoreFile = () => {
+		const { automation } = this.params;
+		const cronStorePath = resolve(automation.storePath);
+		const watcher = chokidar.watch(cronStorePath, {
+			ignoreInitial: true,
+			awaitWriteFinish: {
+				stabilityThreshold: 200,
+				pollInterval: 50
+			}
+		});
+		watcher.on("all", (event, changedPath) => {
+			if (resolve(changedPath) !== cronStorePath) return;
+			if (event === "add" || event === "change" || event === "unlink") try {
+				automation.reloadFromStore();
+			} catch (error) {
+				console.error(`Cron store reload failed (${event}): ${String(error)}`);
+			}
+		});
+		return watcher;
+	};
+};
+function watchServiceConfigFile(params) {
+	const configPath = resolve(params.configPath);
+	const watcher = chokidar.watch(configPath, {
+		ignoreInitial: true,
+		awaitWriteFinish: {
+			stabilityThreshold: 200,
+			pollInterval: 50
+		}
+	});
+	params.watcherRegistry.remember(watcher);
+	watcher.on("all", (event, changedPath) => {
+		if (resolve(changedPath) !== configPath) return;
+		if (event === "add") {
+			params.scheduleReload("config add");
+			return;
+		}
+		if (event === "change") {
+			params.scheduleReload("config change");
+			return;
+		}
+		if (event === "unlink") params.scheduleReload("config unlink");
+	});
+}
+var ServiceFileWatcherRegistry = class {
+	watchers = [];
+	remember = (watcher) => {
+		this.watchers.push(watcher);
+	};
+	clear = async () => {
+		const watchers = this.watchers.splice(0);
+		await Promise.allSettled(watchers.map(async (watcher) => {
+			try {
+				await watcher.close();
+			} catch {}
+		}));
+	};
+};
+function markLocalUiRuntimeIfStarted(params) {
+	const { uiConfig, uiStartup } = params;
+	if (uiStartup) localUiRuntimeStore.writeCurrentProcess(uiConfig);
+}
+//#endregion
+export { GatewayRuntimeSupportService, ServiceFileWatcherRegistry, markLocalUiRuntimeIfStarted, watchServiceConfigFile };
+
+//# sourceMappingURL=service-startup-support.service.js.map

package/dist/services/gateway/service-startup-support.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"service-startup-support.service.js","names":[],"sources":["../../../src/services/gateway/service-startup-support.service.ts"],"sourcesContent":["import type { Config } from \"@nextclaw/core\";\nimport type { AutomationManager } from \"@nextclaw/kernel\";\nimport type { RemoteServiceModule } from \"@nextclaw/remote\";\nimport chokidar, { type FSWatcher } from \"chokidar\";\nimport { resolve } from \"node:path\";\nimport { localUiRuntimeStore } from \"@nextclaw-service/stores/local-ui-runtime.store.js\";\n\ntype GatewayRuntimeSupportServiceParams = {\n  automation: AutomationManager;\n  remoteModule: RemoteServiceModule | null;\n  watchConfigFile: () => void;\n  watcherRegistry: ServiceFileWatcherRegistry;\n};\n\nexport class GatewayRuntimeSupportService {\n  constructor(private readonly params: GatewayRuntimeSupportServiceParams) {}\n\n  start = async (): Promise<void> => {\n    const {\n      automation,\n      remoteModule,\n      watchConfigFile,\n      watcherRegistry\n    } = this.params;\n    const cronJobs = automation.status().jobs;\n    if (cronJobs > 0) {\n      console.log(`✓ Cron: ${cronJobs} scheduled jobs`);\n    }\n    remoteModule?.start();\n    watchConfigFile();\n    await automation.start();\n    watcherRegistry.remember(this.watchCronStoreFile());\n  };\n\n  private watchCronStoreFile = (): FSWatcher => {\n    const { automation } = this.params;\n    const cronStorePath = resolve(automation.storePath);\n    const watcher = chokidar.watch(cronStorePath, {\n      ignoreInitial: true,\n      awaitWriteFinish: { stabilityThreshold: 200, pollInterval: 50 }\n    });\n    watcher.on(\"all\", (event, changedPath) => {\n      if (resolve(changedPath) !== cronStorePath) {\n        return;\n      }\n      if (event === \"add\" || event === \"change\" || event === \"unlink\") {\n        try {\n          automation.reloadFromStore();\n        } catch (error) {\n          console.error(`Cron store reload failed (${event}): ${String(error)}`);\n        }\n      }\n    });\n    return watcher;\n  };\n}\n\nexport function watchServiceConfigFile(params: {\n  configPath: string;\n  watcherRegistry: ServiceFileWatcherRegistry;\n  scheduleReload: (reason: string) => void;\n}): void {\n  const configPath = resolve(params.configPath);\n  const watcher = chokidar.watch(configPath, {\n    ignoreInitial: true,\n    awaitWriteFinish: { stabilityThreshold: 200, pollInterval: 50 }\n  });\n  params.watcherRegistry.remember(watcher);\n  watcher.on(\"all\", (event, changedPath) => {\n    if (resolve(changedPath) !== configPath) {\n      return;\n    }\n    if (event === \"add\") {\n      params.scheduleReload(\"config add\");\n      return;\n    }\n    if (event === \"change\") {\n      params.scheduleReload(\"config change\");\n      return;\n    }\n    if (event === \"unlink\") {\n      params.scheduleReload(\"config unlink\");\n    }\n  });\n}\n\nexport class ServiceFileWatcherRegistry {\n  private readonly watchers: FSWatcher[] = [];\n\n  readonly remember = (watcher: FSWatcher): void => {\n    this.watchers.push(watcher);\n  };\n\n  readonly clear = async (): Promise<void> => {\n    const watchers = this.watchers.splice(0);\n    await Promise.allSettled(watchers.map(async (watcher) => {\n      try {\n        await watcher.close();\n      } catch {\n        void 0;\n      }\n    }));\n  };\n}\n\nexport function markLocalUiRuntimeIfStarted(params: {\n  uiStartup: unknown | null | undefined;\n  uiConfig: Pick<Config[\"ui\"], \"host\" | \"port\">;\n}): void {\n  const { uiConfig, uiStartup } = params;\n  if (uiStartup) {\n    localUiRuntimeStore.writeCurrentProcess(uiConfig);\n  }\n}\n"],"mappings":";;;;AAcA,IAAa,+BAAb,MAA0C;CACxC,YAAY,QAA6D;AAA5C,OAAA,SAAA;;CAE7B,QAAQ,YAA2B;EACjC,MAAM,EACJ,YACA,cACA,iBACA,oBACE,KAAK;EACT,MAAM,WAAW,WAAW,QAAQ,CAAC;AACrC,MAAI,WAAW,EACb,SAAQ,IAAI,WAAW,SAAS,iBAAiB;AAEnD,gBAAc,OAAO;AACrB,mBAAiB;AACjB,QAAM,WAAW,OAAO;AACxB,kBAAgB,SAAS,KAAK,oBAAoB,CAAC;;CAGrD,2BAA8C;EAC5C,MAAM,EAAE,eAAe,KAAK;EAC5B,MAAM,gBAAgB,QAAQ,WAAW,UAAU;EACnD,MAAM,UAAU,SAAS,MAAM,eAAe;GAC5C,eAAe;GACf,kBAAkB;IAAE,oBAAoB;IAAK,cAAc;IAAI;GAChE,CAAC;AACF,UAAQ,GAAG,QAAQ,OAAO,gBAAgB;AACxC,OAAI,QAAQ,YAAY,KAAK,cAC3B;AAEF,OAAI,UAAU,SAAS,UAAU,YAAY,UAAU,SACrD,KAAI;AACF,eAAW,iBAAiB;YACrB,OAAO;AACd,YAAQ,MAAM,6BAA6B,MAAM,KAAK,OAAO,MAAM,GAAG;;IAG1E;AACF,SAAO;;;AAIX,SAAgB,uBAAuB,QAI9B;CACP,MAAM,aAAa,QAAQ,OAAO,WAAW;CAC7C,MAAM,UAAU,SAAS,MAAM,YAAY;EACzC,eAAe;EACf,kBAAkB;GAAE,oBAAoB;GAAK,cAAc;GAAI;EAChE,CAAC;AACF,QAAO,gBAAgB,SAAS,QAAQ;AACxC,SAAQ,GAAG,QAAQ,OAAO,gBAAgB;AACxC,MAAI,QAAQ,YAAY,KAAK,WAC3B;AAEF,MAAI,UAAU,OAAO;AACnB,UAAO,eAAe,aAAa;AACnC;;AAEF,MAAI,UAAU,UAAU;AACtB,UAAO,eAAe,gBAAgB;AACtC;;AAEF,MAAI,UAAU,SACZ,QAAO,eAAe,gBAAgB;GAExC;;AAGJ,IAAa,6BAAb,MAAwC;CACtC,WAAyC,EAAE;CAE3C,YAAqB,YAA6B;AAChD,OAAK,SAAS,KAAK,QAAQ;;CAG7B,QAAiB,YAA2B;EAC1C,MAAM,WAAW,KAAK,SAAS,OAAO,EAAE;AACxC,QAAM,QAAQ,WAAW,SAAS,IAAI,OAAO,YAAY;AACvD,OAAI;AACF,UAAM,QAAQ,OAAO;WACf;IAGR,CAAC;;;AAIP,SAAgB,4BAA4B,QAGnC;CACP,MAAM,EAAE,UAAU,cAAc;AAChC,KAAI,UACF,qBAAoB,oBAAoB,SAAS"}

package/dist/services/marketplace/service-marketplace-installer.service.d.ts

@@ -0,0 +1,29 @@
+import { MarketplaceInstaller } from "@nextclaw/server";
+
+//#region src/services/marketplace/service-marketplace-installer.service.d.ts
+type UserFacingResult = {
+  message: string;
+  output?: string;
+};
+type BuiltinSkillInstallResult = UserFacingResult | null;
+declare class ServiceMarketplaceInstaller {
+  private readonly deps;
+  constructor(deps: {
+    applyLiveConfigReload?: () => Promise<void>;
+    runCliSubcommand: (args: string[]) => Promise<string>;
+    installBuiltinSkill: (slug: string, force?: boolean) => BuiltinSkillInstallResult;
+  });
+  createInstaller(): MarketplaceInstaller;
+  private installSkill;
+  private installMcp;
+  private updateSkill;
+  private uninstallSkill;
+  private enableMcp;
+  private disableMcp;
+  private removeMcp;
+  private doctorMcp;
+  private createMcpMarketplaceOps;
+}
+//#endregion
+export { ServiceMarketplaceInstaller };
+//# sourceMappingURL=service-marketplace-installer.service.d.ts.map

package/dist/services/marketplace/service-marketplace-installer.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service-marketplace-installer.service.d.ts","names":[],"sources":["../../../src/services/marketplace/service-marketplace-installer.service.ts"],"mappings":";;;KAgBK,gBAAA;EACH,OAAA;EACA,MAAA;AAAA;AAAA,KAGG,yBAAA,GAA4B,gBAAA;AAAA,cAEpB,2BAAA;EAAA,iBAEQ,IAAA;cAAA,IAAA;IACf,qBAAA,SAA8B,OAAA;IAC9B,gBAAA,GAAmB,IAAA,eAAmB,OAAA;IACtC,mBAAA,GAAsB,IAAA,UAAc,KAAA,eAAoB,yBAAA;EAAA;EAI5D,eAAA,CAAA,GAAmB,oBAAA;EAAA,QAaL,YAAA;EAAA,QAkCA,UAAA;EAAA,QAIA,WAAA;EAAA,QAWA,cAAA;EAAA,QAeA,SAAA;EAAA,QAIA,UAAA;EAAA,QAIA,SAAA;EAAA,QAIA,SAAA;EAAA,QAIN,uBAAA;AAAA"}

package/dist/services/marketplace/service-marketplace-installer.service.js

@@ -0,0 +1,87 @@
+import { buildMarketplaceSkillInstallArgs, buildMarketplaceSkillUpdateArgs, pickUserFacingCommandSummary } from "../../utils/marketplace/service-marketplace-helpers.utils.js";
+import { ServiceMcpMarketplaceOps } from "./service-mcp-marketplace-ops.service.js";
+import { getSkillsPath, getWorkspacePath, loadConfig } from "@nextclaw/core";
+import { existsSync, rmSync } from "node:fs";
+import { join } from "node:path";
+//#region src/services/marketplace/service-marketplace-installer.service.ts
+var ServiceMarketplaceInstaller = class {
+	constructor(deps) {
+		this.deps = deps;
+	}
+	createInstaller() {
+		return {
+			installSkill: (params) => this.installSkill(params),
+			updateSkill: (params) => this.updateSkill(params),
+			installMcp: (params) => this.installMcp(params),
+			uninstallSkill: (slug) => this.uninstallSkill(slug),
+			enableMcp: (name) => this.enableMcp(name),
+			disableMcp: (name) => this.disableMcp(name),
+			removeMcp: (name) => this.removeMcp(name),
+			doctorMcp: (name) => this.doctorMcp(name)
+		};
+	}
+	async installSkill(params) {
+		const { force, kind, slug } = params;
+		if (kind === "builtin") {
+			const result = this.deps.installBuiltinSkill(slug, force);
+			if (!result) throw new Error(`Builtin skill not found: ${slug}`);
+			return result;
+		}
+		if (kind && kind !== "marketplace") throw new Error(`Unsupported marketplace skill kind: ${kind}`);
+		const args = buildMarketplaceSkillInstallArgs({
+			slug,
+			workspace: getWorkspacePath(loadConfig().agents.defaults.workspace),
+			force
+		});
+		try {
+			return { message: pickUserFacingCommandSummary(await this.deps.runCliSubcommand(args), `Installed skill: ${slug}`) };
+		} catch (error) {
+			const fallback = this.deps.installBuiltinSkill(slug, force);
+			if (!fallback) throw error;
+			return fallback;
+		}
+	}
+	async installMcp(params) {
+		return await this.createMcpMarketplaceOps().install(params);
+	}
+	async updateSkill(params) {
+		const workspace = getWorkspacePath(loadConfig().agents.defaults.workspace);
+		const output = await this.deps.runCliSubcommand(buildMarketplaceSkillUpdateArgs({
+			slug: params.slug,
+			workspace,
+			force: params.force
+		}));
+		return {
+			message: pickUserFacingCommandSummary(output, `Updated skill: ${params.slug}`),
+			output
+		};
+	}
+	async uninstallSkill(slug) {
+		const targetDir = join(getSkillsPath(getWorkspacePath(loadConfig().agents.defaults.workspace)), slug);
+		if (!existsSync(targetDir)) throw new Error(`Skill not installed in workspace: ${slug}`);
+		rmSync(targetDir, {
+			recursive: true,
+			force: true
+		});
+		return { message: `Uninstalled skill: ${slug}` };
+	}
+	async enableMcp(name) {
+		return await this.createMcpMarketplaceOps().enable(name);
+	}
+	async disableMcp(name) {
+		return await this.createMcpMarketplaceOps().disable(name);
+	}
+	async removeMcp(name) {
+		return await this.createMcpMarketplaceOps().remove(name);
+	}
+	async doctorMcp(name) {
+		return await this.createMcpMarketplaceOps().doctor(name);
+	}
+	createMcpMarketplaceOps() {
+		return new ServiceMcpMarketplaceOps({ applyLiveConfigReload: this.deps.applyLiveConfigReload });
+	}
+};
+//#endregion
+export { ServiceMarketplaceInstaller };
+
+//# sourceMappingURL=service-marketplace-installer.service.js.map

package/dist/services/marketplace/service-marketplace-installer.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"service-marketplace-installer.service.js","names":[],"sources":["../../../src/services/marketplace/service-marketplace-installer.service.ts"],"sourcesContent":["import { getSkillsPath, getWorkspacePath, loadConfig } from \"@nextclaw/core\";\nimport type {\n  MarketplaceInstallSkillParams,\n  MarketplaceInstaller,\n  MarketplaceMcpDoctorResult,\n  MarketplaceMcpInstallRequest\n} from \"@nextclaw/server\";\nimport { existsSync, rmSync } from \"node:fs\";\nimport { join } from \"node:path\";\nimport {\n  buildMarketplaceSkillInstallArgs,\n  buildMarketplaceSkillUpdateArgs,\n  pickUserFacingCommandSummary\n} from \"@nextclaw-service/utils/marketplace/service-marketplace-helpers.utils.js\";\nimport { ServiceMcpMarketplaceOps } from \"@nextclaw-service/services/marketplace/service-mcp-marketplace-ops.service.js\";\n\ntype UserFacingResult = {\n  message: string;\n  output?: string;\n};\n\ntype BuiltinSkillInstallResult = UserFacingResult | null;\n\nexport class ServiceMarketplaceInstaller {\n  constructor(\n    private readonly deps: {\n      applyLiveConfigReload?: () => Promise<void>;\n      runCliSubcommand: (args: string[]) => Promise<string>;\n      installBuiltinSkill: (slug: string, force?: boolean) => BuiltinSkillInstallResult;\n    }\n  ) {}\n\n  createInstaller(): MarketplaceInstaller {\n    return {\n      installSkill: (params) => this.installSkill(params),\n      updateSkill: (params) => this.updateSkill(params),\n      installMcp: (params) => this.installMcp(params),\n      uninstallSkill: (slug) => this.uninstallSkill(slug),\n      enableMcp: (name) => this.enableMcp(name),\n      disableMcp: (name) => this.disableMcp(name),\n      removeMcp: (name) => this.removeMcp(name),\n      doctorMcp: (name) => this.doctorMcp(name)\n    };\n  }\n\n  private async installSkill(params: MarketplaceInstallSkillParams): Promise<UserFacingResult> {\n    const { force, kind, slug } = params;\n    if (kind === \"builtin\") {\n      const result = this.deps.installBuiltinSkill(slug, force);\n      if (!result) {\n        throw new Error(`Builtin skill not found: ${slug}`);\n      }\n      return result;\n    }\n\n    if (kind && kind !== \"marketplace\") {\n      throw new Error(`Unsupported marketplace skill kind: ${kind}`);\n    }\n\n    const workspace = getWorkspacePath(loadConfig().agents.defaults.workspace);\n    const args = buildMarketplaceSkillInstallArgs({\n      slug,\n      workspace,\n      force\n    });\n\n    try {\n      const output = await this.deps.runCliSubcommand(args);\n      const summary = pickUserFacingCommandSummary(output, `Installed skill: ${slug}`);\n      return { message: summary };\n    } catch (error) {\n      const fallback = this.deps.installBuiltinSkill(slug, force);\n      if (!fallback) {\n        throw error;\n      }\n      return fallback;\n    }\n  }\n\n  private async installMcp(params: MarketplaceMcpInstallRequest): Promise<{ name: string; message: string; output?: string }> {\n    return await this.createMcpMarketplaceOps().install(params);\n  }\n\n  private async updateSkill(params: MarketplaceInstallSkillParams): Promise<UserFacingResult> {\n    const workspace = getWorkspacePath(loadConfig().agents.defaults.workspace);\n    const output = await this.deps.runCliSubcommand(buildMarketplaceSkillUpdateArgs({\n      slug: params.slug,\n      workspace,\n      force: params.force\n    }));\n    const summary = pickUserFacingCommandSummary(output, `Updated skill: ${params.slug}`);\n    return { message: summary, output };\n  }\n\n  private async uninstallSkill(slug: string): Promise<UserFacingResult> {\n    const workspace = getWorkspacePath(loadConfig().agents.defaults.workspace);\n    const targetDir = join(getSkillsPath(workspace), slug);\n\n    if (!existsSync(targetDir)) {\n      throw new Error(`Skill not installed in workspace: ${slug}`);\n    }\n\n    rmSync(targetDir, { recursive: true, force: true });\n\n    return {\n      message: `Uninstalled skill: ${slug}`\n    };\n  }\n\n  private async enableMcp(name: string): Promise<UserFacingResult> {\n    return await this.createMcpMarketplaceOps().enable(name);\n  }\n\n  private async disableMcp(name: string): Promise<UserFacingResult> {\n    return await this.createMcpMarketplaceOps().disable(name);\n  }\n\n  private async removeMcp(name: string): Promise<UserFacingResult> {\n    return await this.createMcpMarketplaceOps().remove(name);\n  }\n\n  private async doctorMcp(name: string): Promise<MarketplaceMcpDoctorResult> {\n    return await this.createMcpMarketplaceOps().doctor(name);\n  }\n\n  private createMcpMarketplaceOps(): ServiceMcpMarketplaceOps {\n    return new ServiceMcpMarketplaceOps({\n      applyLiveConfigReload: this.deps.applyLiveConfigReload\n    });\n  }\n}\n"],"mappings":";;;;;;AAuBA,IAAa,8BAAb,MAAyC;CACvC,YACE,MAKA;AALiB,OAAA,OAAA;;CAOnB,kBAAwC;AACtC,SAAO;GACL,eAAe,WAAW,KAAK,aAAa,OAAO;GACnD,cAAc,WAAW,KAAK,YAAY,OAAO;GACjD,aAAa,WAAW,KAAK,WAAW,OAAO;GAC/C,iBAAiB,SAAS,KAAK,eAAe,KAAK;GACnD,YAAY,SAAS,KAAK,UAAU,KAAK;GACzC,aAAa,SAAS,KAAK,WAAW,KAAK;GAC3C,YAAY,SAAS,KAAK,UAAU,KAAK;GACzC,YAAY,SAAS,KAAK,UAAU,KAAK;GAC1C;;CAGH,MAAc,aAAa,QAAkE;EAC3F,MAAM,EAAE,OAAO,MAAM,SAAS;AAC9B,MAAI,SAAS,WAAW;GACtB,MAAM,SAAS,KAAK,KAAK,oBAAoB,MAAM,MAAM;AACzD,OAAI,CAAC,OACH,OAAM,IAAI,MAAM,4BAA4B,OAAO;AAErD,UAAO;;AAGT,MAAI,QAAQ,SAAS,cACnB,OAAM,IAAI,MAAM,uCAAuC,OAAO;EAIhE,MAAM,OAAO,iCAAiC;GAC5C;GACA,WAHgB,iBAAiB,YAAY,CAAC,OAAO,SAAS,UAAU;GAIxE;GACD,CAAC;AAEF,MAAI;AAGF,UAAO,EAAE,SADO,6BADD,MAAM,KAAK,KAAK,iBAAiB,KAAK,EACA,oBAAoB,OAAO,EACrD;WACpB,OAAO;GACd,MAAM,WAAW,KAAK,KAAK,oBAAoB,MAAM,MAAM;AAC3D,OAAI,CAAC,SACH,OAAM;AAER,UAAO;;;CAIX,MAAc,WAAW,QAAmG;AAC1H,SAAO,MAAM,KAAK,yBAAyB,CAAC,QAAQ,OAAO;;CAG7D,MAAc,YAAY,QAAkE;EAC1F,MAAM,YAAY,iBAAiB,YAAY,CAAC,OAAO,SAAS,UAAU;EAC1E,MAAM,SAAS,MAAM,KAAK,KAAK,iBAAiB,gCAAgC;GAC9E,MAAM,OAAO;GACb;GACA,OAAO,OAAO;GACf,CAAC,CAAC;AAEH,SAAO;GAAE,SADO,6BAA6B,QAAQ,kBAAkB,OAAO,OAAO;GAC1D;GAAQ;;CAGrC,MAAc,eAAe,MAAyC;EAEpE,MAAM,YAAY,KAAK,cADL,iBAAiB,YAAY,CAAC,OAAO,SAAS,UAAU,CAC3B,EAAE,KAAK;AAEtD,MAAI,CAAC,WAAW,UAAU,CACxB,OAAM,IAAI,MAAM,qCAAqC,OAAO;AAG9D,SAAO,WAAW;GAAE,WAAW;GAAM,OAAO;GAAM,CAAC;AAEnD,SAAO,EACL,SAAS,sBAAsB,QAChC;;CAGH,MAAc,UAAU,MAAyC;AAC/D,SAAO,MAAM,KAAK,yBAAyB,CAAC,OAAO,KAAK;;CAG1D,MAAc,WAAW,MAAyC;AAChE,SAAO,MAAM,KAAK,yBAAyB,CAAC,QAAQ,KAAK;;CAG3D,MAAc,UAAU,MAAyC;AAC/D,SAAO,MAAM,KAAK,yBAAyB,CAAC,OAAO,KAAK;;CAG1D,MAAc,UAAU,MAAmD;AACzE,SAAO,MAAM,KAAK,yBAAyB,CAAC,OAAO,KAAK;;CAG1D,0BAA4D;AAC1D,SAAO,IAAI,yBAAyB,EAClC,uBAAuB,KAAK,KAAK,uBAClC,CAAC"}

package/dist/services/marketplace/service-mcp-marketplace-ops.service.d.ts

@@ -0,0 +1,40 @@
+import * as _$_nextclaw_mcp0 from "@nextclaw/mcp";
+
+//#region src/services/marketplace/service-mcp-marketplace-ops.service.d.ts
+declare class ServiceMcpMarketplaceOps {
+  private readonly options;
+  constructor(options: {
+    applyLiveConfigReload?: () => Promise<void>;
+  });
+  install(params: {
+    spec: string;
+    name?: string;
+    enabled?: boolean;
+    allAgents?: boolean;
+    agents?: string[];
+    inputs?: Record<string, string>;
+    template?: unknown;
+  }): Promise<{
+    name: string;
+    message: string;
+    output?: string;
+  }>;
+  enable(name: string): Promise<{
+    message: string;
+    output?: string;
+  }>;
+  disable(name: string): Promise<{
+    message: string;
+    output?: string;
+  }>;
+  remove(name: string): Promise<{
+    message: string;
+    output?: string;
+  }>;
+  doctor(name: string): Promise<_$_nextclaw_mcp0.McpDoctorReport>;
+  private createMutationService;
+  private createDoctorFacade;
+}
+//#endregion
+export { ServiceMcpMarketplaceOps };
+//# sourceMappingURL=service-mcp-marketplace-ops.service.d.ts.map

package/dist/services/marketplace/service-mcp-marketplace-ops.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service-mcp-marketplace-ops.service.d.ts","names":[],"sources":["../../../src/services/marketplace/service-mcp-marketplace-ops.service.ts"],"mappings":";;;cAGa,wBAAA;EAAA,iBAEQ,OAAA;cAAA,OAAA;IACf,qBAAA,SAA8B,OAAA;EAAA;EAI5B,OAAA,CAAQ,MAAA;IACZ,IAAA;IACA,IAAA;IACA,OAAA;IACA,SAAA;IACA,MAAA;IACA,MAAA,GAAS,MAAA;IACT,QAAA;EAAA,IACE,OAAA;IAAU,IAAA;IAAc,OAAA;IAAiB,MAAA;EAAA;EA+BvC,MAAA,CAAO,IAAA,WAAe,OAAA;IAAU,OAAA;IAAiB,MAAA;EAAA;EASjD,OAAA,CAAQ,IAAA,WAAe,OAAA;IAAU,OAAA;IAAiB,MAAA;EAAA;EASlD,MAAA,CAAO,IAAA,WAAe,OAAA;IAAU,OAAA;IAAiB,MAAA;EAAA;EASjD,MAAA,CAAO,IAAA,WAAY,OAAA,CATU,gBAAA,CASV,eAAA;EAAA,QAQjB,qBAAA;EAAA,QAOA,kBAAA;AAAA"}

package/dist/services/marketplace/service-mcp-marketplace-ops.service.js

@@ -0,0 +1,69 @@
+import { loadConfig, saveConfig } from "@nextclaw/core";
+import { McpDoctorFacade, McpMutationService } from "@nextclaw/mcp";
+//#region src/services/marketplace/service-mcp-marketplace-ops.service.ts
+var ServiceMcpMarketplaceOps = class {
+	constructor(options) {
+		this.options = options;
+	}
+	async install(params) {
+		if (!params.template) throw new Error(`Missing MCP marketplace template for ${params.spec}`);
+		const template = params.template;
+		const result = this.createMutationService().installFromTemplate({
+			template,
+			name: params.name,
+			enabled: params.enabled,
+			scope: {
+				allAgents: params.allAgents ?? true,
+				agents: params.allAgents === false ? params.agents ?? [] : []
+			},
+			inputs: params.inputs,
+			metadata: {
+				source: "marketplace",
+				catalogSlug: params.spec,
+				displayName: template.defaultName
+			}
+		});
+		if (!result.changed) throw new Error(result.message);
+		await this.options.applyLiveConfigReload?.();
+		return {
+			name: result.name,
+			message: result.message
+		};
+	}
+	async enable(name) {
+		const result = this.createMutationService().toggleEnabled(name, true);
+		if (!result.changed) throw new Error(result.message);
+		await this.options.applyLiveConfigReload?.();
+		return { message: result.message };
+	}
+	async disable(name) {
+		const result = this.createMutationService().toggleEnabled(name, false);
+		if (!result.changed) throw new Error(result.message);
+		await this.options.applyLiveConfigReload?.();
+		return { message: result.message };
+	}
+	async remove(name) {
+		const result = this.createMutationService().removeServer(name);
+		if (!result.changed) throw new Error(result.message);
+		await this.options.applyLiveConfigReload?.();
+		return { message: result.message };
+	}
+	async doctor(name) {
+		const report = await this.createDoctorFacade().inspectOne(name);
+		if (!report) throw new Error(`Unknown MCP server: ${name}`);
+		return report;
+	}
+	createMutationService() {
+		return new McpMutationService({
+			getConfig: () => loadConfig(),
+			saveConfig: (config) => saveConfig(config)
+		});
+	}
+	createDoctorFacade() {
+		return new McpDoctorFacade({ getConfig: () => loadConfig() });
+	}
+};
+//#endregion
+export { ServiceMcpMarketplaceOps };
+
+//# sourceMappingURL=service-mcp-marketplace-ops.service.js.map

package/dist/services/marketplace/service-mcp-marketplace-ops.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"service-mcp-marketplace-ops.service.js","names":[],"sources":["../../../src/services/marketplace/service-mcp-marketplace-ops.service.ts"],"sourcesContent":["import { loadConfig, saveConfig } from \"@nextclaw/core\";\nimport { McpDoctorFacade, McpMutationService, type McpMarketplaceInstallTemplate } from \"@nextclaw/mcp\";\n\nexport class ServiceMcpMarketplaceOps {\n  constructor(\n    private readonly options: {\n      applyLiveConfigReload?: () => Promise<void>;\n    }\n  ) {}\n\n  async install(params: {\n    spec: string;\n    name?: string;\n    enabled?: boolean;\n    allAgents?: boolean;\n    agents?: string[];\n    inputs?: Record<string, string>;\n    template?: unknown;\n  }): Promise<{ name: string; message: string; output?: string }> {\n    if (!params.template) {\n      throw new Error(`Missing MCP marketplace template for ${params.spec}`);\n    }\n\n    const template = params.template as McpMarketplaceInstallTemplate;\n    const result = this.createMutationService().installFromTemplate({\n      template,\n      name: params.name,\n      enabled: params.enabled,\n      scope: {\n        allAgents: params.allAgents ?? true,\n        agents: params.allAgents === false ? params.agents ?? [] : []\n      },\n      inputs: params.inputs,\n      metadata: {\n        source: \"marketplace\",\n        catalogSlug: params.spec,\n        displayName: template.defaultName\n      }\n    });\n    if (!result.changed) {\n      throw new Error(result.message);\n    }\n    await this.options.applyLiveConfigReload?.();\n    return {\n      name: result.name,\n      message: result.message\n    };\n  }\n\n  async enable(name: string): Promise<{ message: string; output?: string }> {\n    const result = this.createMutationService().toggleEnabled(name, true);\n    if (!result.changed) {\n      throw new Error(result.message);\n    }\n    await this.options.applyLiveConfigReload?.();\n    return { message: result.message };\n  }\n\n  async disable(name: string): Promise<{ message: string; output?: string }> {\n    const result = this.createMutationService().toggleEnabled(name, false);\n    if (!result.changed) {\n      throw new Error(result.message);\n    }\n    await this.options.applyLiveConfigReload?.();\n    return { message: result.message };\n  }\n\n  async remove(name: string): Promise<{ message: string; output?: string }> {\n    const result = this.createMutationService().removeServer(name);\n    if (!result.changed) {\n      throw new Error(result.message);\n    }\n    await this.options.applyLiveConfigReload?.();\n    return { message: result.message };\n  }\n\n  async doctor(name: string) {\n    const report = await this.createDoctorFacade().inspectOne(name);\n    if (!report) {\n      throw new Error(`Unknown MCP server: ${name}`);\n    }\n    return report;\n  }\n\n  private createMutationService(): McpMutationService {\n    return new McpMutationService({\n      getConfig: () => loadConfig(),\n      saveConfig: (config) => saveConfig(config)\n    });\n  }\n\n  private createDoctorFacade(): McpDoctorFacade {\n    return new McpDoctorFacade({\n      getConfig: () => loadConfig()\n    });\n  }\n}\n"],"mappings":";;;AAGA,IAAa,2BAAb,MAAsC;CACpC,YACE,SAGA;AAHiB,OAAA,UAAA;;CAKnB,MAAM,QAAQ,QAQkD;AAC9D,MAAI,CAAC,OAAO,SACV,OAAM,IAAI,MAAM,wCAAwC,OAAO,OAAO;EAGxE,MAAM,WAAW,OAAO;EACxB,MAAM,SAAS,KAAK,uBAAuB,CAAC,oBAAoB;GAC9D;GACA,MAAM,OAAO;GACb,SAAS,OAAO;GAChB,OAAO;IACL,WAAW,OAAO,aAAa;IAC/B,QAAQ,OAAO,cAAc,QAAQ,OAAO,UAAU,EAAE,GAAG,EAAE;IAC9D;GACD,QAAQ,OAAO;GACf,UAAU;IACR,QAAQ;IACR,aAAa,OAAO;IACpB,aAAa,SAAS;IACvB;GACF,CAAC;AACF,MAAI,CAAC,OAAO,QACV,OAAM,IAAI,MAAM,OAAO,QAAQ;AAEjC,QAAM,KAAK,QAAQ,yBAAyB;AAC5C,SAAO;GACL,MAAM,OAAO;GACb,SAAS,OAAO;GACjB;;CAGH,MAAM,OAAO,MAA6D;EACxE,MAAM,SAAS,KAAK,uBAAuB,CAAC,cAAc,MAAM,KAAK;AACrE,MAAI,CAAC,OAAO,QACV,OAAM,IAAI,MAAM,OAAO,QAAQ;AAEjC,QAAM,KAAK,QAAQ,yBAAyB;AAC5C,SAAO,EAAE,SAAS,OAAO,SAAS;;CAGpC,MAAM,QAAQ,MAA6D;EACzE,MAAM,SAAS,KAAK,uBAAuB,CAAC,cAAc,MAAM,MAAM;AACtE,MAAI,CAAC,OAAO,QACV,OAAM,IAAI,MAAM,OAAO,QAAQ;AAEjC,QAAM,KAAK,QAAQ,yBAAyB;AAC5C,SAAO,EAAE,SAAS,OAAO,SAAS;;CAGpC,MAAM,OAAO,MAA6D;EACxE,MAAM,SAAS,KAAK,uBAAuB,CAAC,aAAa,KAAK;AAC9D,MAAI,CAAC,OAAO,QACV,OAAM,IAAI,MAAM,OAAO,QAAQ;AAEjC,QAAM,KAAK,QAAQ,yBAAyB;AAC5C,SAAO,EAAE,SAAS,OAAO,SAAS;;CAGpC,MAAM,OAAO,MAAc;EACzB,MAAM,SAAS,MAAM,KAAK,oBAAoB,CAAC,WAAW,KAAK;AAC/D,MAAI,CAAC,OACH,OAAM,IAAI,MAAM,uBAAuB,OAAO;AAEhD,SAAO;;CAGT,wBAAoD;AAClD,SAAO,IAAI,mBAAmB;GAC5B,iBAAiB,YAAY;GAC7B,aAAa,WAAW,WAAW,OAAO;GAC3C,CAAC;;CAGJ,qBAA8C;AAC5C,SAAO,IAAI,gBAAgB,EACzB,iBAAiB,YAAY,EAC9B,CAAC"}

package/dist/services/marketplace/skills-query.service.d.ts

@@ -0,0 +1,110 @@
+import * as _$_nextclaw_kernel0 from "@nextclaw/kernel";
+import { LocalizedTextMap } from "@nextclaw/kernel";
+
+//#region src/services/marketplace/skills-query.service.d.ts
+type MarketplaceSkillSort = "relevance" | "updated";
+type MarketplaceSkillInstallKind = "builtin" | "marketplace";
+type MarketplaceInstallSpec = {
+  kind: MarketplaceSkillInstallKind;
+  spec: string;
+  command: string;
+};
+type MarketplaceSkillItemSummary = {
+  id: string;
+  slug: string;
+  type: "skill";
+  name: string;
+  summary: string;
+  summaryI18n: LocalizedTextMap;
+  tags: string[];
+  author: string;
+  install: MarketplaceInstallSpec;
+  updatedAt: string;
+};
+type MarketplaceSkillItemView = MarketplaceSkillItemSummary & {
+  description?: string;
+  descriptionI18n?: LocalizedTextMap;
+  sourceRepo?: string;
+  homepage?: string;
+  publishedAt: string;
+};
+type MarketplaceSkillContentView = {
+  type: "skill";
+  slug: string;
+  name: string;
+  install: MarketplaceInstallSpec;
+  source: "builtin" | "marketplace" | "remote";
+  raw: string;
+  metadataRaw?: string;
+  bodyRaw: string;
+  sourceUrl?: string;
+};
+type MarketplaceSkillListView = {
+  total: number;
+  page: number;
+  pageSize: number;
+  totalPages: number;
+  sort: MarketplaceSkillSort;
+  query?: string;
+  items: MarketplaceSkillItemSummary[];
+};
+type MarketplaceSkillRecommendationView = {
+  type: "skill";
+  sceneId: string;
+  title: string;
+  description?: string;
+  total: number;
+  items: MarketplaceSkillItemSummary[];
+};
+type MarketplaceSkillsSearchView = MarketplaceSkillListView & {
+  apiBaseUrl: string;
+};
+type MarketplaceSkillInfoView = {
+  apiBaseUrl: string;
+  item: MarketplaceSkillItemView;
+  content: MarketplaceSkillContentView | null;
+  contentUnavailableReason: string | null;
+};
+type MarketplaceSkillsRecommendationResultView = MarketplaceSkillRecommendationView & {
+  apiBaseUrl: string;
+};
+declare class SkillsQueryService {
+  listInstalled: (params: {
+    workdir: string;
+    query?: string;
+    scope?: string;
+  }) => _$_nextclaw_kernel0.InstalledSkillsList;
+  getInstalledInfo: (params: {
+    workdir: string;
+    selector: string;
+  }) => _$_nextclaw_kernel0.InstalledSkillDetail;
+  searchMarketplaceSkills: (params: {
+    apiBaseUrl?: string;
+    query?: string;
+    tag?: string;
+    sort?: string;
+    page?: string | number;
+    pageSize?: string | number;
+  }) => Promise<MarketplaceSkillsSearchView>;
+  getMarketplaceSkillInfo: (params: {
+    apiBaseUrl?: string;
+    slug: string;
+  }) => Promise<MarketplaceSkillInfoView>;
+  recommendMarketplaceSkills: (params: {
+    apiBaseUrl?: string;
+    scene?: string;
+    limit?: string | number;
+  }) => Promise<MarketplaceSkillsRecommendationResultView>;
+  private normalizeMarketplaceSummary;
+  private normalizeMarketplaceItem;
+  private normalizeMarketplaceContent;
+  private normalizeMarketplaceInstallSpec;
+  private normalizeMarketplaceSort;
+  private normalizePositiveInteger;
+  private normalizeRequiredString;
+  private normalizeOptionalString;
+  private fetchMarketplaceView;
+}
+//#endregion
+export { MarketplaceSkillInfoView, MarketplaceSkillsRecommendationResultView, MarketplaceSkillsSearchView, SkillsQueryService };
+//# sourceMappingURL=skills-query.service.d.ts.map