@kikimoradev/kcloud 1.0.3 → 1.0.4

package/dist/main.js

@@ -2687,6 +2687,7 @@ z.object({
 //#endregion
 //#region ../../packages/contracts/src/agent-backups.ts
 const agentBackupTriggers = ["nightly", "manual"];
+const agentBackupUnavailableReasons = ["release_without_export"];
 const agentBackupSchema = z.object({
 	id: idSchema,
 	agentId: idSchema,
@@ -2699,9 +2700,15 @@ const agentBackupSchema = z.object({
 	createdAt: z.iso.datetime(),
 	expiresAt: z.iso.datetime()
 }).meta({ id: "AgentBackup" });
+const agentBackupUnavailableSchema = z.object({
+	reason: z.enum(agentBackupUnavailableReasons),
+	kikimoraVersion: z.string(),
+	requiredVersion: z.string()
+}).meta({ id: "AgentBackupUnavailable" });
 z.object({
 	items: z.array(agentBackupSchema),
-	retentionDays: z.int().positive()
+	retentionDays: z.int().positive(),
+	unavailable: agentBackupUnavailableSchema.nullable()
 }).meta({ id: "AgentBackupList" });
 z.object({ state: z.literal("requested") }).meta({ id: "AgentBackupRequested" });
 z.object({
@@ -2774,6 +2781,7 @@ const archiveSkipReasons = [
 	"special_file",
 	"unreadable"
 ];
+const omittedAgentReasons = ["remote_node", "unplaced"];
 const maxBackupRetentionDays = 3650;
 const maxPlatformSecretLength = 4096;
 const maxHostOperationOutputLength = 4096;
@@ -2968,6 +2976,12 @@ const archivedAgentSchema = z.object({
 	message: "expected no more listed skipped files than skippedTotal",
 	path: ["skippedTotal"]
 });
+const omittedAgentSchema = z.object({
+	agentId: idSchema,
+	slug: slugSchema,
+	nodeId: idSchema.nullable(),
+	reason: z.enum(omittedAgentReasons)
+});
 z.object({
 	version: z.literal(1),
 	backupId: idSchema,
@@ -2980,7 +2994,8 @@ z.object({
 	cipher: z.literal(backupCipher),
 	parts: z.array(backupPartSchema).refine(everyPartOnce, { message: `expected exactly the parts ${backupPartNames.join(", ")}` }),
 	database: z.object({ pgVersion: z.string().min(1) }),
-	agents: z.array(archivedAgentSchema)
+	agents: z.array(archivedAgentSchema),
+	omitted: z.array(omittedAgentSchema).default([])
 });
 const hostOperationSchema = z.object({
 	id: idSchema,
@@ -4247,7 +4262,9 @@ const restoredAgent = async (api, agentId, { backupId, name, node, slug }) => {
 	}), restoreHints);
 };
 const keptFor = (days) => `A backup is kept for ${String(days)} ${days === 1 ? "day" : "days"}.`;
-const backupsTable = ({ items, retentionDays }) => items.length === 0 ? `The agent has no backup yet. ${keptFor(retentionDays)}` : [renderTable([
+const unavailableNote = ({ unavailable }) => unavailable?.reason === "release_without_export" ? [`Kikimora ${unavailable.kikimoraVersion} cannot export the memory of the agent, so its node backs nothing up. Backups need ${unavailable.requiredVersion} or newer: move the agent with kcloud agents set, then kcloud agents update.`] : [];
+const backupsTable = (list) => [...unavailableNote(list), backupListing(list)].join("\n");
+const backupListing = ({ items, retentionDays }) => items.length === 0 ? `The agent has no backup yet. ${keptFor(retentionDays)}` : [renderTable([
 	{ header: "CREATED" },
 	{ header: "TRIGGER" },
 	{ header: "NODE" },
@@ -6783,7 +6800,7 @@ const agentBackupTools = [
 	defineTool({
 		name: "agent_backups_list",
 		title: "List the backups of an agent",
-		description: "List the backups of the memory of an agent, the newest first, with their trigger, node, Kikimora release, entries, size and expiry, and the days a backup is kept.",
+		description: "List the backups of the memory of an agent, the newest first, with their trigger, node, Kikimora release, entries, size and expiry, the days a backup is kept, and in unavailable why the node makes none, such as a Kikimora release that exports no memory.",
 		operations: ["listAgentBackups"],
 		safety: "read",
 		input: z.object(agentFields),

package/package.json

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