kiku-agent 1.0.8 → 1.0.9

package/README.md

@@ -87,7 +87,7 @@ Automatic installation is available for global npm installs. Source checkouts, l
 
 After an update or rollback, restart `kiku-agent` and any application hosting `kiku-mcp`. Update settings and rollback history are stored in the normal Kiku user data directory as `update-state.json`; sessions, memory, `.env`, and YouTube cookies are not modified.
 
-For a local checkout before the package is published, use `npm pack` followed by `npm install -g ./kiku-agent-1.0.8.tgz`.
+For a local checkout before the package is published, use `npm pack` followed by `npm install -g ./kiku-agent-1.0.9.tgz`.
 
 ### ✨ Features
 - **LM Studio Integration**: Connects seamlessly to LM Studio's OpenAI-compatible server at `http://127.0.0.1:1234/v1` (default model `google/gemma-4-e4b`, with auto-detection of loaded models).

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kiku-agent",
-  "version": "1.0.8",
+  "version": "1.0.9",
   "description": "Kiku AI terminal agent and MCP server for Ju Jingyi knowledge, media, and career data.",
   "license": "GPL-3.0",
   "type": "module",
@@ -29,10 +29,10 @@
   "kikuUpdate": {
     "channel": "stable",
     "releaseSummary": [
+      "Added graceful 404 error handling for unpublished channels and non-existent version lookups",
+      "Enhanced CLI update diagnostics with active release channel switching guidance",
       "Updated production model defaults and live fallback resolution across cloud providers",
-      "Hardened REST API key validation and isolated rate-limit probes",
-      "Fixed discography filtering, MCP configuration isolation, and environment loading order",
-      "Secured YouTube iframe messaging and expanded provider and API regression coverage"
+      "Hardened REST API key validation and isolated rate-limit probes"
     ],
     "releaseUrl": "https://www.npmjs.com/package/kiku-agent"
   },

package/server/agent/commands.js

@@ -1957,12 +1957,16 @@ export const handlers = {
           return 'HANDLED';
         }
         const channel = await manager.setChannel(requested);
+        const lines = [
+          `${C.emerald}[OK] Future /update checks will use ${C.bold}${channel}${C.reset}${C.emerald}.${C.reset}`,
+        ];
+        if (channel !== 'latest') {
+          lines.push(`${C.amber}[NOTE] The "${channel}" channel may not have published builds on npm yet.${C.reset}`);
+        }
+        lines.push(`${C.dim}This changes only the release channel; it does not install anything.${C.reset}`);
         printSolidPanel({
           title: 'Update Channel Changed',
-          lines: [
-            `${C.emerald}[OK] Future /update checks will use ${C.bold}${channel}${C.reset}${C.emerald}.${C.reset}`,
-            `${C.dim}This changes only the release channel; it does not install anything.${C.reset}`,
-          ],
+          lines,
         });
         return 'HANDLED';
       }
@@ -2047,12 +2051,16 @@ export const handlers = {
       return 'HANDLED';
     } catch (error) {
       const safeMessage = error instanceof UpdateError ? error.message : 'The update operation failed unexpectedly.';
+      const lines = [
+        `${C.red}[${error.code || 'UPDATE_ERROR'}] ${safeMessage}${C.reset}`,
+      ];
+      if (error.code === 'CHANNEL_NOT_FOUND') {
+        lines.push(`${C.gold}Tip:${C.reset} ${C.white}Run ${C.bold}/update channel latest${C.reset}${C.white} to return to the active release channel.${C.reset}`);
+      }
+      lines.push(`${C.dim}No session, memory, or environment files were changed.${C.reset}`);
       printSolidPanel({
         title: 'Update Failed',
-        lines: [
-          `${C.red}[${error.code || 'UPDATE_ERROR'}] ${safeMessage}${C.reset}`,
-          `${C.dim}No session, memory, or environment files were changed.${C.reset}`,
-        ],
+        lines,
       });
       return 'HANDLED';
     }

package/server/agent/updateManager.js

@@ -24,11 +24,14 @@ export class UpdateError extends Error {
 }
 
 function cleanOutput(value, maxLength = 400) {
-  return String(value || '')
+  const text = String(value || '')
     .replace(/\x1b(?:\[[0-?]*[ -/]*[@-~]|\][^\x07]*(?:\x07|\x1b\\))/g, '')
     .replace(/[\x00-\x08\x0b\x0c\x0e-\x1f\x7f]/g, '')
-    .trim()
-    .slice(0, maxLength);
+    .split('\n')
+    .map(line => line.replace(/^npm\s+(?:error|ERR!)\s*/i, '').trim())
+    .filter(Boolean)
+    .join(' ');
+  return text.slice(0, maxLength);
 }
 
 function parseSemver(value) {
@@ -281,6 +284,21 @@ export class UpdateManager {
     const spec = `${this.packageName}@${normalizedTarget}`;
     const result = await this.runner(['view', spec, '--json', '--prefer-online'], { timeoutMs: DEFAULT_TIMEOUT_MS });
     if (result.code !== 0) {
+      const errText = String(result.stderr || '');
+      if (/E404|404\s+No match found|No match found for version|not found|404\s+Not\s+Found/i.test(errText)) {
+        if (UPDATE_CHANNELS.includes(normalizedTarget)) {
+          throw new UpdateError(
+            `No release is currently available for channel "${normalizedTarget}" on npm. (Only "latest" is currently published).`,
+            'CHANNEL_NOT_FOUND',
+            { target: normalizedTarget, exitCode: result.code }
+          );
+        }
+        throw new UpdateError(
+          `Version or tag "${normalizedTarget}" was not found on the npm registry.`,
+          'RELEASE_NOT_FOUND',
+          { target: normalizedTarget, exitCode: result.code }
+        );
+      }
       throw new UpdateError(
         cleanOutput(result.stderr) || 'npm could not find the requested release.',
         'REGISTRY_LOOKUP_FAILED',