npm - clew-code - Versions diffs - 0.2.21 → 0.2.23 - Mend

clew-code 0.2.21 → 0.2.23

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.

Files changed (67) hide show

package/README.md +45 -45
package/dist/main.js +2906 -2722
package/docs/architecture.html +91 -148
package/docs/assets/clew-agent-loop.png +0 -0
package/docs/assets/clew-general-architecture.png +0 -0
package/docs/assets/clew-mcp-architecture.png +0 -0
package/docs/assets/clew-p2p-swarm.png +0 -0
package/docs/changelog.html +150 -0
package/docs/cli-reference.html +90 -0
package/docs/commands.html +133 -241
package/docs/configuration.html +85 -147
package/docs/contributing.html +91 -0
package/docs/css/styles.css +272 -152
package/docs/daemon.html +62 -129
package/docs/features/bridge-mode.html +61 -66
package/docs/features/evals.html +57 -149
package/docs/features/searxng-search.html +58 -118
package/docs/features/sentry-setup.html +61 -124
package/docs/index.html +185 -148
package/docs/installation.html +77 -105
package/docs/internals/growthbook-ab-testing.html +69 -91
package/docs/internals/hidden-features.html +81 -143
package/docs/js/main.js +29 -0
package/docs/loop.html +69 -181
package/docs/mcp.html +99 -247
package/docs/models.html +63 -92
package/docs/permission-model.html +86 -102
package/docs/plugins.html +84 -102
package/docs/providers.html +87 -127
package/docs/quick-start.html +81 -93
package/docs/research-memory.html +71 -102
package/docs/security.html +71 -0
package/docs/skills.html +67 -117
package/docs/swarm.html +78 -236
package/docs/tools.html +183 -171
package/docs/troubleshooting.html +86 -106
package/docs/voice-mode.html +79 -0
package/package.json +1 -1
package/docs/architecture.th.html +0 -79
package/docs/clew-code-architecture.html +0 -1126
package/docs/commands.th.html +0 -269
package/docs/configuration.th.html +0 -108
package/docs/daemon.th.html +0 -73
package/docs/features/bridge-mode.th.html +0 -62
package/docs/features/evals.th.html +0 -62
package/docs/features/searxng-search.th.html +0 -67
package/docs/features/sentry-setup.th.html +0 -69
package/docs/features/swarm.html +0 -156
package/docs/generated/providers.html +0 -625
package/docs/generated/tools.html +0 -558
package/docs/index.th.html +0 -292
package/docs/installation.th.html +0 -105
package/docs/internals/growthbook-ab-testing.th.html +0 -60
package/docs/internals/hidden-features.th.html +0 -107
package/docs/loop.th.html +0 -227
package/docs/mcp.th.html +0 -207
package/docs/models.th.html +0 -61
package/docs/permission-model.th.html +0 -67
package/docs/plugins.th.html +0 -79
package/docs/prompts-and-features.html +0 -806
package/docs/providers.th.html +0 -81
package/docs/quick-start.th.html +0 -89
package/docs/research-memory.th.html +0 -72
package/docs/skills.th.html +0 -90
package/docs/swarm.th.html +0 -280
package/docs/tools.th.html +0 -84
package/docs/troubleshooting.th.html +0 -85

package/docs/swarm.th.html DELETED Viewed

