npm - clew-code - Versions diffs - 0.2.20 → 0.2.22 - Mend

clew-code 0.2.20 → 0.2.22

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 (66) hide show

package/dist/main.js +1888 -1883
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 +156 -265
package/docs/configuration.html +85 -147
package/docs/contributing.html +91 -0
package/docs/css/styles.css +425 -425
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 +137 -125
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 +69 -110
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 +152 -151
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/loop.th.html DELETED Viewed

@@ -1,227 +0,0 @@
-<!DOCTYPE html>
-<html lang="th">
-<head>
-  <meta charset="UTF-8">
-  <meta name="viewport" content="width=device-width, initial-scale=1.0">
-  <title>Agent Loop — Clew Code</title>
-  <meta name="description" content="Autonomous agent loop — task queue consumer, worker lifecycle, retry logic, dead-letter queue, lease-based concurrency">
-  <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>Agent Loop</span></div>
-      <h1>Autonomous Agent Loop</h1>
-      <p class="section-subtitle">Loop ที่รันอัตโนมัติ 24/7 — ดึงงานจากคิว, spawn worker, เช็คสถานะ, retry เมื่อ fail, dead-letter เมื่อเกิน max retry</p>
-      <p>Agent Loop อยู่ใน <code>src/services/autonomous/agentLoop.ts</code> — เป็น consumer ตัวเดียวที่อ่าน task queue และบริหาร lifecycle ของ worker process ทั้งหมด</p>
-      <h2>เทคนิคและหลักการ</h2>
-      <h3>ทำไมต้องเป็น Loop แทนที่จะเป็น Message Queue?</h3>
-      <p>ระบบ message queue แบบ RabbitMQ/Kafka มี overhead ในการ setup และ maintenance Agent Loop ใช้<strong>ไฟล์ JSON เป็น persistent queue</strong> — ทำงานได้โดยไม่ต้องมี external dependency:</p>
-      <ul>
-        <li><strong>Zero external deps</strong> — ใช้ <code>fs.watch</code> ตรวจจับการเปลี่ยนแปลงของไฟล์ queue</li>
-        <li><strong>File-based atomicity</strong> — อ่าน/เขียนไฟล์เดียวภายใต้ lock ทำให้หลาย process แข่งกัน consume ได้</li>
-        <li><strong>Self-debouncing</strong> — <code>ourWriteInProgress</code> flag ป้องกัน self-trigger เมื่อเราเป็นคนเขียนเอง</li>
-        <li><strong>Cross-platform</strong> — ไฟล์ JSON ทำงานได้ทุก OS ไม่ต้องติดตั้ง message broker</li>
-      </ul>
-      <h3>Lease-Based Concurrency — ป้องกัน Task Duplicate</h3>
-      <p>ปัญหาคลาสสิกของ distributed workers: มี 2 worker เห็น task เดียวกันและทำงานซ้ำ Lease แก้ปัญหานี้โดยไม่ต้องใช้ distributed lock:</p>
-      <pre><code>Main Loop                    Queue File (.json)              Worker Process
-    │                              │                              │
-    │ getNextTask()                │                              │
-    │─────────────────────────────►│                              │
-    │◄─── task {id, status:pending}│                              │
-    │                              │                              │
-    │ leaseTask(id, agentId)      │                              │
-    │─────────────────────────────►│                              │
-    │  (atomic: check no lease    │                              │
-    │   → write leaseOwner +      │                              │
-    │   leaseExpiresAt)           │                              │
-    │◄─────── true (leased) ──────│                              │
-    │                              │                              │
-    │ spawnWorker(prompt)         │                              │
-    │─────────────────────────────────────────────────────────────►│
-    │◄──── WorkerSession {id, pid} │                              │
-    │                              │                              │
-    │          ═══ LOOP ═══        │                              │
-    │   while running:             │                              │
-    │     checkWorker(sessionId)   │                              │
-    │     ────────────────────────────────────────────────────────►│
-    │     ◄─── "running" / "completed" / "failed"                 │
-    │                              │                              │
-    │                              │  (worker ทำงาน autonomously) │
-    │                              │                              │
-    │   [completed] → releaseLease │                              │
-    │              → markCompleted │                              │
-    │                              │                              │
-    │   [failed] → markFailed      │                              │
-    │           → retryTask()      │                              │
-    │           → stopWorker()     │                              │
-    │                              │                              │
-    │   [timeout 30m] → stopWorker │                              │
-    │                → releaseLease│                              │
-    │                → retryTask() │                              │</code></pre>
-      <ul>
-        <li><strong>Lease owner</strong> — ระบุว่า worker ไหนกำลังทำ task นี้</li>
-        <li><strong>Lease expiry</strong> — ถ้า worker crash โดยไม่ release, lease จะหมดอายุเอง → worker อื่นรับงานต่อได้</li>
-        <li><strong>Startup recovery</strong> — ตอน <code>startLoop</code> จะรอ 2 วินาที (ให้ process เก่าตายแน่ๆ) แล้วเรียก <code>expireLeases()</code> ล้าง stale lease ทั้งหมด</li>
-      </ul>
-      <h3>Retry with Exponential Backoff</h3>
-      <p>Task ที่ fail ไม่ได้แปลว่าต้อง dead-letter ทันที:</p>
-      <pre><code>Retry attempt     Backoff delay         Cumulative wait
-─────────────     ─────────────         ──────────────
-      1           base × 2¹ = 30s              30s
-      2           base × 2² = 60s              90s
-      3           base × 2³ = 120s            210s
-      4           base × 2⁴ = 240s            450s
-      5 (max)      base × 2⁵ = 480s            930s (~15 min)
-After max retries → dead_letter queue
-Dead-letter preserves: title, description, lastError, errorLog, retryCount</code></pre>
-      <ul>
-        <li><strong>Exponential backoff</strong> — base = 15s, factor = 2 — ลดการถล่ม queue เมื่อ task fail ซ้ำๆ</li>
-        <li><strong>Max retries</strong> — default 5 ครั้งต่อ task</li>
-        <li><strong>Retry interval</strong> — <code>retryAfter</code> timestamp ป้องกันไม่ให้ retry ก่อนเวลาที่กำหนด</li>
-        <li><strong>Dead-letter queue</strong> — task ที่ใช้ retry หมดจะถูกย้ายไปสถานะ <code>dead_letter</code> พร้อม <code>deadLetterReason</code> และ <code>errorLog</code> — ไม่หายไปไหน ตรวจสอบย้อนหลังได้</li>
-      </ul>
-      <h3>Worker Lifecycle + Concurrent Cap</h3>
-      <p>Main loop มีกลไกจำกัดจำนวน worker พร้อมกัน:</p>
-      <ul>
-        <li><strong>MAX_CONCURRENT_WORKERS = 3</strong> — ป้องกันไม่ให้ spawn worker มากเกินไปจนเครื่องพัง</li>
-        <li><strong>Loop poll interval</strong> — ถ้า worker เต็ม → sleep <code>LOOP_SLEEP_MS</code> (5s) แล้วตรวจใหม่</li>
-        <li><strong>Worker timeout = 30 นาที</strong> — task ที่รันนานเกินจะถูก kill เพื่อคืน resource</li>
-        <li><strong>Worker poll = 10s</strong> — เช็คสถานะ worker ทุก 10 วินาทีผ่าน supervisor IPC</li>
-      </ul>
-      <h3>Supervisor Integration — Process Health</h3>
-      <p>Worker ไม่ได้ถูกรันโดยตรง แต่ spawn ผ่าน<strong>Supervisor process</strong> (child_process):</p>
-      <pre><code>Agent Loop                    Supervisor                   Worker
-    │                              │                         │
-    │ sendRequest({type:'spawn'})  │                         │
-    │─────────────────────────────►│                         │
-    │                              │ spawn child_process     │
-    │                              │────────────────────────►│
-    │◄─── {ok:true, sessionId, pid}│                         │
-    │                              │                         │
-    │ sendRequest({type:'attach'}) │                         │
-    │─────────────────────────────►│                         │
-    │                              │ check process status    │
-    │◄─── {status, isRunning}      │                         │
-    │                              │                         │
-    │ sendRequest({type:'stop'})   │                         │
-    │─────────────────────────────►│                         │
-    │                              │ kill + cleanup          │
-    │                              │────────────────────────►│</code></pre>
-      <ul>
-        <li><strong>Crash isolation</strong> — worker crash ไม่ทำให้ loop crash — supervisor แยก process คนละตัว</li>
-        <li><strong>Output capture</strong> — supervisor เก็บ stdout/stderr ของ worker ไว้ใน <code>~/.clew/daemon/jobs/{sessionId}/output.log</code></li>
-        <li><strong>Health monitoring</strong> — loop เช็คผ่าน supervisor แทนที่จะ monitor PID โดยตรง (PID reuse problem)</li>
-      </ul>
-      <h3>Integration Points — Peer + Cron + Watch</h3>
-      <p>Agent Loop ไม่ได้อยู่เดี่ยวๆ — มัน integrate กับระบบอื่นของ Clew:</p>
-      <ul>
-        <li><strong>Peer todo listener</strong> — ฟัง <code>/peer-todo</code> HTTP endpoint → รับ task จาก remote peer → add เข้า queue</li>
-        <li><strong>Cron scheduler</strong> — <code>daemonCronScheduler</code> fire task ตาม schedule → add เข้า queue</li>
-        <li><strong>File watcher</strong> — <code>fs.watch</code> บน queue file → ตรวจจับ task ใหม่จาก process อื่น (เช่นจาก CLI <code>/task add</code>)</li>
-      </ul>
-      <p>architecture แบบนี้ทำให้ task เข้า queue ได้จากหลายช่องทาง — CLI, remote peer, cron — แต่มี consumer เดียว (loop) ที่คุมการ execute</p>
-      <h3>Task Log Persistence</h3>
-      <p>ทุก task มี log ของตัวเอง:</p>
-      <ul>
-        <li><strong>Per-task log</strong> — <code>~/.clew/daemon/logs/{taskId}.log</code> — 500 บรรทัดสุดท้ายของ worker output</li>
-        <li><strong>Error extraction</strong> — ตอน task fail, loop จะ extract non-noise lines (20 บรรทัดสุดท้าย) เก็บเป็น <code>errorLog[]</code> ใน queue entry</li>
-        <li><strong>Worker exit code</strong> — บันทึกว่า worker จบด้วย exit code 0 (success) หรือ 1 (failure)</li>
-      </ul>
-      <h3>Crash Recovery Flow</h3>
-      <p>ถ้า loop process ตาย (kill -9, power loss, OOM):</p>
-      <pre><code>Previous Run Crash
-      │
-      ▼
-startLoop() called
-      │
-      ├── loadQueue() — อ่านไฟล์ queue จาก disk
-      │
-      ├── sleep(2000ms) — รอให้แน่ใจว่า process เก่าตายแล้ว
-      │
-      ├── expireLeases() — ล้าง lease ทั้งหมดที่หมดอายุ
-      │   (task ที่ถูก lease โดย processID เก่าจะถูก reset → pending)
-      │
-      ├── start heartbeat (ทุก 60s)
-      │
-      ├── start cron scheduler
-      │
-      ├── start peer sharing
-      │
-      ├── start file watcher
-      │
-      └── MAIN LOOP ──► getNextTask() → processTask() → loop</code></pre>
-      <h2>Task Lifecycle (State Machine)</h2>
-      <pre><code>                 ┌──────────┐
-                 │ pending   │◄──────────────────────────────┐
-                 └────┬─────┘                               │
-                      │ leaseTask()                          │
-                      ▼                                      │
-                 ┌──────────┐                               │
-                 │in_progress│                               │
-                 └────┬─────┘                               │
-          ┌───────────┼───────────┐                         │
-          ▼           ▼           ▼                         │
-    ┌──────────┐ ┌──────────┐ ┌──────────┐                 │
-    │completed │ │ failed   │ │cancelled │                 │
-    └──────────┘ └────┬─────┘ └──────────┘                 │
-                      │ retryTask()                         │
-                      ├── retryCount < max → backoff → ────┘
-                      │
-                      └── retryCount ≥ max
-                              │
-                              ▼
-                         ┌──────────────┐
-                         │ dead_letter   │
-                         │ (preserved    │
-                         │  for review)  │
-                         └──────────────┘</code></pre>
-      <h2>ไฟล์ที่เกี่ยวข้อง</h2>
-      <table>
-        <tr><th>ไฟล์</th><th>หน้าที่</th></tr>
-        <tr><td><code>src/services/autonomous/agentLoop.ts</code></td><td>Main loop — start, stop, processTask, worker lifecycle</td></tr>
-        <tr><td><code>src/services/autonomous/taskQueue.ts</code></td><td>Queue CRUD, lease management, retry, dead-letter, file watcher</td></tr>
-        <tr><td><code>src/services/autonomous/daemonMode.ts</code></td><td>Daemon entry point — calls startLoop/stopLoop</td></tr>
-        <tr><td><code>src/Task.ts</code></td><td>Task type definitions, state machine, task ID generation</td></tr>
-        <tr><td><code>src/tasks/LocalAgentTask/</code></td><td>Local worker task — UI + lifecycle</td></tr>
-        <tr><td><code>src/tasks/RemoteAgentTask/</code></td><td>Remote worker task — UI + lifecycle</td></tr>
-        <tr><td><code>src/components/AutonomousExecutionAccordion.tsx</code></td><td>UI component สำหรับแสดง task queue ใน REPL</td></tr>
-      </table>
-      <footer class="footer">
-        <span>Clew Code — 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/mcp.th.html DELETED Viewed

