@dev.sail.money/sailor 1.1.0-61 → 1.1.0-62

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dev.sail.money/sailor",
-  "version": "1.1.0-61",
+  "version": "1.1.0-62",
   "description": "Operator toolkit for Sail Protocol",
   "bin": {
     "sailor": "packages/cli/dist/index.cjs"

package/packages/cli/dist/index.cjs

@@ -43604,6 +43604,7 @@ async function runCommand(opts) {
   for (const [k, v] of Object.entries(env)) {
     if (v && !process.env[k]) process.env[k] = v;
   }
+  const runReason = opts.reason ?? process.env.SAIL_RUN_REASON ?? "manual";
   const configChainId = readJsonFile(sailPath("config.json"))?.chainId;
   const chainIdRaw = opts.chain != null ? String(opts.chain) : process.env.CHAIN_ID ?? env.CHAIN_ID ?? (configChainId != null ? String(configChainId) : void 0);
   if (!chainIdRaw) {
@@ -43733,7 +43734,7 @@ Configure the chain in the SDK chain registry or set KERNEL_ADDRESS in .sail/.en
     return d;
   };
   async function runTick() {
-    appendActivity({ ts: nowIso(), actor: "agent", type: "tick_start", chainId });
+    appendActivity({ ts: nowIso(), actor: "agent", type: "tick_start", chainId, reason: runReason });
     let blockInfo = { number: 0n, timestamp: 0n };
     try {
       const block = await publicClient.getBlock();
@@ -43896,6 +43897,7 @@ Configure the chain in the SDK chain registry or set KERNEL_ADDRESS in .sail/.en
   console.log(`Account: ${accountAddr}`);
   console.log(`Chain: ${chainName2} (${chainId})`);
   console.log(once ? "Mode: single tick (--once)" : `Interval: ${intervalSec}s`);
+  console.log(`Reason: ${runReason}`);
   console.log("Press Ctrl+C to stop");
   console.log("");
   writeAgentPid(chainId);
@@ -44042,6 +44044,110 @@ async function scan(options) {
   );
 }
 
+// src/commands/trigger.ts
+var import_node_child_process2 = require("node:child_process");
+var GH_API = "https://api.github.com";
+function parseRepoFromRemoteUrl(url) {
+  const trimmed = url.trim().replace(/\.git$/, "");
+  const m = trimmed.match(/github\.com[/:]([^/]+)\/([^/]+?)$/);
+  return m ? `${m[1]}/${m[2]}` : null;
+}
+function resolveRepo(explicit) {
+  if (explicit) {
+    if (!/^[^/\s]+\/[^/\s]+$/.test(explicit)) {
+      throw new Error(`--repo must be in "owner/repo" form \u2014 got: "${explicit}"`);
+    }
+    return explicit;
+  }
+  let url;
+  try {
+    url = (0, import_node_child_process2.execFileSync)("git", ["remote", "get-url", "origin"], {
+      encoding: "utf-8",
+      stdio: ["ignore", "pipe", "ignore"]
+    }).trim();
+  } catch {
+    throw new Error(
+      'Could not read the git remote "origin".\nPass --repo <owner/repo> explicitly.'
+    );
+  }
+  const repo = parseRepoFromRemoteUrl(url);
+  if (!repo) {
+    throw new Error(
+      `Could not parse a GitHub owner/repo from the origin remote (${url}).
+Pass --repo <owner/repo>.`
+    );
+  }
+  return repo;
+}
+function resolveToken() {
+  const token = process.env.SAIL_GH_TOKEN ?? process.env.GITHUB_TOKEN;
+  if (!token) {
+    throw new Error(
+      "No GitHub token found. Set SAIL_GH_TOKEN (or GITHUB_TOKEN) in your environment.\nIt needs the `actions: write` permission on the repo (a fine-grained PAT or a GitHub App token).\nThe token is read from the environment only \u2014 it is never passed as an argument or stored."
+    );
+  }
+  return token;
+}
+function buildDispatchRequest(args) {
+  return {
+    url: `${GH_API}/repos/${args.repo}/actions/workflows/${encodeURIComponent(args.workflow)}/dispatches`,
+    method: "POST",
+    headers: {
+      Authorization: `Bearer ${args.token}`,
+      Accept: "application/vnd.github+json",
+      "X-GitHub-Api-Version": "2022-11-28",
+      "User-Agent": "sailor-cli",
+      "Content-Type": "application/json"
+    },
+    body: JSON.stringify({ ref: args.ref, inputs: { reason: args.reason } })
+  };
+}
+async function triggerGithub(options = {}) {
+  const workflow = options.workflow ?? "agent-tick.yml";
+  const ref = options.ref ?? "main";
+  const reason = options.reason ?? "manual";
+  const repo = resolveRepo(options.repo);
+  const token = resolveToken();
+  const req = buildDispatchRequest({ repo, workflow, ref, reason, token });
+  let res;
+  try {
+    res = await fetch(req.url, { method: req.method, headers: req.headers, body: req.body });
+  } catch (err) {
+    throw new Error(`Could not reach GitHub to fire workflow_dispatch: ${err.message}`);
+  }
+  if (res.status === 204) {
+    emit(
+      options.json,
+      () => {
+        console.log(`\u2713 Triggered ${workflow} on ${repo}@${ref}`);
+        console.log(`  reason: ${reason}`);
+        console.log(`  runs:   https://github.com/${repo}/actions/workflows/${workflow}`);
+      },
+      { status: "ok", repo, workflow, ref, reason }
+    );
+    return;
+  }
+  let detail = "";
+  try {
+    detail = await res.text();
+  } catch {
+  }
+  let message = `GitHub returned ${res.status}`;
+  if (res.status === 401) message += " \u2014 bad or expired token";
+  else if (res.status === 403) message += " \u2014 token lacks `actions: write` on this repo";
+  else if (res.status === 404)
+    message += ` \u2014 workflow "${workflow}" or repo "${repo}" not found (or the token can't see it)`;
+  if (detail) {
+    try {
+      const parsed = JSON.parse(detail);
+      if (parsed.message) message += `: ${parsed.message}`;
+    } catch {
+      message += `: ${detail.slice(0, 200)}`;
+    }
+  }
+  throw new Error(message);
+}
+
 // src/commands/session.ts
 function requireAccount() {
   const account2 = readJsonFile(sailPath("account.json"));
@@ -44241,7 +44347,7 @@ async function status() {
 }
 
 // src/commands/ui.ts
-var import_node_child_process2 = require("node:child_process");
+var import_node_child_process3 = require("node:child_process");
 var import_node_fs17 = __toESM(require("node:fs"), 1);
 var import_node_net2 = __toESM(require("node:net"), 1);
 var import_node_path13 = __toESM(require("node:path"), 1);
@@ -44311,7 +44417,7 @@ async function uiCommand() {
   import_node_fs17.default.mkdirSync(runtimeDir, { recursive: true });
   const logFile = import_node_path13.default.join(runtimeDir, "ui.log");
   const logFd = import_node_fs17.default.openSync(logFile, "a");
-  const child = (0, import_node_child_process2.spawn)(process.execPath, [serverBundle], {
+  const child = (0, import_node_child_process3.spawn)(process.execPath, [serverBundle], {
     detached: true,
     stdio: ["ignore", logFd, logFd],
     env: { ...process.env, SAIL_DIR: sailDir2, SERVE_DIST: "1", PORT: String(port), SAILOR_UI_DIST: uiDistDir }
@@ -44462,9 +44568,16 @@ owner.command("connect").description("Open the signing station, wait for your wa
 owner.command("show").description("Show the saved project owner").option("--json", "Emit machine-readable JSON").action(actionWith(ownerShow));
 program2.command("scan").description("Discover the owner's SMAs, their permissions, and local keys; save to context.json").option("--owner <address>", "Owner address to scan (defaults to the saved project owner)").option("--json", "Emit machine-readable JSON").action(actionWith(scan));
 program2.command("status").description("Show current account, permission, and session status").action(action(status));
-program2.command("run").description("Run the agent execution loop (use --once for a single tick)").option("--once", "Run a single tick then exit").option("--chain <chainId>", "Chain ID to run on (overrides CHAIN_ID env and .env.local)").action(async (opts) => {
+program2.command("run").description("Run the agent execution loop (use --once for a single tick)").option("--once", "Run a single tick then exit").option("--chain <chainId>", "Chain ID to run on (overrides CHAIN_ID env and .env.local)").option(
+  "--reason <text>",
+  "Label why this run fired (observability only; also read from SAIL_RUN_REASON)"
+).action(async (opts) => {
   try {
-    await runCommand({ once: opts.once, chain: opts.chain ? Number(opts.chain) : void 0 });
+    await runCommand({
+      once: opts.once,
+      chain: opts.chain ? Number(opts.chain) : void 0,
+      reason: opts.reason
+    });
   } catch (err) {
     console.error(`Error: ${err.message}`);
     closePrompts();
@@ -44472,6 +44585,8 @@ program2.command("run").description("Run the agent execution loop (use --once fo
   }
   closePrompts();
 });
+var trigger = program2.command("trigger").description("Wake the agent on demand from an external system");
+trigger.command("github").description("Fire the agent's GitHub Actions workflow_dispatch (the same job the cron runs)").option("--workflow <file>", "Workflow file to dispatch", "agent-tick.yml").option("--ref <branch>", "Git ref to run the workflow on", "main").option("--reason <text>", "Why this run fired \u2014 recorded as the workflow's reason input").option("--repo <owner/repo>", "Override the repository (default: from the git origin remote)").option("--json", "Emit machine-readable JSON").action(actionWith(triggerGithub));
 var session = program2.command("session").description("Control the agent session");
 session.command("pause").description("Pause the agent session (revoke dispatch rights)").action(action(sessionPause));
 session.command("resume").description("Resume a paused session").action(action(sessionResume));

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-15T17:19:52.072Z
+ * Generated at : 2026-06-15T17:43:57.156Z
  */
 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-15T17:19:52.072Z
+ * Generated at : 2026-06-15T17:43:57.156Z
  */
 export const SAIL_INTELLIGENCE_BASE_URL = "https://api.sail.money";
 export const SAIL_INTELLIGENCE_DOCS_URL = "https://api.sail.money/docs";

package/templates/default/.github/workflows/agent-tick.yml

@@ -1,10 +1,35 @@
 name: Agent Tick
 
+# ─────────────────────────────────────────────────────────────────────────────
+# WHEN does your agent run? Two mechanisms — you almost certainly need to tune
+# the first one for your strategy.
+#
+#   1. schedule (cron, below) — a heartbeat / backstop. GitHub Actions cron is
+#      NON-PUNCTUAL: it drifts and is SKIPPED under load, so it is the wrong
+#      PRIMARY driver for anything latency-sensitive. Tune the cadence to your
+#      strategy's volatility:
+#        • LP / perps / liquidations  → minutes — but don't rely on cron for it;
+#          use an external trigger (#2). Here cron is only a safety net.
+#        • DCA / periodic rebalance    → daily.
+#        • treasury / slow rebalances  → hourly to daily.
+#      The default below (hourly) is a GENERIC PLACEHOLDER — change it.
+#
+#   2. workflow_dispatch — an on-demand trigger. Anything that can make an HTTP
+#      call can wake this job the instant a condition is met (a price band, an
+#      on-chain event, a webhook). Fire it from the CLI:  sailor trigger github
+#      This is how you get low-latency reaction that cron cannot give you.
+# ─────────────────────────────────────────────────────────────────────────────
+
 on:
   schedule:
-    # Every Monday at 09:00 UTC
-    - cron: "0 9 * * 1"
+    # Generic placeholder — hourly. TUNE THIS to your strategy (see above).
+    - cron: "0 * * * *"
   workflow_dispatch:
+    inputs:
+      reason:
+        description: "Why this run fired (recorded in the run log for auditability)"
+        required: false
+        default: "manual"
 
 jobs:
   tick:
@@ -30,4 +55,6 @@ jobs:
           RPC_URL: ${{ secrets.RPC_URL }}
           SAIL_PASSPHRASE: ${{ secrets.SAIL_PASSPHRASE }}
           CHAIN_ID: ${{ vars.CHAIN_ID || '8453' }}
+          # Labels the run: the dispatch reason, or "scheduled" for cron runs.
+          SAIL_RUN_REASON: ${{ github.event.inputs.reason || 'scheduled' }}
         run: npx sailor run --once