@@ -1,280 +0,0 @@
-<!DOCTYPE html>
-<html lang="th">
-<head>
-  <meta charset="UTF-8">
-  <meta name="viewport" content="width=device-width, initial-scale=1.0">
-  <title>ระบบ Peer — Clew</title>
-  <meta name="description" content="ระบบ peer-to-peer บน LAN — ค้นหา, ส่งข้อความ, มอบหมายงาน, และรันคำสั่งระยะไกลระหว่าง Clew instances">
-  <link rel="preconnect" href="https://fonts.googleapis.com">
-  <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
-  <link href="https://fonts.googleapis.com/css2?family=DM+Sans:wght@400;500;600;700&family=JetBrains+Mono:wght@400;500;600;700&family=Noto+Sans+Thai:wght@400;500;600;700&display=swap" rel="stylesheet">
-  <link rel="stylesheet" href="css/styles.css">
-  <link rel="icon" type="image/svg+xml" href="./assets/clew.svg">
-</head>
-<body>
-<header class="header"></header>
-<div class="app">
-  <aside class="sidebar" id="sidebar"></aside>
-  <div class="sidebar-overlay" id="sidebarOverlay"></div>
-  <div class="content-wrap">
-    <main class="content">
-      <div class="breadcrumbs"><a href="index.th.html">หน้าแรก</a><span class="sep">/</span><span>ระบบ Peer</span></div>
-      <h1>ระบบ Peer</h1>
-      <p class="section-subtitle">Peer-to-peer บน LAN — ค้นหา Clew instances อื่น, ส่งข้อความ, มอบหมายงาน, และรันคำสั่งระยะไกล</p>
-      <p>ระบบ peer อยู่ใน <code>src/peer/</code> และประกอบด้วย 3 ชั้นหลัก: <strong>PeerServer</strong> (HTTP server), <strong>PeerDiscovery</strong> (สแกน LAN), และ <strong>PeerStore</strong> (registry ในหน่วยความจำ)</p>
-      <h2>สถาปัตยกรรม</h2>
-      <pre><code> ┌─────────────────────────────────────────────────────────────────────────────┐
- │                          SWARM SYSTEM FLOW                                   │
- └─────────────────────────────────────────────────────────────────────────────┘
-                          ┌──────────────────────────┐
-                          │      /swarm share          │
-                          │  (Machine A — Worker)     │
-                          └────────────┬─────────────┘
-                                       │
-                     ┌─────────────────┼─────────────────┐
-                     ▼                  ▼                  ▼
-            ┌──────────────┐  ┌──────────────┐  ┌──────────────┐
-            │ PeerServer   │  │PeerDiscovery │  │  PeerStore   │
-            │ HTTP :random  │  │              │  │  (in-memory) │
-            │  port         │  │              │  │              │
-            └──────┬───────┘  └──────┬───────┘  └──────────────┘
-                   │                 │
-                   │    ┌────────────┼────────────┐
-                   │    │            │            │
-                   │    ▼            ▼            ▼
-                   │ ┌────────┐ ┌────────┐ ┌─────────────┐
-                   │ │  File  │ │  UDP   │ │  PeerStore   │
-                   │ │ ~/.cl/ │ │multicast│ │ (singleton) │
-                   │ │ peers/ │ │239...  │ │             │
-                   │ │{pid}.  │ │:42069  │ │             │
-                   │ │ json   │ │        │ │             │
-                   │ └────┬───┘ └────┬───┘ └─────────────┘
-                   │      │          │
-                   │      │          │  heartbeat ทุก 30s
-                   │      │          │  stale timeout 90s
-                   │      │          │
-                   ▼      ▼          ▼
- ┌─────────────────────────────────────────────────────┐
- │                   LAN NETWORK                        │
- │                                                     │
- │   ┌─────────┐         ┌─────────┐                   │
- │   │ Machine B│◄───────►│ Machine C│  ...             │
- │   │ Clew Code│  query  │ Clew Code│                   │
- │   └────┬─────┘         └────┬─────┘                   │
- │        │                    │                         │
- └────────┼────────────────────┼─────────────────────────┘
-          │                    │
-          │  /swarm discover    │  /swarm discover
-          ▼                    ▼
- ═══ WORKER (Machine A) ENDPOINTS ═══
-      Peer อื่น          POST /peer-info     ──►  { hostname, ip, cwd, shell, ... }
-         │                POST /peer-msg      ──►  รับข้อความ chat
-         ├───────────────► POST /peer-todo     ──►  รับ task (ไปอยู่ใน inbox)
-         │                POST /peer-exec     ──►  รัน shell command + คืน stdout/stderr
- ═══ CLIENT (Machine B) SWARM TOOLS ═══
-      /swarm discover  ──►  scan files + UDP query (3s timeout)
-                               │
-                               ▼
-                          [peer list]
-                               │
-           ┌───────────────────┼───────────────────┐
-           ▼                   ▼                   ▼
-    /swarm join          /swarm send_task      /swarm run
-    (POST /peer-info)   (POST /peer-todo)    (POST /peer-exec)
-           │
-           ▼
-    /swarm send_message   ──►  POST /peer-msg  ──►  inbox ปลายทาง
-    /swarm broadcast      ──►  POST /peer-msg  ──►  ทุก peer ที่เชื่อมต่อ
-    /swarm ping           ──►  GET  /peer-info  ──►  เช็ค alive
- ═══ DAEMON (agentLoop.ts) ═══
-      ┌───────────────────────────────────┐
-      │  Autonomous Agent Loop            │
-      │  - ฟัง /peer-todo ตลอด 24/7      │
-      │  - รับ task จาก remote swarm nodes     │
-      │  - execute ใน background worker   │
-      │  - สูงสุด 3 workers พร้อมกัน      │
-      └───────────────────────────────────┘
- ═══ DATA LIFECYCLE ═══
-      advertise ──► heartbeat ทุก 30s
-                        │
-                        ├── 90s ไม่มี heartbeat ──► stale → evict
-                        │
-      stop share ──► send UDP "offline"
-                     delete peer file
-                     close HTTP server</code></pre>
-      <h2>เทคนิคและหลักการ</h2>
-      <h3>Discovery แบบสองชั้น (Two-Layer Discovery)</h3>
-      <p>ทำไมไม่ใช้แค่ UDP multicast หรือแค่ file-based อย่างเดียว?</p>
-      <ul>
-        <li><strong>File-based</strong> — ทำงานบนเครื่องเดียวกันได้ทันที โดยไม่ต้องใช้ network เลย แค่อ่าน/เขียนไฟล์ JSON ใน <code>~/.clew/peers/</code> ซึ่งเร็วกว่าและไม่ต้องกังวลเรื่อง firewall</li>
-        <li><strong>UDP Multicast</strong> — ข้ามเครื่องได้ผ่าน LAN ใช้ multicast group <code>239.255.37.37:42069</code> ไม่ต้องรู้ IP ปลายทางล่วงหน้า</li>
-        <li><strong>ทำไมต้องทั้งสอง?</strong> — แต่ละวิธีมีข้อจำกัด: file-based ข้ามเครื่องไม่ได้, UDP multicast อาจถูกบล็อคด้วย network policy การใช้ทั้งสองวิธีทำให้ discovery ทำงานได้ในทุกสภาพแวดล้อม โดยไม่ต้องให้ผู้ใช้ configure อะไรเลย</li>
-      </ul>
-      <h3>Lease-based Task Claiming</h3>
-      <p>เมื่อมีหลาย worker (หรือหลาย daemon process) วิ่งพร้อมกัน จะป้องกันไม่ให้ task ถูกทำซ้ำได้อย่างไร?</p>
-      <ul>
-        <li><strong>Atomic lease</strong> — ก่อนเริ่ม task, worker ต้องขอ lease ด้วย <code>leaseTask(id, agentId)</code> ซึ่งเช็คว่า task ยังไม่มีใครจอง และเขียน lease owner + expiry timestamp ลงไฟล์แบบ atomic (read-modify-write ภายใต้ lock)</li>
-        <li><strong>Lease expiry</strong> — ถ้า worker crash หรือ disconnect, lease จะหมดอายุเอง (default 30 นาที) ทำให้ worker อื่นมารับงานต่อได้ — <em>crash recovery โดยไม่ต้องมี distributed coordinator</em></li>
-        <li><strong>Stale lease cleanup</strong> — ตอน startLoop จะรอ 2 วินาที แล้วเรียก <code>expireLeases()</code> เพื่อ clear lease เก่าจาก session ก่อนหน้า</li>
-        <li><strong>ทำไมไม่ใช้ lock file?</strong> — lock file แบบ OS-level (flock) ใช้ข้าม process บนเครื่องเดียวกันได้ แต่ใช้ข้ามเครื่องไม่ได้ Lease บนไฟล์ JSON แก้ปัญหานี้ได้โดยไม่ต้องพึ่ง external service อย่าง Redis/ZooKeeper</li>
-      </ul>
-      <h3>Heartbeat + Stale Eviction</h3>
-      <p>Peer discovery ต้องรู้ว่าใครยัง alive อยู่ โดยไม่ต้อง polling:</p>
-      <ul>
-        <li><strong>Push-based heartbeat</strong> — แต่ละ peer ส่ง beacon ทุก 30 วินาที ผ่านทั้ง file (เขียน timestamp ใหม่) และ UDP multicast</li>
-        <li><strong>Pull-based eviction</strong> — consumer เช็คอายุของ peer entry ถ้าเกิน 90 วินาที (<code>PEER_STALE_TIMEOUT</code>) ถือว่า stale → evict</li>
-        <li><strong>3× heartbeat interval</strong> — timeout = 3 × heartbeat interval เป็นค่า default ในระบบ distributed systems (ให้โอกาส retry ก่อน宣布ตาย)</li>
-        <li><strong>Graceful shutdown</strong> — ตอน <code>/swarm stop</code> จะส่ง UDP "offline" message + ลบไฟล์ peer ทันที ไม่ต้องรอ timeout</li>
-      </ul>
-      <h3>Random Port Binding</h3>
-      <p>PeerServer bind ที่ port 0 (OS เลือก port ว่างให้):</p>
-      <ul>
-        <li><strong>No port conflicts</strong> — ถ้าใช้ fixed port แล้วมีหลาย instance จะชนกัน</li>
-        <li><strong>Security through obscurity</strong> — port สุ่มทำให้ attacker สแกนหายากกว่า fixed port (แต่ไม่ใช่ security หลัก — security จริงอยู่ที่ authentication layer)</li>
-        <li><strong>Discovery solves discovery</strong> — ไม่ต้องรู้ port ล่วงหน้า เพราะ discovery protocol จะบอก port ให้เอง</li>
-      </ul>
-      <h3>Message Broadcasting</h3>
-      <p><code>peer_broadcast</code> ส่ง task ไปทุก peer ที่เชื่อมต่อพร้อมกัน:</p>
-      <ul>
-        <li>ไม่ใช่ UDP broadcast — ใช้ HTTP POST sequential ไปทีละ peer (fire-and-forget)</li>
-        <li>รองรับ parallel สูงสุด 8 peers ต่อ 1 batch</li>
-        <li>เหมาะสำหรับ: deploy to all machines, run tests everywhere, health check ทุก node</li>
-      </ul>
-      <h2>องค์ประกอบหลัก</h2>
-      <h3>PeerServer <code>src/peer/PeerServer.ts</code></h3>
-      <p>HTTP server ขนาดเล็กที่เริ่มบน port สุ่ม (OS เลือกให้) เมื่อรัน <code>/swarm share</code> แต่ละ endpoint รองรับการโต้ตอบแบบต่างๆ:</p>
-      <table>
-        <tr><th>Endpoint</th><th>Method</th><th>หน้าที่</th></tr>
-        <tr><td><code>/peer-info</code></td><td>GET</td><td>ส่งข้อมูล peer (hostname, IP, cwd, shell, platform)</td></tr>
-        <tr><td><code>/peer-msg</code></td><td>POST</td><td>รับข้อความ chat จาก peer อื่น</td></tr>
-        <tr><td><code>/peer-todo</code></td><td>POST</td><td>รับ task ที่ถูกมอบหมายจาก peer อื่น</td></tr>
-        <tr><td><code>/peer-exec</code></td><td>POST</td><td>รันคำสั่ง shell และส่งคืน stdout/stderr</td></tr>
-      </table>
-      <h3>PeerDiscovery <code>src/peer/PeerDiscovery.ts</code></h3>
-      <p>กลไกค้นหา 2 วิธีทำงานร่วมกัน:</p>
-      <ul>
-        <li><strong>File-based</strong> — แต่ละ instance เขียนไฟล์ <code>~/.clew/peers/{pid}.json</code> เก็บข้อมูล hostname, IP, port, shell, cwd instances อื่นอ่านไฟล์เพื่อค้นหา peer ในเครื่องเดียวกัน</li>
-        <li><strong>UDP Multicast</strong> — ส่ง heartbeat beacon ไปที่ <code>239.255.37.37:42069</code> ทุก 30 วินาที ตอบกลับ <code>clew-peer-query</code> ด้วย <code>clew-peer-info</code> ใช้ข้ามเครื่อง</li>
-        <li><strong>Stale eviction</strong> — Peer ที่ไม่เห็น 90 วินาที (<code>PEER_STALE_TIMEOUT</code>) จะถูกลบอัตโนมัติ</li>
-      </ul>
-      <h3>PeerStore <code>src/peer/PeerStore.ts</code></h3>
-      <p>Singleton registry ในหน่วยความจำที่เก็บ peer ทั้งหมดที่รู้จัก (ทั้งที่ค้นพบและที่ join เอง), ข้อความ chat, todos, และ custom tags (ชื่อที่กำหนดเอง, บทบาท)</p>
-      <ul>
-        <li><strong>Discovered peers</strong> — ถูกลบอัตโนมัติเมื่อ stale</li>
-        <li><strong>Joined connections</strong> — คงอยู่ถาวร ไม่ถูกลบอัตโนมัติ</li>
-        <li><strong>Tags</strong> — ชื่อที่กำหนดเองและบทบาทต่อ peer</li>
-      </ul>
-      <h2>Discovery Protocol</h2>
-      <pre><code>DiscoveryMessage =
-  | { type: "clew-peer-query",  version: 1 }                    // broadcast scan
-  | { type: "clew-peer-info",   version: 1,                     // heartbeat / response
-      id: string, hostname: string, ip: string, port: number,
-      cwd: string, sessionId?: string, appVersion: string,
-      shell?: string, platform?: string, term?: string,
-      status: "online" | "offline" }
-UDP port:     42069
-Multicast IP: 239.255.37.37
-Heartbeat:    ทุก 30 วินาที
-Stale after:  90 วินาที</code></pre>
-      <h2>คำสั่ง</h2>
-      <table>
-        <tr><th>คำสั่ง</th><th>คำอธิบาย</th></tr>
-        <tr><td><code>/swarm</code></td><td>เปิดเมนู interactive (share, join, discover, inbox)</td></tr>
-        <tr><td><code>/swarm share</code></td><td>เริ่มประกาศ instance นี้เป็น worker บน LAN</td></tr>
-        <tr><td><code>/swarm stop</code></td><td>หยุดประกาศและปิด swarm server</td></tr>
-        <tr><td><code>/swarm discover</code></td><td>สแกนหา peers (file + UDP, timeout 3s)</td></tr>
-        <tr><td><code>/swarm join &lt;host&gt; &lt;port&gt;</code></td><td>เชื่อมต่อกับ remote swarm node ด้วย host และ port</td></tr>
-        <tr><td><code>/swarm name &lt;ชื่อ&gt;</code></td><td>กำหนดชื่อที่แสดงสำหรับตัวเอง</td></tr>
-        <tr><td><code>/swarm role &lt;บทบาท&gt;</code></td><td>กำหนดบทบาท (builder, tester, deployer, ฯลฯ)</td></tr>
-        <tr><td><code>/swarm inbox</code></td><td>ดูข้อความและ todos ที่รออยู่จาก peers</td></tr>
-        <tr><td><code>/swarm disconnect &lt;peer&gt;</code></td><td>ตัดการเชื่อมต่อจาก peer ที่ระบุ</td></tr>
-        <tr><td><code>/swarm todos</code></td><td>แสดงรายการ task ทั้งหมดที่ได้รับ</td></tr>
-        <tr><td><code>/swarm todo done &lt;id&gt;</code></td><td>ทำเครื่องหมาย task ว่าเสร็จแล้ว</td></tr>
-      </table>
-      <h2>AI Tools</h2>
-      <p>เครื่องมือที่ AI agent ใช้เพื่อโต้ตอบกับระบบ peer:</p>
-      <table>
-        <tr><th>Tool</th><th>คำอธิบาย</th></tr>
-        <tr><td><code>peer_discover</code></td><td>สแกน LAN หา Clew workers</td></tr>
-        <tr><td><code>peer_join</code></td><td>เชื่อมต่อกับ remote swarm node ผ่าน HTTP</td></tr>
-        <tr><td><code>peer_ping</code></td><td>ตรวจสอบว่า peer ออนไลน์อยู่หรือไม่ (GET /peer-info)</td></tr>
-        <tr><td><code>peer_info</code></td><td>ดึงข้อมูล peer อย่างละเอียด</td></tr>
-        <tr><td><code>peer_send_message</code></td><td>ส่งข้อความ chat ไปที่ peer</td></tr>
-        <tr><td><code>peer_send_task</code></td><td>มอบหมาย task ให้ remote worker</td></tr>
-        <tr><td><code>peer_broadcast</code></td><td>ส่ง task ไปทุก peer ที่เชื่อมต่อพร้อมกัน</td></tr>
-        <tr><td><code>peer_run</code></td><td>รันคำสั่ง shell บน remote worker</td></tr>
-        <tr><td><code>peer_disconnect</code></td><td>ลบ peer ออกจากรายการเชื่อมต่อ</td></tr>
-        <tr><td><code>peer_list_messages</code></td><td>แสดงข้อความ chat ทั้งหมดที่ได้รับ</td></tr>
-        <tr><td><code>peer_list_roles</code></td><td>แสดงรายการ peers พร้อมบทบาท</td></tr>
-        <tr><td><code>peer_list_tasks</code></td><td>แสดง task ทั้งหมดและสถานะ</td></tr>
-        <tr><td><code>peer_set_name</code></td><td>กำหนดชื่อที่แสดงให้ peer</td></tr>
-        <tr><td><code>peer_set_role</code></td><td>กำหนดบทบาทให้ peer</td></tr>
-        <tr><td><code>peer_share</code></td><td>เปิด/ปิด/เช็คสถานะการแชร์</td></tr>
-      </table>
-      <h2>การเชื่อมต่อกับ DAEMON</h2>
-      <p>Autonomous agent loop (<code>src/services/autonomous/agentLoop.ts</code>) เชื่อมต่อกับ PeerServer เพื่อรับ task จาก remote swarm nodes:</p>
-      <ul>
-        <li>ฟัง <code>/peer-todo</code> POST ตลอด 24/7</li>
-        <li>จัดคิว task ที่ได้รับและประมวลผลใน background workers</li>
-        <li>สูงสุด 3 workers พร้อมกัน; task timeout หลัง 30 นาที</li>
-        <li>ดูผลลัพธ์ผ่าน <code>/swarm todos</code> และ <code>/tasks</code></li>
-      </ul>
-      <h2>ไฟล์ในระบบ</h2>
-      <table>
-        <tr><th>ไฟล์</th><th>หน้าที่</th></tr>
-        <tr><td><code>src/peer/PeerServer.ts</code></td><td>HTTP server พร้อม endpoint /peer-info, /peer-msg, /peer-todo, /peer-exec</td></tr>
-        <tr><td><code>src/peer/PeerDiscovery.ts</code></td><td>ค้นหา peer ผ่านไฟล์ + UDP multicast บน LAN</td></tr>
-        <tr><td><code>src/peer/PeerStore.ts</code></td><td>Singleton registry ใน memory (peers, messages, todos, tags)</td></tr>
-        <tr><td><code>src/peer/types.ts</code></td><td>Shared types และค่าคงที่ของ protocol</td></tr>
-        <tr><td><code>src/commands/swarm/</code></td><td>Interactive peer menu และ CLI commands</td></tr>
-        <tr><td><code>src/tools/Peer*Tool/</code></td><td>16 AI agent tools สำหรับ swarm operations</td></tr>
-        <tr><td><code>src/services/autonomous/agentLoop.ts</code></td><td>Daemon integration: รับ remote tasks ผ่าน PeerServer</td></tr>
-      </table>
-      <footer class="footer">
-        <span>Clew Code 0.2.14 — Open Source</span>
-        <div class="footer-links">
-          <a href="https://github.com/ClewCode/ClewCode">GitHub</a>
-          <a href="https://github.com/ClewCode/ClewCode/issues">Issues</a>
-        </div>
-      </footer>
-    </main>
-    <nav class="toc-sidebar"></nav>
-  </div>
-</div>
-<script src="js/main.js"></script>
-</body>
-</html>