@@ -1,207 +0,0 @@
-<!DOCTYPE html>
-<html lang="th">
-<head>
-  <meta charset="UTF-8">
-  <meta name="viewport" content="width=device-width, initial-scale=1.0">
-  <title>MCP — Clew Code</title>
-  <meta name="description" content="Model Context Protocol (MCP) — เชื่อมต่อเครื่องมือภายนอก, ทรัพยากร, และบริการ ผ่าน stdio, SSE, และ OAuth">
-  <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>MCP</span></div>
-      <h1>Model Context Protocol (MCP)</h1>
-      <p class="section-subtitle">เชื่อมต่อ Clew กับเครื่องมือภายนอก, แหล่งข้อมูล, และบริการผ่าน MCP — มาตรฐานเปิดสำหรับ AI-tool integration</p>
-      <p>MCP อยู่ใน <code>src/services/mcp/</code> — Clew ค้นหาเซิร์ฟเวอร์ MCP จาก <strong>settings.json</strong>, <strong>CLI flags</strong>, และ <strong>plugin manifests</strong> แล้วรวมเครื่องมือเข้าสู่ runtime</p>
-      <h2>สถาปัตยกรรม</h2>
-      <pre><code> ┌──────────────────────────────────────────────────────────────────────────┐
- │                    MCP — MODEL CONTEXT PROTOCOL                           │
- └──────────────────────────────────────────────────────────────────────────┘
-                         ┌──────────────────────────┐
-                         │   Settings / CLI Config   │
-                         │  src/services/mcp/config  │
-                         └────────────┬─────────────┘
-                                      │
-                                      ▼
-                     ┌──────────────────────────┐
-                     │   MCPConnectionManager   │
-                     │  จัดการ lifecycle        │
-                     │  ของเซิร์ฟเวอร์ MCP ทั้งหมด │
-                     └────────────┬─────────────┘
-                                  │
-              ┌───────────────────┼───────────────────┐
-              ▼                   ▼                   ▼
-      ┌──────────────┐   ┌──────────────┐   ┌──────────────┐
-      │  Stdio MCP   │   │   SSE MCP    │   │Direct Connect│
-      │ (subprocess) │   │  (remote)    │   │ (in-process) │
-      │ npx/node/etc │   │  HTTP + SSE  │   │              │
-      └──────┬───────┘   └──────┬───────┘   └──────┬───────┘
-             │                  │                   │
-             └──────────────────┼───────────────────┘
-                                │
-                                ▼
-                     ┌──────────────────────┐
-                     │   Client (JSON-RPC)  │
-                     │  tools/list          │
-                     │  tools/call          │
-                     │  resources/list      │
-                     └──────────┬───────────┘
-                                │
-                                ▼
-                     ┌──────────────────────┐
-                     │   assembleToolPool   │
-                     │  (MCP + built-in     │
-                     │   tools รวมกัน)      │
-                     └──────────┬───────────┘
-                                │
-                                ▼
-                     ┌──────────────────────┐
-                     │    Query Engine      │
-                     │  Model เห็น tools     │
-                     │  ทั้งหมดใน pool      │
-                     └──────────────────────┘</code></pre>
-      <h2>วิธีการทำงาน</h2>
-      <h3>การค้นหาเซิร์ฟเวอร์</h3>
-      <p>MCP servers ถูกค้นหาจาก 3 แหล่งเมื่อเริ่มต้น:</p>
-      <ol>
-        <li><strong><code>settings.json</code></strong> — คีย์ <code>mcpServers</code> กำหนด command, args, env</li>
-        <li><strong>CLI <code>--mcp-config</code></strong> — ไฟล์หรือ inline JSON</li>
-        <li><strong>Plugins</strong> — manifest ของ plugin สามารถประกาศ MCP server ได้; เริ่มเมื่อ plugin โหลด, หยุดเมื่อ unload</li>
-      </ol>
-      <h3>ประเภทการเชื่อมต่อ</h3>
-      <table>
-        <tr><th>ประเภท</th><th>Transport</th><th>วิธีการ</th></tr>
-        <tr>
-          <td><strong>Stdio</strong></td>
-          <td>stdin/stdout</td>
-          <td>Clew spawn subprocess (เช่น <code>npx @modelcontextprotocol/server-filesystem</code>) และสื่อสารผ่าน JSON-RPC ทาง stdin/stdout</td>
-        </tr>
-        <tr>
-          <td><strong>SSE</strong></td>
-          <td>HTTP + SSE</td>
-          <td>เชื่อมต่อ remote MCP server ผ่าน HTTP ใช้ SSE สำหรับ server→client, HTTP POST สำหรับ client→server รองรับ OAuth</td>
-        </tr>
-        <tr>
-          <td><strong>Direct Connect</strong></td>
-          <td>In-process</td>
-          <td>รัน MCP server ใน process เดียวกัน ใช้ InProcessTransport — ไม่มี network, ไม่มี subprocess ใช้ใน plugin-bundled servers</td>
-        </tr>
-      </table>
-      <h3>Tool Lifecycle</h3>
-      <pre><code>  1. CONNECT    ──► MCPConnectionManager เชื่อมต่อ server
-                       │
-                       ▼
-  2. DISCOVER   ──► เรียก tools/list (รองรับ paginated)
-                       │
-                       ▼
-  3. MERGE      ──► assembleToolPool() รวม MCP tools
-                       │  กับ built-in tools (sort + dedup)
-                       ▼
-  4. PRESENT    ──► Model เห็น MCP tools เป็น native tools
-                       │  (permission gating, hooks, logging)
-                       ▼
-  5. EXECUTE    ──► Model เรียก tool → toolExecution.ts
-                       │  route ไปยัง server ที่ถูกต้อง
-                       ▼
-  6. RESPOND    ──► ผลลัพธ์กลับไปหา model</code></pre>
-      <h3>การยืนยันตัวตน (Authentication)</h3>
-      <ul>
-        <li><strong>OAuth 2.0</strong> — redirect flow สำหรับ remote MCP servers เปิด local HTTP port เพื่อรับ callback</li>
-        <li><strong>Bearer token</strong> — static API token ใน <code>Authorization</code> header</li>
-        <li><strong>XAA token</strong> — auth provider token สำหรับ MCP servers</li>
-        <li><strong>Credential vault</strong> — credentials ที่เก็บไว้ใน vault ถูก inject อัตโนมัติ</li>
-      </ul>
-      <h2>คำสั่ง MCP</h2>
-      <table>
-        <tr><th>คำสั่ง</th><th>คำอธิบาย</th></tr>
-        <tr><td><code>/mcp</code></td><td>เปิดเมนูจัดการ MCP — list servers, add, remove, reconnect</td></tr>
-        <tr><td><code>/mcp list</code></td><td>แสดงเซิร์ฟเวอร์ MCP ทั้งหมด พร้อม tools, resources, prompts</td></tr>
-        <tr><td><code>/mcp add &lt;name&gt; &lt;command&gt; [args...]</code></td><td>เพิ่ม stdio MCP server ใหม่</td></tr>
-        <tr><td><code>/mcp remove &lt;name&gt;</code></td><td>ลบ MCP server</td></tr>
-        <tr><td><code>/mcp reconnect &lt;name&gt;</code></td><td>เชื่อมต่อ MCP server ใหม่</td></tr>
-      </table>
-      <h2>รูปแบบ Config (settings.json)</h2>
-      <div class="code-block-wrap">
-        <div class="code-block-header"><span>json</span></div>
-        <pre><code>{
-  "mcpServers": {
-    "filesystem": {
-      "command": "npx",
-      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/workspace"],
-      "env": {}
-    },
-    "database": {
-      "command": "node",
-      "args": ["./mcp/db-server.js"],
-      "env": {
-        "DB_URL": "postgresql://localhost:5432/mydb"
-      }
-    },
-    "remote-api": {
-      "url": "https://mcp.example.com",
-      "headers": {
-        "Authorization": "Bearer sk-..."
-      }
-    }
-  }
-}</code></pre>
-      </div>
-      <h2>Plugin-Bundled MCP Servers</h2>
-      <p>Plugin สามารถประกาศ MCP server ใน manifest เมื่อ plugin โหลด Clew จะสร้าง DirectConnect session ให้อัตโนมัติ — ไม่ต้อง subprocess ไม่ต้อง network — server จะพร้อมใช้งานทันที</p>
-      <h2>เครื่องมือ Built-in ที่ใช้ MCP</h2>
-      <table>
-        <tr><th>Tool</th><th>MCP ใช้ทำอะไร</th></tr>
-        <tr><td><code>ListMcpResources</code></td><td>แสดง resources จาก MCP servers ทั้งหมด (resources/list)</td></tr>
-        <tr><td><code>ReadMcpResource</code></td><td>อ่าน resource ตาม URI จาก MCP server (resources/read)</td></tr>
-      </table>
-      <h2>ไฟล์สำคัญ</h2>
-      <table>
-        <tr><th>ไฟล์</th><th>หน้าที่</th></tr>
-        <tr><td><code>src/services/mcp/MCPConnectionManager.tsx</code></td><td>จัดการ lifecycle ของเซิร์ฟเวอร์ MCP</td></tr>
-        <tr><td><code>src/services/mcp/config.ts</code></td><td>โหลด config จาก settings.json และ CLI flags</td></tr>
-        <tr><td><code>src/services/mcp/client.ts</code></td><td>JSON-RPC client</td></tr>
-        <tr><td><code>src/services/mcp/auth.ts</code></td><td>OAuth + Bearer token authentication</td></tr>
-        <tr><td><code>src/services/mcp/oauthPort.ts</code></td><td>Local HTTP server สำหรับ OAuth callback</td></tr>
-        <tr><td><code>src/services/mcp/types.ts</code></td><td>Type definitions</td></tr>
-        <tr><td><code>src/services/mcp/InProcessTransport.ts</code></td><td>In-process transport สำหรับ DirectConnect</td></tr>
-        <tr><td><code>src/services/mcp/officialRegistry.ts</code></td><td>ทะเบียน MCP server ทางการ</td></tr>
-        <tr><td><code>src/tools.ts</code></td><td>assembleToolPool() รวม MCP tools</td></tr>
-      </table>
-      <footer class="footer">
-        <span>Clew Code — โอเพนซอร์ส</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/models.th.html DELETED Viewed

