@termix-it/cryptoclaw 1.0.5 → 1.0.6

package/README.md

@@ -1,42 +1,89 @@
-# CryptoClaw
+# CryptoClaw — Private Crypto AI Assistant
 
-> Private crypto AI assistant — wallet management, DeFi, NFTs, and multi-chain operations from your terminal.
+<p align="center">
+  <strong>Wallet management, DeFi, NFTs, and multi-chain operations from your terminal.</strong>
+</p>
 
-[![npm version](https://img.shields.io/npm/v/@termix-it/cryptoclaw?style=for-the-badge)](https://www.npmjs.com/package/@termix-it/cryptoclaw)
-[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg?style=for-the-badge)](LICENSE)
+<p align="center">
+  <a href="https://www.npmjs.com/package/@termix-it/cryptoclaw"><img src="https://img.shields.io/npm/v/@termix-it/cryptoclaw?style=for-the-badge" alt="npm version"></a>
+  <a href="https://github.com/TermiX-official/cryptoclaw"><img src="https://img.shields.io/github/stars/TermiX-official/cryptoclaw?style=for-the-badge" alt="GitHub stars"></a>
+  <a href="LICENSE"><img src="https://img.shields.io/badge/License-MIT-blue.svg?style=for-the-badge" alt="MIT License"></a>
+</p>
+
+**CryptoClaw** is a private, AI-powered crypto assistant you run on your own devices. It gives your AI agent native access to wallets, DeFi protocols, NFTs, on-chain data, and CEX trading — all through natural language. It connects to the messaging channels you already use (Telegram, WhatsApp, Discord, Slack, Signal, iMessage, and more) and works entirely on your own machine. Your keys stay yours.
+
+If you want a personal, always-on crypto assistant that feels local, fast, and private — this is it.
+
+---
 
 ## Official Binance Skills Integration
 
-CryptoClaw proudly integrates the official Binance Skills Hub — 7 native skills powered by Binance's Web3 and CEX infrastructure, giving your AI assistant direct access to Binance market data, trading, and on-chain intelligence.
+CryptoClaw is the first AI assistant to ship with the **official [Binance Skills Hub](https://github.com/binance/binance-skills-hub)** — 7 native skills powered directly by Binance's Web3 and CEX infrastructure.
 
-Thanks to [@binance](https://github.com/binance) for building and open-sourcing the [Binance Skills Hub](https://github.com/binance/binance-skills-hub). 🙌
+> Special thanks to [@binance](https://github.com/binance) for building and open-sourcing the Binance Skills Hub. 🙌
 
-| Skill | Description |
+| Skill | What it does |
 |-------|-------------|
-| `binance-spot` | CEX spot trading — place orders, manage accounts, 60+ endpoints |
-| `binance-market-rank` | Trending tokens, smart money inflow, social hype, PnL leaderboard |
-| `binance-token-info` | Token search, metadata, real-time market data, candlestick charts |
-| `binance-token-audit` | Security audit — detect honeypots, rug pulls, malicious contracts |
+| `binance-spot` | CEX spot trading — place/cancel orders, query account, 60+ Binance API endpoints |
+| `binance-market-rank` | Trending tokens, smart money inflow, social hype leaderboard, PnL rankings |
+| `binance-token-info` | Token search, metadata, real-time market data, K-line candlestick charts |
+| `binance-token-audit` | Security audit — detect honeypots, rug pulls, and malicious contracts |
 | `binance-trading-signal` | Smart Money on-chain buy/sell signals on BSC & Solana |
-| `binance-address-info` | Query any wallet's token holdings and portfolio across chains |
-| `binance-meme-rush` | Real-time meme token launchpad tracking and trending narratives |
+| `binance-address-info` | Query any wallet's token holdings and portfolio across BSC, Base, Solana |
+| `binance-meme-rush` | Real-time meme token launchpad tracking and AI trending narrative discovery |
+
+Supported chains for Binance Web3 skills: **BSC (56)**, **Base (8453)**, **Solana (CT_501)**, **Ethereum (1)**
+
+---
+
+## What CryptoClaw Can Do
+
+### Crypto Core
+- **Wallet management** — create, import, monitor, and sign across EVM and Solana wallets
+- **Token swaps** — Uniswap, PancakeSwap, and other DEX protocols across EVM chains
+- **DeFi positions** — track yield farming, staking, liquidity pools (Aave, DeFiLlama, DeBank)
+- **NFT operations** — query, transfer, and monitor ERC721/ERC1155 collections
+- **Contract deployment** — deploy ERC20/ERC721 from templates
+- **On-chain data** — Etherscan, Dune Analytics, whale tracking, gas monitoring
+- **Security checks** — GoPlus Security API + Binance Token Audit for every token
 
-## What is CryptoClaw?
+### Market Intelligence
+- **Binance market rankings** — trending, smart money inflow, social hype, Binance Alpha
+- **Smart Money signals** — follow professional on-chain buy/sell activity (BSC + Solana)
+- **Meme token discovery** — real-time launchpad tracking (Pump.fun, Four.meme, Moonit)
+- **CoinGecko & DeFiLlama** — prices, market caps, TVL, protocol analytics
+- **Macro calendar** — Fed rates, CPI, economic events impacting crypto
+- **Hyperliquid** — perpetual futures and spot trading on Hyperliquid DEX
+- **Whale watcher** — monitor large on-chain transactions
 
-CryptoClaw is an AI-powered crypto assistant that runs locally in your terminal. It connects to the messaging channels you already use and helps you manage wallets, interact with DeFi protocols, track NFTs, and execute multi-chain operations — all through natural language.
+### Messaging Channels
+Connect CryptoClaw to the channels you already use:
 
-## Features
+| Channel | Status |
+|---------|--------|
+| Telegram | Supported |
+| WhatsApp | Supported |
+| Discord | Supported |
+| Slack | Supported |
+| Signal | Supported |
+| iMessage (BlueBubbles) | Supported |
+| Microsoft Teams | Supported |
+| Matrix | Supported |
+| IRC | Supported |
+| Feishu | Supported |
+| LINE | Supported |
+| Mattermost | Supported |
+| Nextcloud Talk | Supported |
+| Nostr | Supported |
+| Zalo | Supported |
+| WebChat | Supported |
 
-- **Multi-chain support** — Ethereum, Solana, and more
-- **Wallet management** — create, import, and monitor wallets
-- **DeFi integration** — swap, stake, and track positions
-- **NFT operations** — query, transfer, and monitor collections
-- **Messaging channels** — WhatsApp, Telegram, Slack, Discord, and more
-- **AI-native** — natural language interface powered by leading LLMs
-- **Privacy-first** — runs on your own machine, your keys stay yours
+---
 
 ## Install
 
+**Requirements:** Node.js 22+
+
 ```bash
 npm install -g @termix-it/cryptoclaw
 ```
@@ -48,58 +95,233 @@ pnpm add -g @termix-it/cryptoclaw
 bun add -g @termix-it/cryptoclaw
 ```
 
-**Requirements:** Node.js 22+
+---
 
 ## Quick Start
 
 ```bash
-# Run the onboarding wizard
+# Run the onboarding wizard (recommended)
 cryptoclaw onboard
 
 # Start the gateway
-cryptoclaw gateway run
+cryptoclaw gateway run --port 18789
 
-# Check channel status
+# Check status of all connected channels
 cryptoclaw channels status
+
+# Send a message to any channel
+cryptoclaw message send --to @username --message "What is the BTC price?"
+
+# Run the AI agent directly
+cryptoclaw agent --message "Show me smart money signals on BSC" --thinking high
 ```
 
+---
+
 ## Supported Chains
 
-| Chain    | Status    |
-| -------- | --------- |
-| Ethereum | Supported |
-| Solana   | Supported |
-| Base     | Supported |
-| Arbitrum | Supported |
-| Polygon  | Supported |
+| Chain | Type | Details |
+|-------|------|---------|
+| Ethereum | EVM | Mainnet + testnets |
+| BSC (BNB Chain) | EVM | Binance Smart Chain |
+| Base | EVM | Coinbase L2 |
+| Arbitrum | EVM | Arbitrum One |
+| Polygon | EVM | PoS chain |
+| Solana | SVM | SPL tokens |
+| Hyperliquid | L1 | Perps + spot |
+
+---
+
+## Skills Library (80+)
 
-## Supported Channels
+CryptoClaw ships with 80+ skills covering crypto, DeFi, productivity, and automation. Skills are loaded per-conversation and give the AI agent native access to external tools and APIs.
 
-Connect CryptoClaw to your preferred messaging platform:
+### Crypto & DeFi
+
+| Skill | Description |
+|-------|-------------|
+| `binance-spot` | Binance CEX spot trading — 60+ endpoints |
+| `binance-market-rank` | Trending tokens, smart money, social hype rankings |
+| `binance-token-info` | Token search, metadata, real-time data, K-lines |
+| `binance-token-audit` | Security audit for honeypots and rug pulls |
+| `binance-trading-signal` | Smart Money on-chain buy/sell signals |
+| `binance-address-info` | Wallet portfolio query across chains |
+| `binance-meme-rush` | Launchpad meme token and trend discovery |
+| `wallet-manager` | Create, import, and manage blockchain wallets |
+| `token-swap` | Swap tokens on Uniswap/PancakeSwap |
+| `coingecko` | Prices, market caps, charts, trending tokens |
+| `defillama` | TVL, protocol analytics, yield pools |
+| `debank` | Wallet portfolios and DeFi positions |
+| `etherscan` | Block explorer queries (ETH, BSC, Polygon, etc.) |
+| `hyperliquid` | Perpetual futures and spot on Hyperliquid DEX |
+| `aave-bsc` | Aave V3 lending on BSC |
+| `dune` | Custom SQL analytics on Dune |
+| `gas-tracker` | Gas prices across networks |
+| `whale-watcher` | Large on-chain transaction monitoring |
+| `market-data` | Multi-source price and market data |
+| `security-check` | Token/address security via GoPlus API |
+| `portfolio-tracker` | Track holdings and portfolio value |
+| `defi-dashboard` | Yield farming, staking, liquidity pools |
+| `nft-manager` | View, transfer, manage NFTs |
+| `contract-deployer` | Deploy ERC20/ERC721 from templates |
+| `four-meme` | BSC launchpad token discovery |
+| `macro-calendar` | Macro events (Fed, CPI, economic calendar) |
+| `agent-identity` | On-chain AI agent identity (ERC-8004) |
+
+### Productivity & Automation
+
+| Skill | Description |
+|-------|-------------|
+| `github` | GitHub issues, PRs, CI runs via `gh` CLI |
+| `gh-issues` | Auto-implement GitHub issues and open PRs |
+| `notion` | Notion pages, databases, blocks |
+| `trello` | Trello boards, lists, and cards |
+| `obsidian` | Obsidian vault management |
+| `apple-notes` | Apple Notes via `memo` CLI (macOS) |
+| `apple-reminders` | Apple Reminders via `remindctl` |
+| `bear-notes` | Bear notes via `grizzly` CLI |
+| `things-mac` | Things 3 task management (macOS) |
+| `1password` | 1Password CLI integration |
+| `gog` | Google Workspace (Gmail, Calendar, Drive, Sheets) |
+| `himalaya` | Email via IMAP/SMTP |
+| `slack` | Slack channel and DM operations |
+| `discord` | Discord channel operations |
+| `tmux` | Remote tmux session control |
+| `summarize` | Summarize URLs, podcasts, and files |
+| `blogwatcher` | RSS/Atom feed monitoring |
+| `oracle` | Prompt bundling and agent orchestration |
+
+### AI & Media
+
+| Skill | Description |
+|-------|-------------|
+| `coding-agent` | Delegate coding tasks to Codex/Claude/Pi agents |
+| `skill-creator` | Create and publish new agent skills |
+| `openai-image-gen` | Batch image generation via OpenAI |
+| `openai-whisper` | Local speech-to-text (offline) |
+| `openai-whisper-api` | Transcription via OpenAI Whisper API |
+| `nano-banana-pro` | Image generation/editing via Gemini |
+| `gemini` | Gemini CLI for Q&A and generation |
+| `peekaboo` | macOS UI capture and automation |
+| `camsnap` | RTSP/ONVIF camera capture |
+| `video-frames` | Frame/clip extraction via ffmpeg |
+| `gifgrep` | GIF search and download |
+| `canvas` | Agent-driven visual workspace |
+| `session-logs` | Search and analyze conversation history |
+| `model-usage` | Per-model cost and usage tracking |
+
+### Home & Lifestyle
+
+| Skill | Description |
+|-------|-------------|
+| `openhue` | Philips Hue lights via OpenHue CLI |
+| `eightctl` | Eight Sleep pod control |
+| `sonoscli` | Sonos speaker control |
+| `spotify-player` | Spotify playback via terminal |
+| `songsee` | Audio spectrogram visualization |
+| `weather` | Weather via wttr.in / Open-Meteo |
+| `goplaces` | Google Places API search |
+| `ordercli` | Foodora order history |
 
-- Telegram
-- WhatsApp
-- Discord
-- Slack
-- Signal
-- iMessage
-- Microsoft Teams
-- Matrix
-- and more...
+### Voice & TTS
+
+| Skill | Description |
+|-------|-------------|
+| `sag` | ElevenLabs TTS (mac-style `say` UX) |
+| `sherpa-onnx-tts` | Local TTS via sherpa-onnx (offline) |
+| `voice-call` | Voice calls via the voice-call plugin |
+
+---
 
 ## Configuration
 
 ```bash
 # Set your preferred AI model
 cryptoclaw config set model openai/gpt-4o
+# or: anthropic/claude-opus-4-6, google/gemini-2.0-flash, etc.
 
 # Add a wallet
 cryptoclaw wallet add
 
-# List connected channels
-cryptoclaw channels list
+# Connect a messaging channel
+cryptoclaw channels connect telegram
+cryptoclaw channels connect discord
+cryptoclaw channels connect whatsapp
+
+# List installed skills
+cryptoclaw skills list
+
+# Install a skill
+cryptoclaw skills install binance-spot
+
+# Check channel and gateway health
+cryptoclaw channels status --probe
+cryptoclaw doctor
+```
+
+---
+
+## Architecture
+
+```
+Telegram / WhatsApp / Discord / Slack / Signal / iMessage / Matrix / ...
+               │
+               ▼
+┌──────────────────────────────────────┐
+│              Gateway                 │
+│          (control plane)             │
+│        ws://127.0.0.1:18789          │
+└──────────────┬───────────────────────┘
+               │
+               ├─ AI Agent (RPC / streaming)
+               │    └─ Skills: binance-spot, wallet-manager, token-swap, ...
+               ├─ CLI  (cryptoclaw …)
+               ├─ WebChat UI
+               └─ macOS / iOS / Android nodes
+```
+
+The Gateway is the local control plane. The AI agent connects to it via WebSocket RPC, loads skills on demand, and routes responses back to any connected channel. Everything runs on your machine.
+
+---
+
+## Development
+
+```bash
+git clone https://github.com/TermiX-official/cryptoclaw.git
+cd cryptoclaw
+
+pnpm install
+pnpm build
+
+# Dev loop
+pnpm gateway:watch
+
+# Run tests
+pnpm test
+
+# Type check
+pnpm tsgo
 ```
 
+---
+
+## Security
+
+CryptoClaw connects to real messaging surfaces and real on-chain infrastructure. Treat inbound messages as **untrusted input** by default.
+
+- **DM pairing** — unknown senders get a pairing code challenge; the agent does not process their message until approved.
+- **Wallet signing** — private keys never leave your machine; all signing is local.
+- **Token audit** — `binance-token-audit` and `security-check` skills run automatically before swaps when configured.
+- **Mainnet confirmation** — Binance spot and swap skills require explicit user confirmation before executing mainnet transactions.
+
+Run `cryptoclaw doctor` to surface misconfigured security policies.
+
+---
+
 ## License
 
 MIT — see [LICENSE](LICENSE) for details.
+
+---
+
+*Built on [OpenClaw](https://github.com/openclaw/openclaw) — the open-source AI gateway platform.*

package/dist/{accounts-DarjcXFz.js → accounts-BSIXwC37.js}

@@ -1,5 +1,5 @@
 import { _ as normalizeAccountId } from "./session-key-k6urs9r-.js";
-import { v as createAccountListHelpers, y as resolveAccountEntry } from "./accounts-CucAhPu5.js";
+import { v as createAccountListHelpers, y as resolveAccountEntry } from "./accounts-Bod7973i.js";
 
 //#region src/imessage/accounts.ts
 const { listAccountIds, resolveDefaultAccountId } = createAccountListHelpers("imessage");

package/dist/{accounts-CucAhPu5.js → accounts-Bod7973i.js}

@@ -6,7 +6,7 @@ import { _ as normalizeAccountId, g as DEFAULT_ACCOUNT_ID, v as normalizeOptiona
 import { f as jidToE164, v as resolveUserPath } from "./utils-cwpAMi-t.js";
 import path from "node:path";
 import fs from "node:fs";
-import fs$1 from "node:fs/promises";
+import fsPromises from "node:fs/promises";
 
 //#region src/routing/account-lookup.ts
 function resolveAccountEntry(accounts, accountId) {
@@ -105,14 +105,14 @@ async function webAuthExists(authDir = resolveDefaultWebAuthDir()) {
 	maybeRestoreCredsFromBackup(resolvedAuthDir);
 	const credsPath = resolveWebCredsPath(resolvedAuthDir);
 	try {
-		await fs$1.access(resolvedAuthDir);
+		await fsPromises.access(resolvedAuthDir);
 	} catch {
 		return false;
 	}
 	try {
-		const stats = await fs$1.stat(credsPath);
+		const stats = await fsPromises.stat(credsPath);
 		if (!stats.isFile() || stats.size <= 1) return false;
-		const raw = await fs$1.readFile(credsPath, "utf-8");
+		const raw = await fsPromises.readFile(credsPath, "utf-8");
 		JSON.parse(raw);
 		return true;
 	} catch {
@@ -120,7 +120,7 @@ async function webAuthExists(authDir = resolveDefaultWebAuthDir()) {
 	}
 }
 async function clearLegacyBaileysAuthState(authDir) {
-	const entries = await fs$1.readdir(authDir, { withFileTypes: true });
+	const entries = await fsPromises.readdir(authDir, { withFileTypes: true });
 	const shouldDelete = (name) => {
 		if (name === "oauth.json") return false;
 		if (name === "creds.json" || name === "creds.json.bak") return true;
@@ -130,7 +130,7 @@ async function clearLegacyBaileysAuthState(authDir) {
 	await Promise.all(entries.map(async (entry) => {
 		if (!entry.isFile()) return;
 		if (!shouldDelete(entry.name)) return;
-		await fs$1.rm(path.join(authDir, entry.name), { force: true });
+		await fsPromises.rm(path.join(authDir, entry.name), { force: true });
 	}));
 }
 async function logoutWeb(params) {
@@ -141,7 +141,7 @@ async function logoutWeb(params) {
 		return false;
 	}
 	if (params.isLegacyAuthDir) await clearLegacyBaileysAuthState(resolvedAuthDir);
-	else await fs$1.rm(resolvedAuthDir, {
+	else await fsPromises.rm(resolvedAuthDir, {
 		recursive: true,
 		force: true
 	});

package/dist/{accounts-DjUjM_0M.js → accounts-D3YOECeq.js}

@@ -1,5 +1,5 @@
 import { _ as normalizeAccountId } from "./session-key-k6urs9r-.js";
-import { v as createAccountListHelpers, y as resolveAccountEntry } from "./accounts-CucAhPu5.js";
+import { v as createAccountListHelpers, y as resolveAccountEntry } from "./accounts-Bod7973i.js";
 
 //#region src/signal/accounts.ts
 const { listAccountIds, resolveDefaultAccountId } = createAccountListHelpers("signal");

package/dist/{acp-cli-BKEdLWJH.js → acp-cli-CGC73qiP.js}

@@ -3,10 +3,10 @@ import "./paths-BMo6kTge.js";
 import { d as defaultRuntime } from "./subsystem-Cfn2Pryx.js";
 import "./boolean-DtWR5bt3.js";
 import { n as isMainModule } from "./entry.js";
-import { z as loadConfig } from "./auth-profiles-CtYlKXxI.js";
-import "./agent-scope-C5bklqr1.js";
+import { z as loadConfig } from "./auth-profiles-yB_p54Kf.js";
+import "./agent-scope-BGsA4zEf.js";
 import { v as resolveUserPath, x as shortenHomePath } from "./utils-cwpAMi-t.js";
-import "./openclaw-root-BFfBQ6FD.js";
+import "./openclaw-root-BU3lu8pM.js";
 import "./logger-DB-PHqB2.js";
 import "./exec-B45rafWZ.js";
 import "./registry-BrR1Dq5T.js";
@@ -14,13 +14,13 @@ import "./github-copilot-token-Byc_YVYE.js";
 import "./host-env-security-lcjXF83D.js";
 import { t as VERSION } from "./version-DdJhsIqk.js";
 import "./env-vars-mSSOl7Rv.js";
-import "./manifest-registry-DjbHJw7g.js";
+import "./manifest-registry-CzoQ4XAn.js";
 import { h as GATEWAY_CLIENT_NAMES, m as GATEWAY_CLIENT_MODES } from "./message-channel-CXgeX9no.js";
-import { t as GatewayClient } from "./client-BqLxmdBY.js";
-import { s as resolveGatewayCredentialsWithSecretInputs, t as buildGatewayConnectionDetails } from "./call-BHrnZxI1.js";
+import { t as GatewayClient } from "./client-Kkj2aHgb.js";
+import { s as resolveGatewayCredentialsWithSecretInputs, t as buildGatewayConnectionDetails } from "./call-CeJbHmC5.js";
 import "./pairing-token-BXrId5bQ.js";
-import "./net-DFijUFfS.js";
-import "./tailnet-Bdvg29Ll.js";
+import "./net-CfwQaj6f.js";
+import "./tailnet-D8ZmZFEq.js";
 import { r as isKnownCoreToolId } from "./tool-catalog-C04U7H3F.js";
 import { n as resolveWindowsSpawnProgram, t as materializeWindowsSpawnProgram } from "./windows-spawn-BTikdM3p.js";
 import { t as formatDocsLink } from "./links-BVDZVrXu.js";

package/dist/{agent-scope-C5bklqr1.js → agent-scope-BGsA4zEf.js}

@@ -2,13 +2,13 @@ import { g as resolveStateDir, y as resolveRequiredHomeDir } from "./paths-BMo6k
 import { t as createSubsystemLogger } from "./subsystem-Cfn2Pryx.js";
 import { E as parseAgentSessionKey, T as isSubagentSessionKey, c as normalizeAgentId, t as DEFAULT_AGENT_ID, u as resolveAgentIdFromSessionKey, w as isCronSessionKey } from "./session-key-k6urs9r-.js";
 import { m as pathExists, v as resolveUserPath } from "./utils-cwpAMi-t.js";
-import { _ as normalizeSkillFilter, i as openBoundaryFile, t as resolveOpenClawPackageRoot } from "./openclaw-root-BFfBQ6FD.js";
+import { _ as normalizeSkillFilter, i as openBoundaryFile, t as resolveOpenClawPackageRoot } from "./openclaw-root-BU3lu8pM.js";
 import { t as runCommandWithTimeout } from "./exec-B45rafWZ.js";
 import { fileURLToPath } from "node:url";
 import os from "node:os";
 import path from "node:path";
 import fs from "node:fs";
-import fs$1 from "node:fs/promises";
+import fsPromises from "node:fs/promises";
 
 //#region src/config/model-input.ts
 function resolveAgentModelPrimaryValue(model) {
@@ -150,7 +150,7 @@ async function loadTemplate(name) {
 		const templateDir = await resolveWorkspaceTemplateDir();
 		const templatePath = path.join(templateDir, name);
 		try {
-			return stripFrontMatter(await fs$1.readFile(templatePath, "utf-8"));
+			return stripFrontMatter(await fsPromises.readFile(templatePath, "utf-8"));
 		} catch {
 			throw new Error(`Missing workspace template: ${name} (${templatePath}). Ensure docs/reference/templates are packaged.`);
 		}
@@ -165,7 +165,7 @@ async function loadTemplate(name) {
 }
 async function writeFileIfMissing(filePath, content) {
 	try {
-		await fs$1.writeFile(filePath, content, {
+		await fsPromises.writeFile(filePath, content, {
 			encoding: "utf-8",
 			flag: "wx"
 		});
@@ -177,7 +177,7 @@ async function writeFileIfMissing(filePath, content) {
 }
 async function fileExists(filePath) {
 	try {
-		await fs$1.access(filePath);
+		await fsPromises.access(filePath);
 		return true;
 	} catch {
 		return false;
@@ -201,7 +201,7 @@ function parseWorkspaceOnboardingState(raw) {
 }
 async function readWorkspaceOnboardingState(statePath) {
 	try {
-		return parseWorkspaceOnboardingState(await fs$1.readFile(statePath, "utf-8")) ?? { version: WORKSPACE_STATE_VERSION };
+		return parseWorkspaceOnboardingState(await fsPromises.readFile(statePath, "utf-8")) ?? { version: WORKSPACE_STATE_VERSION };
 	} catch (err) {
 		if (err.code !== "ENOENT") throw err;
 		return { version: WORKSPACE_STATE_VERSION };
@@ -215,20 +215,20 @@ async function isWorkspaceOnboardingCompleted(dir) {
 	return typeof state.onboardingCompletedAt === "string" && state.onboardingCompletedAt.trim().length > 0;
 }
 async function writeWorkspaceOnboardingState(statePath, state) {
-	await fs$1.mkdir(path.dirname(statePath), { recursive: true });
+	await fsPromises.mkdir(path.dirname(statePath), { recursive: true });
 	const payload = `${JSON.stringify(state, null, 2)}\n`;
 	const tmpPath = `${statePath}.tmp-${process.pid}-${Date.now().toString(36)}`;
 	try {
-		await fs$1.writeFile(tmpPath, payload, { encoding: "utf-8" });
-		await fs$1.rename(tmpPath, statePath);
+		await fsPromises.writeFile(tmpPath, payload, { encoding: "utf-8" });
+		await fsPromises.rename(tmpPath, statePath);
 	} catch (err) {
-		await fs$1.unlink(tmpPath).catch(() => {});
+		await fsPromises.unlink(tmpPath).catch(() => {});
 		throw err;
 	}
 }
 async function hasGitRepo(dir) {
 	try {
-		await fs$1.stat(path.join(dir, ".git"));
+		await fsPromises.stat(path.join(dir, ".git"));
 		return true;
 	} catch {
 		return false;
@@ -258,7 +258,7 @@ async function ensureGitRepo(dir, isBrandNewWorkspace) {
 }
 async function ensureAgentWorkspace(params) {
 	const dir = resolveUserPath(params?.dir?.trim() ? params.dir.trim() : DEFAULT_AGENT_WORKSPACE_DIR);
-	await fs$1.mkdir(dir, { recursive: true });
+	await fsPromises.mkdir(dir, { recursive: true });
 	if (!params?.ensureBootstrapFiles) return { dir };
 	const agentsPath = path.join(dir, DEFAULT_AGENTS_FILENAME);
 	const soulPath = path.join(dir, DEFAULT_SOUL_FILENAME);
@@ -285,7 +285,7 @@ async function ensureAgentWorkspace(params) {
 		const paths = [...templatePaths, ...userContentPaths];
 		return (await Promise.all(paths.map(async (p) => {
 			try {
-				await fs$1.access(p);
+				await fsPromises.access(p);
 				return true;
 			} catch {
 				return false;
@@ -318,7 +318,7 @@ async function ensureAgentWorkspace(params) {
 	if (!state.bootstrapSeededAt && bootstrapExists) markState({ bootstrapSeededAt: nowIso() });
 	if (!state.onboardingCompletedAt && state.bootstrapSeededAt && !bootstrapExists) markState({ onboardingCompletedAt: nowIso() });
 	if (!state.bootstrapSeededAt && !state.onboardingCompletedAt && !bootstrapExists) {
-		const [identityContent, userContent] = await Promise.all([fs$1.readFile(identityPath, "utf-8"), fs$1.readFile(userPath, "utf-8")]);
+		const [identityContent, userContent] = await Promise.all([fsPromises.readFile(identityPath, "utf-8"), fsPromises.readFile(userPath, "utf-8")]);
 		const hasUserContent = await (async () => {
 			const indicators = [
 				path.join(dir, "memory"),
@@ -326,7 +326,7 @@ async function ensureAgentWorkspace(params) {
 				path.join(dir, ".git")
 			];
 			for (const indicator of indicators) try {
-				await fs$1.access(indicator);
+				await fsPromises.access(indicator);
 				return true;
 			} catch {}
 			return false;
@@ -357,7 +357,7 @@ async function resolveMemoryBootstrapEntries(resolvedDir) {
 	for (const name of candidates) {
 		const filePath = path.join(resolvedDir, name);
 		try {
-			await fs$1.access(filePath);
+			await fsPromises.access(filePath);
 			entries.push({
 				name,
 				filePath
@@ -370,7 +370,7 @@ async function resolveMemoryBootstrapEntries(resolvedDir) {
 	for (const entry of entries) {
 		let key = entry.filePath;
 		try {
-			key = await fs$1.realpath(entry.filePath);
+			key = await fsPromises.realpath(entry.filePath);
 		} catch {}
 		if (seen.has(key)) continue;
 		seen.add(key);