package/docs/tools.th.html DELETED Viewed

@@ -1,84 +0,0 @@
-<!DOCTYPE html>
-<html lang="th">
-<head>
-  <meta charset="UTF-8">
-  <meta name="viewport" content="width=device-width, initial-scale=1.0">
-  <title>เครื่องมือ — Clew</title>
-  <meta name="description" content="ข้อมูลอ้างอิงเครื่องมือในตัวของ Clew — การดำเนินการไฟล์, เชลล์, ค้นหา, เอเจนต์, MCP, และระบบอัตโนมัติ">
-  <link rel="preconnect" href="https://fonts.googleapis.com">
-  <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
-  <link href="https://fonts.googleapis.com/css2?family=DM+Sans:wght@400;500;600;700&family=JetBrains+Mono:wght@400;500;600;700&family=Noto+Sans+Thai:wght@400;500;600;700&display=swap" rel="stylesheet">
-  <link rel="stylesheet" href="css/styles.css">
-  <link rel="icon" type="image/svg+xml" href="./assets/clew.svg">
-</head>
-<body>
-<header class="header"></header>
-<div class="app"><aside class="sidebar" id="sidebar"></aside><div class="sidebar-overlay" id="sidebarOverlay"></div>
-<div class="content-wrap"><main class="content">
-  <div class="breadcrumbs"><a href="index.th.html">หน้าแรก</a><span class="sep">/</span><span>เครื่องมือ</span></div>
-  <h1>เครื่องมือ</h1>
-  <p class="section-subtitle">Clew มีเครื่องมือในตัว 50+ รายการ พร้อมเครื่องมือ MCP ที่โหลดแบบไดนามิก เครื่องมือถูกเรียกโดยโมเดล AI ผ่านบล็อก <code>tool_use</code></p>
-  <h2>วิธีการทำงานของเครื่องมือ</h2>
-  <p>เครื่องมือถูกกำหนดด้วย Zod schemas ใน <code>src/Tool.ts</code> ผ่านตัวช่วย <code>buildTool()</code> และลงทะเบียนใน <code>src/tools.ts</code></p>
-  <pre><code>โมเดลส่ง tool_use
-  ปรับมาตรฐานการเรียกใช้เครื่องมือ (toolCallParser.ts)
-  ตรวจสอบสิทธิ์ (permissions.ts)
-  ฮุค PreToolUse (ปลั๊กอิน)
-  ดำเนินการเครื่องมือ (StreamingToolExecutor)
-  ฮุค PostToolUse (ปลั๊กอิน)
-  ส่งคืนผลลัพธ์เป็น tool_result
-  วนซ้ำคำถามต่อไป</code></pre>
-  <h2>การดำเนินการไฟล์และโค้ด</h2>
-  <table>
-    <tr><th>เครื่องมือ</th><th>คำอธิบาย</th></tr>
-    <tr><td><code>Read</code></td><td>อ่านไฟล์พร้อมหมายเลขบรรทัด, รองรับรูปภาพ, PDF, Jupyter notebooks</td></tr>
-    <tr><td><code>Write</code></td><td>สร้างไฟล์ใหม่พร้อมเนื้อหาเต็ม</td></tr>
-    <tr><td><code>Edit</code></td><td>แก้ไขแบบแทนที่สตริงที่แน่นอน</td></tr>
-    <tr><td><code>Glob</code></td><td>ค้นหาไฟล์ด้วย pattern, เรียงตามเวลาแก้ไข</td></tr>
-    <tr><td><code>Grep</code></td><td>ค้นหาเนื้อหาด้วย regex พร้อมบรรทัดบริบท</td></tr>
-    <tr><td><code>NotebookEdit</code></td><td>แก้ไขเซลล์ Jupyter notebook</td></tr>
-  </table>
-  <h2>เชลล์และระบบ</h2>
-  <table>
-    <tr><th>เครื่องมือ</th><th>คำอธิบาย</th></tr>
-    <tr><td><code>Bash</code></td><td>รันคำสั่ง shell พร้อม timeout, background, sandbox</td></tr>
-    <tr><td><code>Monitor</code></td><td>สตรีม stdout/stderr จากงานพื้นหลังแบบเรียลไทม์</td></tr>
-    <tr><td><code>TaskOutput</code></td><td>รับผลลัพธ์จากงานที่กำลังรันหรือเสร็จแล้ว</td></tr>
-  </table>
-  <h2>ค้นหาและเว็บ</h2>
-  <table>
-    <tr><th>เครื่องมือ</th><th>คำอธิบาย</th></tr>
-    <tr><td><code>WebSearch</code></td><td>ค้นหาเว็บหลายผู้ให้บริการ (Tavily, Brave, Serper, SearXNG, DuckDuckGo)</td></tr>
-    <tr><td><code>WebFetch</code></td><td>ดึงและวิเคราะห์เนื้อหาจาก URL</td></tr>
-    <tr><td><code>SessionSearch</code></td><td>ค้นหาข้อความเต็มในประวัติเซสชันที่ผ่านมา</td></tr>
-  </table>
-  <h2>ความปลอดภัยและสิทธิ์ของเครื่องมือ</h2>
-  <p>แต่ละเครื่องมือประกาศ:</p>
-  <ul>
-    <li><strong>isEnabled()</strong> — พร้อมใช้งานใน build ปัจจุบันหรือไม่</li>
-    <li><strong>isConcurrencySafe()</strong> — รันพร้อมกับเครื่องมืออื่นได้หรือไม่</li>
-    <li><strong>isReadOnly()</strong> — ไม่แก้ไขระบบไฟล์</li>
-    <li><strong>isDestructive()</strong> — ดำเนินการที่ไม่สามารถย้อนกลับ</li>
-  </ul>
-  <footer class="footer">
-    <span>Clew Code 0.2.14 — โอเพนซอร์ส</span>
-    <div class="footer-links">
-      <a href="https://github.com/ClewCode/ClewCode">GitHub</a>
-      <a href="https://github.com/ClewCode/ClewCode/issues">ปัญหา</a>
-    </div>
-  </footer>
-</main>
-<nav class="toc-sidebar"></nav>
-</div>
-</div>
-<script src="js/main.js"></script>
-</body>
-</html>

