@getxflow/cli 0.12.0 → 0.12.1

package/dist/api.js

@@ -94,7 +94,7 @@ async function send(client, path, options = {}) {
     }
     catch (e) {
         const reason = e instanceof Error ? e.message : String(e);
-        throw new ApiError(`The platform is unreachable: ${reason}`, 'network', 0, `Check the connection and the address ${client.apiUrl}`);
+        throw new ApiError(`The platform is unreachable: ${reason}`, 'network', 0, `Check the connection and the address ${client.apiUrl}. Inside an agent sandbox the network is usually switched off: then the command belongs to a person in their own terminal`);
     }
     assertProtocol(response);
     return response;

package/dist/commands/skills.js

@@ -73,13 +73,29 @@ function skillPath(base, agent, global) {
 function installed(base, agent, global) {
     return (0, node_fs_1.existsSync)(skillPath(base, agent, global));
 }
+/**
+ * A refused write turned into an answer. Agent sandboxes keep `.agents`, `.codex` and
+ * `.git` read-only precisely so that an agent cannot rewrite its own instructions, so
+ * this is the ordinary outcome of an agent running the command, not a broken machine.
+ */
+function writeRefused(path, e) {
+    const code = e instanceof Error ? e.code : undefined;
+    if (code !== 'EACCES' && code !== 'EPERM' && code !== 'EROFS')
+        return e;
+    return new errors_1.CliError(`No permission to write ${path}`, 'An agent sandbox usually keeps .agents, .codex and .git read-only. Ask the person to run this command in their own terminal');
+}
 /** Writes only when the content differs. */
 function writeIfChanged(path, content) {
     const before = (0, node_fs_1.existsSync)(path) ? (0, node_fs_1.readFileSync)(path, 'utf-8') : null;
     if (before === content)
         return null;
-    (0, node_fs_1.mkdirSync)((0, node_path_1.dirname)(path), { recursive: true });
-    (0, node_fs_1.writeFileSync)(path, content, 'utf-8');
+    try {
+        (0, node_fs_1.mkdirSync)((0, node_path_1.dirname)(path), { recursive: true });
+        (0, node_fs_1.writeFileSync)(path, content, 'utf-8');
+    }
+    catch (e) {
+        throw writeRefused(path, e);
+    }
     return before === null ? 'new' : 'updated';
 }
 /**
@@ -118,7 +134,12 @@ function writePointer(base, create) {
     }
     if (before === next)
         return null;
-    (0, node_fs_1.writeFileSync)(path, next, 'utf-8');
+    try {
+        (0, node_fs_1.writeFileSync)(path, next, 'utf-8');
+    }
+    catch (e) {
+        throw writeRefused(path, e);
+    }
     return { path, state: before === null ? 'new' : 'updated' };
 }
 function install(base, ids, global) {
@@ -268,8 +289,11 @@ function installSkillQuietly(base) {
         }
         return true;
     }
-    catch {
-        (0, ui_1.note)((0, ui_1.dim)('  Could not lay out the AI agent instructions: xflow skills'));
+    catch (e) {
+        // The reason travels with the failure: a refused write is fixed by a person running
+        // the command, and "try xflow skills" alone sends the agent round the same wall.
+        (0, ui_1.note)((0, ui_1.dim)(`  Could not lay out the AI agent instructions: ${e instanceof Error ? e.message : e}`));
+        (0, ui_1.note)((0, ui_1.dim)(`  ${e instanceof errors_1.CliError && e.hint ? e.hint : 'Try again: xflow skills'}`));
         return false;
     }
 }

package/dist/version.js

@@ -2,6 +2,6 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.DEFAULT_API_URL = exports.CLI_VERSION = void 0;
 /** Keep in sync with cli/package.json. */
-exports.CLI_VERSION = '0.12.0';
+exports.CLI_VERSION = '0.12.1';
 /** Overridden by XFLOW_API_URL or the `api` field in xflow.json. */
 exports.DEFAULT_API_URL = 'https://app.getxflow.com';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@getxflow/cli",
-  "version": "0.12.0",
+  "version": "0.12.1",
   "description": "CLI for the XFlow platform: source sync, deployment and publishing of applications",
   "license": "UNLICENSED",
   "engines": {

package/skills/xflow/SKILL.md

@@ -24,7 +24,7 @@ contains the fix.
 
 ## Keeping these instructions current
 
-These instructions ship with xflow CLI 0.12.0. They travel inside the package, so the copy
+These instructions ship with xflow CLI 0.12.1. They travel inside the package, so the copy
 you are reading can be older than the CLI answering your commands, and nothing about that
 is visible in the text itself.