@@ -1,61 +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 — วิธีเลือก, สลับ, และจัดการโมเดลจาก 27 ผู้ให้บริการ">
-  <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 รองรับ 100+ โมเดลจาก 27 ผู้ให้บริการ เลือกโมเดลที่เหมาะกับแต่ละงาน — จากการใช้เหตุผลระดับสูงไปจนถึงการอนุมานในเครื่องที่รวดเร็ว</p>
-  <h2>คู่มือการเลือกโมเดล</h2>
-  <table>
-    <tr><th>ลักษณะงาน</th><th>โมเดลแนะนำ</th><th>บริบท</th><th>หมายเหตุ</th></tr>
-    <tr><td>สถาปัตยกรรมซับซ้อนและแก้ไขขนาดใหญ่</td><td>claude-opus-4-7, claude-sonnet-4-6, gpt-5.5, deepseek-v4-pro</td><td>1M โทเค็น</td><td>การเรียกใช้เครื่องมือดีที่สุด, การใช้เหตุผลแข็งแกร่ง, บริบทใหญ่ที่สุด</td></tr>
-    <tr><td>รีวิวโค้ดและดีบัก</td><td>claude-sonnet-4-6, gpt-5.5, gemini-3.1-pro</td><td>1M-2M โทเค็น</td><td>ทำตามคำแนะนำดี, ผลลัพธ์เชื่อถือได้</td></tr>
-    <tr><td>ค้นหาและสรุปผลอย่างรวดเร็ว</td><td>claude-haiku-4-5, deepseek-v4-flash, mistral-small-4, groq/llama-3.3-70b</td><td>128K-200K</td><td>เร็ว, คุ้มค่า, หน่วงเวลาต่ำ</td></tr>
-    <tr><td>ออฟไลน์ / ไม่มีเครือข่าย</td><td>ollama/llama4:70b, ollama/llama3.3</td><td>131K โทเค็น</td><td>ในเครื่องทั้งหมด, ไม่ต้องใช้เครือข่าย</td></tr>
-  </table>
-  <h2>การสลับโมเดล</h2>
-  <pre><code>/model                          # ตัวเลือกแบบโต้ตอบ
-/model list                     # แสดงโมเดลทั้งหมดจากผู้ให้บริการที่ใช้งาน
-/model claude-sonnet-4-7        # สลับด้วย ID เต็ม
-/model sonnet                   # สลับด้วย alias
---model opus                    # CLI flag ตอนเริ่ม</code></pre>
-  <h2>CLI Flags สำหรับโมเดล</h2>
-  <table>
-    <tr><th>Flag</th><th>คำอธิบาย</th></tr>
-    <tr><td><code>--model &lt;name&gt;</code></td><td>ตั้งค่าโมเดลตอนเริ่ม</td></tr>
-    <tr><td><code>--effort &lt;level&gt;</code></td><td>ตั้งค่าระดับการใช้เหตุผล: low, medium, high, max</td></tr>
-    <tr><td><code>--thinking &lt;mode&gt;</code></td><td>โหมดการคิด: enabled, adaptive, disabled</td></tr>
-    <tr><td><code>--fallback-model &lt;model&gt;</code></td><td>โมเดลสำรองเมื่อโมเดลหลักโอเวอร์โหลด</td></tr>
-  </table>
-  <footer class="footer">
-    <span>Clew 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/permission-model.th.html DELETED Viewed

