Skip to content

πŸ™Œ OpenHands: AI-Driven Development

feat: add daily-rotating file logger for dev scripts (closes #815) (#1181)

Tim O'Farrell90754e2571fa
diff --git a/package-lock.json b/package-lock.json
index b288e50f3a..c5b7d29474 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -101,7 +101,9 @@
"tailwindcss": "4.2.4",
"typescript": "6.0.3",
"vite-plugin-svgr": "5.2.0",
- "vitest": "4.1.5"
+ "vitest": "4.1.5",
+ "winston": "^3.19.0",
+ "winston-daily-rotate-file": "^5.0.0"
},
"engines": {
"node": ">=22.12.0"
@@ -727,6 +729,16 @@
"specificity": "bin/cli.js"
}
},
+ "node_modules/@colors/colors": {
+ "version": "1.6.0",
+ "resolved": "https://registry.npmjs.org/@colors/colors/-/colors-1.6.0.tgz",
+ "integrity": "sha512-Ir+AOibqzrIsL6ajt3Rz3LskB7OiMVHqltZmspbW/TJuTVuyOMirVqAkjfY6JISiLHgyNqicAC8AyHHGzNd/dA==",
+ "dev": true,
+ "license": "MIT",
+ "engines": {
+ "node": ">=0.1.90"
+ }
+ },
"node_modules/@csstools/color-helpers": {
"version": "6.0.2",
"resolved": "https://registry.npmjs.org/@csstools/color-helpers/-/color-helpers-6.0.2.tgz",
@@ -867,6 +879,18 @@
"node": ">=20.19.0"
}
},
+ "node_modules/@dabh/diagnostics": {
+ "version": "2.0.8",
+ "resolved": "https://registry.npmjs.org/@dabh/diagnostics/-/diagnostics-2.0.8.tgz",
+ "integrity": "sha512-R4MSXTVnuMzGD7bzHdW2ZhhdPC/igELENcq5IjEverBvq5hn1SXCWcsi6eSsdWP0/Ur+SItRRjAktmdoX/8R/Q==",
+ "dev": true,
+ "license": "MIT",
+ "dependencies": {
+ "@so-ric/colorspace": "^1.1.6",
+ "enabled": "2.0.x",
+ "kuler": "^2.0.0"
+ }
+ },
"node_modules/@emnapi/core": {
"version": "1.10.0",
"resolved": "https://registry.npmjs.org/@emnapi/core/-/core-1.10.0.tgz",
@@ -6196,6 +6220,67 @@
"win32"
]
},
+ "node_modules/@so-ric/colorspace": {
+ "version": "1.1.6",
+ "resolved": "https://registry.npmjs.org/@so-ric/colorspace/-/colorspace-1.1.6.tgz",
+ "integrity": "sha512-/KiKkpHNOBgkFJwu9sh48LkHSMYGyuTcSFK/qMBdnOAlrRJzRSXAOFB5qwzaVQuDl8wAvHVMkaASQDReTahxuw==",
+ "dev": true,
+ "license": "MIT",
+ "dependencies": {
+ "color": "^5.0.2",
+ "text-hex": "1.0.x"
+ }
+ },
+ "node_modules/@so-ric/colorspace/node_modules/color": {
+ "version": "5.0.3",
+ "resolved": "https://registry.npmjs.org/color/-/color-5.0.3.tgz",
+ "integrity": "sha512-ezmVcLR3xAVp8kYOm4GS45ZLLgIE6SPAFoduLr6hTDajwb3KZ2F46gulK3XpcwRFb5KKGCSezCBAY4Dw4HsyXA==",
+ "dev": true,
+ "license": "MIT",
+ "dependencies": {
+ "color-convert": "^3.1.3",
+ "color-string": "^2.1.3"
+ },
+ "engines": {
+ "node": ">=18"
+ }
+ },
+ "node_modules/@so-ric/colorspace/node_modules/color-convert": {
+ "version": "3.1.3",
+ "resolved": "https://registry.npmjs.org/color-convert/-/color-convert-3.1.3.tgz",
+ "integrity": "sha512-fasDH2ont2GqF5HpyO4w0+BcewlhHEZOFn9c1ckZdHpJ56Qb7MHhH/IcJZbBGgvdtwdwNbLvxiBEdg336iA9Sg==",
+ "dev": true,
+ "license": "MIT",
+ "dependencies": {
+ "color-name": "^2.0.0"
+ },
+ "engines": {
+ "node": ">=14.6"
+ }
+ },
+ "node_modules/@so-ric/colorspace/node_modules/color-name": {
+ "version": "2.1.0",
+ "resolved": "https://registry.npmjs.org/color-name/-/color-name-2.1.0.tgz",
+ "integrity": "sha512-1bPaDNFm0axzE4MEAzKPuqKWeRaT43U/hyxKPBdqTfmPF+d6n7FSoTFxLVULUJOmiLp01KjhIPPH+HrXZJN4Rg==",
+ "dev": true,
+ "license": "MIT",
+ "engines": {
+ "node": ">=12.20"
+ }
+ },
+ "node_modules/@so-ric/colorspace/node_modules/color-string": {
+ "version": "2.1.4",
+ "resolved": "https://registry.npmjs.org/color-string/-/color-string-2.1.4.tgz",
+ "integrity": "sha512-Bb6Cq8oq0IjDOe8wJmi4JeNn763Xs9cfrBcaylK1tPypWzyoy2G3l90v9k64kjphl/ZJjPIShFztenRomi8WTg==",
+ "dev": true,
+ "license": "MIT",
+ "dependencies": {
+ "color-name": "^2.0.0"
+ },
+ "engines": {
+ "node": ">=18"
+ }
+ },
"node_modules/@socket.io/component-emitter": {
"version": "3.1.2",
"resolved": "https://registry.npmjs.org/@socket.io/component-emitter/-/component-emitter-3.1.2.tgz",
@@ -7098,6 +7183,13 @@
"dev": true,
"license": "MIT"
},
+ "node_modules/@types/triple-beam": {
+ "version": "1.3.5",
+ "resolved": "https://registry.npmjs.org/@types/triple-beam/-/triple-beam-1.3.5.tgz",
+ "integrity": "sha512-6WaYesThRMCl19iryMYP7/x2OVgCtbIVflDGFpWnb9irXI3UjYE4AzmYuiUKY1AJstGijoY+MgUszMgRxIYTYw==",
+ "dev": true,
+ "license": "MIT"
+ },
"node_modules/@types/trusted-types": {
"version": "2.0.7",
"resolved": "https://registry.npmjs.org/@types/trusted-types/-/trusted-types-2.0.7.tgz",
@@ -8445,6 +8537,13 @@
"dev": true,
"license": "MIT"
},
+ "node_modules/async": {
+ "version": "3.2.6",
+ "resolved": "https://registry.npmjs.org/async/-/async-3.2.6.tgz",
+ "integrity": "sha512-htCUDlxyyCLMgaM3xXg0C0LW2xqfuQ6p05pCEIsXuyQ+a1koYKTuBMzRNwmybfLgvJDMd0r1LTn4+E0Ti6C2AA==",
+ "dev": true,
+ "license": "MIT"
+ },
"node_modules/async-function": {
"version": "1.0.0",
"resolved": "https://registry.npmjs.org/async-function/-/async-function-1.0.0.tgz",
@@ -9705,6 +9804,13 @@
"dev": true,
"license": "MIT"
},
+ "node_modules/enabled": {
+ "version": "2.0.0",
+ "resolved": "https://registry.npmjs.org/enabled/-/enabled-2.0.0.tgz",
+ "integrity": "sha512-AKrN98kuwOzMIdAizXGI86UFBoo26CL21UM763y1h/GMSJ4/OHU9k2YlsmBpyScFo/wbLzWQJBMCW4+IO3/+OQ==",
+ "dev": true,
+ "license": "MIT"
+ },
"node_modules/encodeurl": {
"version": "2.0.0",
"resolved": "https://registry.npmjs.org/encodeurl/-/encodeurl-2.0.0.tgz",
@@ -10856,6 +10962,13 @@
}
}
},
+ "node_modules/fecha": {
+ "version": "4.2.3",
+ "resolved": "https://registry.npmjs.org/fecha/-/fecha-4.2.3.tgz",
+ "integrity": "sha512-OP2IUU6HeYKJi3i0z4A19kHMQoLVs4Hc+DPqqxI2h/DPZHTm/vjsfC6P0b4jCMy14XizLBqvndQ+UilD7707Jw==",
+ "dev": true,
+ "license": "MIT"
+ },
"node_modules/fflate": {
"version": "0.4.8",
"resolved": "https://registry.npmjs.org/fflate/-/fflate-0.4.8.tgz",
@@ -10875,6 +10988,16 @@
"node": ">=16.0.0"
}
},
+ "node_modules/file-stream-rotator": {
+ "version": "0.6.1",
+ "resolved": "https://registry.npmjs.org/file-stream-rotator/-/file-stream-rotator-0.6.1.tgz",
+ "integrity": "sha512-u+dBid4PvZw17PmDeRcNOtCP9CCK/9lRN2w+r1xIS7yOL9JFrIBKTvrYsxT4P0pGtThYTn++QS5ChHaUov3+zQ==",
+ "dev": true,
+ "license": "MIT",
+ "dependencies": {
+ "moment": "^2.29.1"
+ }
+ },
"node_modules/fill-range": {
"version": "7.1.1",
"resolved": "https://registry.npmjs.org/fill-range/-/fill-range-7.1.1.tgz",
@@ -10959,6 +11082,13 @@
"dev": true,
"license": "ISC"
},
+ "node_modules/fn.name": {
+ "version": "1.1.0",
+ "resolved": "https://registry.npmjs.org/fn.name/-/fn.name-1.1.0.tgz",
+ "integrity": "sha512-GRnmB5gPyJpAhTQdSZTSp9uaPSvl09KoYcMQtsB9rQoOmzs9dH6ffeccH+Z+cv6P68Hu5bC6JjRh4Ah/mHSNRw==",
+ "dev": true,
+ "license": "MIT"
+ },
"node_modules/follow-redirects": {
"version": "1.16.0",
"resolved": "https://registry.npmjs.org/follow-redirects/-/follow-redirects-1.16.0.tgz",
@@ -12274,6 +12404,19 @@
"url": "https://github.com/sponsors/ljharb"
}
},
+ "node_modules/is-stream": {
+ "version": "2.0.1",
+ "resolved": "https://registry.npmjs.org/is-stream/-/is-stream-2.0.1.tgz",
+ "integrity": "sha512-hFoiJiTl63nn+kstHGBtewWSKnQLpyb155KHheA1l39uvtO9nWIop1p3udqPcUd/xbF1VLMO4n7OI6p7RbngDg==",
+ "dev": true,
+ "license": "MIT",
+ "engines": {
+ "node": ">=8"
+ },
+ "funding": {
+ "url": "https://github.com/sponsors/sindresorhus"
+ }
+ },
"node_modules/is-string": {
"version": "1.1.1",
"resolved": "https://registry.npmjs.org/is-string/-/is-string-1.1.1.tgz",
@@ -12630,6 +12773,13 @@
"node": ">=6"
}
},
+ "node_modules/kuler": {
+ "version": "2.0.0",
+ "resolved": "https://registry.npmjs.org/kuler/-/kuler-2.0.0.tgz",
+ "integrity": "sha512-Xq9nH7KlWZmXAtodXDDRE7vs6DU1gTU8zYDHDiWLSip45Egwq3plLHzPn27NgvzL2r1LMPC1vdqh98sQxtqj4A==",
+ "dev": true,
+ "license": "MIT"
+ },
"node_modules/language-subtag-registry": {
"version": "0.3.23",
"resolved": "https://registry.npmjs.org/language-subtag-registry/-/language-subtag-registry-0.3.23.tgz",
@@ -13057,6 +13207,24 @@
"url": "https://github.com/chalk/slice-ansi?sponsor=1"
}
},
+ "node_modules/logform": {
+ "version": "2.7.0",
+ "resolved": "https://registry.npmjs.org/logform/-/logform-2.7.0.tgz",
+ "integrity": "sha512-TFYA4jnP7PVbmlBIfhlSe+WKxs9dklXMTEGcBCIvLhE/Tn3H6Gk1norupVW7m5Cnd4bLcr08AytbyV/xj7f/kQ==",
+ "dev": true,
+ "license": "MIT",
+ "dependencies": {
+ "@colors/colors": "1.6.0",
+ "@types/triple-beam": "^1.3.2",
+ "fecha": "^4.2.0",
+ "ms": "^2.1.1",
+ "safe-stable-stringify": "^2.3.1",
+ "triple-beam": "^1.3.0"
+ },
+ "engines": {
+ "node": ">= 12.0.0"
+ }
+ },
"node_modules/long": {
"version": "5.3.2",
"resolved": "https://registry.npmjs.org/long/-/long-5.3.2.tgz",
@@ -14227,6 +14395,16 @@
"node": ">=10"
}
},
+ "node_modules/moment": {
+ "version": "2.30.1",
+ "resolved": "https://registry.npmjs.org/moment/-/moment-2.30.1.tgz",
+ "integrity": "sha512-uEmtNhbDOrWPFS+hdjFCBfy9f2YoyzRpwcl+DqpC6taX21FzsTLQVbMV/W7PzNSX6x/bhC1zA3c2UQ5NzH6how==",
+ "dev": true,
+ "license": "MIT",
+ "engines": {
+ "node": "*"
+ }
+ },
"node_modules/monaco-editor": {
"version": "0.55.1",
"resolved": "https://registry.npmjs.org/monaco-editor/-/monaco-editor-0.55.1.tgz",
@@ -14533,6 +14711,16 @@
"node": ">=0.10.0"
}
},
+ "node_modules/object-hash": {
+ "version": "3.0.0",
+ "resolved": "https://registry.npmjs.org/object-hash/-/object-hash-3.0.0.tgz",
+ "integrity": "sha512-RSn9F68PjH9HqtltsSnqYC1XXoWe9Bju5+213R98cNGttag9q9yAOTzdbsqvIa7aNm5WffBZFpWYr2aWrklWAw==",
+ "dev": true,
+ "license": "MIT",
+ "engines": {
+ "node": ">= 6"
+ }
+ },
"node_modules/object-inspect": {
"version": "1.13.4",
"resolved": "https://registry.npmjs.org/object-inspect/-/object-inspect-1.13.4.tgz",
@@ -14662,6 +14850,16 @@
"node": ">= 0.8"
}
},
+ "node_modules/one-time": {
+ "version": "1.0.0",
+ "resolved": "https://registry.npmjs.org/one-time/-/one-time-1.0.0.tgz",
+ "integrity": "sha512-5DXOiRKwuSEcQ/l0kGCF6Q3jcADFv5tSmRaJck/OqkVFcOzutB134KRSfF0xDrL39MNnqxbHBbUUcjZIhTgb2g==",
+ "dev": true,
+ "license": "MIT",
+ "dependencies": {
+ "fn.name": "1.x.x"
+ }
+ },
"node_modules/onetime": {
"version": "7.0.0",
"resolved": "https://registry.npmjs.org/onetime/-/onetime-7.0.0.tgz",
@@ -15648,6 +15846,21 @@
"react-dom": ">=16.6.0"
}
},
+ "node_modules/readable-stream": {
+ "version": "3.6.2",
+ "resolved": "https://registry.npmjs.org/readable-stream/-/readable-stream-3.6.2.tgz",
+ "integrity": "sha512-9u/sniCrY3D5WdsERHzHE4G2YCXqoG5FTHUiCC4SIbr6XcLZBY05ya9EKjYek9O5xOAwjGq+1JdGBAS7Q9ScoA==",
+ "dev": true,
+ "license": "MIT",
+ "dependencies": {
+ "inherits": "^2.0.3",
+ "string_decoder": "^1.1.1",
+ "util-deprecate": "^1.0.1"
+ },
+ "engines": {
+ "node": ">= 6"
+ }
+ },
"node_modules/readdirp": {
"version": "4.1.2",
"resolved": "https://registry.npmjs.org/readdirp/-/readdirp-4.1.2.tgz",
@@ -16158,6 +16371,16 @@
"url": "https://github.com/sponsors/ljharb"
}
},
+ "node_modules/safe-stable-stringify": {
+ "version": "2.5.0",
+ "resolved": "https://registry.npmjs.org/safe-stable-stringify/-/safe-stable-stringify-2.5.0.tgz",
+ "integrity": "sha512-b3rppTKm9T+PsVCBEOUR46GWI7fdOs00VKZ1+9c1EWDaDMvjQc6tUwuFyIprgGgTcWoVHSKrU8H31ZHA2e0RHA==",
+ "dev": true,
+ "license": "MIT",
+ "engines": {
+ "node": ">=10"
+ }
+ },
"node_modules/safer-buffer": {
"version": "2.1.2",
"resolved": "https://registry.npmjs.org/safer-buffer/-/safer-buffer-2.1.2.tgz",
@@ -16619,6 +16842,16 @@
"node": ">=12.0.0"
}
},
+ "node_modules/stack-trace": {
+ "version": "0.0.10",
+ "resolved": "https://registry.npmjs.org/stack-trace/-/stack-trace-0.0.10.tgz",
+ "integrity": "sha512-KGzahc7puUKkzyMt+IqAep+TVNbKP+k2Lmwhub39m1AsTSkaDutx56aDCo+HLDzf/D26BIHTJWNiTG1KAJiQCg==",
+ "dev": true,
+ "license": "MIT",
+ "engines": {
+ "node": "*"
+ }
+ },
"node_modules/stackback": {
"version": "0.0.2",
"resolved": "https://registry.npmjs.org/stackback/-/stackback-0.0.2.tgz",
@@ -16669,6 +16902,16 @@
"dev": true,
"license": "MIT"
},
+ "node_modules/string_decoder": {
+ "version": "1.3.0",
+ "resolved": "https://registry.npmjs.org/string_decoder/-/string_decoder-1.3.0.tgz",
+ "integrity": "sha512-hkRX8U1WjJFd8LsDJ2yQ/wWWxaopEsABU1XfkM8A+j0+85JAGppt16cr1Whg6KIbb4okU6Mql6BOj+uup/wKeA==",
+ "dev": true,
+ "license": "MIT",
+ "dependencies": {
+ "safe-buffer": "~5.2.0"
+ }
+ },
"node_modules/string-argv": {
"version": "0.3.2",
"resolved": "https://registry.npmjs.org/string-argv/-/string-argv-0.3.2.tgz",
@@ -17028,6 +17271,13 @@
"url": "https://opencollective.com/webpack"
}
},
+ "node_modules/text-hex": {
+ "version": "1.0.0",
+ "resolved": "https://registry.npmjs.org/text-hex/-/text-hex-1.0.0.tgz",
+ "integrity": "sha512-uuVGNWzgJ4yhRaNSiubPY7OjISw4sw4E5Uv0wbjp+OzcbmVU/rsT8ujgcXJhn9ypzsgr5vlzpPqP+MBBKcGvbg==",
+ "dev": true,
+ "license": "MIT"
+ },
"node_modules/tinybench": {
"version": "2.9.0",
"resolved": "https://registry.npmjs.org/tinybench/-/tinybench-2.9.0.tgz",
@@ -17167,6 +17417,16 @@
"url": "https://github.com/sponsors/wooorm"
}
},
+ "node_modules/triple-beam": {
+ "version": "1.4.1",
+ "resolved": "https://registry.npmjs.org/triple-beam/-/triple-beam-1.4.1.tgz",
+ "integrity": "sha512-aZbgViZrg1QNcG+LULa7nhZpJTZSLm/mXnHXnbAbjmN5aSa0y7V+wvv6+4WaBtpISJzThKy+PIPxc1Nq1EJ9mg==",
+ "dev": true,
+ "license": "MIT",
+ "engines": {
+ "node": ">= 14.0.0"
+ }
+ },
"node_modules/trough": {
"version": "2.2.0",
"resolved": "https://registry.npmjs.org/trough/-/trough-2.2.0.tgz",
@@ -18239,6 +18499,63 @@
"node": ">=8"
}
},
+ "node_modules/winston": {
+ "version": "3.19.0",
+ "resolved": "https://registry.npmjs.org/winston/-/winston-3.19.0.tgz",
+ "integrity": "sha512-LZNJgPzfKR+/J3cHkxcpHKpKKvGfDZVPS4hfJCc4cCG0CgYzvlD6yE/S3CIL/Yt91ak327YCpiF/0MyeZHEHKA==",
+ "dev": true,
+ "license": "MIT",
+ "dependencies": {
+ "@colors/colors": "^1.6.0",
+ "@dabh/diagnostics": "^2.0.8",
+ "async": "^3.2.3",
+ "is-stream": "^2.0.0",
+ "logform": "^2.7.0",
+ "one-time": "^1.0.0",
+ "readable-stream": "^3.4.0",
+ "safe-stable-stringify": "^2.3.1",
+ "stack-trace": "0.0.x",
+ "triple-beam": "^1.3.0",
+ "winston-transport": "^4.9.0"
+ },
+ "engines": {
+ "node": ">= 12.0.0"
+ }
+ },
+ "node_modules/winston-daily-rotate-file": {
+ "version": "5.0.0",
+ "resolved": "https://registry.npmjs.org/winston-daily-rotate-file/-/winston-daily-rotate-file-5.0.0.tgz",
+ "integrity": "sha512-JDjiXXkM5qvwY06733vf09I2wnMXpZEhxEVOSPenZMii+g7pcDcTBt2MRugnoi8BwVSuCT2jfRXBUy+n1Zz/Yw==",
+ "dev": true,
+ "license": "MIT",
+ "dependencies": {
+ "file-stream-rotator": "^0.6.1",
+ "object-hash": "^3.0.0",
+ "triple-beam": "^1.4.1",
+ "winston-transport": "^4.7.0"
+ },
+ "engines": {
+ "node": ">=8"
+ },
+ "peerDependencies": {
+ "winston": "^3"
+ }
+ },
+ "node_modules/winston-transport": {
+ "version": "4.9.0",
+ "resolved": "https://registry.npmjs.org/winston-transport/-/winston-transport-4.9.0.tgz",
+ "integrity": "sha512-8drMJ4rkgaPo1Me4zD/3WLfI/zPdA9o2IipKODunnGDcuqbHwjsbB79ylv04LCGGzU0xQ6vTznOMpQGaLhhm6A==",
+ "dev": true,
+ "license": "MIT",
+ "dependencies": {
+ "logform": "^2.7.0",
+ "readable-stream": "^3.6.2",
+ "triple-beam": "^1.3.0"
+ },
+ "engines": {
+ "node": ">= 12.0.0"
+ }
+ },
"node_modules/word-wrap": {
"version": "1.2.5",
"resolved": "https://registry.npmjs.org/word-wrap/-/word-wrap-1.2.5.tgz",
diff --git a/package.json b/package.json
index 390c73231d..f57b673767 100644
--- a/package.json
+++ b/package.json
@@ -153,7 +153,9 @@
"tailwindcss": "4.2.4",
"typescript": "6.0.3",
"vite-plugin-svgr": "5.2.0",
- "vitest": "4.1.5"
+ "vitest": "4.1.5",
+ "winston": "^3.19.0",
+ "winston-daily-rotate-file": "^5.0.0"
},
"packageManager": "[email protected]",
"volta": {
diff --git a/scripts/dev-safe.mjs b/scripts/dev-safe.mjs
index e93aaa5e34..e809d7e7b0 100644
--- a/scripts/dev-safe.mjs
+++ b/scripts/dev-safe.mjs
@@ -25,6 +25,7 @@ import {
// Docker entrypoint can run it as a CLI. Re-exported below for back-compat
// (dev-with-automation.mjs and tests still import it from here).
import { buildRuntimeServicesInfo } from "./runtime-services-info.mjs";
+import { fileLog, stripAnsi } from "./logger.mjs";
// ── Centralized config (single source of truth for versions, ports, etc.) ───
const __dev_safe_dirname = path.dirname(fileURLToPath(import.meta.url));
@@ -834,13 +835,16 @@ function spawnProcess(command, args, options = {}) {
child.once("error", (error) => {
if (isEnoentError(error) && command === "uvx") {
- console.error(formatMissingUvxGuidance(options?.cwd));
+ const msg = formatMissingUvxGuidance(options?.cwd);
+ console.error(msg);
+ fileLog("error", stripAnsi(msg));
} else if (isEnoentError(error)) {
- console.error(
- `Failed to start ${command}. Make sure it is installed and on your PATH.`,
- );
+ const msg = `Failed to start ${command}. Make sure it is installed and on your PATH.`;
+ console.error(msg);
+ fileLog("error", msg);
} else {
console.error(`Failed to start ${command}:`, error);
+ fileLog("error", `Failed to start ${command}: ${error.message}`);
}
});
@@ -849,9 +853,12 @@ function spawnProcess(command, args, options = {}) {
async function main() {
console.log("Starting isolated agent-server + frontend dev stack...");
+ fileLog("info", "Starting isolated agent-server + frontend dev stack...");
validateFrontendDependencies();
console.log("Frontend dependencies found.");
+ fileLog("info", "Frontend dependencies found.");
console.log("Allocating ports...");
+ fileLog("info", "Allocating ports...");
// Use async config builder with dynamic port allocation
const config = await buildSafeDevConfigAsync();
@@ -890,6 +897,16 @@ async function main() {
console.log(`- secret key: ${secretKeySource}`);
console.log(`- session API key: ${sessionKeySource}`);
console.log("");
+ fileLog(
+ "info",
+ [
+ "Agent-server stack config:",
+ ` agent-server: ${agentServerCmd.source}`,
+ ` backend: ${config.backendBaseUrl}`,
+ ` working dir: ${config.workingDir}`,
+ ` state dir: ${config.stateDir}`,
+ ].join("\n"),
+ );
const backend = spawnProcess(
agentServerCmd.command,
@@ -990,7 +1007,9 @@ async function main() {
backend.once("exit", (code) => {
if (!shuttingDown) {
- console.error(`agent-server exited unexpectedly with code ${code ?? 0}`);
+ const msg = `agent-server exited unexpectedly with code ${code ?? 0}`;
+ console.error(msg);
+ fileLog("error", msg);
shutdown();
process.exitCode = code ?? 1;
}
@@ -1077,7 +1096,12 @@ if (
import.meta.url === pathToFileURL(process.argv[1]).href
) {
main().catch((error) => {
- console.error(error instanceof Error ? error.message : error);
+ const msg = error instanceof Error ? error.message : String(error);
+ console.error(msg);
+ fileLog("error", `Fatal error: ${msg}`);
+ if (error instanceof Error && error.stack) {
+ fileLog("error", error.stack);
+ }
process.exit(1);
});
}
diff --git a/scripts/dev-with-automation.mjs b/scripts/dev-with-automation.mjs
index 6393fe539c..9779e8ec87 100644
--- a/scripts/dev-with-automation.mjs
+++ b/scripts/dev-with-automation.mjs
@@ -68,6 +68,7 @@ import {
isProcessRunning,
signalProcessTree,
} from "./dev-process-utils.mjs";
+import { fileLog, stripAnsi } from "./logger.mjs";
const __dirname = dirname(fileURLToPath(import.meta.url));
const projectRoot = resolve(__dirname, "..");
@@ -105,18 +106,22 @@ const c = {
function logService(name, message, color = c.reset) {
const ts = new Date().toISOString().split("T")[1].split(".")[0];
console.log(`${c.dim}${ts}${c.reset} ${color}[${name}]${c.reset} ${message}`);
+ fileLog("info", `[${name}] ${stripAnsi(message)}`);
}
function logStep(step, message) {
console.log(`${c.cyan}[${step}]${c.reset} ${message}`);
+ fileLog("info", `[${step}] ${message}`);
}
function logSuccess(message) {
console.log(`${c.green}βœ“${c.reset} ${message}`);
+ fileLog("info", `βœ“ ${message}`);
}
function logError(message) {
console.error(`${c.red}βœ—${c.reset} ${message}`);
+ fileLog("error", `βœ— ${stripAnsi(message)}`);
}
/**
@@ -472,7 +477,9 @@ function checkPrerequisites({
if (checkUvx) {
if (!commandExists("uvx")) {
- console.error(formatMissingUvxGuidance(projectRoot));
+ const uvxGuidance = formatMissingUvxGuidance(projectRoot);
+ console.error(uvxGuidance);
+ fileLog("error", stripAnsi(uvxGuidance));
process.exit(1);
}
logSuccess("uvx found");
@@ -862,6 +869,7 @@ function shutdown() {
console.log("");
console.log(`${c.yellow}Shutting down...${c.reset}`);
+ fileLog("info", "Shutting down...");
for (const [name, proc] of processes) {
logService(name, "Stopping...", c.dim);
@@ -1133,6 +1141,20 @@ function printBanner(config) {
console.log(`${c.dim}State directory: ${config.stateDir}${c.reset}`);
console.log(`${c.dim}Press Ctrl+C to stop${c.reset}`);
console.log("");
+
+ // Write a compact plain-text summary to the log file.
+ const summary = [
+ `${stackName} β€” started`,
+ ` Ingress: http://localhost:${config.ingressPort}/`,
+ ...(config.launchFrontend
+ ? [` Main UI: http://localhost:${config.ingressPort}/`]
+ : []),
+ ...(config.launchAutomation
+ ? [` API Docs: http://localhost:${config.ingressPort}/api/automation/docs`]
+ : []),
+ ` State directory: ${config.stateDir}`,
+ ];
+ fileLog("info", summary.join("\n"));
}
async function main(options = {}) {
@@ -1186,6 +1208,7 @@ async function main(options = {}) {
console.log("");
console.log(`${c.cyan}${c.bold}${titleWithMode}${c.reset}`);
console.log("");
+ fileLog("info", titleWithMode);
// Setup phase
checkPrerequisites({
@@ -1397,6 +1420,7 @@ if (isMainModule) {
logError(`Fatal error: ${err.message}`);
if (err.stack) {
console.error(c.dim + err.stack + c.reset);
+ fileLog("error", err.stack);
}
process.exit(1);
});
diff --git a/scripts/logger.mjs b/scripts/logger.mjs
new file mode 100644
index 0000000000..9c93bdd64a
--- /dev/null
+++ b/scripts/logger.mjs
@@ -0,0 +1,77 @@
+/**
+ * Shared file logger for agent-canvas dev scripts.
+ *
+ * Writes log output to a daily-rotating file under <project-root>/logs/
+ * alongside the existing console output (which is unchanged).
+ *
+ * File naming: logs/agent-canvas.YYYY-MM-DD.log
+ * Retention: 7 days (files older than 7 days are automatically deleted)
+ */
+
+import { mkdirSync } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+import process from "node:process";
+import { createLogger, format } from "winston";
+import DailyRotateFile from "winston-daily-rotate-file";
+
+// Mirror the state-directory logic from dev-safe.mjs so log files live
+// alongside all other agent-canvas runtime state (e.g. ~/.openhands/agent-canvas).
+// The same env var (OH_CANVAS_SAFE_STATE_DIR) overrides both.
+const stateDir =
+ process.env.OH_CANVAS_SAFE_STATE_DIR ||
+ join(homedir(), ".openhands", "agent-canvas");
+const logDir = join(stateDir, "logs");
+
+// Ensure the logs directory exists before the transport tries to open a file.
+mkdirSync(logDir, { recursive: true });
+
+// Matches any ANSI CSI escape sequence (colors, cursor movement, etc.).
+const ANSI_RE = /\x1b\[[0-9;]*m/g;
+
+/**
+ * Remove ANSI escape codes so log files contain clean plain text.
+ * @param {string} str
+ * @returns {string}
+ */
+export function stripAnsi(str) {
+ return typeof str === "string" ? str.replace(ANSI_RE, "") : String(str);
+}
+
+const fileTransport = new DailyRotateFile({
+ dirname: logDir,
+ filename: "agent-canvas.%DATE%.log",
+ datePattern: "YYYY-MM-DD",
+ maxFiles: "7d",
+ // Audit file tracks which rotated files exist; kept alongside log files.
+ auditFile: join(logDir, ".log-audit.json"),
+ createSymlink: false,
+});
+
+const fileLogger = createLogger({
+ level: "debug",
+ format: format.combine(
+ format.timestamp({ format: "YYYY-MM-DD HH:mm:ss" }),
+ format.printf(
+ ({ timestamp, level, message }) =>
+ `${timestamp} [${level.toUpperCase().padEnd(5)}] ${message}`,
+ ),
+ ),
+ transports: [fileTransport],
+});
+
+// Swallow any transport-level errors (e.g. disk full) so a logging failure
+// never crashes the dev server.
+fileLogger.on("error", () => {});
+fileTransport.on("error", () => {});
+
+/**
+ * Write a message to the rotating log file.
+ * ANSI escape codes are stripped automatically; console output is unaffected.
+ *
+ * @param {'info' | 'warn' | 'error' | 'debug'} level
+ * @param {string} message
+ */
+export function fileLog(level, message) {
+ fileLogger.log(level, stripAnsi(message));
+}