@shardflux/cli 0.6.0 → 0.6.2

package/dist/main.js

@@ -47,7 +47,7 @@ function hintFor(info, cred, file) {
     if (info.code === 'timeout' && info.operation_id)
         return `the operation continues server side; keep waiting with: shard operations wait ${info.operation_id}`;
     if (info.code === 'operation_failed' && info.retryable) {
-        return info.details?.error_code === 'capacity_unavailable' ? 'no host could admit it before its deadline; nothing was started. Retry later.' : 'the operation may succeed if you retry it later.';
+        return info.details?.error_code === 'capacity_unavailable' ? 'nothing was started; run the same command again' : 'the operation may succeed if you retry it later.';
     }
     if (info.code === 'interrupted' && info.operation_id)
         return `keep waiting with: shard operations wait ${info.operation_id}`;
@@ -79,7 +79,7 @@ function hintFor(info, cred, file) {
     const policyHint = spendPolicyHint(info);
     if (policyHint)
         return policyHint;
-    // File patches (contracts §26.2): what to do about each refusal. details.index is the 0-based edit (--old) index.
+    // File patches: what to do about each refusal. details.index is the 0-based edit (--old) index.
     const reason = info.details?.reason;
     const index = typeof info.details?.index === 'number' ? ` #${info.details.index + 1}` : '';
     if (reason === 'revision_mismatch') {
@@ -93,7 +93,7 @@ function hintFor(info, cred, file) {
     if (reason === 'edit_not_text')
         return 'the file is not UTF-8 text; use files write for binary data';
     if (reason === 'host_capacity')
-        return 'the workspace’s host has no room to run it right now; retry in a few seconds';
+        return 'the workspace cannot be woken right now and the call did not run; retry in a few seconds';
     if (reason === 'host_feature_unavailable')
         return hostFeatureHint(info.details?.feature);
     // A processful command that could not start (0.5.1): what to change, from the workspace's reason.
@@ -167,17 +167,15 @@ function spendPolicyHint(info) {
     }
 }
 /**
- * 409 conflict host_feature_unavailable (contracts §26.7; 0.5.0): the workspace runs on a host agent that predates the
- * call. Not retryable: it lasts until the workspace runs on an upgraded host (minutes to hours), so the hint names
- * another way to do it now.
+ * 409 conflict host_feature_unavailable (0.5.0): the call is not available for this workspace. Not retryable, so the
+ * hint names the fallback that works now.
  */
 function hostFeatureHint(feature) {
-    const later = 'it will once the workspace runs on an upgraded host (retrying now does not help)';
     if (feature === 'file_search')
-        return `the workspace’s host does not support files search yet; ${later}. Search with a command instead: shard ws exec <id|key> -- grep -rn <pattern> <path>`;
+        return 'files search is not available for this workspace (retrying does not help); search with a command instead: shard ws exec <id|key> -- grep -rn <pattern> <path>';
     if (feature === 'file_patch')
-        return `the workspace’s host does not support files patch yet; ${later}. Rewrite the file instead: shard files read <id|key> <path> --out F, edit F, then shard files write <id|key> <path> --from F`;
-    return `the workspace’s host does not support this call yet; ${later}`;
+        return 'files patch is not available for this workspace (retrying does not help); rewrite the file instead: shard files read <id|key> <path> --out F, edit F, then shard files write <id|key> <path> --from F';
+    return 'this call is not available for this workspace (retrying does not help)';
 }
 /** What an execution that ended failed or lost ran into (error.details.reason), where the reason alone says little. */
 const EXECUTION_CAUSES = {
@@ -186,10 +184,10 @@ const EXECUTION_CAUSES = {
     host_unreachable: 'its host stopped answering',
     host_restarted: 'its host restarted',
     tree_moved: 'the tree changed while it ran',
-    no_execution_host: 'no host had room to run it',
+    no_execution_host: 'the execution could not be placed',
     workspace_deleted: 'the workspace was deleted',
 };
-/** Hints for file-first workspaces (0.5.0; contracts §29.7, §29.8): the mode refusals, tree revisions and executions. */
+/** Hints for file-first workspaces (0.5.0): the mode refusals, tree revisions and executions. */
 function fileFirstHint(info) {
     const d = info.details ?? {};
     const reason = d.reason;
@@ -211,7 +209,7 @@ function fileFirstHint(info) {
             return `this key already belongs to a ${has} workspace and a workspace’s mode never changes; use another key for a ${wants} workspace (or reopen this one without --mode)`;
         }
         case 'mode_not_available':
-            return 'this deployment does not offer file-first workspaces yet; leave out --mode file-first to open a processful workspace';
+            return 'this deployment does not offer file-first workspaces; leave out --mode file-first to open a processful workspace';
         case 'layout_unsupported':
             return d.mode === 'file_first' ? 'file-first workspaces run on layered template versions only; open a template version whose disk layouts include layered (shard templates get <slug> lists them)' : undefined;
         case 'tree_revision_mismatch': {
@@ -229,7 +227,7 @@ function fileFirstHint(info) {
         case 'execution_id_reused':
             return 'this --execution-id was already used for a different request (the same id with the same request returns its recorded result); pass a new --execution-id';
         case 'no_execution_host':
-            return 'no host had room to run the execution, also after retries with the same execution id; nothing ran. Retry later';
+            return 'the execution cannot be placed right now, also after retries with the same execution id; nothing ran. Retry';
         default:
             return undefined;
     }
@@ -271,7 +269,7 @@ function nudges(info, command) {
     const reason = reasonOf(info);
     return !NO_NUDGE_CODES.has(info.code) && !(reason !== undefined && NO_NUDGE_REASONS.has(reason));
 }
-/** `shard feedback` could not send: how to fix it, and the way to still reach the founder. */
+/** `shard feedback` could not send: how to fix it, and the way to still reach the Shardflux team. */
 function feedbackHint(info, credentialHint) {
     if (info.code === 'usage')
         return 'run "shard feedback --help"';

package/dist/template-yaml.js

@@ -1,5 +1,5 @@
 /**
- * template.yaml text (contracts §24.1: the recipe v2 document in YAML; only clients parse YAML): the starter file of
+ * template.yaml text (the recipe v2 document in YAML; only clients parse YAML): the starter file of
  * `shard templates init` and the export of a version (`shard templates export`), written like the dashboard's
  * Template file section (keys in the recipe's order, long scripts as block literals, no line folding).
  */

package/dist/update-check.js

@@ -1,5 +1,5 @@
 /**
- * `shard` tells its user when it is outdated or no longer supported (0.5.0+; contracts §30.4). The API's
+ * `shard` tells its user when it is outdated or no longer supported (0.5.0+). The API's
  * GET /v1/client-versions names the latest published version of every client and the oldest one it still serves.
  *
  * - At most one request per 24 hours per API URL and package: the answer is cached in

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shardflux/cli",
-  "version": "0.6.0",
+  "version": "0.6.2",
   "type": "module",
   "description": "shard: the Shardflux command line. Create an account, sign in, set up keys and billing, then open, run commands in, move files to, suspend, resume and fork persistent agent workspaces.",
   "license": "Apache-2.0",
@@ -44,7 +44,7 @@
   },
   "dependencies": {
     "yaml": "2.9.1",
-    "@shardflux/sdk": "^0.11.0"
+    "@shardflux/sdk": "^0.11.1"
   },
   "devDependencies": {
     "@eslint/js": "10.0.1",