@@ -1,67 +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 — โหมด, กฎ, และความปลอดภัย">
-  <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 ควบคุมการดำเนินการเครื่องมือผ่านระบบสิทธิ์แบบหลายชั้นพร้อมหลายโหมด, กฎอนุญาต/ปฏิเสธ, และการตรวจสอบเฉพาะเครื่องมือ</p>
-  <h2>โหมดสิทธิ์</h2>
-  <p>กำหนดใน <code>src/types/permissions.ts</code> เจ็ดโหมดที่ผู้ใช้เข้าถึงได้:</p>
-  <table>
-    <tr><th>โหมด</th><th>พฤติกรรม</th></tr>
-    <tr><td><code>default</code></td><td>ถามก่อนดำเนินการเครื่องมือที่ละเอียดอ่อน (read/write/bash/network) ค่าเริ่มต้นที่ปลอดภัย</td></tr>
-    <tr><td><code>ask</code></td><td>ถามก่อนทุกการดำเนินการเครื่องมือ</td></tr>
-    <tr><td><code>plan</code></td><td>ชอบโหมดวางแผน — AI ต้องนำเสนอแผนก่อนดำเนินการ</td></tr>
-    <tr><td><code>auto</code></td><td>อนุมัติอัตโนมัติสำหรับการกระทำความเสี่ยงต่ำ ถามสำหรับการดำเนินการเสี่ยง</td></tr>
-    <tr><td><code>acceptEdits</code></td><td>อนุมัติอัตโนมัติสำหรับการแก้ไขไฟล์ มีประโยชน์สำหรับการพัฒนาที่รวดเร็ว</td></tr>
-    <tr><td><code>bypassPermissions</code></td><td>ข้ามการขอสิทธิ์ทั้งหมด ใช้ใน sandbox ที่เชื่อถือได้เท่านั้น</td></tr>
-    <tr><td><code>dontAsk</code></td><td>ไม่ถาม — ปฏิเสธอัตโนมัติทุกอย่างที่ต้องขอสิทธิ์</td></tr>
-  </table>
-  <h2>กฎสิทธิ์</h2>
-  <p>กฎอนุญาต/ปฏิเสธแบบละเอียดควบคุมเครื่องมือและอาร์กิวเมนต์เฉพาะ:</p>
-  <pre><code>/permissions     # เปิดตัวจัดการกฎสิทธิ์แบบโต้ตอบ</code></pre>
-  <p>กฎสามารถกำหนดเป้าหมายเครื่องมือเฉพาะด้วยการจับคู่รูปแบบ:</p>
-  <ul>
-    <li><code>Bash(git *)</code> — อนุญาต/ปฏิเสธคำสั่ง git โดยเฉพาะ</li>
-    <li><code>Edit</code> — อนุญาต/ปฏิเสธการแก้ไขไฟล์ทั้งหมด</li>
-    <li><code>Bash(rm *)</code> — เตือน/บล็อกคำสั่ง shell ที่เป็นอันตราย</li>
-  </ul>
-  <h2>แนวทางปฏิบัติด้านความปลอดภัย</h2>
-  <ul>
-    <li><strong>โหมดค่าเริ่มต้น</strong> สำหรับการพัฒนาประจำวัน</li>
-    <li><strong>โหมดวางแผน</strong> สำหรับโครงสร้างพื้นฐานการผลิตหรือโค้ดที่ไม่คุ้นเคย</li>
-    <li><strong>โหมดข้าม</strong> เฉพาะใน worktrees ที่ใช้แล้วทิ้งหรือ Docker sandboxes</li>
-    <li>ใช้กฎอนุญาต/ปฏิเสธเพื่ออนุญาตรูปแบบที่ปลอดภัยขณะบล็อกรูปแบบอันตราย</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>