feed-the-machine 1.5.0 → 1.6.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (224) hide show
  1. package/LICENSE +21 -21
  2. package/README.md +170 -170
  3. package/bin/generate-manifest.mjs +463 -463
  4. package/bin/install.mjs +491 -491
  5. package/docs/HOOKS.md +243 -243
  6. package/docs/INBOX.md +233 -233
  7. package/ftm/SKILL.md +122 -122
  8. package/ftm-audit/SKILL.md +623 -541
  9. package/ftm-audit/references/protocols/PROJECT-PATTERNS.md +91 -91
  10. package/ftm-audit/references/protocols/RUNTIME-WIRING.md +66 -66
  11. package/ftm-audit/references/protocols/WIRING-CONTRACTS.md +135 -135
  12. package/ftm-audit/references/strategies/AUTO-FIX-STRATEGIES.md +69 -69
  13. package/ftm-audit/references/templates/REPORT-FORMAT.md +96 -96
  14. package/ftm-audit/scripts/run-knip.sh +23 -23
  15. package/ftm-audit.yml +2 -2
  16. package/ftm-brainstorm/SKILL.md +498 -498
  17. package/ftm-brainstorm/evals/evals.json +100 -100
  18. package/ftm-brainstorm/evals/promptfoo.yaml +109 -109
  19. package/ftm-brainstorm/references/agent-prompts.md +224 -224
  20. package/ftm-brainstorm/references/plan-template.md +121 -121
  21. package/ftm-brainstorm.yml +2 -2
  22. package/ftm-browse/SKILL.md +454 -454
  23. package/ftm-browse/daemon/browser-manager.ts +206 -206
  24. package/ftm-browse/daemon/bun.lock +30 -30
  25. package/ftm-browse/daemon/cli.ts +347 -347
  26. package/ftm-browse/daemon/commands.ts +410 -410
  27. package/ftm-browse/daemon/main.ts +357 -357
  28. package/ftm-browse/daemon/package.json +17 -17
  29. package/ftm-browse/daemon/server.ts +189 -189
  30. package/ftm-browse/daemon/snapshot.ts +519 -519
  31. package/ftm-browse/daemon/tsconfig.json +22 -22
  32. package/ftm-browse.yml +4 -4
  33. package/ftm-capture/SKILL.md +370 -370
  34. package/ftm-capture.yml +4 -4
  35. package/ftm-codex-gate/SKILL.md +361 -361
  36. package/ftm-codex-gate.yml +2 -2
  37. package/ftm-config/SKILL.md +345 -345
  38. package/ftm-config.default.yml +82 -80
  39. package/ftm-config.yml +2 -2
  40. package/ftm-council/SKILL.md +416 -416
  41. package/ftm-council/references/prompts/CLAUDE-INVESTIGATION.md +60 -60
  42. package/ftm-council/references/prompts/CODEX-INVESTIGATION.md +58 -58
  43. package/ftm-council/references/prompts/GEMINI-INVESTIGATION.md +58 -58
  44. package/ftm-council/references/prompts/REBUTTAL-TEMPLATE.md +57 -57
  45. package/ftm-council/references/protocols/PREREQUISITES.md +47 -47
  46. package/ftm-council/references/protocols/STEP-0-FRAMING.md +46 -46
  47. package/ftm-council.yml +2 -2
  48. package/ftm-dashboard/SKILL.md +163 -163
  49. package/ftm-dashboard.yml +4 -4
  50. package/ftm-debug/SKILL.md +1037 -1037
  51. package/ftm-debug/references/phases/PHASE-0-INTAKE.md +58 -58
  52. package/ftm-debug/references/phases/PHASE-1-TRIAGE.md +46 -46
  53. package/ftm-debug/references/phases/PHASE-2-WAR-ROOM-AGENTS.md +279 -279
  54. package/ftm-debug/references/phases/PHASE-3-TO-6-EXECUTION.md +436 -436
  55. package/ftm-debug/references/protocols/BLACKBOARD.md +86 -86
  56. package/ftm-debug/references/protocols/EDGE-CASES.md +103 -103
  57. package/ftm-debug.yml +2 -2
  58. package/ftm-diagram/SKILL.md +277 -277
  59. package/ftm-diagram.yml +2 -2
  60. package/ftm-executor/SKILL.md +777 -767
  61. package/ftm-executor/references/STYLE-TEMPLATE.md +73 -73
  62. package/ftm-executor/references/phases/PHASE-0-VERIFICATION.md +62 -62
  63. package/ftm-executor/references/phases/PHASE-2-AGENT-ASSEMBLY.md +34 -34
  64. package/ftm-executor/references/phases/PHASE-3-WORKTREES.md +38 -38
  65. package/ftm-executor/references/phases/PHASE-4-5-AUDIT.md +72 -72
  66. package/ftm-executor/references/phases/PHASE-4-DISPATCH.md +66 -66
  67. package/ftm-executor/references/phases/PHASE-5-5-CODEX-GATE.md +73 -73
  68. package/ftm-executor/references/protocols/DOCUMENTATION-BOOTSTRAP.md +36 -36
  69. package/ftm-executor/references/protocols/MODEL-PROFILE.md +59 -44
  70. package/ftm-executor/references/protocols/PROGRESS-TRACKING.md +66 -66
  71. package/ftm-executor/runtime/ftm-runtime.mjs +252 -252
  72. package/ftm-executor/runtime/package.json +8 -8
  73. package/ftm-executor.yml +2 -2
  74. package/ftm-git/SKILL.md +441 -441
  75. package/ftm-git/evals/evals.json +26 -26
  76. package/ftm-git/evals/promptfoo.yaml +75 -75
  77. package/ftm-git/hooks/post-commit-experience.sh +92 -92
  78. package/ftm-git/references/patterns/SECRET-PATTERNS.md +104 -104
  79. package/ftm-git/references/protocols/REMEDIATION.md +139 -139
  80. package/ftm-git/scripts/pre-commit-secrets.sh +110 -110
  81. package/ftm-git.yml +2 -2
  82. package/ftm-inbox/backend/adapters/_retry.py +64 -64
  83. package/ftm-inbox/backend/adapters/base.py +230 -230
  84. package/ftm-inbox/backend/adapters/freshservice.py +104 -104
  85. package/ftm-inbox/backend/adapters/gmail.py +125 -125
  86. package/ftm-inbox/backend/adapters/jira.py +136 -136
  87. package/ftm-inbox/backend/adapters/registry.py +192 -192
  88. package/ftm-inbox/backend/adapters/slack.py +110 -110
  89. package/ftm-inbox/backend/db/connection.py +54 -54
  90. package/ftm-inbox/backend/db/schema.py +78 -78
  91. package/ftm-inbox/backend/executor/__init__.py +7 -7
  92. package/ftm-inbox/backend/executor/engine.py +149 -149
  93. package/ftm-inbox/backend/executor/step_runner.py +98 -98
  94. package/ftm-inbox/backend/main.py +103 -103
  95. package/ftm-inbox/backend/models/__init__.py +1 -1
  96. package/ftm-inbox/backend/models/unified_task.py +36 -36
  97. package/ftm-inbox/backend/planner/__init__.py +6 -6
  98. package/ftm-inbox/backend/planner/generator.py +127 -127
  99. package/ftm-inbox/backend/planner/schema.py +34 -34
  100. package/ftm-inbox/backend/requirements.txt +5 -5
  101. package/ftm-inbox/backend/routes/execute.py +186 -186
  102. package/ftm-inbox/backend/routes/health.py +52 -52
  103. package/ftm-inbox/backend/routes/inbox.py +68 -68
  104. package/ftm-inbox/backend/routes/plan.py +271 -271
  105. package/ftm-inbox/bin/launchagent.mjs +91 -91
  106. package/ftm-inbox/bin/setup.mjs +188 -188
  107. package/ftm-inbox/bin/start.sh +10 -10
  108. package/ftm-inbox/bin/status.sh +17 -17
  109. package/ftm-inbox/bin/stop.sh +8 -8
  110. package/ftm-inbox/config.example.yml +55 -55
  111. package/ftm-inbox/package-lock.json +2898 -2898
  112. package/ftm-inbox/package.json +26 -26
  113. package/ftm-inbox/postcss.config.js +6 -6
  114. package/ftm-inbox/src/app.css +199 -199
  115. package/ftm-inbox/src/app.html +18 -18
  116. package/ftm-inbox/src/lib/api.ts +166 -166
  117. package/ftm-inbox/src/lib/components/ExecutionLog.svelte +81 -81
  118. package/ftm-inbox/src/lib/components/InboxFeed.svelte +143 -143
  119. package/ftm-inbox/src/lib/components/PlanStep.svelte +271 -271
  120. package/ftm-inbox/src/lib/components/PlanView.svelte +206 -206
  121. package/ftm-inbox/src/lib/components/StreamPanel.svelte +99 -99
  122. package/ftm-inbox/src/lib/components/TaskCard.svelte +190 -190
  123. package/ftm-inbox/src/lib/components/ui/EmptyState.svelte +63 -63
  124. package/ftm-inbox/src/lib/components/ui/KawaiiCard.svelte +86 -86
  125. package/ftm-inbox/src/lib/components/ui/PillButton.svelte +106 -106
  126. package/ftm-inbox/src/lib/components/ui/StatusBadge.svelte +67 -67
  127. package/ftm-inbox/src/lib/components/ui/StreamDrawer.svelte +149 -149
  128. package/ftm-inbox/src/lib/components/ui/ThemeToggle.svelte +80 -80
  129. package/ftm-inbox/src/lib/theme.ts +47 -47
  130. package/ftm-inbox/src/routes/+layout.svelte +76 -76
  131. package/ftm-inbox/src/routes/+page.svelte +401 -401
  132. package/ftm-inbox/svelte.config.js +12 -12
  133. package/ftm-inbox/tailwind.config.ts +63 -63
  134. package/ftm-inbox/tsconfig.json +13 -13
  135. package/ftm-inbox/vite.config.ts +6 -6
  136. package/ftm-intent/SKILL.md +241 -241
  137. package/ftm-intent.yml +2 -2
  138. package/ftm-manifest.json +3794 -3794
  139. package/ftm-map/SKILL.md +291 -291
  140. package/ftm-map/scripts/db.py +712 -712
  141. package/ftm-map/scripts/index.py +415 -415
  142. package/ftm-map/scripts/parser.py +224 -224
  143. package/ftm-map/scripts/queries/go-tags.scm +20 -20
  144. package/ftm-map/scripts/queries/javascript-tags.scm +35 -35
  145. package/ftm-map/scripts/queries/python-tags.scm +31 -31
  146. package/ftm-map/scripts/queries/ruby-tags.scm +19 -19
  147. package/ftm-map/scripts/queries/rust-tags.scm +37 -37
  148. package/ftm-map/scripts/queries/typescript-tags.scm +41 -41
  149. package/ftm-map/scripts/query.py +301 -301
  150. package/ftm-map/scripts/ranker.py +377 -377
  151. package/ftm-map/scripts/requirements.txt +5 -5
  152. package/ftm-map/scripts/setup-hooks.sh +27 -27
  153. package/ftm-map/scripts/setup.sh +56 -56
  154. package/ftm-map/scripts/test_db.py +364 -364
  155. package/ftm-map/scripts/test_parser.py +174 -174
  156. package/ftm-map/scripts/test_query.py +183 -183
  157. package/ftm-map/scripts/test_ranker.py +199 -199
  158. package/ftm-map/scripts/views.py +591 -591
  159. package/ftm-map.yml +2 -2
  160. package/ftm-mind/SKILL.md +1943 -1943
  161. package/ftm-mind/evals/promptfoo.yaml +142 -142
  162. package/ftm-mind/references/blackboard-schema.md +328 -328
  163. package/ftm-mind/references/complexity-guide.md +110 -110
  164. package/ftm-mind/references/event-registry.md +319 -319
  165. package/ftm-mind/references/mcp-inventory.md +296 -296
  166. package/ftm-mind/references/protocols/COMPLEXITY-SIZING.md +72 -72
  167. package/ftm-mind/references/protocols/MCP-HEURISTICS.md +32 -32
  168. package/ftm-mind/references/protocols/PLAN-APPROVAL.md +80 -80
  169. package/ftm-mind/references/reflexion-protocol.md +249 -249
  170. package/ftm-mind/references/routing/SCENARIOS.md +22 -22
  171. package/ftm-mind/references/routing-scenarios.md +35 -35
  172. package/ftm-mind.yml +2 -2
  173. package/ftm-pause/SKILL.md +395 -395
  174. package/ftm-pause/references/protocols/SKILL-RESTORE-PROTOCOLS.md +186 -186
  175. package/ftm-pause/references/protocols/VALIDATION.md +80 -80
  176. package/ftm-pause.yml +2 -2
  177. package/ftm-researcher/SKILL.md +275 -275
  178. package/ftm-researcher/evals/agent-diversity.yaml +17 -17
  179. package/ftm-researcher/evals/synthesis-quality.yaml +12 -12
  180. package/ftm-researcher/evals/trigger-accuracy.yaml +39 -39
  181. package/ftm-researcher/references/adaptive-search.md +116 -116
  182. package/ftm-researcher/references/agent-prompts.md +193 -193
  183. package/ftm-researcher/references/council-integration.md +193 -193
  184. package/ftm-researcher/references/output-format.md +203 -203
  185. package/ftm-researcher/references/synthesis-pipeline.md +165 -165
  186. package/ftm-researcher/scripts/score_credibility.py +234 -234
  187. package/ftm-researcher/scripts/validate_research.py +92 -92
  188. package/ftm-researcher.yml +2 -2
  189. package/ftm-resume/SKILL.md +518 -518
  190. package/ftm-resume/references/protocols/VALIDATION.md +172 -172
  191. package/ftm-resume.yml +2 -2
  192. package/ftm-retro/SKILL.md +380 -380
  193. package/ftm-retro/references/protocols/SCORING-RUBRICS.md +89 -89
  194. package/ftm-retro/references/templates/REPORT-FORMAT.md +109 -109
  195. package/ftm-retro.yml +2 -2
  196. package/ftm-routine/SKILL.md +170 -170
  197. package/ftm-routine.yml +4 -4
  198. package/ftm-state/blackboard/capabilities.json +5 -5
  199. package/ftm-state/blackboard/capabilities.schema.json +27 -27
  200. package/ftm-state/blackboard/context.json +23 -23
  201. package/ftm-state/blackboard/experiences/index.json +9 -9
  202. package/ftm-state/blackboard/patterns.json +6 -6
  203. package/ftm-state/schemas/context.schema.json +130 -130
  204. package/ftm-state/schemas/experience-index.schema.json +77 -77
  205. package/ftm-state/schemas/experience.schema.json +78 -78
  206. package/ftm-state/schemas/patterns.schema.json +44 -44
  207. package/ftm-upgrade/SKILL.md +194 -194
  208. package/ftm-upgrade/scripts/check-version.sh +76 -76
  209. package/ftm-upgrade/scripts/upgrade.sh +143 -143
  210. package/ftm-upgrade.yml +2 -2
  211. package/ftm-verify.yml +2 -2
  212. package/ftm.yml +2 -2
  213. package/hooks/ftm-blackboard-enforcer.sh +93 -93
  214. package/hooks/ftm-discovery-reminder.sh +90 -90
  215. package/hooks/ftm-drafts-gate.sh +61 -61
  216. package/hooks/ftm-event-logger.mjs +107 -107
  217. package/hooks/ftm-map-autodetect.sh +79 -79
  218. package/hooks/ftm-pending-sync-check.sh +22 -22
  219. package/hooks/ftm-plan-gate.sh +92 -92
  220. package/hooks/ftm-post-commit-trigger.sh +57 -57
  221. package/hooks/settings-template.json +81 -81
  222. package/install.sh +363 -363
  223. package/package.json +84 -84
  224. package/uninstall.sh +25 -25
