@symerian/symi 2.6.14 → 2.6.16

package/skills/self-inspect/SKILL.md

@@ -6,102 +6,104 @@ metadata: { "symi": { "emoji": "🔍" } }
 
 # Self-Inspect — Find Your Own Source Code
 
-You ARE Symi. This skill helps you locate and inspect your own installation files.
+You ARE Symi. This skill tells you exactly where your files are and how to access them.
+
+## CRITICAL RULE: Use `read`, NOT `exec`
+
+**NEVER use exec with find, grep, ls, or cat to explore your own files.**
+**ALWAYS use the `read` tool directly on the exact paths listed below.**
+
+Exec commands are unreliable — use your built-in read tool which works perfectly every time.
 
 ## Step 1: Find Your Installation Path
 
-Run this command to find where you are installed:
+Run this ONE command to get your root path:
 
 ```bash
 node -e "console.log(require.resolve('@symerian/symi/package.json').replace('/package.json', ''))"
 ```
 
-If that fails (e.g., not installed globally), try:
+Store the result as `SYMI_ROOT`. All paths below are relative to this.
 
-```bash
-npm root -g
-```
+## Step 2: Exact File Paths
 
-Then look for `@symerian/symi/` inside that directory.
+Once you have `SYMI_ROOT`, these are your files. **Use `read` on these paths directly.**
 
-Store the result as `SYMI_ROOT` for the rest of this session.
+### Glass UI (Web Dashboard)
 
-## Step 2: Key Directory Layout
+| File      | Path                                        | What It Contains                                     |
+| --------- | ------------------------------------------- | ---------------------------------------------------- |
+| HTML      | `SYMI_ROOT/dist/control-ui/index.html`      | Page structure, Agent Status Orb SVG, panels         |
+| CSS       | `SYMI_ROOT/dist/control-ui/css/style.css`   | ALL styling — themes, colors, orb animations, layout |
+| Main JS   | `SYMI_ROOT/dist/control-ui/js/app.js`       | State machine, streaming, event handling, watchdog   |
+| WebSocket | `SYMI_ROOT/dist/control-ui/js/gateway.js`   | WebSocket client, RPC, profile events                |
+| Rendering | `SYMI_ROOT/dist/control-ui/js/render.js`    | Message rendering, markdown, code blocks             |
+| Models    | `SYMI_ROOT/dist/control-ui/js/models.js`    | Model toggle (Local/CoreWeave/API)                   |
+| Heartbeat | `SYMI_ROOT/dist/control-ui/js/symipulse.js` | Heartbeat panel                                      |
+| History   | `SYMI_ROOT/dist/control-ui/js/history.js`   | Session history drawer                               |
+| Debug     | `SYMI_ROOT/dist/control-ui/js/debug.js`     | Debug panel (Shift+D)                                |
 
-Once you have `SYMI_ROOT`, these are your key directories:
+### Config and Data
+
+| What          | Exact Path                                   |
+| ------------- | -------------------------------------------- |
+| Config        | `~/.symi/symi.json`                          |
+| Workspace     | `~/.symi/workspace/`                         |
+| Sessions      | `~/.symi/agents/main/sessions/`              |
+| Session store | `~/.symi/agents/main/sessions/sessions.json` |
+| Memory DB     | `~/.symi/state/memory/`                      |
+| User skills   | `~/.symi/workspace/skills/`                  |
+| Package info  | `SYMI_ROOT/package.json`                     |
+
+## Step 3: How to Do Common Tasks
+
+### View any file
 
 ```
-SYMI_ROOT/
-├── package.json              # Version, dependencies
-├── dist/                     # Built JavaScript (production code)
-│   ├── control-ui/           # ** Glass UI — the web dashboard **
-│   │   ├── index.html        # HTML structure, Agent Status Orb
-│   │   ├── css/style.css     # ALL styling (themes, orb animations, layout)
-│   │   └── js/
-│   │       ├── app.js        # State machine, streaming, event handling
-│   │       ├── gateway.js    # WebSocket client, RPC
-│   │       ├── render.js     # Message rendering, markdown
-│   │       ├── models.js     # Model toggle
-│   │       ├── symipulse.js  # Heartbeat panel
-│   │       ├── history.js    # Session history drawer
-│   │       └── debug.js      # Debug panel (Shift+D)
-│   ├── index.js              # Main entry point
-│   └── entry.js              # CLI entry
-├── skills/                   # Bundled skills (including this one)
-└── docs/                     # Documentation
+Use: read tool with the exact path
+Do NOT use: exec cat, exec head, exec find, exec grep
 ```
 
