@kikimoradev/kcloud 1.5.1 → 1.5.3

package/dist/main.js

@@ -1130,7 +1130,9 @@ const agentProvisionSchema = z.object({
 			"ok",
 			"fetch_failed",
 			"clone_failed"
-		])
+		]),
+		brokenCloneMovedTo: z.string().optional(),
+		locksKeptForSandbox: z.array(z.string()).optional()
 	})),
 	docker: z.enum([
 		"ready",
@@ -1151,6 +1153,10 @@ const agentProgressSchema = z.object({
 	layersTotal: z.int().nonnegative().nullable(),
 	updatedAt: z.iso.datetime()
 }).meta({ id: "AgentProgress" });
+const agentClaudeCodeSchema = z.object({
+	version: z.string().nullable(),
+	source: z.enum(["release", "host"])
+}).meta({ id: "AgentClaudeCode" });
 const storageStates = [
 	"ok",
 	"warning",
@@ -1602,11 +1608,13 @@ const agentAdmissionSchema = z.object({
 	monitor: agentAdmissionStateSchema.nullable(),
 	executor: agentAdmissionStateSchema.nullable()
 }).meta({ id: "AgentAdmission" });
+const nodeUpdateAwaits = ["start", "end"];
 const admissionHoldSchema = z.object({
 	pools: z.array(sessionRoleSchema),
 	sessions: z.int().nonnegative(),
 	target: z.string().nullable(),
-	updating: z.boolean()
+	updating: z.boolean(),
+	awaits: z.enum(nodeUpdateAwaits)
 }).meta({ id: "AdmissionHold" });
 const nodeStateSchema = z.enum([
 	"pending",
@@ -1679,7 +1687,12 @@ const poolUsageSchema = z.object({
 	memoryMaxBytes: z.int().nonnegative().nullable(),
 	cpus: z.number().nonnegative().nullable(),
 	memoryKills: z.int().nonnegative(),
-	processors: z.int().positive().nullable().optional()
+	processors: z.int().positive().nullable().optional(),
+	earlierRun: z.object({
+		memoryBytes: z.int().nonnegative().nullable(),
+		holds: z.boolean()
+	}).meta({ id: "EarlierPoolRun" }).nullable().optional(),
+	limitRaised: z.boolean().optional()
 }).meta({ id: "PoolUsage" });
 const nodePoolSchema = z.object({
 	slots: z.int().nonnegative(),
@@ -1790,6 +1803,7 @@ const nodeUpdateSchema = z.object({
 	sessions: z.int().nonnegative(),
 	since: z.iso.datetime().nullable(),
 	held: z.array(sessionRoleSchema),
+	awaits: z.enum(nodeUpdateAwaits),
 	last: z.object({
 		outcome: z.enum([
 			"updated",
@@ -1808,6 +1822,8 @@ const nodeAgentSchema = z.object({
 	projectId: idSchema,
 	projectName: z.string(),
 	state: agentStateSchema,
+	failureReason: z.string().nullable(),
+	retryAt: z.iso.datetime().nullable(),
 	poolLimit: poolLimitSchema.nullable()
 }).meta({ id: "NodeAgent" });
 const nodeRuntimeSchema = z.object({
@@ -2687,7 +2703,8 @@ const agentRuntimeSchema = z.object({
 	stopDeadlineAt: z.iso.datetime().nullable(),
 	admission: agentAdmissionSchema.nullable(),
 	admissionHold: admissionHoldSchema.nullable(),
-	poolLimit: poolLimitSchema.nullable()
+	poolLimit: poolLimitSchema.nullable(),
+	claudeCode: agentClaudeCodeSchema.nullable()
 }).meta({ id: "AgentRuntime" });
 const agentListItemSchema = z.object({
 	id: idSchema,
@@ -4507,7 +4524,11 @@ const sessionFailures = {
 	launcherRefused: "refused by the session starter"
 };
 const sessionFailureText = (reason) => reason === null ? "-" : sessionFailures[reason] ?? reason;
-const unsupportedReasons = { node_outdated: "the node runs a version that reports no pools" };
+const unsupportedReasons = {
+	node_outdated: "the node runs a version that reports no pools",
+	configure_failed: "the host did not take the limits",
+	configure_failing: "the node keeps failing to apply the limits, so sessions run without them until it succeeds"
+};
 const enforcementText = ({ state, reason }) => {
 	switch (state) {
 		case "enforced": return "The node holds each pool to the CPU and memory of its split.";
@@ -4538,6 +4559,12 @@ const memoryOf$1 = (pool) => {
 	return memoryMaxBytes === null ? bytesOf(memoryBytes) : `${bytesOf(memoryBytes)} of ${bytesOf(memoryMaxBytes)}`;
 };
 const roles = ["monitor", "executor"];
+const earlierRunTexts = (pools) => roles.flatMap((role) => {
+	const earlier = pools[role].usage?.earlierRun ?? null;
+	if (earlier === null) return [];
+	return [`The ${role} pool shares its memory with the sessions of the earlier run of the node, which use ${earlier.memoryBytes === null ? "an unknown amount" : bytesOf(earlier.memoryBytes)}${earlier.holds ? "; new sessions wait until they end" : ""}.`];
+});
+const limitRaisedTexts = (pools) => roles.filter((role) => pools[role].usage?.limitRaised === true).map((role) => `The ${role} pool keeps its memory limit above its share while its sessions use more; new sessions wait until they use less.`);
 const workOf = (role, { taskId, taskTitle, readable }) => {
 	if (readable === false) return "another project";
 	if (taskId === null) return role === "monitor" ? "monitor cycle" : "-";
@@ -4593,6 +4620,8 @@ const poolsText = (pools, split) => {
 		...pools.agentsSlice == null ? [] : [agentsSliceText(pools.agentsSlice)],
 		...pools.refused == null ? [] : [refusedText(pools.refused)],
 		...pools.layout == null ? [] : layoutTexts(pools.layout, split),
+		...earlierRunTexts(pools),
+		...limitRaisedTexts(pools),
 		renderTable([
 			{ header: "POOL" },
 			{ header: "SLOTS IN USE" },
@@ -4693,6 +4722,11 @@ const agentsOf = async (scope, project) => {
 	}
 	return listed;
 };
+const changeTakingActions = ["start", "update"];
+const changeTakerOf = ({ availableActions }) => {
+	const takers = changeTakingActions.filter((action) => availableActions.includes(action)).map((action) => `kcloud agents ${action}`);
+	return takers.length === 0 ? "a restart" : takers.join(" or ");
+};
 const changedAgent = async (api, agentId, document) => {
 	const current = dataOf("describe the agent", await api.GET("/agents/{id}", { params: { path: { id: agentId } } }), agentHints);
 	const change = typeof document === "object" && document !== null && "version" in document ? document : {
@@ -4784,7 +4818,7 @@ const configCommands = (adaptersOf) => [
 			const file = invocation.values.file;
 			if (file === void 0) throw new UsageError("agents set needs --file <path>.", "The file holds the sections to change; kcloud agents show <agent> --json shows the current ones.");
 			const agent = await changedAgent(run.api, agentId, agentChangeWithoutLimits(run, await documentOf(run, file)));
-			return printed(run, agent, (changed) => changed.restartRequired ? `Changed ${changed.name}; it needs kcloud agents update to take the change.` : `Changed ${changed.name}.`);
+			return printed(run, agent, (changed) => changed.restartRequired ? `Changed ${changed.name}; it needs ${changeTakerOf(changed)} to take the change.` : `Changed ${changed.name}.`);
 		}
 	}),
 	defineCommand({
@@ -4831,13 +4865,22 @@ const admissionRowsOf = (agent) => {
 const admissionHoldRowsOf = ({ runtime }) => {
 	const hold = runtime.admissionHold;
 	if (hold == null) return [];
-	if (hold.updating) return [["admissions", `held while the node updates to ${hold.target ?? "-"}`]];
+	if (hold.updating || hold.awaits === "start") return [["admissions", `held while the node updates to ${hold.target ?? "-"}`]];
 	const all = hold.pools.includes("monitor");
 	const noun = all ? "session" : "executor session";
 	const waits = `${String(hold.sessions)} ${noun}${hold.sessions === 1 ? "" : "s"}`;
 	return [["admissions", `${all ? "held" : "executor held"} for the node update to ${hold.target ?? "-"}, waiting for ${waits}`]];
 };
 const poolLimitRowsOf = ({ runtime }) => runtime.poolLimit === null ? [] : [["pool limit", poolLimitText(runtime.poolLimit)]];
+const claudeCodeOf = ({ runtime, release }) => {
+	const running = runtime.claudeCode ?? null;
+	if (running?.source === "host") return "host";
+	return running?.version ?? release?.claudeCodeVersion ?? "unknown";
+};
+const failureRowsOf = ({ failureReason, retryAt }) => {
+	if (failureReason === null) return [];
+	return [["failure", retryAt === null ? failureReason : `${failureReason}, retry at ${retryAt}`]];
+};
 const detailsOf = (agent) => [
 	renderTable([{ header: "FIELD" }, { header: "VALUE" }], [
 		["name", agent.name],
@@ -4846,6 +4889,7 @@ const detailsOf = (agent) => [
 		["wanted", agent.desiredState],
 		["observed", agent.observedState],
 		["release", agent.kikimoraVersion],
+		["claude code", claudeCodeOf(agent)],
 		["node", agent.node === null ? "none" : `${agent.node.name} (${agent.node.state})`],
 		["requires", agent.requiredCapabilities.length === 0 ? "nothing" : agent.requiredCapabilities.join(", ")],
 		["timezone", agent.timezone],
@@ -4854,6 +4898,7 @@ const detailsOf = (agent) => [
 		["browser", agent.machine.browser ? "yes" : "no"],
 		["container", agent.runtime.containerId ?? "none"],
 		["health", agent.runtime.health],
+		...failureRowsOf(agent),
 		...admissionRowsOf(agent),
 		...admissionHoldRowsOf(agent),
 		...poolLimitRowsOf(agent),
@@ -6675,7 +6720,7 @@ const agentTools = [
 	defineTool({
 		name: "agent_update",
 		title: "Change an agent",
-		description: "Change sections of an agent. Without version the change applies to the version read just before it. When restartRequired comes back true, agent_action update applies the change.",
+		description: "Change sections of an agent. Without version the change applies to the version read just before it. When restartRequired comes back true, agent_action start or update applies the change, whichever availableActions offers.",
 		operations: ["updateAgent"],
 		safety: "write",
 		input: z.object({
@@ -6713,7 +6758,7 @@ const agentTools = [
 	defineTool({
 		name: "agent_action",
 		title: "Start, pause, resume, restart or update an agent",
-		description: "start lets the agent work, pause holds it between sessions, resume lets a paused agent work again, restart restarts its container, update replaces the container to apply pending changes. The agent returns with the actions it takes next.",
+		description: "start lets the agent work and applies pending changes, pause holds it between sessions, resume lets a paused agent work again, restart restarts its container, update replaces the container to apply pending changes. The agent returns with the actions it takes next.",
 		operations: ["runAgentAction"],
 		safety: "write",
 		input: z.object({
@@ -9923,7 +9968,9 @@ const updateOf = ({ update }) => {
 	if (update === null) return "not reported";
 	switch (update.state) {
 		case "current": return "current";
-		case "waiting": return heldPoolsOf(update).includes("monitor") ? `admissions held for ${update.target ?? "-"}, waits for ${sessionsText(update.sessions, "session")}` : `executor admissions held for ${update.target ?? "-"}, waits for ${sessionsText(update.sessions, "executor session")}; monitors go on until the executor pool is empty`;
+		case "waiting":
+			if (update.awaits === "start") return `admissions held while the node updates to ${update.target ?? "-"}`;
+			return heldPoolsOf(update).includes("monitor") ? `admissions held for ${update.target ?? "-"}, waits for ${sessionsText(update.sessions, "session")}` : `executor admissions held for ${update.target ?? "-"}, waits for ${sessionsText(update.sessions, "executor session")}; monitors go on until the executor pool is empty`;
 		case "updating": return `updating to ${update.target ?? "-"}`;
 		case "failed": return `failed to reach ${update.target ?? "-"}, runs its previous version`;
 		case "unmanaged": return "updated with its platform";
@@ -9935,6 +9982,10 @@ const lastUpdateOf = ({ update }) => {
 	const outcome = `${last.outcome} ${last.version ?? "-"} at ${last.at}`;
 	return last.reason === null ? outcome : `${outcome}: ${last.reason}`;
 };
+const agentFailuresOf = ({ agents }) => agents.flatMap(({ slug, failureReason, retryAt }) => {
+	if (failureReason === null) return [];
+	return [`${slug} failure: ${retryAt === null ? failureReason : `${failureReason}, retry at ${retryAt}`}`];
+});
 const nodeDetailsText = (node) => [
 	renderTable([{ header: "FIELD" }, { header: "VALUE" }], [
 		["name", node.name],
@@ -9973,6 +10024,7 @@ const nodeDetailsText = (node) => [
 		poolLimitText(agent.poolLimit),
 		agent.id
 	])),
+	...agentFailuresOf(node),
 	"",
 	...node.runtime === null ? ["The node has reported no runtime yet."] : [
 		renderTable([{ header: "RUNTIME" }, { header: "VALUE" }], runtimeRowsOf(node.runtime, node.engine)),

package/package.json

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