@@ -1,206 +1,206 @@
1
- import * as fs from "fs";
2
- import * as path from "path";
3
- import { chromium, type Browser, type BrowserContext, type Page } from "playwright";
4
-
5
- const IDLE_TIMEOUT_MS = 30 * 60 * 1000; // 30 minutes
6
- const DEFAULT_USER_DATA_DIR = path.join(process.env.HOME || "~", ".ftm-browse", "user-data");
7
-
8
- class BrowserManager {
9
- private browser: Browser | null = null;
10
- private context: BrowserContext | null = null;
11
- private page: Page | null = null;
12
- private idleTimer: ReturnType<typeof setTimeout> | null = null;
13
- private shutdownCallback: (() => void) | null = null;
14
- private initPromise: Promise<void> | null = null;
15
- private userDataDir: string | null = null;
16
-
17
- setUserDataDir(dir: string | null): void {
18
- this.userDataDir = dir;
19
- }
20
-
21
- setShutdownCallback(cb: () => void): void {
22
- this.shutdownCallback = cb;
23
- }
24
-
25
- resetIdleTimer(): void {
26
- if (this.idleTimer) {
27
- clearTimeout(this.idleTimer);
28
- }
29
- this.idleTimer = setTimeout(() => {
30
- console.log("[browser-manager] 30min idle timeout reached, shutting down");
31
- void this.shutdown();
32
- }, IDLE_TIMEOUT_MS);
33
- }
34
-
35
- async initialize(): Promise<void> {
36
- // Short-circuit if already running (handles both ephemeral and persistent context modes)
37
- if (this.isRunning()) return;
38
-
39
- // Deduplicate concurrent init calls
40
- if (this.initPromise) {
41
- return this.initPromise;
42
- }
43
-
44
- this.initPromise = this._doInit().finally(() => {
45
- this.initPromise = null;
46
- });
47
- return this.initPromise;
48
- }
49
-
50
- private async _doInit(): Promise<void> {
51
- const launchArgs = [
52
- "--no-sandbox",
53
- "--disable-setuid-sandbox",
54
- "--disable-dev-shm-usage",
55
- "--disable-gpu",
56
- "--disable-background-networking",
57
- "--disable-default-apps",
58
- "--disable-extensions",
59
- "--disable-sync",
60
- "--disable-translate",
61
- "--metrics-recording-only",
62
- "--mute-audio",
63
- "--no-first-run",
64
- "--safebrowsing-disable-auto-update",
65
- ];
66
-
67
- const contextOptions = {
68
- viewport: { width: 1280, height: 800 } as { width: number; height: number } | null,
69
- userAgent:
70
- "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36",
71
- };
72
-
73
- if (this.userDataDir) {
74
- // Persistent context — cookies and session data survive daemon restarts
75
- const resolvedDir = this.userDataDir === "default" ? DEFAULT_USER_DATA_DIR : this.userDataDir;
76
- console.log(`[browser-manager] Launching Chromium with persistent context at: ${resolvedDir}`);
77
-
78
- if (!fs.existsSync(resolvedDir)) {
79
- fs.mkdirSync(resolvedDir, { recursive: true, mode: 0o700 });
80
- }
81
-
82
- // launchPersistentContext returns a BrowserContext directly (no separate Browser)
83
- this.context = await chromium.launchPersistentContext(resolvedDir, {
84
- headless: true,
85
- args: launchArgs,
86
- ...contextOptions,
87
- });
88
-
89
- // Reuse existing page if available, otherwise open a new one
90
- const existingPages = this.context.pages();
91
- this.page = existingPages.length > 0 ? existingPages[0] : await this.context.newPage();
92
- } else {
93
- // Ephemeral context — no persistence (default, safe)
94
- console.log("[browser-manager] Launching Chromium (ephemeral)...");
95
-
96
- this.browser = await chromium.launch({
97
- headless: true,
98
- args: launchArgs,
99
- });
100
-
101
- this.context = await this.browser.newContext(contextOptions);
102
- this.page = await this.context.newPage();
103
- }
104
-
105
- // Start idle timer
106
- this.resetIdleTimer();
107
-
108
- console.log("[browser-manager] Browser ready");
109
- }
110
-
111
- async getPage(): Promise<Page> {
112
- await this.initialize();
113
- this.resetIdleTimer();
114
-
115
- if (!this.page || this.page.isClosed()) {
116
- console.log("[browser-manager] Page was closed, creating new page");
117
- this.page = await this.context!.newPage();
118
- }
119
-
120
- return this.page;
121
- }
122
-
123
- async getOrCreatePage(tabIndex?: number): Promise<Page> {
124
- await this.initialize();
125
- this.resetIdleTimer();
126
-
127
- const pages = this.context!.pages();
128
-
129
- if (tabIndex !== undefined && tabIndex < pages.length) {
130
- this.page = pages[tabIndex];
131
- return this.page;
132
- }
133
-
134
- if (!this.page || this.page.isClosed()) {
135
- this.page = await this.context!.newPage();
136
- }
137
-
138
- return this.page;
139
- }
140
-
141
- async getAllPages(): Promise<Page[]> {
142
- if (!this.context) return [];
143
- return this.context.pages();
144
- }
145
-
146
- async setActivePage(index: number): Promise<Page | null> {
147
- if (!this.context) return null;
148
- const pages = this.context.pages();
149
- if (index < 0 || index >= pages.length) return null;
150
- this.page = pages[index];
151
- this.resetIdleTimer();
152
- return this.page;
153
- }
154
-
155
- async shutdown(): Promise<void> {
156
- if (this.idleTimer) {
157
- clearTimeout(this.idleTimer);
158
- this.idleTimer = null;
159
- }
160
-
161
- try {
162
- if (this.page && !this.page.isClosed()) {
163
- await this.page.close();
164
- }
165
- } catch {
166
- // Ignore close errors
167
- }
168
-
169
- try {
170
- if (this.context) {
171
- await this.context.close();
172
- }
173
- } catch {
174
- // Ignore close errors
175
- }
176
-
177
- try {
178
- if (this.browser) {
179
- await this.browser.close();
180
- }
181
- } catch {
182
- // Ignore close errors
183
- }
184
-
185
- this.page = null;
186
- this.context = null;
187
- this.browser = null;
188
-
189
- console.log("[browser-manager] Browser shut down");
190
-
191
- if (this.shutdownCallback) {
192
- this.shutdownCallback();
193
- }
194
- }
195
-
196
- isRunning(): boolean {
197
- // Persistent context mode: browser is null, check context instead
198
- if (this.userDataDir) {
199
- return this.context !== null;
200
- }
201
- return this.browser !== null && this.browser.isConnected();
202
- }
203
- }
204
-
205
- // Singleton instance
206
- export const browserManager = new BrowserManager();
1
+ import * as fs from "fs";
2
+ import * as path from "path";
3
+ import { chromium, type Browser, type BrowserContext, type Page } from "playwright";
4
+
5
+ const IDLE_TIMEOUT_MS = 30 * 60 * 1000; // 30 minutes
6
+ const DEFAULT_USER_DATA_DIR = path.join(process.env.HOME || "~", ".ftm-browse", "user-data");
7
+
8
+ class BrowserManager {
9
+ private browser: Browser | null = null;
10
+ private context: BrowserContext | null = null;
11
+ private page: Page | null = null;
12
+ private idleTimer: ReturnType<typeof setTimeout> | null = null;
13
+ private shutdownCallback: (() => void) | null = null;
14
+ private initPromise: Promise<void> | null = null;
15
+ private userDataDir: string | null = null;
16
+
17
+ setUserDataDir(dir: string | null): void {
18
+ this.userDataDir = dir;
19
+ }
20
+
21
+ setShutdownCallback(cb: () => void): void {
22
+ this.shutdownCallback = cb;
23
+ }
24
+
25
+ resetIdleTimer(): void {
26
+ if (this.idleTimer) {
27
+ clearTimeout(this.idleTimer);
28
+ }
29
+ this.idleTimer = setTimeout(() => {
30
+ console.log("[browser-manager] 30min idle timeout reached, shutting down");
31
+ void this.shutdown();
32
+ }, IDLE_TIMEOUT_MS);
33
+ }
34
+
35
+ async initialize(): Promise<void> {
36
+ // Short-circuit if already running (handles both ephemeral and persistent context modes)
37
+ if (this.isRunning()) return;
38
+
39
+ // Deduplicate concurrent init calls
40
+ if (this.initPromise) {
41
+ return this.initPromise;
42
+ }
43
+
44
+ this.initPromise = this._doInit().finally(() => {
45
+ this.initPromise = null;
46
+ });
47
+ return this.initPromise;
48
+ }
49
+
50
+ private async _doInit(): Promise<void> {
51
+ const launchArgs = [
52
+ "--no-sandbox",
53
+ "--disable-setuid-sandbox",
54
+ "--disable-dev-shm-usage",
55
+ "--disable-gpu",
56
+ "--disable-background-networking",
57
+ "--disable-default-apps",
58
+ "--disable-extensions",
59
+ "--disable-sync",
60
+ "--disable-translate",
61
+ "--metrics-recording-only",
62
+ "--mute-audio",
63
+ "--no-first-run",
64
+ "--safebrowsing-disable-auto-update",
65
+ ];
66
+
67
+ const contextOptions = {
68
+ viewport: { width: 1280, height: 800 } as { width: number; height: number } | null,
69
+ userAgent:
70
+ "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36",
71
+ };
72
+
73
+ if (this.userDataDir) {
74
+ // Persistent context — cookies and session data survive daemon restarts
75
+ const resolvedDir = this.userDataDir === "default" ? DEFAULT_USER_DATA_DIR : this.userDataDir;
76
+ console.log(`[browser-manager] Launching Chromium with persistent context at: ${resolvedDir}`);
77
+
78
+ if (!fs.existsSync(resolvedDir)) {
79
+ fs.mkdirSync(resolvedDir, { recursive: true, mode: 0o700 });
80
+ }
81
+
82
+ // launchPersistentContext returns a BrowserContext directly (no separate Browser)
83
+ this.context = await chromium.launchPersistentContext(resolvedDir, {
84
+ headless: true,
85
+ args: launchArgs,
86
+ ...contextOptions,
87
+ });
88
+
89
+ // Reuse existing page if available, otherwise open a new one
90
+ const existingPages = this.context.pages();
91
+ this.page = existingPages.length > 0 ? existingPages[0] : await this.context.newPage();
92
+ } else {
93
+ // Ephemeral context — no persistence (default, safe)
94
+ console.log("[browser-manager] Launching Chromium (ephemeral)...");
95
+
96
+ this.browser = await chromium.launch({
97
+ headless: true,
98
+ args: launchArgs,
99
+ });
100
+
101
+ this.context = await this.browser.newContext(contextOptions);
102
+ this.page = await this.context.newPage();
103
+ }
104
+
105
+ // Start idle timer
106
+ this.resetIdleTimer();
107
+
108
+ console.log("[browser-manager] Browser ready");
109
+ }
110
+
111
+ async getPage(): Promise<Page> {
112
+ await this.initialize();
113
+ this.resetIdleTimer();
114
+
115
+ if (!this.page || this.page.isClosed()) {
116
+ console.log("[browser-manager] Page was closed, creating new page");
117
+ this.page = await this.context!.newPage();
118
+ }
119
+
120
+ return this.page;
121
+ }
122
+
123
+ async getOrCreatePage(tabIndex?: number): Promise<Page> {
124
+ await this.initialize();
125
+ this.resetIdleTimer();
126
+
127
+ const pages = this.context!.pages();
128
+
129
+ if (tabIndex !== undefined && tabIndex < pages.length) {
130
+ this.page = pages[tabIndex];
131
+ return this.page;
132
+ }
133
+
134
+ if (!this.page || this.page.isClosed()) {
135
+ this.page = await this.context!.newPage();
136
+ }
137
+
138
+ return this.page;
139
+ }
140
+
141
+ async getAllPages(): Promise<Page[]> {
142
+ if (!this.context) return [];
143
+ return this.context.pages();
144
+ }
145
+
146
+ async setActivePage(index: number): Promise<Page | null> {
147
+ if (!this.context) return null;
148
+ const pages = this.context.pages();
149
+ if (index < 0 || index >= pages.length) return null;
150
+ this.page = pages[index];
151
+ this.resetIdleTimer();
152
+ return this.page;
153
+ }
154
+
155
+ async shutdown(): Promise<void> {
156
+ if (this.idleTimer) {
157
+ clearTimeout(this.idleTimer);
158
+ this.idleTimer = null;
159
+ }
160
+
161
+ try {
162
+ if (this.page && !this.page.isClosed()) {
163
+ await this.page.close();
164
+ }
165
+ } catch {
166
+ // Ignore close errors
167
+ }
168
+
169
+ try {
170
+ if (this.context) {
171
+ await this.context.close();
172
+ }
173
+ } catch {
174
+ // Ignore close errors
175
+ }
176
+
177
+ try {
178
+ if (this.browser) {
179
+ await this.browser.close();
180
+ }
181
+ } catch {
182
+ // Ignore close errors
183
+ }
184
+
185
+ this.page = null;
186
+ this.context = null;
187
+ this.browser = null;
188
+
189
+ console.log("[browser-manager] Browser shut down");
190
+
191
+ if (this.shutdownCallback) {
192
+ this.shutdownCallback();
193
+ }
194
+ }
195
+
196
+ isRunning(): boolean {
197
+ // Persistent context mode: browser is null, check context instead
198
+ if (this.userDataDir) {
199
+ return this.context !== null;
200
+ }
201
+ return this.browser !== null && this.browser.isConnected();
202
+ }
203
+ }
204
+
205
+ // Singleton instance
206
+ export const browserManager = new BrowserManager();
@@ -1,30 +1,30 @@
1
- {
2
- "lockfileVersion": 1,
3
- "configVersion": 1,
4
- "workspaces": {
5
- "": {
6
- "name": "ftm-browse",
7
- "dependencies": {
8
- "playwright": "^1.49.0",
9
- },
10
- "devDependencies": {
11
- "@types/bun": "latest",
12
- },
13
- },
14
- },
15
- "packages": {
16
- "@types/bun": ["@types/bun@1.3.10", "", { "dependencies": { "bun-types": "1.3.10" } }, "sha512-0+rlrUrOrTSskibryHbvQkDOWRJwJZqZlxrUs1u4oOoTln8+WIXBPmAuCF35SWB2z4Zl3E84Nl/D0P7803nigQ=="],
17
-
18
- "@types/node": ["@types/node@25.5.0", "", { "dependencies": { "undici-types": "~7.18.0" } }, "sha512-jp2P3tQMSxWugkCUKLRPVUpGaL5MVFwF8RDuSRztfwgN1wmqJeMSbKlnEtQqU8UrhTmzEmZdu2I6v2dpp7XIxw=="],
19
-
20
- "bun-types": ["bun-types@1.3.10", "", { "dependencies": { "@types/node": "*" } }, "sha512-tcpfCCl6XWo6nCVnpcVrxQ+9AYN1iqMIzgrSKYMB/fjLtV2eyAVEg7AxQJuCq/26R6HpKWykQXuSOq/21RYcbg=="],
21
-
22
- "fsevents": ["fsevents@2.3.2", "", { "os": "darwin" }, "sha512-xiqMQR4xAeHTuB9uWm+fFRcIOgKBMiOBP+eXiyT7jsgVCq1bkVygt00oASowB7EdtpOHaaPgKt812P9ab+DDKA=="],
23
-
24
- "playwright": ["playwright@1.58.2", "", { "dependencies": { "playwright-core": "1.58.2" }, "optionalDependencies": { "fsevents": "2.3.2" }, "bin": { "playwright": "cli.js" } }, "sha512-vA30H8Nvkq/cPBnNw4Q8TWz1EJyqgpuinBcHET0YVJVFldr8JDNiU9LaWAE1KqSkRYazuaBhTpB5ZzShOezQ6A=="],
25
-
26
- "playwright-core": ["playwright-core@1.58.2", "", { "bin": { "playwright-core": "cli.js" } }, "sha512-yZkEtftgwS8CsfYo7nm0KE8jsvm6i/PTgVtB8DL726wNf6H2IMsDuxCpJj59KDaxCtSnrWan2AeDqM7JBaultg=="],
27
-
28
- "undici-types": ["undici-types@7.18.2", "", {}, "sha512-AsuCzffGHJybSaRrmr5eHr81mwJU3kjw6M+uprWvCXiNeN9SOGwQ3Jn8jb8m3Z6izVgknn1R0FTCEAP2QrLY/w=="],
29
- }
30
- }
1
+ {
2
+ "lockfileVersion": 1,
3
+ "configVersion": 1,
4
+ "workspaces": {
5
+ "": {
6
+ "name": "ftm-browse",
7
+ "dependencies": {
8
+ "playwright": "^1.49.0",
9
+ },
10
+ "devDependencies": {
11
+ "@types/bun": "latest",
12
+ },
13
+ },
14
+ },
15
+ "packages": {
16
+ "@types/bun": ["@types/bun@1.3.10", "", { "dependencies": { "bun-types": "1.3.10" } }, "sha512-0+rlrUrOrTSskibryHbvQkDOWRJwJZqZlxrUs1u4oOoTln8+WIXBPmAuCF35SWB2z4Zl3E84Nl/D0P7803nigQ=="],
17
+
18
+ "@types/node": ["@types/node@25.5.0", "", { "dependencies": { "undici-types": "~7.18.0" } }, "sha512-jp2P3tQMSxWugkCUKLRPVUpGaL5MVFwF8RDuSRztfwgN1wmqJeMSbKlnEtQqU8UrhTmzEmZdu2I6v2dpp7XIxw=="],
19
+
20
+ "bun-types": ["bun-types@1.3.10", "", { "dependencies": { "@types/node": "*" } }, "sha512-tcpfCCl6XWo6nCVnpcVrxQ+9AYN1iqMIzgrSKYMB/fjLtV2eyAVEg7AxQJuCq/26R6HpKWykQXuSOq/21RYcbg=="],
21
+
22
+ "fsevents": ["fsevents@2.3.2", "", { "os": "darwin" }, "sha512-xiqMQR4xAeHTuB9uWm+fFRcIOgKBMiOBP+eXiyT7jsgVCq1bkVygt00oASowB7EdtpOHaaPgKt812P9ab+DDKA=="],
23
+
24
+ "playwright": ["playwright@1.58.2", "", { "dependencies": { "playwright-core": "1.58.2" }, "optionalDependencies": { "fsevents": "2.3.2" }, "bin": { "playwright": "cli.js" } }, "sha512-vA30H8Nvkq/cPBnNw4Q8TWz1EJyqgpuinBcHET0YVJVFldr8JDNiU9LaWAE1KqSkRYazuaBhTpB5ZzShOezQ6A=="],
25
+
26
+ "playwright-core": ["playwright-core@1.58.2", "", { "bin": { "playwright-core": "cli.js" } }, "sha512-yZkEtftgwS8CsfYo7nm0KE8jsvm6i/PTgVtB8DL726wNf6H2IMsDuxCpJj59KDaxCtSnrWan2AeDqM7JBaultg=="],
27
+
28
+ "undici-types": ["undici-types@7.18.2", "", {}, "sha512-AsuCzffGHJybSaRrmr5eHr81mwJU3kjw6M+uprWvCXiNeN9SOGwQ3Jn8jb8m3Z6izVgknn1R0FTCEAP2QrLY/w=="],
29
+ }
30
+ }