@dev.sail.money/sailor 1.2.1-94 → 1.3.0-206

package/README.md

@@ -102,6 +102,18 @@ npm install -g @sail.money/sailor
 sailor init my-agent
 ```
 
+### Docker (no Node.js required)
+
+Run sailor from a pre-built image — useful when you don't want to install Node.js or want an isolated environment:
+
+```bash
+mkdir my-agent && cd my-agent
+docker run -d --name agent -P -v "${PWD}:/workspace" sailmoney/sailor
+docker exec agent sailor init
+```
+
+Then open the folder in your AI coding assistant and say **"start"**. See the [Docker Hub](#docker-hub-publish-dockeryml) section below for full usage details.
+
 ---
 
 ## Quickstart
@@ -382,6 +394,57 @@ Or pin in `package.json`:
 
 Either way, `@sail.money/sailor/sdk` imports work unchanged.
 
+### Docker Hub (`publish-docker.yml`)
+
+A pre-built image is published to Docker Hub so you can run the CLI without installing Node.js locally. The image uses Alpine Linux and includes `tsx` (required to compile TypeScript agent code at runtime).
+
+| Trigger | Tag |
+|---|---|
+| Merge to `main` or manual dispatch | `sailmoney/sailor:dev` |
+| Tag push (`v*`) | `sailmoney/sailor:<version>` + `sailmoney/sailor:latest` |
+
+#### Starting the container
+
+Run this from your project root. `-P` publishes all exposed ports to random available host ports; use a fixed `-p <host>:3334` if you want a stable UI port.
+
+```bash
+docker run -d --name agent -P -v "${PWD}:/workspace" sailmoney/sailor
+```
+
+- `-d` — detached, runs in the background
+- `--name agent` — container name used in all `docker exec` calls
+- `-P` — maps container ports (UI: 3334, station: 3141) to random host ports
+- `-v "${PWD}:/workspace"` — mounts the current project into the container
+
+#### Running sailor commands
+
+All sailor commands run via `docker exec`:
+
+```bash
+docker exec agent sailor --version
+docker exec agent sailor init
+docker exec agent sailor ui start
+docker exec agent sailor run --once
+```
+
+Project files are on your **local filesystem** — read and write them directly from local paths. Only `sailor` commands need the `docker exec` prefix; the volume mount makes files accessible to both sides.
+
+#### Opening the dashboard
+
+The UI always binds to port **3334 inside the container**, but the host-side port depends on how `-P` mapped it. Resolve it before opening the browser:
+
+```bash
+docker port agent 3334
+# → 0.0.0.0:49201   (open http://localhost:49201 in the browser)
+```
+
+#### Stopping
+
+```bash
+docker stop agent    # stop the container
+docker start agent   # restart it later (project files and state are on the host)
+```
+
 ---
 
 ## Security model

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dev.sail.money/sailor",
-  "version": "1.2.1-94",
+  "version": "1.3.0-206",
   "description": "Operator toolkit for Sail Protocol",
   "bin": {
     "sailor": "packages/cli/dist/index.cjs"
@@ -24,6 +24,7 @@
     "AGENTS.md"
   ],
   "scripts": {
+    "clean": "node scripts/clean.mjs",
     "build": "pnpm --filter @sail/sdk build && pnpm --filter sailor build && pnpm --filter sailor-ui build",
     "test": "pnpm --filter sailor-ui test",
     "test:ui": "pnpm --filter sailor-ui test:ui",

package/packages/cli/dist/index.cjs

@@ -38519,7 +38519,8 @@ var import_websocket2 = __toESM(require_websocket2(), 1);
 var import_websocket_server2 = __toESM(require_websocket_server2(), 1);
 
 // src/signing/server.ts
-var DEFAULT_SIGNING_PORT = 3141;
+var _signingPort = parseInt(process.env.SAILOR_STATION_PORT ?? "", 10);
+var DEFAULT_SIGNING_PORT = Number.isFinite(_signingPort) && _signingPort >= 1 && _signingPort <= 65535 ? _signingPort : 3141;
 var RUNTIME_SUBDIR = (0, import_node_path4.join)(".sail", "runtime");
 var SERVER_STATE_FILE = "server.json";
 var REQUEST_SECRET_HEADER = "x-sailor-secret";
@@ -40693,6 +40694,9 @@ function scaffoldProjectWorkspace(dest, name, options) {
   import_node_fs9.default.mkdirSync(import_node_path8.default.join(sailDir2, "keys"), { recursive: true });
   import_node_fs9.default.mkdirSync(import_node_path8.default.join(sailDir2, "runtime"), { recursive: true });
   import_node_fs9.default.mkdirSync(import_node_path8.default.join(sailDir2, "state"), { recursive: true });
+  const installMode = process.env.SAILOR_INSTALL_MODE === "docker" ? "docker" : "local";
+  const _rawContainerName = process.env.SAILOR_CONTAINER_NAME ?? "agent";
+  const containerName = /^[a-zA-Z0-9][a-zA-Z0-9_.-]*$/.test(_rawContainerName) ? _rawContainerName : "agent";
   import_node_fs9.default.writeFileSync(
     import_node_path8.default.join(sailDir2, "config.json"),
     `${JSON.stringify(
@@ -40703,6 +40707,8 @@ function scaffoldProjectWorkspace(dest, name, options) {
         // null = chain not yet chosen; Stage 1 will set this
         stateDir: ".sail/state",
         createdAt: (/* @__PURE__ */ new Date()).toISOString(),
+        installMode,
+        ...installMode === "docker" ? { containerName } : {},
         contracts: {
           kernel: "",
           mandateFactory: ""
@@ -40794,6 +40800,14 @@ Pass --force to scaffold into it anyway (existing files with the same name are o
       "This project is already initialized.\nRun `sailor update` to re-sync template files, or `sailor init --force` to re-initialize (overwrites scaffold files; your .sail/keys/ and .sail/state/ are left in place)."
     );
   }
+  const existingConfigPath = import_node_path8.default.join(dest, ".sail", "config.json");
+  const previousConfig = import_node_fs9.default.existsSync(existingConfigPath) ? (() => {
+    try {
+      return JSON.parse(import_node_fs9.default.readFileSync(existingConfigPath, "utf-8"));
+    } catch {
+      return null;
+    }
+  })() : null;
   copyDirSync(templateSrc, dest);
   const pkgRoot = packageRoot();
   const examplesPermSrc = import_node_path8.default.join(pkgRoot, "examples", "permissions");
@@ -40833,6 +40847,18 @@ Pass --force to scaffold into it anyway (existing files with the same name are o
   }
   scaffoldProjectWorkspace(dest, name, options);
   scaffoldFoundryWorkspace(dest);
+  const newMode = process.env.SAILOR_INSTALL_MODE === "docker" ? "docker" : "local";
+  if (previousConfig?.installMode === "docker" && newMode === "local") {
+    const prev = previousConfig.containerName ?? "agent";
+    console.log(`
+Switched to local install. If the Docker container is still running:`);
+    console.log(`  docker stop ${prev}`);
+    console.log(`You can restart it anytime with the standard docker run command.`);
+  } else if (previousConfig?.installMode === "local" && newMode === "docker") {
+    const containerName = process.env.SAILOR_CONTAINER_NAME ?? "agent";
+    console.log(`
+Switched to Docker install (container: ${containerName}).`);
+  }
   printWelcome(
     dest,
     name,
@@ -40943,6 +40969,12 @@ Created ${name}/`);
     "\u2551  If you skip this step, setup WILL break and you will have to        \u2551",
     "\u2551  restart. There are no shortcuts.                                    \u2551",
     "\u2551                                                                      \u2551",
+    "\u2551  IF SAILOR IS RUNNING IN DOCKER:                                     \u2551",
+    "\u2551    \u2022 Read project files from your local filesystem \u2014 they are        \u2551",
+    "\u2551      shared via volume mount, do NOT use docker exec to read them.   \u2551",
+    "\u2551    \u2022 Prefix every sailor command with:                               \u2551",
+    "\u2551      docker exec <containerName> sailor <command>                    \u2551",
+    "\u2551                                                                      \u2551",
     "\u255A\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u255D",
     ""
   ].join("\n"));
@@ -40996,6 +41028,41 @@ async function updateCommand() {
   }
   const added = [];
   copyDirSyncIfMissing(templateSrc, dest, added);
+  const configPath = import_node_path9.default.join(dest, ".sail", "config.json");
+  try {
+    const config = JSON.parse(import_node_fs10.default.readFileSync(configPath, "utf-8"));
+    const newMode = process.env.SAILOR_INSTALL_MODE === "docker" ? "docker" : "local";
+    const _rawContainerName = process.env.SAILOR_CONTAINER_NAME ?? "agent";
+    const containerName = /^[a-zA-Z0-9][a-zA-Z0-9_.-]*$/.test(_rawContainerName) ? _rawContainerName : "agent";
+    if (config.installMode !== newMode) {
+      const previousMode = config.installMode;
+      const previousContainer = config.containerName;
+      config.installMode = newMode;
+      if (newMode === "docker") {
+        config.containerName = containerName;
+      } else {
+        delete config.containerName;
+      }
+      import_node_fs10.default.writeFileSync(configPath, `${JSON.stringify(config, null, 2)}
+`, "utf-8");
+      if (previousMode === "docker" && newMode === "local") {
+        const prev = previousContainer ?? "agent";
+        console.log(`
+Switched to local install. If the Docker container is still running:`);
+        console.log(`  docker stop ${prev}`);
+        console.log(`You can restart it anytime with the standard docker run command.`);
+      } else if (newMode === "docker") {
+        console.log(`
+Switched to Docker install (container: ${containerName}).`);
+      }
+    } else if (newMode === "docker" && config.containerName !== containerName) {
+      config.containerName = containerName;
+      import_node_fs10.default.writeFileSync(configPath, `${JSON.stringify(config, null, 2)}
+`, "utf-8");
+    }
+  } catch {
+    console.warn("Warning: could not update install mode in .sail/config.json");
+  }
   if (removed.length === 0 && updated.length === 0 && added.length === 0) {
     console.log("Nothing to update.");
     return;
@@ -45148,7 +45215,8 @@ async function uiCommand() {
   const serverBundle = import_node_path16.default.resolve(distDir, "server.cjs");
   const projectRoot = process.cwd();
   const sailDir2 = import_node_path16.default.join(projectRoot, ".sail");
-  const port = await findFreePort(projectPort(projectRoot));
+  const envPort = Number(process.env.PORT);
+  const port = await findFreePort(Number.isInteger(envPort) && envPort > 0 && envPort <= 65535 ? envPort : projectPort(projectRoot));
   if (!import_node_fs20.default.existsSync(serverBundle)) {
     throw new Error(`Server bundle not found at ${serverBundle}. Re-run the sailor build.`);
   }

package/packages/sdk/dist/intelligence.d.ts

@@ -5,7 +5,7 @@
  * Do not edit manually — run `pnpm build` to regenerate.
  *
  * Spec version : 1.2.0
- * Generated at : 2026-06-20T13:49:45.632Z
+ * Generated at : 2026-06-23T09:10:35.761Z
  */
 export declare const SAIL_INTELLIGENCE_BASE_URL = "https://api.sail.money";
 export declare const SAIL_INTELLIGENCE_DOCS_URL = "https://api.sail.money/docs";

package/packages/sdk/dist/intelligence.js

@@ -5,7 +5,7 @@
  * Do not edit manually — run `pnpm build` to regenerate.
  *
  * Spec version : 1.2.0
- * Generated at : 2026-06-20T13:49:45.632Z
+ * Generated at : 2026-06-23T09:10:35.761Z
  */
 export const SAIL_INTELLIGENCE_BASE_URL = "https://api.sail.money";
 export const SAIL_INTELLIGENCE_DOCS_URL = "https://api.sail.money/docs";

package/scripts/clean.mjs

@@ -0,0 +1,17 @@
+import { rmSync } from "node:fs";
+
+const targets = [
+  "node_modules",
+  "packages/sdk/node_modules",
+  "packages/sdk/dist",
+  "packages/sdk/tsconfig.tsbuildinfo",
+  "packages/cli/node_modules",
+  "packages/cli/dist",
+  "packages/ui/node_modules",
+  "packages/ui/dist",
+];
+
+for (const p of targets) {
+  rmSync(p, { recursive: true, force: true });
+  console.log(`  removed ${p}`);
+}

package/templates/default/.agents/skills/sail-onboarding/SKILL.md

@@ -7,6 +7,42 @@ description: Walks the agent through setting up a new Sailor project or resuming
 
 ## Running the CLI
 
+**Determine the installation mode first** — read `.sail/config.json → installMode` before running any command:
+
+- `"local"` (or field absent) — `sailor` is on the PATH. Run commands directly: `sailor <command>`
+- `"docker"` — sailor runs in a container. Read `containerName` from the same config. Prefix every command:
+  `docker exec <containerName> sailor <command>`
+  Project files are on your **local filesystem** (mounted at `/workspace` inside the container) — read and write them normally from local paths. Do NOT use `docker exec` to read files; the volume mount makes them directly accessible.
+
+### Starting the Docker container
+
+If the container is not running, start it from the project root:
+
+```bash
+docker run -d --name agent -P -v "${PWD}:/workspace" sailmoney/sailor
+```
+
+- `-d` — detached, runs in the background
+- `--name agent` — names the container; use a different name with `-e SAILOR_CONTAINER_NAME=<name>` if needed
+- `-P` — publishes all exposed ports to random available host ports (UI: 3334, station: 3141)
+- `-v "${PWD}:/workspace"` — mounts the current project directory into the container
+
+After starting, resolve the host port before opening the UI in the browser:
+
+```bash
+docker port agent 3334
+# → 0.0.0.0:49201   (use 49201, not 3334, in the browser URL)
+```
+
+All `sailor` commands run via `docker exec`:
+
+```bash
+docker exec agent sailor --version
+docker exec agent sailor init
+docker exec agent sailor ui start
+docker exec agent sailor station start --json &
+```
+
 The published package is **`@sail.money/sailor`** — always use the scoped name with the registry. The bare name `sailor` is a different, unrelated npm package; never `npx sailor@<version>` or `npm i sailor`. Install it (`npm i -g @sail.money/sailor`, or as a project dep), after which the `sailor` bin works bare (`sailor <command>`) and `npx sailor <command>` resolves the installed bin. Every `sailor …` command in these skills assumes it is installed. Confirm the toolchain up front and pin a recent version — `npx @sail.money/sailor@latest --version` — because an old cached `npx` build can be missing newer commands (e.g. `mandate simulate`); if a documented command reports "unknown command", you are on a stale version, not hitting a missing feature.
 
 After upgrading the CLI, run `sailor update` from the project root to pull in updated skills, `AGENTS.md`, `Dockerfile`, and other tooling files. User files (`src/`, `mandates/`, `.sail/`, `package.json`) are never touched.

package/templates/default/.agents/skills/sail-servers/SKILL.md

@@ -36,6 +36,32 @@ sailor station stop --json    # SIGTERM, verified against the recorded URL first
 
 Signing-flow commands (`mandate deploy/attach/deploy-clone/revoke`, `onboard`, `account deploy-chain`, `account rotate-signer`, `owner connect`) push requests to a running station daemon if one exists, otherwise they spin up an ephemeral in-process signing server for the duration of the command. Starting a persistent station first means the owner connects their wallet once and approves a whole sequence of requests in the same browser tab — do this before any multi-step signing flow.
 
+## Docker installation
+
+If `.sail/config.json → installMode` is `"docker"`, prefix every command with `docker exec <containerName>` (read `containerName` from the same config):
+
+```bash
+docker exec agent sailor ui start
+docker exec agent sailor ui status
+docker exec agent sailor ui stop
+
+docker exec agent sailor station start --json
+docker exec agent sailor station status --json
+docker exec agent sailor station stop --json
+```
+
+The UI always binds to port **3334 inside the container** (the image sets `ENV PORT=3334`), but the host-side port depends on how the container was started. Before giving the user a URL, resolve the actual host port:
+
+```bash
+docker port <containerName> 3334
+# → 0.0.0.0:3334   (host port matches)
+# → 0.0.0.0:8080   (host port is different — use 8080 in the URL)
+```
+
+The URL to open in the browser is `http://localhost:<host-port>` where `<host-port>` is what `docker port` returned, not necessarily 3334. Never hard-code the port — always resolve it first.
+
+Project files at `/workspace` are your local directory — read and write them directly from local paths; only `sailor` commands need the `docker exec` prefix.
+
 ## Troubleshooting
 
 - Command stuck "waiting"? It is blocked on a browser signature — check `GET /config` `pendingCount`, and tell the user to open the station URL and approve. Signing requests time out after 10 minutes.

package/templates/default/AGENTS.md

@@ -77,7 +77,7 @@ Detailed procedures live in skills. If your tooling does not auto-discover skill
 
 | Skill | Load when | Path |
 |---|---|---|
-| sail-onboarding | New project setup, or resuming a partially set-up project | `.agents/skills/sail-onboarding/SKILL.md` |
+| sail-onboarding | New project setup, or resuming a partially set-up project, documentation of sailor commands | `.agents/skills/sail-onboarding/SKILL.md` |
 | sail-project-info | Any question about project, account, mandate, chain, or environment state | `.agents/skills/sail-project-info/SKILL.md` |
 | sail-servers | Starting, stopping, or health-checking the dashboard or signing station | `.agents/skills/sail-servers/SKILL.md` |
 | sail-transactions | Building dispatches or any EVM transaction for the agent | `.agents/skills/sail-transactions/SKILL.md` |