feed-the-machine 1.6.1 → 1.7.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.
- package/LICENSE +21 -21
- package/README.md +170 -170
- package/bin/brain.py +1340 -0
- package/bin/convert_claude_skills_to_codex.py +490 -0
- package/bin/generate-manifest.mjs +463 -463
- package/bin/harden_codex_skills.py +141 -0
- package/bin/install.mjs +491 -491
- package/bin/migrate-eng-buddy-data.py +875 -0
- package/bin/playbook_engine/__init__.py +1 -0
- package/bin/playbook_engine/conftest.py +8 -0
- package/bin/playbook_engine/extractor.py +33 -0
- package/bin/playbook_engine/manager.py +102 -0
- package/bin/playbook_engine/models.py +84 -0
- package/bin/playbook_engine/registry.py +35 -0
- package/bin/playbook_engine/test_extractor.py +72 -0
- package/bin/playbook_engine/test_integration.py +129 -0
- package/bin/playbook_engine/test_manager.py +85 -0
- package/bin/playbook_engine/test_models.py +166 -0
- package/bin/playbook_engine/test_registry.py +67 -0
- package/bin/playbook_engine/test_tracer.py +86 -0
- package/bin/playbook_engine/tracer.py +93 -0
- package/bin/tasks_db.py +456 -0
- package/docs/HOOKS.md +243 -243
- package/docs/INBOX.md +233 -233
- package/ftm/SKILL.md +125 -122
- package/ftm-audit/SKILL.md +623 -623
- package/ftm-audit/references/protocols/PROJECT-PATTERNS.md +91 -91
- package/ftm-audit/references/protocols/RUNTIME-WIRING.md +66 -66
- package/ftm-audit/references/protocols/WIRING-CONTRACTS.md +135 -135
- package/ftm-audit/references/strategies/AUTO-FIX-STRATEGIES.md +69 -69
- package/ftm-audit/references/templates/REPORT-FORMAT.md +96 -96
- package/ftm-audit/scripts/run-knip.sh +23 -23
- package/ftm-audit.yml +2 -2
- package/ftm-brainstorm/SKILL.md +1003 -498
- package/ftm-brainstorm/evals/evals.json +180 -100
- package/ftm-brainstorm/evals/promptfoo.yaml +109 -109
- package/ftm-brainstorm/references/agent-prompts.md +552 -224
- package/ftm-brainstorm/references/plan-template.md +209 -121
- package/ftm-brainstorm.yml +2 -2
- package/ftm-browse/SKILL.md +454 -454
- package/ftm-browse/daemon/browser-manager.ts +206 -206
- package/ftm-browse/daemon/bun.lock +30 -30
- package/ftm-browse/daemon/cli.ts +347 -347
- package/ftm-browse/daemon/commands.ts +410 -410
- package/ftm-browse/daemon/main.ts +357 -357
- package/ftm-browse/daemon/package.json +17 -17
- package/ftm-browse/daemon/server.ts +189 -189
- package/ftm-browse/daemon/snapshot.ts +519 -519
- package/ftm-browse/daemon/tsconfig.json +22 -22
- package/ftm-browse.yml +4 -4
- package/ftm-capture/SKILL.md +370 -370
- package/ftm-capture.yml +4 -4
- package/ftm-codex-gate/SKILL.md +361 -361
- package/ftm-codex-gate.yml +2 -2
- package/ftm-config/SKILL.md +422 -345
- package/ftm-config.default.yml +125 -82
- package/ftm-config.yml +44 -2
- package/ftm-council/SKILL.md +416 -416
- package/ftm-council/references/prompts/CLAUDE-INVESTIGATION.md +60 -60
- package/ftm-council/references/prompts/CODEX-INVESTIGATION.md +58 -58
- package/ftm-council/references/prompts/GEMINI-INVESTIGATION.md +58 -58
- package/ftm-council/references/prompts/REBUTTAL-TEMPLATE.md +57 -57
- package/ftm-council/references/protocols/PREREQUISITES.md +47 -47
- package/ftm-council/references/protocols/STEP-0-FRAMING.md +46 -46
- package/ftm-council.yml +2 -2
- package/ftm-dashboard/SKILL.md +163 -163
- package/ftm-dashboard.yml +4 -4
- package/ftm-debug/SKILL.md +1037 -1037
- package/ftm-debug/references/phases/PHASE-0-INTAKE.md +58 -58
- package/ftm-debug/references/phases/PHASE-1-TRIAGE.md +46 -46
- package/ftm-debug/references/phases/PHASE-2-WAR-ROOM-AGENTS.md +279 -279
- package/ftm-debug/references/phases/PHASE-3-TO-6-EXECUTION.md +436 -436
- package/ftm-debug/references/protocols/BLACKBOARD.md +86 -86
- package/ftm-debug/references/protocols/EDGE-CASES.md +103 -103
- package/ftm-debug.yml +2 -2
- package/ftm-diagram/SKILL.md +277 -277
- package/ftm-diagram.yml +2 -2
- package/ftm-executor/SKILL.md +777 -777
- package/ftm-executor/references/STYLE-TEMPLATE.md +73 -73
- package/ftm-executor/references/phases/PHASE-0-VERIFICATION.md +62 -62
- package/ftm-executor/references/phases/PHASE-2-AGENT-ASSEMBLY.md +34 -34
- package/ftm-executor/references/phases/PHASE-3-WORKTREES.md +38 -38
- package/ftm-executor/references/phases/PHASE-4-5-AUDIT.md +72 -72
- package/ftm-executor/references/phases/PHASE-4-DISPATCH.md +66 -66
- package/ftm-executor/references/phases/PHASE-5-5-CODEX-GATE.md +73 -73
- package/ftm-executor/references/protocols/DOCUMENTATION-BOOTSTRAP.md +36 -36
- package/ftm-executor/references/protocols/MODEL-PROFILE.md +59 -59
- package/ftm-executor/references/protocols/PROGRESS-TRACKING.md +66 -66
- package/ftm-executor/runtime/ftm-runtime.mjs +252 -252
- package/ftm-executor/runtime/package.json +8 -8
- package/ftm-executor.yml +2 -2
- package/ftm-git/SKILL.md +441 -441
- package/ftm-git/evals/evals.json +26 -26
- package/ftm-git/evals/promptfoo.yaml +75 -75
- package/ftm-git/hooks/post-commit-experience.sh +92 -92
- package/ftm-git/references/patterns/SECRET-PATTERNS.md +104 -104
- package/ftm-git/references/protocols/REMEDIATION.md +139 -139
- package/ftm-git/scripts/pre-commit-secrets.sh +110 -110
- package/ftm-git.yml +2 -2
- package/ftm-inbox/backend/__pycache__/main.cpython-314.pyc +0 -0
- package/ftm-inbox/backend/adapters/_retry.py +64 -64
- package/ftm-inbox/backend/adapters/base.py +230 -230
- package/ftm-inbox/backend/adapters/freshservice.py +104 -104
- package/ftm-inbox/backend/adapters/gmail.py +125 -125
- package/ftm-inbox/backend/adapters/jira.py +136 -136
- package/ftm-inbox/backend/adapters/registry.py +192 -192
- package/ftm-inbox/backend/adapters/slack.py +110 -110
- package/ftm-inbox/backend/db/connection.py +54 -54
- package/ftm-inbox/backend/db/schema.py +78 -78
- package/ftm-inbox/backend/executor/__init__.py +7 -7
- package/ftm-inbox/backend/executor/engine.py +149 -149
- package/ftm-inbox/backend/executor/step_runner.py +98 -98
- package/ftm-inbox/backend/main.py +103 -103
- package/ftm-inbox/backend/models/__init__.py +1 -1
- package/ftm-inbox/backend/models/unified_task.py +36 -36
- package/ftm-inbox/backend/planner/__init__.py +6 -6
- package/ftm-inbox/backend/planner/__pycache__/__init__.cpython-314.pyc +0 -0
- package/ftm-inbox/backend/planner/__pycache__/generator.cpython-314.pyc +0 -0
- package/ftm-inbox/backend/planner/__pycache__/schema.cpython-314.pyc +0 -0
- package/ftm-inbox/backend/planner/generator.py +127 -127
- package/ftm-inbox/backend/planner/schema.py +34 -34
- package/ftm-inbox/backend/requirements.txt +5 -5
- package/ftm-inbox/backend/routes/__pycache__/plan.cpython-314.pyc +0 -0
- package/ftm-inbox/backend/routes/execute.py +186 -186
- package/ftm-inbox/backend/routes/health.py +52 -52
- package/ftm-inbox/backend/routes/inbox.py +68 -68
- package/ftm-inbox/backend/routes/plan.py +271 -271
- package/ftm-inbox/bin/launchagent.mjs +91 -91
- package/ftm-inbox/bin/setup.mjs +188 -188
- package/ftm-inbox/bin/start.sh +10 -10
- package/ftm-inbox/bin/status.sh +17 -17
- package/ftm-inbox/bin/stop.sh +8 -8
- package/ftm-inbox/config.example.yml +55 -55
- package/ftm-inbox/package-lock.json +2898 -2898
- package/ftm-inbox/package.json +26 -26
- package/ftm-inbox/postcss.config.js +6 -6
- package/ftm-inbox/src/app.css +199 -199
- package/ftm-inbox/src/app.html +18 -18
- package/ftm-inbox/src/lib/api.ts +166 -166
- package/ftm-inbox/src/lib/components/ExecutionLog.svelte +81 -81
- package/ftm-inbox/src/lib/components/InboxFeed.svelte +143 -143
- package/ftm-inbox/src/lib/components/PlanStep.svelte +271 -271
- package/ftm-inbox/src/lib/components/PlanView.svelte +206 -206
- package/ftm-inbox/src/lib/components/StreamPanel.svelte +99 -99
- package/ftm-inbox/src/lib/components/TaskCard.svelte +190 -190
- package/ftm-inbox/src/lib/components/ui/EmptyState.svelte +63 -63
- package/ftm-inbox/src/lib/components/ui/KawaiiCard.svelte +86 -86
- package/ftm-inbox/src/lib/components/ui/PillButton.svelte +106 -106
- package/ftm-inbox/src/lib/components/ui/StatusBadge.svelte +67 -67
- package/ftm-inbox/src/lib/components/ui/StreamDrawer.svelte +149 -149
- package/ftm-inbox/src/lib/components/ui/ThemeToggle.svelte +80 -80
- package/ftm-inbox/src/lib/theme.ts +47 -47
- package/ftm-inbox/src/routes/+layout.svelte +76 -76
- package/ftm-inbox/src/routes/+page.svelte +401 -401
- package/ftm-inbox/svelte.config.js +12 -12
- package/ftm-inbox/tailwind.config.ts +63 -63
- package/ftm-inbox/tsconfig.json +13 -13
- package/ftm-inbox/vite.config.ts +6 -6
- package/ftm-intent/SKILL.md +241 -241
- package/ftm-intent.yml +2 -2
- package/ftm-manifest.json +3794 -3794
- package/ftm-map/SKILL.md +291 -291
- package/ftm-map/scripts/db.py +712 -712
- package/ftm-map/scripts/index.py +415 -415
- package/ftm-map/scripts/parser.py +224 -224
- package/ftm-map/scripts/queries/go-tags.scm +20 -20
- package/ftm-map/scripts/queries/javascript-tags.scm +35 -35
- package/ftm-map/scripts/queries/python-tags.scm +31 -31
- package/ftm-map/scripts/queries/ruby-tags.scm +19 -19
- package/ftm-map/scripts/queries/rust-tags.scm +37 -37
- package/ftm-map/scripts/queries/typescript-tags.scm +41 -41
- package/ftm-map/scripts/query.py +301 -301
- package/ftm-map/scripts/ranker.py +377 -377
- package/ftm-map/scripts/requirements.txt +5 -5
- package/ftm-map/scripts/setup-hooks.sh +27 -27
- package/ftm-map/scripts/setup.sh +56 -56
- package/ftm-map/scripts/test_db.py +364 -364
- package/ftm-map/scripts/test_parser.py +174 -174
- package/ftm-map/scripts/test_query.py +183 -183
- package/ftm-map/scripts/test_ranker.py +199 -199
- package/ftm-map/scripts/views.py +591 -591
- package/ftm-map.yml +2 -2
- package/ftm-mind/SKILL.md +201 -1943
- package/ftm-mind/evals/promptfoo.yaml +142 -142
- package/ftm-mind/references/blackboard-protocol.md +110 -0
- package/ftm-mind/references/blackboard-schema.md +328 -328
- package/ftm-mind/references/complexity-guide.md +110 -110
- package/ftm-mind/references/complexity-sizing.md +138 -0
- package/ftm-mind/references/decide-act-protocol.md +172 -0
- package/ftm-mind/references/direct-execution.md +51 -0
- package/ftm-mind/references/environment-discovery.md +77 -0
- package/ftm-mind/references/event-registry.md +319 -319
- package/ftm-mind/references/mcp-inventory.md +300 -296
- package/ftm-mind/references/ops-routing.md +47 -0
- package/ftm-mind/references/orient-protocol.md +234 -0
- package/ftm-mind/references/personality.md +40 -0
- package/ftm-mind/references/protocols/COMPLEXITY-SIZING.md +72 -72
- package/ftm-mind/references/protocols/MCP-HEURISTICS.md +32 -32
- package/ftm-mind/references/protocols/PLAN-APPROVAL.md +80 -80
- package/ftm-mind/references/reflexion-protocol.md +249 -249
- package/ftm-mind/references/routing/SCENARIOS.md +22 -22
- package/ftm-mind/references/routing-scenarios.md +35 -35
- package/ftm-mind.yml +2 -2
- package/ftm-ops.yml +4 -0
- package/ftm-pause/SKILL.md +395 -395
- package/ftm-pause/references/protocols/SKILL-RESTORE-PROTOCOLS.md +186 -186
- package/ftm-pause/references/protocols/VALIDATION.md +80 -80
- package/ftm-pause.yml +2 -2
- package/ftm-researcher/SKILL.md +275 -275
- package/ftm-researcher/evals/agent-diversity.yaml +17 -17
- package/ftm-researcher/evals/synthesis-quality.yaml +12 -12
- package/ftm-researcher/evals/trigger-accuracy.yaml +39 -39
- package/ftm-researcher/references/adaptive-search.md +116 -116
- package/ftm-researcher/references/agent-prompts.md +193 -193
- package/ftm-researcher/references/council-integration.md +193 -193
- package/ftm-researcher/references/output-format.md +203 -203
- package/ftm-researcher/references/synthesis-pipeline.md +165 -165
- package/ftm-researcher/scripts/score_credibility.py +234 -234
- package/ftm-researcher/scripts/validate_research.py +92 -92
- package/ftm-researcher.yml +2 -2
- package/ftm-resume/SKILL.md +518 -518
- package/ftm-resume/references/protocols/VALIDATION.md +172 -172
- package/ftm-resume.yml +2 -2
- package/ftm-retro/SKILL.md +380 -380
- package/ftm-retro/references/protocols/SCORING-RUBRICS.md +89 -89
- package/ftm-retro/references/templates/REPORT-FORMAT.md +109 -109
- package/ftm-retro.yml +2 -2
- package/ftm-routine/SKILL.md +170 -170
- package/ftm-routine.yml +4 -4
- package/ftm-state/blackboard/capabilities.json +5 -5
- package/ftm-state/blackboard/capabilities.schema.json +27 -27
- package/ftm-state/blackboard/context.json +37 -23
- package/ftm-state/blackboard/experiences/doom-statusline-fix.json +26 -0
- package/ftm-state/blackboard/experiences/hackathon-pages-site.json +26 -0
- package/ftm-state/blackboard/experiences/hindsight-sso-kickoff.json +42 -0
- package/ftm-state/blackboard/experiences/index.json +58 -9
- package/ftm-state/blackboard/experiences/learning-ragnarok-api-access.json +23 -0
- package/ftm-state/blackboard/experiences/nordlayer-members-auto-assign.json +26 -0
- package/ftm-state/blackboard/experiences/saml2aws-stale-session-fix.json +41 -0
- package/ftm-state/blackboard/patterns.json +6 -6
- package/ftm-state/schemas/context.schema.json +130 -130
- package/ftm-state/schemas/experience-index.schema.json +77 -77
- package/ftm-state/schemas/experience.schema.json +78 -78
- package/ftm-state/schemas/patterns.schema.json +44 -44
- package/ftm-upgrade/SKILL.md +194 -194
- package/ftm-upgrade/scripts/check-version.sh +76 -76
- package/ftm-upgrade/scripts/upgrade.sh +143 -143
- package/ftm-upgrade.yml +2 -2
- package/ftm-verify.yml +2 -2
- package/ftm.yml +2 -2
- package/hooks/ftm-auto-log.sh +137 -0
- package/hooks/ftm-blackboard-enforcer.sh +93 -93
- package/hooks/ftm-discovery-reminder.sh +90 -90
- package/hooks/ftm-drafts-gate.sh +61 -61
- package/hooks/ftm-event-logger.mjs +107 -107
- package/hooks/ftm-install-hooks.sh +240 -0
- package/hooks/ftm-learning-capture.sh +117 -0
- package/hooks/ftm-map-autodetect.sh +79 -79
- package/hooks/ftm-pending-sync-check.sh +22 -22
- package/hooks/ftm-plan-gate.sh +92 -92
- package/hooks/ftm-post-commit-trigger.sh +57 -57
- package/hooks/ftm-post-compaction.sh +138 -0
- package/hooks/ftm-pre-compaction.sh +147 -0
- package/hooks/ftm-session-end.sh +52 -0
- package/hooks/ftm-session-snapshot.sh +213 -0
- package/hooks/settings-template.json +81 -81
- package/install.sh +363 -363
- package/package.json +84 -84
- 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
|
+
}
|