package/docs/troubleshooting.th.html DELETED Viewed

@@ -1,85 +0,0 @@
-<!DOCTYPE html>
-<html lang="th">
-<head>
-  <meta charset="UTF-8">
-  <meta name="viewport" content="width=device-width, initial-scale=1.0">
-  <title>การแก้ปัญหา — Clew</title>
-  <meta name="description" content="ปัญหาทั่วไปและวิธีแก้ไขสำหรับ Clew — คีย์ผู้ให้บริการ, ข้อผิดพลาด build, MCP, ปลั๊กอิน, และปัญหารันไทม์">
-  <link rel="preconnect" href="https://fonts.googleapis.com">
-  <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
-  <link href="https://fonts.googleapis.com/css2?family=DM+Sans:wght@400;500;600;700&family=JetBrains+Mono:wght@400;500;600;700&family=Noto+Sans+Thai:wght@400;500;600;700&display=swap" rel="stylesheet">
-  <link rel="stylesheet" href="css/styles.css">
-  <link rel="icon" type="image/svg+xml" href="./assets/clew.svg">
-</head>
-<body>
-<header class="header"></header>
-<div class="app"><aside class="sidebar" id="sidebar"></aside><div class="sidebar-overlay" id="sidebarOverlay"></div>
-<div class="content-wrap"><main class="content">
-  <div class="breadcrumbs"><a href="index.th.html">หน้าแรก</a><span class="sep">/</span><span>การแก้ปัญหา</span></div>
-  <h1>การแก้ปัญหา</h1>
-  <p class="section-subtitle">เริ่มต้นด้วย <code>/doctor</code> — มันตรวจสอบเวอร์ชันรันไทม์, ข้อมูลประจำตัวผู้ให้บริการ, ความสมบูรณ์ของการตั้งค่า, สถานะปลั๊กอิน/MCP, และ Sentry telemetry</p>
-  <h2>ปัญหาเริ่มต้น</h2>
-  <h3>"command not found: clew"</h3>
-  <p>พาธติดตั้ง global npm อาจไม่อยู่ใน <code>PATH</code> ใช้ <code>npx clew-code</code> หรือ <code>bun x clew-code</code> เป็นทางเลือก</p>
-  <h3>"Bun not found"</h3>
-  <p>Clew ต้องใช้ <a href="https://bun.sh">Bun 1.3+</a> เป็นรันไทม์สำหรับแพ็กเกจ npm</p>
-  <h2>ปัญหาผู้ให้บริการ</h2>
-  <h3>"No API key configured"</h3>
-  <p>ตั้งค่าคีย์ API อย่างน้อยหนึ่งรายการเป็นตัวแปรสภาพแวดล้อม ดู <a href="providers.th.html">ผู้ให้บริการ</a> สำหรับรายการทั้งหมด</p>
-  <pre><code>export ANTHROPIC_API_KEY=sk-ant-...
-export DEEPSEEK_API_KEY=sk-...</code></pre>
-  <p>รัน <code>/doctor</code> เพื่อตรวจสอบผู้ให้บริการที่ตั้งค่า</p>
-  <h3>"Rate limited" หรือ "Quota exceeded"</h3>
-  <p>ตั้งค่าโมเดลสำรองผ่าน CLI: <code>--fallback-model &lt;model&gt;</code> หรือใช้ <code>/model</code> เพื่อสลับไปยังผู้ให้บริการอื่น</p>
-  <h2>ปัญหา Build</h2>
-  <h3>ข้อผิดพลาด TypeScript ระหว่าง build</h3>
-  <pre><code>bun run build
-# ข้อผิดพลาด TypeScript อาจอยู่ในโค้ดที่ยังไม่ได้ commit หรือโมดูลภายนอก
-# รันการตรวจสอบเป้าหมาย:
-bun x tsc --noEmit
-bun test <targeted-path></code></pre>
-  <h3>ปัญหาเฉพาะ Windows</h3>
-  <ul>
-    <li>ripgrep แถมมาที่ <code>src/utils/vendor/ripgrep/x64-win32/rg.exe</code></li>
-    <li>TTY polyfill อาจจำเป็นสำหรับ Ink compatibility</li>
-    <li>PowerShell และ Bash อาจทำงานแตกต่างสำหรับการเรียกใช้เครื่องมือ</li>
-  </ul>
-  <h2>ปัญหา MCP</h2>
-  <h3>"MCP server connection failed"</h3>
-  <p>ตรวจสอบว่าคำสั่งเซิร์ฟเวอร์มีอยู่และพาธถูกต้อง ตรวจสอบไวยากรณ์ JSON config ด้วยคำสั่ง <code>/mcp</code></p>
-  <h2>ปัญหาปลั๊กอิน</h2>
-  <h3>ปลั๊กอินไม่โหลด</h3>
-  <p>ตรวจสอบรูปแบบและตำแหน่ง manifest ของปลั๊กอิน ใช้ <code>/plugin</code> และ <code>/reload-plugins</code> เพื่อรีเฟรช</p>
-  <h2>การขอความช่วยเหลือ</h2>
-  <ul>
-    <li><strong>การตรวจสอบในแอป:</strong> <code>/doctor</code> — ตรวจสอบสภาพแวดล้อมอย่างครอบคลุม</li>
-    <li><strong>ภาพรวมสถานะ:</strong> <code>/status</code> — เวอร์ชัน, โมเดล, การเชื่อมต่อ API</li>
-    <li><strong>GitHub Issues:</strong> รายงานบั๊กและขอฟีเจอร์</li>
-    <li><strong>โหมด Debug:</strong> รันด้วย <code>DEBUG=1</code> หรือ <code>DEBUG=provider:anthropic</code></li>
-  </ul>
-  <footer class="footer">
-    <span>Clew Code 0.2.14 — โอเพนซอร์ส</span>
-    <div class="footer-links">
-      <a href="https://github.com/ClewCode/ClewCode">GitHub</a>
-      <a href="https://github.com/ClewCode/ClewCode/issues">ปัญหา</a>
-      <a href="https://npmjs.com/package/clew-code">npm</a>
-    </div>
-  </footer>
-</main>
-<nav class="toc-sidebar"></nav>
-</div>
-</div>
-<script src="js/main.js"></script>
-</body>
-</html>