@kikimoradev/kcloud 0.9.0 → 0.10.0

package/dist/main.js

@@ -947,6 +947,10 @@ 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",
@@ -1172,6 +1176,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,
@@ -3191,43 +3199,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 +3251,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 +3266,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 +4512,7 @@ const createAgentsCommand = (adaptersOf) => defineGroup({
 		...configCommands(adaptersOf),
 		createCommand(adaptersOf),
 		...lifecycleCommands(adaptersOf),
+		checkCommand(adaptersOf),
 		tasksCommand(adaptersOf),
 		...observabilityCommands(adaptersOf),
 		...streamCommands(adaptersOf)
@@ -5081,6 +5117,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.10.0",
   "dependencies": {
     "@clack/prompts": "1.8.1",
     "@modelcontextprotocol/server": "2.1.0",