-## Step 3: Common Tasks
-
-### Modify Glass UI Theme/Styles
+### Modify Glass UI Theme/Colors
 
-1. Find: `SYMI_ROOT/dist/control-ui/css/style.css`
-2. **Back up first**: `cp style.css style.css.bak`
-3. Edit the CSS file directly
-4. Refresh the browser — changes take effect immediately (no rebuild needed)
+1. **Read** the CSS: `read SYMI_ROOT/dist/control-ui/css/style.css`
+2. **Back up**: `exec cp SYMI_ROOT/dist/control-ui/css/style.css SYMI_ROOT/dist/control-ui/css/style.css.bak`
+3. **Edit** with the edit tool — use `edit` to replace specific color values
+4. Tell the user to refresh their browser
 
 ### Modify Glass UI Behavior
 
-1. Find: `SYMI_ROOT/dist/control-ui/js/app.js` (or other JS files)
-2. **Back up first**: `cp app.js app.js.bak`
-3. Edit the JavaScript file
-4. Refresh the browser
+1. **Read** the JS file you need (see table above)
+2. **Back up**: `exec cp <file> <file>.bak`
+3. **Edit** with the edit tool
+4. Tell the user to refresh their browser
 
-### Read Your Own Version
+### Read Your Version
 
-```bash
-node -e "console.log(JSON.parse(require('fs').readFileSync(require.resolve('@symerian/symi/package.json'), 'utf-8')).version)"
+```
+read SYMI_ROOT/package.json
 ```
 
-### Read Your Configuration
-
-Your config file is at `~/.symi/symi.json`. Read it to understand your current settings.
+Look for the `"version"` field.
 
-### Inspect Your Sessions
+### Read Your Configuration
 
-Session transcripts are at `~/.symi/agents/main/sessions/`. Each `.jsonl` file is one conversation.
+```
+read ~/.symi/symi.json
+```
 
-### Inspect Your Memory
+### Browse Session History
 
-Memory databases are at `~/.symi/state/memory/`. These are SQLite files.
+```
+read ~/.symi/agents/main/sessions/sessions.json
+```
 
 ## Important Rules
 
-- **Always back up before modifying** any file in `dist/`. Changes to built files are overwritten on upgrade.
-- **dist/ files are production builds** — they are minified/bundled. You can still read and edit them but they may be harder to navigate than source.
-- **Never modify node_modules/** — changes are lost on `npm install`.
-- **CSS changes are safe** — `style.css` is not minified and can be edited freely.
-- **JavaScript changes are riskier** — syntax errors will break the UI. Always back up.
-- If asked to make permanent changes that survive upgrades, the user should modify the source repository (`~/projects/symi/glass-ui/`) and rebuild instead.
-
-## Quick Reference: Config & Data Paths
-
-| What          | Path                                                |
-| ------------- | --------------------------------------------------- |
-| Config        | `~/.symi/symi.json`                                 |
-| Workspace     | `~/.symi/workspace/`                                |
-| Sessions      | `~/.symi/agents/main/sessions/`                     |
-| Memory        | `~/.symi/state/memory/`                             |
-| Skills (user) | `~/.symi/workspace/skills/`                         |
-| Gateway logs  | `journalctl --user -u symi-gateway.service` (Linux) |
-| Gateway logs  | `/tmp/symi/` (macOS)                                |
+- **ALWAYS use `read` to view files** — never exec cat/head/find/grep
+- **ALWAYS use `edit` to modify files** — never exec sed/awk
+- **Always back up before modifying** any file in `dist/`
+- Changes to `dist/` files are overwritten on upgrade (`npm install -g @symerian/symi`)
+- **CSS changes are safe** — `style.css` is not minified, easy to edit
+- **JavaScript changes are riskier** — syntax errors break the UI
+- For permanent changes that survive upgrades, the user should modify the source repo and rebuild

package/dist/plugin-sdk/web-Msnzya6B.js

@@ -1,65 +0,0 @@
-import { a as WA_WEB_AUTH_DIR, g as webAuthExists, s as logWebSelfId, u as pickWebChannel } from "./accounts-Ddm33hQm.js";
-import "./reply-pPqvSkWb.js";
-import "./paths-DR2yt_mP.js";
-import "./github-copilot-token-D9X2phUj.js";
-import "./plugins-BNByVCIH.js";
-import "./fetch-CUNoPTKm.js";
-import "./registry-D0xTnUWt.js";
-import "./retry-CwQ_iIj8.js";
-import "./send-CjOBB3Vo.js";
-import "./config-KlTNfkFF.js";
-import "./subsystem-B2uDN3TV.js";
-import "./command-format-GKSevep4.js";
-import "./model-selection-CsbEfrS0.js";
-import "./agent-scope-CYYpcO9W.js";
-import "./manifest-registry-CPnHl_K3.js";
-import "./redact-DPnDWsnT.js";
-import "./errors-Bv8oZiTO.js";
-import "./channel-activity-DoC1xtDu.js";
-import "./image-ops-BlQR__MN.js";
-import "./ssrf-DKZ8eBrk.js";
-import "./local-roots-BHLNSI8U.js";
-import "./ir-BJ6BHE5b.js";
-import "./chunk-Dw2XBYXv.js";
-import "./message-channel-COTAJzHd.js";
-import "./bindings-C7hRtgYW.js";
-import "./markdown-tables-BoYFajMu.js";
-import "./render-BiJZ5W4Z.js";
-import "./tables-DNwXwNFa.js";
-import "./send-C5h_YxNb.js";
-import "./tool-images-HJ2sfZDV.js";
-import "./target-errors-Paro1BjP.js";
-import "./send-B2CEnVLL.js";
-import "./send-CRsR8-vO.js";
-import "./runner-CGBT7tgF.js";
-import "./reply-prefix-uxfMZW4p.js";
-import "./tokens-bC3UVmVH.js";
-import "./skill-commands-ff_01_r3.js";
-import "./skills-_yTP47Cd.js";
-import "./chrome-B7RdxmJ0.js";
-import "./thinking-CXqf7WTe.js";
-import "./accounts-s-AdhXVR.js";
-import "./accounts-BtaOa4z_.js";
-import "./deliver-BZ99UKQq.js";
-import "./pi-embedded-helpers-CW630epe.js";
-import "./paths-A0xdf3yk.js";
-import "./diagnostic-05pm5Rxi.js";
-import "./store-BdrNabcU.js";
-import { n as monitorWebInbox, t as monitorWebChannel } from "./channel-web-E56yV1OA.js";
-import "./image-CLOPx7yW.js";
-import "./pi-model-discovery-LbcEa65a.js";
-import "./api-key-rotation-D_sMvI5W.js";
-import "./sqlite-CxAR5ttJ.js";
-import "./diagnostic-session-state-Wd5tNeQG.js";
-import "./manager-CBSBFuFz.js";
-import "./commands-registry-COIaslGl.js";
-import "./send-pYqe432l.js";
-import "./proxy-MquBDehr.js";
-import "./resolve-route-B3CCBumQ.js";
-import "./replies-LLcQL3w6.js";
-import "./outbound-attachment-CnslKL38.js";
-import { n as sendMessageWhatsApp } from "./outbound-B0e8KdaR.js";
-import { i as waitForWaConnection, t as createWaSocket } from "./session-BsOrxiMj.js";
-import { t as loginWeb } from "./login-DQMXuxOk.js";
-
-export { WA_WEB_AUTH_DIR, createWaSocket, logWebSelfId, loginWeb, monitorWebChannel, monitorWebInbox, pickWebChannel, sendMessageWhatsApp, waitForWaConnection, webAuthExists };