@fased/fased 0.1.13 → 0.1.14

package/docs/install/index.md

@@ -579,7 +579,7 @@ Use this order for a new install:
 7. enable Mining or Fased Network only after the base Agent is stable
 
 Successful installation means Fased is installed. It does not replace the
-setup checks for channels, services, wallets, mining, or network roles.
+setup checks for chat apps, services, wallets, mining, or network roles.
 
 ## Troubleshooting: `fased` not found
 

package/docs/links.md

@@ -1,10 +1,10 @@
 ---
-summary: "Official Fased and Fcode ecosystem links for Fased Agent, Fased App, Satcoin, docs, community, and social accounts."
+summary: "Official Fased and Fcode ecosystem links for Fased Agent, Fased Network, Satcoin, docs, community, and social accounts."
 read_when:
   - Finding official Fased links
   - Verifying docs, community, social accounts, or Satcoin links
 title: "Official Links"
-description: "Official Fased and Fcode ecosystem links for Fased Agent, Fased App, Satcoin, docs, community, and social accounts."
+description: "Official Fased and Fcode ecosystem links for Fased Agent, Fased Network, Satcoin, docs, community, and social accounts."
 ---
 
 # Official Links
@@ -24,7 +24,7 @@ Primary ecosystem link hub: [docs.fcode.ai/links](https://docs.fcode.ai/links)
 
 | Name               | Link                                                           |
 | ------------------ | -------------------------------------------------------------- |
-| Fased App          | [fased.ai](https://fased.ai)                                   |
+| Fased site         | [fased.ai](https://fased.ai)                                   |
 | Fased Network      | [fased.app](https://fased.app)                                 |
 | Fased docs         | [docs.fased.ai](https://docs.fased.ai)                         |
 | Fased Agent GitHub | [github.com/fased-ai/fased](https://github.com/fased-ai/fased) |
@@ -32,12 +32,12 @@ Primary ecosystem link hub: [docs.fcode.ai/links](https://docs.fcode.ai/links)
 
 ## Fcode Ecosystem
 
-| Name                     | Link                                     |
-| ------------------------ | ---------------------------------------- |
-| Fcode AI                 | [fcode.ai](https://fcode.ai)             |
-| Fcode docs               | [docs.fcode.ai](https://docs.fcode.ai)   |
+| Name                     | Link                                               |
+| ------------------------ | -------------------------------------------------- |
+| Fcode AI                 | [fcode.ai](https://fcode.ai)                       |
+| Fcode docs               | [docs.fcode.ai](https://docs.fcode.ai)             |
 | Official ecosystem links | [docs.fcode.ai/links](https://docs.fcode.ai/links) |
-| Fcode on X               | [x.com/FcodeAi](https://x.com/FcodeAi)   |
+| Fcode on X               | [x.com/FcodeAi](https://x.com/FcodeAi)             |
 
 ## Satcoin
 

package/docs/platforms/mac/release.md

@@ -35,6 +35,7 @@ Release builds must be Developer ID-signed, zipped, and published with a signed
         --key-id "$APP_STORE_CONNECT_KEY_ID" \
         --issuer "$APP_STORE_CONNECT_ISSUER_ID"
       ```
+
 - `pnpm` deps installed (`pnpm install --config.node-linker=hoisted`).
 - Sparkle tools are fetched automatically via SwiftPM at
   `apps/macos/.build/artifacts/sparkle/Sparkle/bin/`.

package/docs/plugins/crypto/wallet-autonomous-security.md

@@ -70,7 +70,7 @@ flowchart TD
 Avoid these patterns:
 
 - one Agent wallet reused for mining, bond, and vault storage
-- one wallet reused for mining, service payments, treasury, and private business receipts
+- one wallet reused for mining, marketplace payments, treasury, and private business receipts
 - host-only passphrase files as the only real unlock boundary
 - recovery share stored next to the device share
 - leaving Agent automation enabled without tight caps and allowlists

package/docs/plugins/crypto/wallet-roles-and-policies.md

@@ -28,6 +28,7 @@ External addr = read-only balance checks or send destination, never a local sour
     wallet actions, small working balances, and reviewed wallet actions.
 
     Keep Satcoin mining, Vault storage, and bond authority on their own lanes.
+
   </Card>
   <Card title="Mining wallet">
     Use it for Satcoin start, stop, fund, commit, withdraw, claim, sweep, and
@@ -35,6 +36,7 @@ External addr = read-only balance checks or send destination, never a local sour
 
     Keep Marketplace buying, ordinary chat sends, skills, and invoices on Agent
     wallets.
+
   </Card>
   <Card title="Vault wallet">
     Use it for manual-first storage, higher-value balances, recovery separation,
@@ -42,12 +44,14 @@ External addr = read-only balance checks or send destination, never a local sour
 
     Keep routine automation, Marketplace order actions, and mining on their own
     lanes.
+
   </Card>
   <Card title="External Solana address">
     Use it for read-only SOL/SPL balance checks or as a destination for
     manual/approved sends.
 
     External addresses are never local signing sources.
+
   </Card>
 </CardGroup>
 

package/docs/reference/vision.md

@@ -8,13 +8,14 @@ read_when:
 
 ## Fased Vision
 
-Fased is a self-hosted agent runtime for operators who want real control over:
+Fased is an agent setup you can run on your own computer or server when you
+want real control over:
 
-- runtime and host access
-- browser control surfaces
+- host access and remote access
+- the browser Control UI
 - wallets and signer posture
 - optional Fased Network and SAT modules
-- plugins, channels, offers, and reviewed operator workflows
+- plugins, chat apps, offers, and reviewed marketplace workflows
 
 Project overview: [`README.md`](https://github.com/fased-ai/fased/blob/main/README.md)
 Contribution policy: [`CONTRIBUTING.md`](https://github.com/fased-ai/fased/blob/main/CONTRIBUTING.md)
@@ -29,10 +30,10 @@ The current shape is:
 - browser-first control UI
 - local or hosted onboarding flows
 - token-protected and device-auth protected control pages
-- wallet-aware runtime policy
+- wallet-aware controls
 - SAT mining
-- bonded Fased Network operator surfaces
-- operator network views and accounting records
+- bonded Fased Network roles
+- network views and accounting records
 - local offer records and marketplace discovery
 
 Near-term roadmap:
@@ -70,7 +71,8 @@ Preferred posture:
 
 ## Access and safety posture
 
-Fased should make the safe path the default without pretending the runtime is low-power.
+Fased should make the safe path the default without pretending the agent is
+low-power.
 
 Current principles:
 
@@ -82,17 +84,17 @@ Current principles:
 
 ## Wallets, mining, bond, and federation
 
-Wallet and network features belong in the same sovereign runtime, but they should
-not all be turned on at once.
+Wallet and network features belong near the agent, but they should not all be
+turned on at once.
 
-Healthy operator sequence:
+Safe setup sequence:
 
-1. bring up the runtime
+1. bring up the Gateway and dashboard
 2. confirm private access and restart health
-3. choose wallet posture
+3. choose wallet controls
 4. attach signer or passkey-backed wallet flows where needed
-5. define sweep and funding policy before funds
-6. add mining, federation, and bond only after the base runtime is stable
+5. define sweep and funding rules before moving funds
+6. add mining, Fased Network, and bond only after the base agent is stable
 
 Current module split:
 
@@ -120,10 +122,11 @@ product or security reason.
 
 The target product is:
 
-- a self-hosted agent for one operator or one trust boundary
-- a sovereign wallet-aware runtime
+- an agent you can run for one person, team, or trust boundary
+- wallet-aware automation with clear controls
 - a bonded network participant when the operator chooses that path
-- a place where chat, marketplace, network, and market/news review workflows can live under one policy surface
+- a place where chat, marketplace, network, and market/news review workflows can
+  live under one control surface
 
 ## Guardrails
 

package/docs/security/index.md

@@ -1,16 +1,17 @@
 ---
 title: "Security Overview"
-summary: "Security-first setup guide for remote access, credentials, skills, wallet grants, and operator surfaces."
+summary: "Security-first setup guide for remote access, credentials, skills, wallet grants, and admin surfaces."
 read_when:
   - Preparing a public or hosted Fased install
   - Reviewing skill, wallet, service credential, or remote access risk
-  - Explaining which UI surfaces are for normal setup versus operator diagnostics
+  - Explaining which UI surfaces are for normal setup versus admin diagnostics
 ---
 
 # Security Overview
 
-Fased is a user-run agent with a local Gateway. Treat it like a local server with
-access to chats, tools, credentials, files, wallets, and optional paired devices.
+Fased is an agent you run with a local Gateway. Treat it like a local server
+with access to chats, tools, credentials, files, wallets, and optional paired
+devices.
 
 The conservative setup keeps each capability behind a separate gate: connect the
 service, allow the Agent to use the tool, then approve sensitive actions when
@@ -26,10 +27,10 @@ Use the selected Agent first:
 - **Agent > Skills**: review/install skills, configure values, install
   dependencies, test loading, and allow the skill for this Agent.
 - **Agent > Tools**: grant or block this Agent from using tools that already exist.
-- **Agent > Memory**: inspect session-memory status and roots for this Agent.
+- **Agent > Memory**: inspect saved context, session-memory status, and roots for this Agent.
 - **Agent > Tasks**: schedule work that runs as this Agent.
 
-Operator surfaces are separate:
+Admin and monitoring surfaces are separate:
 
 - **Usage**: local token and cost history.
 - **Logs**: gateway log tail.
@@ -145,12 +146,12 @@ Related docs:
 
 - Gateway auth enabled for any non-loopback access.
 - Remote access uses Tailscale, SSH tunnel, or a locked-down reverse proxy.
-- Agent models, channels, services, skills, tools, memory, and tasks configured per Agent.
+- Agent models, chat apps, services, skills, tools, saved context, and tasks configured per Agent.
 - Skills reviewed before install; dependency installers reviewed and verified after install.
 - Wallet skill grants are narrow and separate from mining/vault roles.
 - Logs and Usage reviewed after setup smoke tests.
 - Threat model and security-test-report claims reviewed for the current release.
-- Advanced > Debug and Advanced > Nodes treated as operator/admin diagnostics, not first-run setup.
+- Advanced > Debug and Advanced > Nodes treated as admin diagnostics, not first-run setup.
 - Run the public launch checks in [Full release validation](/reference/full-release-validation).
 
 ## Reporting Vulnerabilities

package/docs/start/agent-wallet-mining-walkthrough.md

@@ -14,6 +14,11 @@ wallet setup, and Satcoin mining control.
 Use this page when you want the shortest guided route. Each section links to the
 deeper docs for the same area.
 
+<Warning>
+Do not start with wallet funding, mining, or bond. First prove the runtime:
+install, open the dashboard, connect a model, and send one browser chat.
+</Warning>
+
 ```mermaid
 flowchart TD
   install["Install Fased"] --> open["Open Control UI"]
@@ -37,6 +42,26 @@ flowchart TD
   class mining,ready,capital,commit,start,activity,stop mining;
 ```
 
+## Before You Start
+
+Pick where Fased Agent runs.
+
+| Setup           | Use when                                     | Recommended path                                       |
+| --------------- | -------------------------------------------- | ------------------------------------------------------ |
+| Local           | you are learning or testing on this computer | macOS Terminal, Windows WSL2 Ubuntu, or Linux terminal |
+| VPS Hosting     | you need an always-on machine                | Ubuntu LTS VPS first; Debian is close                  |
+| Hosted advanced | you already manage Linux servers             | Fedora or RHEL-family with systemd                     |
+
+Practical baseline:
+
+- Local: a normal laptop/desktop that can run a browser and terminal.
+- Hosted test VPS: `1 vCPU / 1 GB RAM` can work, but may feel slow.
+- Hosted smoother VPS: `2 GB RAM` or `2 vCPU / 4 GB RAM`.
+- Hosted disk: `20 GB` minimum, `40 GB+` more comfortable.
+
+For hosted setup, keep the VPS provider console open until private access
+works. Do not expose the dashboard as a public web panel.
+
 ## 1. Install Fased
 
 Choose the setup profile first.
@@ -52,6 +77,18 @@ Choose the setup profile first.
 
     This selects the **Local** profile and keeps VPS SSH/firewall hardening off.
 
+    If onboarding was interrupted, continue it:
+
+    ```bash
+    fased onboard --install-daemon
+    ```
+
+    Then open the dashboard:
+
+    ```bash
+    fased dashboard
+    ```
+
     ![Local installer selecting the Local profile](/images/screenshots/local/local-ui-1.png)
 
     ![Local QuickStart gateway settings](/images/screenshots/local/local-ui-2.png)
@@ -65,8 +102,31 @@ Choose the setup profile first.
     Tailscale/package steps, so use the OS tabs in
     [Install](/install#vps-hosting-install).
 
-    Confirm Tailscale SSH from your own computer before setup hardens SSH and
-    firewall access.
+    On your own computer, install and sign into Tailscale first. Then SSH into
+    the VPS:
+
+    ```bash
+    ssh root@YOUR_PUBLIC_VPS_IP
+    ```
+
+    Run the hosted installer **inside the VPS SSH session**:
+
+    ```bash
+    curl -fsSL https://raw.githubusercontent.com/fased-ai/fased/main/install.sh | bash -s -- --hosting
+    ```
+
+    Do not paste the hosted command into local PowerShell or Terminal unless
+    that shell is already connected to the VPS.
+
+    When setup prints the Tailscale login URL, open it in your local browser.
+    Before setup hardens SSH/firewall access, confirm Tailscale SSH from your
+    own computer:
+
+    ```bash
+    ssh app@YOUR_VPS_TAILSCALE_NAME
+    ```
+
+    It should connect and land in `/home/app/fased`.
 
     ![Tailscale local computer requirement during hosted setup](/images/screenshots/remote/tailscale-1.png)
 
@@ -77,6 +137,25 @@ Choose the setup profile first.
   </Tab>
 </Tabs>
 
+Simple command recap:
+
+```bash
+# Local on this computer
+curl -fsSL https://raw.githubusercontent.com/fased-ai/fased/main/install.sh | bash -s -- --local
+
+# Hosted on the VPS itself
+curl -fsSL https://raw.githubusercontent.com/fased-ai/fased/main/install.sh | bash -s -- --hosting
+
+# Continue setup if interrupted
+fased onboard --install-daemon
+
+# Open browser dashboard
+fased dashboard
+
+# Check health
+fased health
+```
+
 Read next:
 
 - [Getting Started](/start/getting-started)
@@ -115,9 +194,9 @@ Read next:
 
 Open **Agents**.
 
-The selected Agent owns chat, model settings, skills, services, channels,
-tasks, memory, and wallet policy. Start with one Agent unless you already know
-you need separate work profiles.
+The selected Agent owns chat, model settings, skills, services, chat app
+routes, tasks, saved context, and wallet controls. Start with one Agent unless
+you already know you need separate work profiles.
 
 ![Agent setup page with setup checklist](/images/screenshots/web/agent-setup-1.png)