@shardflux/mcp 0.5.0 → 0.5.1

package/CHANGELOG.md

@@ -3,7 +3,16 @@
 Every tool, field and variable the README shows is available from the version named here. Below 1.0, a minor release
 may break compatibility; breaking changes are marked **Breaking**. Versions before 0.3.0 were not published.
 
-## 0.5.0 (not yet published)
+## 0.5.1
+
+Needs `@shardflux/sdk` 0.11.0 (the workspace version).
+
+`workspace_suspend` takes `after_seconds` from 0 to 3600 (before: 30 to 3600): 0 suspends the workspace as soon as it
+is idle (a few seconds of activity flush grace after its last work); a running command or a keepalive still postpones
+it. The result's `message` then says `the workspace is suspended as soon as it is idle`. Out of range is still
+`invalid_arguments` before any request.
+
+## 0.5.0
 
 Needs `@shardflux/sdk` 0.11.0 (the workspace version).
 

package/README.md

@@ -238,7 +238,7 @@ The management tools:
 | `workspace_list` | List the project's workspaces, with `prefix`, `state`, `lifetime`, `purpose`, `include_deleted`, `limit` and `cursor`. By default only persistent standard workspaces are listed. |
 | `workspace_status` | One workspace plus its five most recent operations. |
 | `workspace_suspend`, `workspace_resume` | Lifecycle operation. Returns at once unless `wait: true` (then once it finished, through the SDK's own `wait`). |
-| `workspace_suspend` with `after_seconds` | (0.4.1) Suspend when idle: the workspace is suspended once it has been idle for `after_seconds` (30-3600), instead of now. The description tells the agent to use it when it finishes its work, so the workspace stops using RAM soon after. Its next tool call on the workspace cancels it; a running command or a keepalive postpones it. Returns `suspend_request` (`not_before`: the earliest suspend) and a `message`; `operation` when a suspend was already in progress. Not with `wait`. `workspace_status` shows a pending request as `workspace.suspend_request`. Not for file-first workspaces. |
+| `workspace_suspend` with `after_seconds` | (0.4.1) Suspend when idle: the workspace is suspended once it has been idle for `after_seconds` (0-3600; 0 = as soon as it is idle, 0.5.1+), instead of now. The description tells the agent to use it when it finishes its work, so the workspace stops using RAM soon after. Its next tool call on the workspace cancels it; a running command or a keepalive postpones it. Returns `suspend_request` (`not_before`: the earliest suspend) and a `message`; `operation` when a suspend was already in progress. Not with `wait`. `workspace_status` shows a pending request as `workspace.suspend_request`. Not for file-first workspaces. |
 | `workspace_fork` | Fork into `new_key`. |
 | `operation_wait` | Keep waiting for an operation. |
 | `usage_summary` | The organization's usage summary for the current period: meters, allowances with their cap state, `allowance_exhausted` with `exhausted_reason`, and (0.4.1+, an API with opt-in overage) `spend_cap`: the overage state, cap, charges, lines per allowance and the date the cap is projected to be reached. |

package/dist/server.d.ts

@@ -3,7 +3,7 @@ import type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
 import type { ClientVersionStatus, JsonSchema, LifecycleTiming, Operation, TemplateBuild, TemplateDetail, TemplateOwner, ToolName, WorkspaceMode, WorkspaceTool, WorkspaceView } from '@shardflux/sdk';
 import type { McpConfig } from './config.js';
 import type { ToolErrorInfo } from './errors.js';
-export declare const MCP_SERVER_VERSION = "0.5.0";
+export declare const MCP_SERVER_VERSION = "0.5.1";
 /** The package this server is distributed as: its entry in GET /v1/client-versions (contracts §30.4). */
 export declare const MCP_PACKAGE = "@shardflux/mcp";
 export declare const ALL_TOOL_PERMISSIONS: readonly ToolName[];

package/dist/server.js

@@ -53,7 +53,7 @@ import { parse as parseYaml } from 'yaml';
 import { DEFAULT_WAKE_TIMEOUT_MS } from "./config.js";
 import { ToolError, describeToolError, redact } from "./errors.js";
 import { makeFetch } from "./http.js";
-export const MCP_SERVER_VERSION = '0.5.0';
+export const MCP_SERVER_VERSION = '0.5.1';
 /** The package this server is distributed as: its entry in GET /v1/client-versions (contracts §30.4). */
 export const MCP_PACKAGE = '@shardflux/mcp';
 const USER_AGENT = `shardflux-mcp/${MCP_SERVER_VERSION} shardflux-sdk-ts/${SDK_VERSION}`;
@@ -651,9 +651,9 @@ export function createShardfluxMcpServer(config, opts = {}) {
                 workspace_key: workspaceKeyProp(pinned),
                 after_seconds: {
                     type: 'integer',
-                    minimum: 30,
+                    minimum: 0,
                     maximum: 3600,
-                    description: 'Suspend once the workspace has been idle this many seconds (30-3600) instead of now. Omit to suspend now.',
+                    description: 'Suspend once the workspace has been idle this many seconds (0-3600; 0 = as soon as it is idle) instead of now. Omit to suspend now.',
                 },
                 wait: { type: 'boolean', description: 'Wait until the suspend finishes (default false). Not with after_seconds.' },
             }, keyRequired),
@@ -681,7 +681,7 @@ export function createShardfluxMcpServer(config, opts = {}) {
                     operation: r.operation ? summarizeOperation(r.operation) : null,
                     workspace: summarizeWorkspace(ws.data),
                     message: r.suspendRequest
-                        ? `Suspend scheduled: the workspace is suspended once it has been idle for ${r.suspendRequest.after_seconds} s (not before ${r.suspendRequest.not_before}). Your next tool call on it cancels this; a running command or keepalive postpones it.`
+                        ? `Suspend scheduled: the workspace is suspended ${r.suspendRequest.after_seconds === 0 ? 'as soon as it is idle' : `once it has been idle for ${r.suspendRequest.after_seconds} s`} (not before ${r.suspendRequest.not_before}). Your next tool call on it cancels this; a running command or keepalive postpones it.`
                         : `A suspend is already in progress (operation ${r.operation.id}, ${r.operation.state}); nothing was scheduled.`,
                 };
             },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shardflux/mcp",
-  "version": "0.5.0",
+  "version": "0.5.1",
   "mcpName": "dev.shardflux/mcp",
   "type": "module",
   "description": "Shardflux MCP server (stdio): give Claude, Cursor, Codex or any MCP client persistent cloud workspaces to run commands, edit files, use git and a browser in. Uses your scoped Shardflux API key.",