@kikimoradev/kcloud 0.9.0 → 0.11.0

package/dist/main.js

@@ -947,11 +947,16 @@ const errorCodes = Object.keys({
 	"runtime.control_tampered": "rule_violation",
 	"runtime.workspace_tampered": "rule_violation",
 	"runtime.sandbox_unavailable": "rule_violation",
+	"runtime.monitor_paused": "conflict",
+	"runtime.monitor_draining": "conflict",
+	"runtime.monitor_limited": "conflict",
+	"runtime.monitor_check_unsupported": "rule_violation",
 	"stream.too_many": "rate_limited",
 	"infrastructure.not_configured": "rule_violation",
 	"infrastructure.provider_error": "internal",
 	"infrastructure.operation_in_progress": "conflict",
 	"infrastructure.host_ops_disabled": "rule_violation",
+	"infrastructure.backups_unavailable": "rule_violation",
 	"infrastructure.maintenance_in_progress": "conflict",
 	"infrastructure.maintenance_not_in_progress": "conflict",
 	"backup.not_found": "not_found",
@@ -1034,6 +1039,7 @@ const storageStates = [
 	"blocked",
 	"unknown"
 ];
+const runtimeEngineKinds = ["docker", "native"];
 const dockerStates = [
 	"ok",
 	"unavailable",
@@ -1074,6 +1080,7 @@ const degradedAgentSchema = z.object({
 z.object({
 	status: z.enum(runtimeHealthStates),
 	database: z.object({ ok: z.boolean() }),
+	engine: z.enum(runtimeEngineKinds),
 	docker: z.object({
 		state: z.enum(dockerStates),
 		lastError: z.string().nullable(),
@@ -1172,6 +1179,10 @@ z.object({
 	title: z.string().trim().min(1).max(200).optional(),
 	description: z.string().trim().min(1).max(maxTaskDescriptionLength)
 }).meta({ id: "AddAgentTaskBody" });
+z.object({
+	state: z.enum(["requested", "running"]),
+	cycle: z.int().nonnegative().nullable()
+}).meta({ id: "MonitorCheck" });
 z.object({ status: taskStatusSchema.optional() });
 z.object({
 	id: idSchema,
@@ -2404,6 +2415,7 @@ const registryUnavailableSchema = z.object({
 	detail: z.string().nullable()
 }).meta({ id: "RegistryUnavailable" });
 const hostOperationsAvailabilities = ["enabled", "disabled"];
+const backupsAvailabilities = ["enabled", "unavailable"];
 const installedImageSchema = z.string().regex(pinnedPlatformImagePattern).nullable();
 z.object({
 	version: z.string(),
@@ -2417,6 +2429,7 @@ z.object({
 	expectedScriptsVersion: z.string(),
 	imagePrefix: z.string(),
 	hostOperations: z.enum(hostOperationsAvailabilities),
+	backups: z.enum(backupsAvailabilities),
 	operations: z.array(hostOperationSchema)
 }).meta({ id: "Platform" });
 const keyVersionSchema = z.int().positive();
@@ -2463,10 +2476,15 @@ const hostPointSchema = z.object({
 	memoryUsedBytesAvg: byteCountSchema,
 	memoryUsedBytesMax: byteCountSchema,
 	memoryTotalBytes: byteCountSchema,
-	load1Avg: z.number().nonnegative(),
+	load1Avg: z.number().nonnegative().nullable(),
 	diskRootUsedRatio: hostRatioSchema.nullable(),
 	diskDataUsedRatio: hostRatioSchema.nullable(),
-	diskAgentsUsedRatio: hostRatioSchema.nullable()
+	diskAgentsUsedRatio: hostRatioSchema.nullable(),
+	gpuUtilRatioAvg: hostRatioSchema.nullable(),
+	gpuUtilRatioMax: hostRatioSchema.nullable(),
+	gpuMemoryUsedBytesAvg: byteCountSchema.nullable(),
+	gpuMemoryUsedBytesMax: byteCountSchema.nullable(),
+	gpuMemoryTotalBytes: byteCountSchema.nullable()
 }).meta({ id: "HostPoint" });
 const containerPointSchema = z.object({
 	ts: instantSchema,
@@ -3191,43 +3209,22 @@ const createWhoamiCommand = (adaptersOf) => defineCommand({
 	}
 });
 //#endregion
-//#region src/render/body.ts
-const isTerminal$1 = (stream) => stream.isTTY === true;
-const pipedText$1 = async (stream) => {
-	const chunks = [];
-	for await (const chunk of stream) chunks.push(Buffer.from(chunk));
-	return Buffer.concat(chunks).toString("utf8");
-};
-const fileOptions = { file: { type: "string" } };
-const fileUsage = (what) => [["--file <path>", `read ${what} from a JSON file, or from stdin with -`]];
-const documentOf = async (run, file) => {
-	const text = file === "-" ? isTerminal$1(run.context.io.stdin) ? "" : await pipedText$1(run.context.io.stdin) : await readFileOrRefuse(resolve(run.context.workingDirectory, file));
-	if (text.trim() === "") throw new UsageError(file === "-" ? "Nothing is piped on stdin." : `${file} is empty.`);
-	try {
-		return JSON.parse(text);
-	} catch {
-		throw new CliError(`${file === "-" ? "stdin" : file} is not JSON.`);
-	}
-};
-const readFileOrRefuse = async (path) => {
-	try {
-		return await readFile(path, "utf8");
-	} catch {
-		throw new CliError(`${path} could not be read.`);
-	}
-};
-const validated = (schema, document, what) => {
-	const parsed = schema.safeParse(document);
-	if (!parsed.success) throw new CliError(`That is not ${what}.`, z.prettifyError(parsed.error));
-};
-//#endregion
-//#region src/render/confirm.ts
-const confirmed = async ({ prompt, settings, question }) => {
-	if (settings.yes) return;
-	if (!await prompt.confirm({
-		message: question,
-		initialValue: false
-	})) throw new CancelledError("Nothing was changed.");
+//#region src/commands/run.ts
+const runOf = async (adaptersOf, { settings, context }) => {
+	const adapters = adaptersOf(context);
+	const session = await openSession({
+		settings,
+		context,
+		api: adapters.api
+	});
+	return {
+		api: session.api,
+		origin: session.origin,
+		adapters,
+		prompt: adapters.prompter(settings),
+		settings,
+		context
+	};
 };
 //#endregion
 //#region src/resolve.ts
@@ -3264,24 +3261,6 @@ const resolveAgentId = async (api, reference, project) => {
 	return first.agent.id;
 };
 //#endregion
-//#region src/commands/run.ts
-const runOf = async (adaptersOf, { settings, context }) => {
-	const adapters = adaptersOf(context);
-	const session = await openSession({
-		settings,
-		context,
-		api: adapters.api
-	});
-	return {
-		api: session.api,
-		origin: session.origin,
-		adapters,
-		prompt: adapters.prompter(settings),
-		settings,
-		context
-	};
-};
-//#endregion
 //#region src/commands/agents/shared.ts
 const agentOption = { project: { type: "string" } };
 const agentUsage = [["--project <name>", "the project of the agent, when the agent is named alone"]];
@@ -3297,6 +3276,72 @@ const agentFrom = async (run, reference, project) => {
 	return resolveAgentId(run.api, reference, project);
 };
 //#endregion
+//#region src/commands/agents/check.ts
+const checkHints = {
+	...agentHints,
+	"runtime.control_unreachable": "The worker is not answering; kcloud agents show <agent> tells whether it runs.",
+	"runtime.monitor_paused": "kcloud agents resume <agent> lets the agent work again.",
+	"runtime.monitor_draining": "The agent stops after its current session; start it again to run a cycle.",
+	"runtime.monitor_limited": "The Claude usage limit holds; the monitor runs its next cycle once it resets.",
+	"runtime.monitor_check_unsupported": "Move the agent to Kikimora 0.10.0 or newer with kcloud agents set, then kcloud agents update."
+};
+const checkCommand = (adaptersOf) => defineCommand({
+	name: "check",
+	summary: "Run a monitor cycle now instead of waiting for the interval.",
+	usage: "agents check <agent> [--project <name>]",
+	optionsUsage: agentUsage,
+	options: agentOption,
+	positionals: {
+		min: 1,
+		max: 1
+	},
+	run: async (invocation) => {
+		const run = await runOf(adaptersOf, invocation);
+		const agentId = await agentFrom(run, invocation.positionals[0], invocation.values.project);
+		const check = dataOf("check the monitor", await run.api.POST("/agents/{id}/monitor/check", { params: { path: { id: agentId } } }), checkHints);
+		return printed(run, check, (answer) => answer.state === "running" ? `Monitor cycle ${String(answer.cycle)} is already running.` : "Monitor cycle requested; it starts now, also outside the active hours.");
+	}
+});
+//#endregion
+//#region src/render/body.ts
+const isTerminal$1 = (stream) => stream.isTTY === true;
+const pipedText$1 = async (stream) => {
+	const chunks = [];
+	for await (const chunk of stream) chunks.push(Buffer.from(chunk));
+	return Buffer.concat(chunks).toString("utf8");
+};
+const fileOptions = { file: { type: "string" } };
+const fileUsage = (what) => [["--file <path>", `read ${what} from a JSON file, or from stdin with -`]];
+const documentOf = async (run, file) => {
+	const text = file === "-" ? isTerminal$1(run.context.io.stdin) ? "" : await pipedText$1(run.context.io.stdin) : await readFileOrRefuse(resolve(run.context.workingDirectory, file));
+	if (text.trim() === "") throw new UsageError(file === "-" ? "Nothing is piped on stdin." : `${file} is empty.`);
+	try {
+		return JSON.parse(text);
+	} catch {
+		throw new CliError(`${file === "-" ? "stdin" : file} is not JSON.`);
+	}
+};
+const readFileOrRefuse = async (path) => {
+	try {
+		return await readFile(path, "utf8");
+	} catch {
+		throw new CliError(`${path} could not be read.`);
+	}
+};
+const validated = (schema, document, what) => {
+	const parsed = schema.safeParse(document);
+	if (!parsed.success) throw new CliError(`That is not ${what}.`, z.prettifyError(parsed.error));
+};
+//#endregion
+//#region src/render/confirm.ts
+const confirmed = async ({ prompt, settings, question }) => {
+	if (settings.yes) return;
+	if (!await prompt.confirm({
+		message: question,
+		initialValue: false
+	})) throw new CancelledError("Nothing was changed.");
+};
+//#endregion
 //#region src/commands/agents/plan.ts
 const agentPlanOf = (agent) => ({
 	name: agent.name,
@@ -4477,6 +4522,7 @@ const createAgentsCommand = (adaptersOf) => defineGroup({
 		...configCommands(adaptersOf),
 		createCommand(adaptersOf),
 		...lifecycleCommands(adaptersOf),
+		checkCommand(adaptersOf),
 		tasksCommand(adaptersOf),
 		...observabilityCommands(adaptersOf),
 		...streamCommands(adaptersOf)
@@ -5081,6 +5127,15 @@ const agentTools = [
 		}),
 		run: async ({ action, ...reference }, run) => actionOn(run, await agentIdOf(run, reference), action, false)
 	}),
+	defineTool({
+		name: "agent_check",
+		title: "Run a monitor cycle now",
+		description: "Ask the monitor of an agent to look for work now instead of waiting for its interval, also outside its active hours. state requested means a cycle starts at once; running names the cycle already in progress. A paused, stopping or usage-limited monitor refuses with an error.",
+		operations: ["checkAgentMonitor"],
+		safety: "write",
+		input: z.object(agentFields),
+		run: async (reference, run) => dataOf("check the monitor", await run.api.POST("/agents/{id}/monitor/check", { params: { path: { id: await agentIdOf(run, reference) } } }), checkHints)
+	}),
 	defineTool({
 		name: "agent_interrupt",
 		title: "Stop, reset or cancel an agent",

package/package.json

@@ -15,7 +15,7 @@
   "publishConfig": {
     "access": "public"
   },
-  "version": "0.9.0",
+  "version": "0.11.0",
   "dependencies": {
     "@clack/prompts": "1.8.1",
     "@modelcontextprotocol/server": "2.1.0",