@qearlyao/familiar 0.1.1 → 0.1.2

package/README.md

@@ -30,7 +30,13 @@ irm https://raw.githubusercontent.com/qearlyao/familiar/main/scripts/install.ps1
 ```
 
 The installer checks Node/npm, installs Familiar globally, and initializes
-`~/.familiar` when no workspace exists yet.
+or refreshes missing default files in `~/.familiar`.
+
+Installer options:
+
+- macOS/Linux: `--workspace <path>`, `--with-browser`, `--install-browser-deps`, `--skip-init`, `--package <spec>`.
+- Windows PowerShell: `-Workspace <path>`, `-WithBrowser`, `-InstallBrowserDeps`, `-SkipInit`, `-Package <spec>`, `-BrowserHarnessDir <path>`.
+- `--package` / `-Package` installs the exact npm package spec you provide. Use trusted specs only.
 
 Manual npm install:
 
@@ -171,7 +177,8 @@ Windows PowerShell:
 & ([scriptblock]::Create((irm https://raw.githubusercontent.com/qearlyao/familiar/main/scripts/install.ps1))) -WithBrowser
 ```
 
-- `--with-browser` installs OpenCLI with npm and browser-harness from its upstream repo with `uv`; it requires `git`, `uv`, and Python 3.11+.
+- `--with-browser` / `-WithBrowser` installs OpenCLI with npm and browser-harness from its upstream repo with `uv`; it requires `git`, `uv`, and Python 3.11+.
+- If `uv` or Python 3.11+ is missing, the installer asks whether to install the missing browser dependency. Use `--install-browser-deps` / `-InstallBrowserDeps` for non-interactive installs.
 - `browser-harness` is best for attaching to your already-running Chrome via CDP.
 - OpenCLI is best for site adapters, owned sessions, and unattended Browser Bridge flows.
 - OpenCLI: [jackwener/OpenCLI](https://github.com/jackwener/OpenCLI)

package/dist/agent.js

@@ -415,16 +415,6 @@ export async function createFamiliarAgent(config, settings, memoryService, optio
         session.agent.state.tools = createFamiliarTools(config, session.mediaSink, () => session.referenceAttachments, memoryService);
         session.agent.state.thinkingLevel = session.thinkingLevel;
     };
-    const refreshSession = (session, sessionKey) => {
-        const { model } = resolveChannelModel(sessionKey);
-        const thinkingLevel = resolveChannelThinkingLevel(sessionKey, model).value;
-        session.model = model;
-        session.thinkingLevel = thinkingLevel;
-        session.agent.state.systemPrompt = systemPrompt;
-        session.agent.state.model = model;
-        session.agent.state.thinkingLevel = thinkingLevel;
-        session.agent.state.tools = createFamiliarTools(config, session.mediaSink, () => session.referenceAttachments, memoryService);
-    };
     const prepareReload = async () => {
         const nextConfig = (await options.reloadConfig?.()) ?? config;
         const nextPersona = await loadPersona(nextConfig);

package/dist/cli.js

@@ -136,7 +136,9 @@ async function runDaemon(workspaceInput) {
         setTimeout(() => void stop(75), RESTART_EXIT_DELAY_MS);
         return "Restart requested. If Familiar is managed by launchd/systemd, it should come back automatically; otherwise run familiar run again.";
     };
-    discordDaemon = await startDiscordDaemon(config, familiarAgent, settings, memoryService, { restart: requestRestart });
+    discordDaemon = await startDiscordDaemon(config, familiarAgent, settings, memoryService, {
+        restart: requestRestart,
+    });
     webDaemon = await startWebDaemon(config, familiarAgent, discordDaemon, { restart: requestRestart });
     console.log(`familiar running for workspace ${config.workspacePath}`);
     console.log("agent sessions are created per channel");

package/dist/hot-reload.js

@@ -91,7 +91,9 @@ export function startWorkspaceHotReload(options) {
                     (basename(dirPath) === SKILLS_DIR || relative(workspacePath, dirPath).startsWith(`${SKILLS_DIR}${sep}`))) {
                     void refreshSkillWatchers();
                 }
-                if (!filename || shouldReloadForPath(workspacePath, changedPath) || shouldReloadForPath(workspacePath, dirPath)) {
+                if (!filename ||
+                    shouldReloadForPath(workspacePath, changedPath) ||
+                    shouldReloadForPath(workspacePath, dirPath)) {
                     scheduleReload(relative(workspacePath, changedPath) || relative(workspacePath, dirPath) || ".");
                 }
             });

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@qearlyao/familiar",
-	"version": "0.1.1",
+	"version": "0.1.2",
 	"license": "MIT",
 	"type": "module",
 	"repository": {

package/scripts/install.ps1

@@ -3,6 +3,7 @@ param(
 	[string]$Package = "@qearlyao/familiar@latest",
 	[string]$BrowserHarnessDir = (Join-Path (Join-Path $HOME "Developer") "browser-harness"),
 	[switch]$WithBrowser,
+	[switch]$InstallBrowserDeps,
 	[switch]$SkipInit
 )
 
@@ -14,6 +15,47 @@ function Require-Command($Name) {
 	}
 }
 
+function Update-BrowserDepPath {
+	$candidates = @((Join-Path $HOME ".local\bin"), (Join-Path $HOME ".cargo\bin"))
+	foreach ($candidate in $candidates) {
+		if ((Test-Path $candidate) -and (($env:PATH -split [IO.Path]::PathSeparator) -notcontains $candidate)) {
+			$env:PATH = "$candidate$([IO.Path]::PathSeparator)$env:PATH"
+		}
+	}
+}
+
+function Confirm-BrowserDepInstall($Message) {
+	if ($InstallBrowserDeps) {
+		return $true
+	}
+	try {
+		$answer = Read-Host "$Message Install it now? [y/N]"
+		return $answer -match '^(y|yes)$'
+	} catch {
+		return $false
+	}
+}
+
+function Install-Uv {
+	Write-Host "Installing uv for browser-harness..."
+	irm https://astral.sh/uv/install.ps1 | iex
+	Update-BrowserDepPath
+	if (-not (Get-Command uv -ErrorAction SilentlyContinue)) {
+		throw "uv installer finished, but uv is not on PATH. Open a new terminal or add $HOME\.local\bin to PATH."
+	}
+}
+
+function Ensure-Uv {
+	if (Get-Command uv -ErrorAction SilentlyContinue) {
+		return
+	}
+	if (Confirm-BrowserDepInstall "uv is required for browser-harness but was not found.") {
+		Install-Uv
+		return
+	}
+	throw "Missing required command: uv. Rerun with -WithBrowser -InstallBrowserDeps to install uv and Python 3.11 automatically."
+}
+
 function Test-Python311($Command, $PythonArgs = @()) {
 	& $Command @PythonArgs -c "import sys; raise SystemExit(0 if sys.version_info >= (3, 11) else 1)" *> $null
 	return $LASTEXITCODE -eq 0
@@ -32,15 +74,31 @@ function Resolve-Python311 {
 	if ($py -and (Test-Python311 $py.Source @("-3.11"))) {
 		return @{ Command = $py.Source; Args = @("-3.11"); UvPython = "3.11" }
 	}
-	throw "browser-harness requires Python 3.11 or newer. Install Python 3.11+ and rerun with -WithBrowser."
+	return $null
+}
+
+function Ensure-Python311 {
+	$python311 = Resolve-Python311
+	if ($python311) {
+		return $python311
+	}
+	if (Confirm-BrowserDepInstall "Python 3.11+ is required for browser-harness but was not found.") {
+		Write-Host "Installing Python 3.11 with uv for browser-harness..."
+		& uv python install 3.11
+		if ($LASTEXITCODE -ne 0) {
+			throw "Python 3.11 install failed."
+		}
+		return @{ Command = "uv"; Args = @("python", "find", "3.11"); UvPython = "3.11" }
+	}
+	throw "browser-harness requires Python 3.11 or newer. Rerun with -WithBrowser -InstallBrowserDeps to install uv-managed Python 3.11 automatically."
 }
 
 Require-Command node
 Require-Command npm
 if ($WithBrowser) {
 	Require-Command git
-	Require-Command uv
-	$Python311 = Resolve-Python311
+	Ensure-Uv
+	$Python311 = Ensure-Python311
 }
 
 $nodeVersion = (& node -p "process.versions.node").Trim()
@@ -105,15 +163,10 @@ if (-not (Get-Command familiar -ErrorAction SilentlyContinue)) {
 }
 
 if (-not $SkipInit) {
-	$configPath = Join-Path $Workspace "config.toml"
-	if (Test-Path $configPath) {
-		Write-Host "Workspace already exists at $Workspace; leaving files unchanged."
-	} else {
-		Write-Host "Initializing workspace at $Workspace..."
-		& familiar init $Workspace
-		if ($LASTEXITCODE -ne 0) {
-			throw "familiar init failed."
-		}
+	Write-Host "Initializing or refreshing workspace defaults at $Workspace..."
+	& familiar init $Workspace
+	if ($LASTEXITCODE -ne 0) {
+		throw "familiar init failed."
 	}
 }
 

package/scripts/install.sh

@@ -5,6 +5,7 @@ PACKAGE="@qearlyao/familiar@latest"
 WORKSPACE="${HOME}/.familiar"
 BROWSER_HARNESS_DIR="${HOME}/Developer/browser-harness"
 WITH_BROWSER=0
+INSTALL_BROWSER_DEPS=0
 SKIP_INIT=0
 
 usage() {
@@ -14,6 +15,8 @@ Usage: install.sh [options]
 Options:
   --workspace <path>   Workspace path to initialize. Defaults to ~/.familiar.
   --with-browser       Also install optional OpenCLI and browser-harness helpers.
+  --install-browser-deps
+                       With --with-browser, install missing uv/Python 3.11 browser deps without prompting.
   --skip-init          Install familiar but do not run familiar init.
   --package <spec>     npm package spec to install. Defaults to @qearlyao/familiar@latest.
                        Advanced: installs the exact npm spec provided; use trusted specs only.
@@ -35,6 +38,10 @@ while [ "$#" -gt 0 ]; do
 			WITH_BROWSER=1
 			shift
 			;;
+		--install-browser-deps)
+			INSTALL_BROWSER_DEPS=1
+			shift
+			;;
 		--skip-init)
 			SKIP_INIT=1
 			shift
@@ -66,6 +73,63 @@ need_command() {
 	fi
 }
 
+refresh_browser_dep_path() {
+	for candidate in "${HOME}/.local/bin" "${HOME}/.cargo/bin"; do
+		if [ -d "$candidate" ]; then
+			case ":${PATH}:" in
+				*":${candidate}:"*) ;;
+				*) PATH="${candidate}:${PATH}" ;;
+			esac
+		fi
+	done
+	export PATH
+}
+
+confirm_browser_dep_install() {
+	if [ "$INSTALL_BROWSER_DEPS" -eq 1 ]; then
+		return 0
+	fi
+	if [ -r /dev/tty ] && [ -w /dev/tty ]; then
+		printf "%s Install it now? [y/N] " "$1" >/dev/tty
+		read -r answer </dev/tty || answer=""
+		case "$answer" in
+			y | Y | yes | YES) return 0 ;;
+		esac
+	fi
+	return 1
+}
+
+install_uv() {
+	echo "Installing uv for browser-harness..."
+	if command -v curl >/dev/null 2>&1; then
+		curl -LsSf https://astral.sh/uv/install.sh | sh
+	elif command -v wget >/dev/null 2>&1; then
+		wget -qO- https://astral.sh/uv/install.sh | sh
+	else
+		echo "Missing curl or wget, which is required to install uv automatically." >&2
+		echo "Install uv manually from https://docs.astral.sh/uv/ and rerun with --with-browser." >&2
+		exit 1
+	fi
+	refresh_browser_dep_path
+	if ! command -v uv >/dev/null 2>&1; then
+		echo "uv installer finished, but uv is not on PATH. Open a new terminal or add ~/.local/bin to PATH." >&2
+		exit 1
+	fi
+}
+
+ensure_uv() {
+	if command -v uv >/dev/null 2>&1; then
+		return 0
+	fi
+	if confirm_browser_dep_install "uv is required for browser-harness but was not found."; then
+		install_uv
+		return 0
+	fi
+	echo "Missing required command: uv" >&2
+	echo "Rerun with --with-browser --install-browser-deps to install uv and Python 3.11 automatically." >&2
+	exit 1
+}
+
 find_python() {
 	PYTHON_PATH=""
 	for candidate in python3 python; do
@@ -77,7 +141,21 @@ find_python() {
 			fi
 		fi
 	done
-	echo "browser-harness requires Python 3.11 or newer. Install Python 3.11+ and rerun with --with-browser." >&2
+	return 1
+}
+
+ensure_python() {
+	if find_python; then
+		return 0
+	fi
+	if confirm_browser_dep_install "Python 3.11+ is required for browser-harness but was not found."; then
+		echo "Installing Python 3.11 with uv for browser-harness..."
+		uv python install 3.11
+		PYTHON_PATH="3.11"
+		return 0
+	fi
+	echo "browser-harness requires Python 3.11 or newer." >&2
+	echo "Rerun with --with-browser --install-browser-deps to install uv-managed Python 3.11 automatically." >&2
 	exit 1
 }
 
@@ -85,8 +163,8 @@ need_command node
 need_command npm
 if [ "$WITH_BROWSER" -eq 1 ]; then
 	need_command git
-	need_command uv
-	find_python
+	ensure_uv
+	ensure_python
 fi
 
 NODE_VERSION="$(node -p "process.versions.node")"
@@ -127,12 +205,8 @@ if ! command -v familiar >/dev/null 2>&1; then
 fi
 
 if [ "$SKIP_INIT" -eq 0 ]; then
-	if [ -f "${WORKSPACE}/config.toml" ]; then
-		echo "Workspace already exists at ${WORKSPACE}; leaving files unchanged."
-	else
-		echo "Initializing workspace at ${WORKSPACE}..."
-		familiar init "$WORKSPACE"
-	fi
+	echo "Initializing or refreshing workspace defaults at ${WORKSPACE}..."
+	familiar init "$WORKSPACE"
 fi
 
 cat <<EOF