cc-viewer 1.7.21 → 1.7.23

package/concepts/th/Tool-ProposeGoal.md

@@ -0,0 +1,43 @@
+# ProposeGoal
+
+เสนอเป้าหมายความสำเร็จที่ตรวจสอบได้สำหรับเซสชัน เป้าหมายจะแสดงให้ผู้ใช้เห็นใน dialog อนุมัติ (โดยค่าเริ่มต้น) และเมื่อตั้งแล้วจะชี้นำ conversation ที่เหลือไปสู่ผลลัพธ์ที่ตรวจสอบได้
+
+## เมื่อใดควรใช้
+
+- เซสชันมีสถานะสิ้นสุดที่ชัดเจนซึ่งผู้ประเมินสามารถตรวจสอบได้จาก conversation (เช่น "all tests in test/auth pass")
+- คุณต้องการให้ผู้ใช้ลงนามยอมรับอย่างชัดเจนว่า "เสร็จ" หมายความว่าอะไรก่อนลงมือทำงานใหญ่
+- คำพูดของผู้ใช้เองระบุผลลัพธ์ไว้แล้ว และคุณต้องการบันทึกเป็นเป้าหมายของเซสชัน
+
+## การเปิดใช้งาน
+
+- ปิดตามค่าเริ่มต้น (feature flag ฝั่ง server)
+- ถูกแยกออกจากเซสชันแบบ interactive และ background
+- ปิดโดย settings key `modelProposedGoals: "disabled"`
+
+## พารามิเตอร์
+
+- `condition` (string, required): เงื่อนไขความสำเร็จ เขียนในลักษณะที่ผู้ประเมินอีกคนสามารถตรวจสอบได้จาก conversation (เช่น "all tests in test/auth pass (bun test exits 0)") ความยาวไม่เกิน 500 ตัวอักษร — ผู้ใช้ต้องอ่านเงื่อนไขทั้งหมดใน dialog อนุมัติได้
+- `ask_user` (boolean, optional): จะถามผู้ใช้เพื่ออนุมัติก่อนตั้งเป้าหมายหรือไม่ ค่าเริ่มต้นคือ true (แสดง dialog อนุมัติ) ตั้งเป็น false เฉพาะเมื่อคำพูดของผู้ใช้เองใน conversation นี้ระบุผลลัพธ์นี้ว่าเป็นสิ่งที่ต้องการเท่านั้น เป้าหมายจะถูกตั้งโดยตรงพร้อมข้อความแจ้งที่มองเห็นได้ และผู้ใช้ล้างได้ด้วย `/goal clear`
+
+## ตัวอย่าง
+
+### ตัวอย่างที่ 1: เสนอเป้าหมายที่มี test รองรับ
+
+```
+ProposeGoal(condition="npm run test exits 0 with the new catalog cases included")
+```
+
+ผู้ใช้เห็นเงื่อนไขใน dialog อนุมัติ และยอมรับ, แก้ไข, หรือปฏิเสธได้
+
+### ตัวอย่างที่ 2: รับผลลัพธ์ที่ผู้ใช้ระบุไว้โดยตรง
+
+```
+ProposeGoal(condition="the login form validates email format and shows an inline error", ask_user=false)
+```
+
+ใช้ได้ก็ต่อเมื่อผู้ใช้ระบุผลลัพธ์นั้นอย่างชัดเจนก่อนหน้าใน conversation เท่านั้น
+
+## หมายเหตุ
+
+- ทำให้ `condition` สั้นและตรวจสอบได้อย่างเป็นรูปธรรม — เป้าหมายที่คลุมเครือ ("make it better") ทำให้จุดประสงค์เสียไป
+- `ask_user=false` จำกัดเฉพาะผลลัพธ์ที่ผู้ใช้ระบุเองเท่านั้น นอกเหนือจากนั้นต้องผ่าน dialog อนุมัติ

package/concepts/th/Tool-PushNotification.md

@@ -14,6 +14,12 @@
 
 อย่าส่งการแจ้งเตือนสำหรับการอัปเดตความคืบหน้าตามปกติระหว่างงาน หรือเพื่อยืนยันว่าคุณตอบคำถามที่ผู้ใช้เพิ่งถามและกำลังรออยู่ อย่าแจ้งเตือนเมื่องานสั้นๆ เสร็จสิ้น หากผู้ใช้เพิ่งส่งมาและกำลังรอ การแจ้งเตือนไม่มีคุณค่าและทำลายความไว้วางใจสำหรับการแจ้งเตือนในอนาคต ควรเอนเอียงอย่างหนักไปทางไม่ส่ง
 
+## การเปิดใช้งาน
+
+- ปิดตามค่าเริ่มต้น (feature flag ฝั่ง server)
+- การส่งดำเนินการผ่านโครงสร้างพื้นฐานที่โฮสต์โดย Anthropic — ไม่พร้อมใช้งานบน Amazon Bedrock, Claude Platform on AWS, Google Cloud, หรือ Microsoft Foundry
+- การ push ไปยังโทรศัพท์ต้องมีไคลเอนต์ Remote Control ที่เชื่อมต่ออยู่เพิ่มเติม
+
 ## พารามิเตอร์
 
 - `message` (สตริง, จำเป็น): เนื้อหาการแจ้งเตือน เก็บไว้ต่ำกว่า 200 ตัวอักษร ระบบปฏิบัติการมือถือจะตัดสตริงที่ยาวกว่านั้น เริ่มต้นด้วยสิ่งที่ผู้ใช้จะดำเนินการ: "build failed: 2 auth tests" มีประโยชน์กว่า "task complete"

package/concepts/th/Tool-REPL.md

@@ -0,0 +1,47 @@
+# REPL
+
+รัน JavaScript ใน Node.js vm context แบบ persistent ภายในเซสชัน รองรับ top-level `await` และตัวแปร/ฟังก์ชันที่กำหนดในการเรียกครั้งหนึ่งยังคงใช้งานได้ในการเรียกครั้งถัดไป
+
+## เมื่อใดควรใช้
+
+- การคำนวณเร็ว ๆ, การแปลงข้อมูล, หรือการจัดการ JSON ที่ทำในโค้ดง่ายกว่า shell one-liner
+- การเขียนสคริปต์หลายขั้นตอนที่สถานะระหว่างกลางควรคงอยู่ระหว่างการเรียก (ตัวนับ, ผลลัพธ์สะสม)
+- ลองพฤติกรรมของ API หรือไลบรารีแบบ interactive ก่อนเขียนลงไฟล์
+
+## การเปิดใช้งาน
+
+- ปิดตามค่าเริ่มต้น — ตั้ง `CLAUDE_CODE_REPL=true` เพื่อเปิดใช้งาน
+- ในเซสชันเทอร์มินัล (`cli`) และ claude.ai (`remote`) feature flag ฝั่ง server อาจเปิดใช้งานได้เช่นกัน
+- เมื่อปิดอยู่ REPL จะถูกซ่อนจาก tool list ของโมเดล เมื่อเปิดอยู่ `Read`, `Glob`, `Grep`, `Bash`, `PowerShell`, และ `NotebookEdit` จะถูกแทนที่ด้วยชวเลขของ REPL
+
+## พารามิเตอร์
+
+- `code` (string, required): โค้ด JavaScript ที่จะรัน รองรับ top-level await สถานะคงอยู่ระหว่างการเรียก
+- `description` (string, optional): คำอธิบายที่ชัดเจนและกระชับของสิ่งที่สคริปต์นี้ทำ ในรูป active voice (5–10 คำ) เช่น "Trace upgrade message to its GrowthBook flag"
+- `timeout` (number, optional): เวลาหมดเวลาในหน่วยมิลลิวินาที ค่าเริ่มต้นคือ 30000 สูงสุด 600000
+
+## ตัวอย่าง
+
+### ตัวอย่างที่ 1: คำนวณและนำสถานะกลับมาใช้
+
+```
+REPL(code="const counts = new Map(); ['a','b','a'].forEach(k => counts.set(k, (counts.get(k)||0)+1)); counts.get('a')")
+```
+
+คืนค่า `2` และ `counts` ยังคงถูกกำหนดไว้สำหรับการเรียก REPL ครั้งถัดไปในเซสชันเดียวกัน
+
+### ตัวอย่างที่ 2: top-level await พร้อม timeout ที่นานขึ้น
+
+```
+REPL(
+  code="const res = await fetch('https://example.com/api'); await res.json()",
+  description="Fetch example API and parse JSON",
+  timeout=60000
+)
+```
+
+## หมายเหตุ
+
+- สถานะเป็นแบบ per-session: การเริ่มเซสชันใหม่จะล้างคำจำกัดความทั้งหมด
+- นี่คือสภาพแวดล้อม JavaScript (Node) — ใช้ Bash สำหรับคำสั่ง shell งานที่เกี่ยวข้องกับ filesystem มาก หรือ runtime ที่ไม่ใช่ JS
+- โค้ดที่ทำงานนานควรตั้ง `timeout` อย่างชัดเจน ค่าเริ่มต้น 30 วินาทีจะฆ่าทุกอย่างที่ช้ากว่านั้น

package/concepts/th/Tool-ReadMcpResource.md

@@ -0,0 +1,32 @@
+# ReadMcpResource
+
+อ่าน resource หนึ่งรายการที่ expose โดย MCP (Model Context Protocol) server ที่เชื่อมต่ออยู่ โดยระบุด้วย URI ของมัน
+
+## เมื่อใดควรใช้
+
+- MCP server advertise resource (ไฟล์, record, เอกสาร) ที่คุณต้องการเนื้อหาใน context
+- คุณมี resource URI ที่ชัดเจน — จาก `ListMcpResources`, จาก documentation ของ server, หรือจากผลลัพธ์ของเครื่องมือครั้งก่อน
+
+## การเปิดใช้งาน
+
+- เปิดใช้งานเสมอ แต่ไม่ถูก expose ใน tool list ของโมเดล — มีไว้สำหรับการใช้งานแบบ thin-client / sidecar
+
+## พารามิเตอร์
+
+- `server` (string, required): ชื่อ MCP server
+- `uri` (string, required): resource URI ที่จะอ่าน
+
+## ตัวอย่าง
+
+### ตัวอย่างที่ 1: อ่าน resource ของ server ด้วย URI
+
+```
+ReadMcpResource(server="github", uri="file:///repo/docs/architecture.md")
+```
+
+ส่งคืนเนื้อหา resource ตามที่ MCP server `github` ให้มา
+
+## หมายเหตุ
+
+- ใช้ `ListMcpResources` ก่อนหากไม่รู้ว่า server expose resource อะไรบ้าง ใช้ `ReadMcpResourceDir` สำหรับการแสดงรายการแบบ directory
+- รูปแบบ URI เป็นของแต่ละ server (`file://`, `https://`, รูปแบบกำหนดเอง) — ตรวจสอบว่า server เป้าหมาย advertise อะไร

package/concepts/th/Tool-ReadMcpResourceDir.md

@@ -0,0 +1,32 @@
+# ReadMcpResourceDir
+
+แสดงรายการ entries ของ resource แบบ directory ที่ expose โดย MCP server ที่เชื่อมต่ออยู่ โดยระบุด้วย URI ของมัน
+
+## เมื่อใดควรใช้
+
+- MCP server จัด resource แบบลำดับชั้น และคุณต้องการแจกแจงหนึ่งระดับของลำดับชั้นนั้น
+- คุณต้องการสำรวจก่อนอ่าน resource แต่ละรายการด้วย `ReadMcpResource`
+
+## การเปิดใช้งาน
+
+- เปิดใช้งานเสมอ แต่ไม่ถูก expose ใน tool list ของโมเดล — มีไว้สำหรับการใช้งานแบบ thin-client / sidecar
+
+## พารามิเตอร์
+
+- `server` (string, required): ชื่อ MCP server
+- `uri` (string, required): URI ของ resource แบบ directory ที่จะแสดงรายการ
+
+## ตัวอย่าง
+
+### ตัวอย่างที่ 1: แสดงรายการ resource directory
+
+```
+ReadMcpResourceDir(server="filesystem", uri="file:///project/src/")
+```
+
+ส่งคืน entries ลูกที่ server expose ภายใต้ directory URI นั้น
+
+## หมายเหตุ
+
+- เฉพาะ server ที่จำลอง resource เป็น directory เท่านั้นที่รองรับ ส่วน server แบบ flat จะส่งคืน error หรือรายการว่าง — ถอยกลับไปใช้ `ListMcpResources`
+- ใช้ร่วมกับ `ReadMcpResource` เพื่อเจาะลงไปยัง entries ที่ดูเกี่ยวข้อง

package/concepts/th/Tool-ReadNotifications.md

@@ -0,0 +1,27 @@
+# ReadNotifications
+
+อ่านการแจ้งเตือนที่รออยู่ในคิวสำหรับผู้ช่วยในเซสชันปัจจุบัน — กิจกรรม GitHub บน PR ที่ติดตาม (`github_webhook`), การยิงของ trigger ที่ตั้งเวลา (`trigger_fire`), และข้อความที่มาจากเซสชัน Claude อื่น (`mcp_send_message`)
+
+## เมื่อใดควรใช้
+
+- คุณได้รับการแจ้งเตือนว่ามีบางอย่างเกิดขึ้น — PR ที่ติดตามอัปเดต, trigger ที่ตั้งเวลาถูกยิง, เซสชันอื่นส่งข้อความมา — และต้องการ payload จริง
+- เคลียร์ backlog: batch ขนาดใหญ่ถูกส่งคืนเป็นส่วน ๆ ดังนั้นให้เรียกต่อไปเรื่อย ๆ จนกว่าผลลัพธ์จะรายงาน 0 `remaining`
+
+## พารามิเตอร์
+
+เครื่องมือนี้ไม่มีพารามิเตอร์
+
+## ตัวอย่าง
+
+### ตัวอย่างที่ 1: เคลียร์การแจ้งเตือนที่ค้างอยู่
+
+```
+ReadNotifications()
+```
+
+ส่งคืนการแจ้งเตือนในคิวโดยเรียงจากเก่าสุดก่อน ผลลัพธ์มีจำนวน `remaining` ของการแจ้งเตือนที่ยังอยู่ในคิวหลังจากการเคลียร์ครั้งนี้ — เรียกเครื่องมือนี้อีกครั้งเพื่ออ่านการแจ้งเตือนที่เหลือ
+
+## หมายเหตุ
+
+- การเคลียร์ถูกจำกัดด้วยขนาด (size-budgeted): การเรียกครั้งถัดไปจะคืนส่วนที่เหลือของคิวเดิม (บวกของที่เพิ่งเข้ามาใหม่) ไม่ใช่เฉพาะของใหม่เท่านั้น วนเรียกจนกว่า `remaining` จะเป็น 0
+- การแจ้งเตือนมาจาก GitHub webhook บน PR ที่ติดตาม, trigger ที่ตั้งเวลา, และข้อความจากเซสชัน Claude อื่น; ปัจจุบันยังไม่มีพารามิเตอร์กรอง

package/concepts/th/Tool-RemoteTrigger.md

@@ -10,6 +10,13 @@
 - แสดงรายการหรือตรวจสอบทริกเกอร์ปัจจุบันทั้งหมดเพื่อดูการกำหนดค่าและสถานะ
 - อัปเดตการตั้งค่าทริกเกอร์ เช่น กำหนดการ เพย์โหลด หรือคำอธิบาย โดยไม่ต้องสร้างทริกเกอร์ใหม่
 
+## การเปิดใช้งาน
+
+- ต้องใช้แผน claude.ai Pro, Max, Team, หรือ Enterprise
+- ไม่พร้อมใช้งานบน Amazon Bedrock, Claude Platform on AWS, Google Cloud, หรือ Microsoft Foundry
+- ต้องใช้ feature flag ฝั่ง server และการตั้งค่านโยบาย `allow_remote_sessions` / `allow_routines`
+- ไม่ใช้สำหรับ remote sessions เอง
+
 ## พารามิเตอร์
 
 - `action` (string, จำเป็น): การดำเนินการที่จะดำเนินการ — ค่าหนึ่งใน `list`, `get`, `create`, `update` หรือ `run`

package/concepts/th/Tool-ScheduleWakeup.md

@@ -10,6 +10,11 @@
 - เมื่อรันลูปอัตโนมัติโดยไม่มีพรอมต์จากผู้ใช้ — ส่ง sentinel ตามตัวอักษร `<<autonomous-loop-dynamic>>` เป็น `prompt`
 - เมื่อต้องการโพลล์กระบวนการที่สถานะกำลังจะเปลี่ยนแปลงในเร็วๆ นี้ (ใช้ค่าหน่วงเวลาสั้นเพื่อรักษาแคชให้ยังอุ่นอยู่)
 
+## การเปิดใช้งาน
+
+- ไม่พร้อมใช้งานบน Amazon Bedrock, Claude Platform on AWS, Google Cloud Agent Platform, หรือ Microsoft Foundry
+- ปิดเช่นกันเมื่อการดึง feature flag ถูกปิดใช้งาน (env vars ด้าน telemetry/traffic)
+
 ## พารามิเตอร์
 
 - `delaySeconds` (ตัวเลข, จำเป็น): จำนวนวินาทีจนกว่าจะกลับมาทำงาน ระบบรันไทม์จะจำกัดค่าอัตโนมัติไว้ที่ `[60, 3600]` จึงไม่จำเป็นต้องจำกัดเองด้วยตนเอง

package/concepts/th/Tool-SearchMcpRegistry.md

@@ -0,0 +1,31 @@
+# SearchMcpRegistry
+
+ค้นหา MCP connector registry ด้วย keyword เพื่อค้นพบ connector ที่อาจช่วยให้งานสำเร็จ
+
+## เมื่อใดควรใช้
+
+- งานจะได้ประโยชน์จากบริการภายนอก (ฐานข้อมูล, issue tracker, SaaS API) และคุณต้องการตรวจสอบว่ามี MCP connector สำหรับบริการนั้นหรือไม่
+- ผู้ใช้ระบุชื่อผลิตภัณฑ์และขอให้เชื่อมต่อ — ค้นหา registry เพื่อหา connector ที่ตรงกัน
+
+## การเปิดใช้งาน
+
+- พร้อมใช้งานในเซสชันระยะไกล (claude.ai) บน first-party API เท่านั้น
+
+## พารามิเตอร์
+
+- `keywords` (array of strings, required): วลี keyword ที่อธิบายความตั้งใจของผู้ใช้หรือชื่อผลิตภัณฑ์ 1–8 รายการ แต่ละรายการ 1–64 ตัวอักษร
+
+## ตัวอย่าง
+
+### ตัวอย่างที่ 1: หา connector สำหรับผลิตภัณฑ์ที่ระบุชื่อ
+
+```
+SearchMcpRegistry(keywords=["linear", "issue tracker"])
+```
+
+ส่งคืนรายการ registry ที่ connector ตรงกับ keyword ดึงรายละเอียด connector แบบเต็มด้วย `SuggestConnectors`
+
+## หมายเหตุ
+
+- อ่านอย่างเดียวและปลอดภัยต่อ concurrency ผลลัพธ์ถูกจำกัดขนาด
+- การค้นหาไม่ติดตั้งอะไรเลย — เป็นการค้นพบล้วน ๆ

package/concepts/th/Tool-SendFeedback.md

@@ -0,0 +1,38 @@
+# SendFeedback
+
+ส่ง feedback แบบมีโครงสร้างเกี่ยวกับ Claude Code ไปยัง Anthropic — รายงานบั๊ก, ไอเดียฟีเจอร์, หรือความสามารถที่ขาดหาย — โดยไม่ต้องออกจากเซสชัน
+
+## เมื่อใดควรใช้
+
+- ผู้ใช้ขอให้รายงานบั๊กหรือส่ง feedback เกี่ยวกับตัว Claude Code เอง
+- คุณพบข้อบกพร่องของผลิตภัณฑ์ที่ชัดเจน (คำสั่งเสีย, พฤติกรรมผิด, แครช) ที่คุ้มค่าต่อการรายงาน
+- ผู้ใช้อธิบายฟีเจอร์ที่อยากให้มี (ไอเดียหรือความสามารถที่ขาดหาย)
+
+## พารามิเตอร์
+
+- `type` (string, required): หนึ่งใน `bug`, `idea`, `missing_capability`
+- `title` (string, required): สรุปประเด็นหนึ่งบรรทัดที่สั้นและเฉพาะเจาะจง
+- `details` (string, required): หัวข้อย่อยแบบ labeled เรียงตามลำดับ: **What happened:** (สิ่งที่สังเกตเทียบกับที่คาดหวัง, ข้อความ error ที่แน่นอนหากสั้น); **What the user said:** (อ้างคำพูด หรือ "User didn't comment; observed by the model."); **Repro:** (ขั้นตอนน้อยที่สุด); **Evidence:** (request ID, timestamp, path, เวอร์ชัน — ละเว้นหากไม่มี); และ **Cause:** เป็นตัวเลือกสุดท้าย เฉพาะเมื่อยืนยันแล้วในเซสชันเท่านั้น หนึ่งถึงสามบรรทัดต่อหัวข้อ ไม่มีย่อหน้าแบบเล่าเรื่อง ไม่มีการคาดเดา ไม่มีความลับ
+- `area` (string, optional): แท็กสั้น ๆ ระบุส่วนของ Claude Code ที่เกี่ยวข้อง (เช่น "hooks config", "/help", "file editing") เว้นว่างหากไม่ชัดเจน
+- `failure_mode` (string, optional): สำหรับรายงานพฤติกรรมของโมเดล ให้ระบุ failure mode ที่ใกล้เคียงที่สุด (เช่น `instruction_following`, `repetition_and_looping`, `context_and_memory`, `stopping_short`, หรือ `other`) ละเว้นเฉพาะเมื่อรายงานเป็นบั๊กของผลิตภัณฑ์/tool ล้วน ๆ
+- `task_category` (string, optional): สิ่งที่เซสชันกำลังทำอยู่เมื่อเกิดปัญหา: `code_edit`, `debug`, `explain`, `plan`, `shell`, `search`, `review`, หรือ `other`
+
+## ตัวอย่าง
+
+### ตัวอย่างที่ 1: รายงานบั๊กของผลิตภัณฑ์
+
+```
+SendFeedback(
+  type="bug",
+  title="/export truncates the last message",
+  details="**What happened:** exported transcript is missing the final assistant message.\n**What the user said:** \"the last reply never shows up in the file\".\n**Repro:** run /export after any multi-turn session.\n**Evidence:** v2.1.233, macOS.",
+  area="/export",
+  task_category="other"
+)
+```
+
+## หมายเหตุ
+
+- อย่าใส่ความลับ, token, หรือข้อมูลส่วนตัวของผู้ใช้ใน `details`
+- อ้างคำพูดของผู้ใช้เมื่อมี หากไม่มีให้ระบุว่าโมเดลเป็นผู้สังเกตเห็นปัญหา
+- ทำให้รายงานเป็นข้อเท็จจริง — การคาดเดาสาเหตุรากอยู่ที่ `**Cause:**` เฉพาะเมื่อยืนยันแล้วในเซสชันเท่านั้น

package/concepts/th/Tool-SendFile.md

@@ -0,0 +1,36 @@
+# SendFile
+
+ส่งไฟล์หนึ่งไฟล์ขึ้นไปไปยังเซสชันของ Claude Code อื่น — peer ที่แสดงใน `ListAgents` หรือที่อยู่เซสชันแบบชัดเจน
+
+## เมื่อใดควรใช้
+
+- peer session ต้องการไฟล์จาก working directory ของคุณ (รายงาน, patch, fixture) เพื่อทำงานของมันต่อ
+- คุณประสานงานข้ามเซสชันและต้องการส่งมอบ artifact ไม่ใช่แค่ข้อความ (ใช้ `SendMessage` สำหรับข้อความ)
+
+## การเปิดใช้งาน
+
+- การโอนไฟล์ข้ามเซสชันต้องพร้อมใช้งานในเซสชัน หากไม่ การตรวจสอบจะล้มเหลวพร้อมข้อความ "Cross-session file transfer is not available in this session."
+- Gated ด้วยเงื่อนไขการส่งข้อความข้ามเซสชันเดียวกับ `ListAgents` (feature flag ฝั่ง server ปิดตามค่าเริ่มต้น)
+
+## พารามิเตอร์
+
+- `to` (string, required): ผู้รับ — ชื่อ peer session จาก `ListAgents` หรือที่อยู่แบบ `uds:<socket>` / `bridge:<session id>` ที่ชัดเจน
+- `files` (array of strings, required): path ของไฟล์ (absolute หรือ relative กับ cwd) ที่จะส่ง ต้องส่งเป็น array เสมอแม้มีไฟล์เดียว 1–16 ไฟล์ แต่ละไฟล์ไม่เกิน 30 MiB
+- `message` (string, optional): ข้อความสั้น ๆ ที่ส่งไปพร้อมกับไฟล์
+
+## ตัวอย่าง
+
+### ตัวอย่างที่ 1: ส่งรายงานไปยัง peer session
+
+```
+SendFile(
+  to="teammate-a",
+  files=["./dist/report.html"],
+  message="The analysis you asked for"
+)
+```
+
+## หมายเหตุ
+
+- การส่งไปยังเครื่องระยะไกลอาจต้องอนุมัติเพิ่มเติม
+- การอ่านเนื้อหาไฟล์เป็นส่วนหนึ่งของการส่ง — จะถูกปฏิเสธหากการอ่านไฟล์ถูกปิดโดย permission rules

package/concepts/th/Tool-SendMessage.md

@@ -10,6 +10,11 @@
 - ตอบกลับ protocol prompt เช่นคำขอ shutdown หรือคำขอ plan approval จาก team leader
 - ปิดลูปที่จุดสิ้นสุดของงานที่มอบหมาย เพื่อให้ leader สามารถ mark รายการว่าเสร็จแล้ว
 
+## การเปิดใช้งาน
+
+- Gated ด้วยเงื่อนไขการส่งข้อความข้ามเซสชันเดียวกับ `ListAgents` (feature flag ฝั่ง server ปิดตามค่าเริ่มต้น)
+- Teammate ต้องเปิดใช้งาน experimental agent teams เพิ่มเติมด้วย
+
 ## พารามิเตอร์
 
 - `to` (string, required): `name` ของ teammate เป้าหมายตามที่ลงทะเบียนในทีม หรือ `*` เพื่อ broadcast ไปยัง teammate ทุกคนในคราวเดียว

package/concepts/th/Tool-SendUserFile.md

@@ -0,0 +1,38 @@
+# SendUserFile
+
+ส่งไฟล์หนึ่งไฟล์ขึ้นไปให้ผู้ใช้ — artifact ที่สร้างขึ้น, ภาพหน้าจอ, รายงาน — พร้อมควบคุมวิธีที่ client นำเสนอ
+
+## เมื่อใดควรใช้
+
+- คุณสร้างไฟล์ที่ผู้ใช้ต้องการ (รายงาน, รูปภาพ, หน้า HTML) และต้องการนำเสนอ ไม่ใช่แค่บอก path ของมัน
+- ตอบกลับพร้อมไฟล์แนบ (`status="normal"`) หรือนำเสนอล่วงหน้าสิ่งที่ผู้ใช้ยังไม่ได้ขอแต่ต้องเห็นตอนนี้ (`status="proactive"`)
+
+## การเปิดใช้งาน
+
+- พร้อมใช้งานเมื่อไคลเอนต์ Remote Control เชื่อมต่ออยู่ หรือเซสชันทำงานในสภาพแวดล้อมคลาวด์ที่จัดการ (เช่น Claude Code on the web) เท่านั้น
+- ไม่พร้อมใช้งานบน Amazon Bedrock, Google Cloud, หรือ Microsoft Foundry
+- ต้องให้เซสชันอนุญาตการส่งไฟล์ (ความสามารถที่ gated ด้วย settings/feature) ไม่มีให้ใน brief mode
+
+## พารามิเตอร์
+
+- `files` (array of strings, required): path ของไฟล์ (absolute หรือ relative กับ cwd) ที่จะส่งให้ผู้ใช้ ต้องส่งเป็น array เสมอแม้มีไฟล์เดียว
+- `caption` (string, optional): คำบรรยายสั้น ๆ สำหรับไฟล์
+- `status` (string, required): `proactive` เมื่อนำเสนอไฟล์ที่ผู้ใช้ยังไม่ได้ขอและต้องเห็นตอนนี้ — artifact ที่สร้างขึ้น, รายงานที่เสร็จแล้ว; `normal` เมื่อตอบกลับสิ่งที่ผู้ใช้เพิ่งพูด
+- `display` (string, optional): `render` เปิดไฟล์แบบ inline ใน side panel (HTML, SVG, Mermaid, รูปภาพ, PDF); `attach` แสดงเพียงการ์ดดาวน์โหลด (deliverable ที่ผู้ใช้จะบันทึกและเปิดที่อื่น) ละเว้นเพื่อให้ client ตัดสินใจตามประเภทไฟล์
+
+## ตัวอย่าง
+
+### ตัวอย่างที่ 1: ส่งมอบรายงานที่สร้างขึ้น
+
+```
+SendUserFile(
+  files=["./out/weekly-report.html"],
+  caption="Weekly usage report",
+  status="proactive",
+  display="render"
+)
+```
+
+## หมายเหตุ
+
+- เลือก `display="attach"` สำหรับไฟล์ที่ผู้ใช้บันทึกและเปิดในแอปอื่น ส่วน `render` สำหรับสิ่งที่ควรดูทันที

package/concepts/th/Tool-SendUserMessage.md

@@ -0,0 +1,38 @@
+# SendUserMessage
+
+ส่งข้อความถึงผู้ใช้ — ช่องสัญญาณเอาต์พุตหลักที่มองเห็นได้ในเซสชันแบบ brief-style หรือที่รู้จักใน alias รุ่นเดิมว่า `Brief`
+
+## เมื่อใดควรใช้
+
+- ตอบกลับสิ่งที่ผู้ใช้เพิ่งพูด (`status="normal"`)
+- นำเสนอล่วงหน้าสิ่งที่ผู้ใช้ยังไม่ได้ขอและต้องเห็นตอนนี้ — งานเสร็จในขณะที่พวกเขาไม่อยู่, อุปสรรคที่คุณพบ, การอัปเดตสถานะที่ไม่ได้ร้องขอ (`status="proactive"`)
+
+## การเปิดใช้งาน
+
+- ซ่อนในเซสชันแบบ interactive ตามค่าเริ่มต้น เซสชัน CLI แบบ interactive ส่วนใหญ่คุยกับผู้ใช้โดยตรงแทน
+- เปิดใช้งานใน brief mode หรือผ่าน feature flag ฝั่ง server
+
+## พารามิเตอร์
+
+ใน brief mode:
+
+- `message` (string, required): ข้อความถึงผู้ใช้ รองรับการจัดรูปแบบ markdown
+- `attachments` (array, optional): ไฟล์แนบที่แสดงพร้อมข้อความ แต่ละรายการเป็น path ไฟล์ (absolute หรือ relative กับ cwd) สำหรับไฟล์ที่อ่านได้ในเครื่อง หรือ object `{file_uuid, file_name, size, is_image}` ที่ resolve ไว้แล้วซึ่งได้จาก device tool เช่น `attach_file`
+- `status` (string, required): `proactive` สำหรับการอัปเดตที่ไม่ได้ร้องขอซึ่งผู้ใช้ต้องรู้ตอนนี้ ส่วน `normal` เมื่อตอบกลับผู้ใช้
+
+ใน build ที่ไม่ใช่ brief มีเฉพาะ `message` เท่านั้น
+
+## ตัวอย่าง
+
+### ตัวอย่างที่ 1: ประกาศความสำเร็จแบบ proactive
+
+```
+SendUserMessage(
+  message="The migration finished — 42 files updated, tests green.",
+  status="proactive"
+)
+```
+
+## หมายเหตุ
+
+- ใช้ `proactive` อย่างประหยัด — มีไว้สำหรับสิ่งที่ต้องดึงความสนใจผู้ใช้จริง ๆ ตอนนี้

package/concepts/th/Tool-SuggestConnectors.md

@@ -0,0 +1,28 @@
+# SuggestConnectors
+
+ดึงรายละเอียด connector แบบเต็มสำหรับค่า `directoryUuid` ที่ส่งคืนโดย `SearchMcpRegistry` เพื่อให้ผู้ใช้ได้รับข้อเสนอ connector ที่เป็นรูปธรรมให้เปิดใช้งาน
+
+## เมื่อใดควรใช้
+
+- หลังจาก `SearchMcpRegistry` ส่งคืน connector ที่เป็นตัวเลือก เพื่อดึงรายละเอียดแบบเต็มมาแสดง
+
+## การเปิดใช้งาน
+
+- พร้อมใช้งานในเซสชันระยะไกล (claude.ai) บน first-party API เท่านั้น
+
+## พารามิเตอร์
+
+- `uuids` (array of strings, required): ค่า `directoryUuid` หรือ `server_id` ที่จะดึงรายละเอียด 1–32 รายการ แต่ละรายการ 1–64 ตัวอักษร
+
+## ตัวอย่าง
+
+### ตัวอย่างที่ 1: ดึงรายละเอียดผลการค้นหา registry สองรายการ
+
+```
+SuggestConnectors(uuids=["d290f1ee-6c54-4b01-90e6-d701748f0851", "a1b2c3d4-0000-4000-8000-abcdefabcdef"])
+```
+
+## หมายเหตุ
+
+- อย่าเดา UUID — ดึงรายละเอียดเฉพาะ identifier ที่ส่งคืนมาจาก `SearchMcpRegistry` เท่านั้น
+- เครื่องมือนี้ไม่ได้เชื่อมต่ออะไรเอง การเปิดใช้งาน connector เกิดขึ้นแยกต่างหาก

package/concepts/th/Tool-SuggestPluginInstall.md

@@ -0,0 +1,39 @@
+# SuggestPluginInstall
+
+แสดงการ์ดติดตั้ง plugin แบบ inline จากผลลัพธ์ของ `SearchPlugins` โดยผูกข้อเสนอ plugin เข้ากับคำขอของผู้ใช้
+
+## เมื่อใดควรใช้
+
+- การค้นหา plugin ผุด plugin ที่ตรงกับสิ่งที่ผู้ใช้พยายามทำ และคุณต้องการเสนอให้ติดตั้ง
+
+## การเปิดใช้งาน
+
+- เฉพาะเมื่อไคลเอนต์ Remote Control เชื่อมต่ออยู่ หรือเซสชันทำงานในสภาพแวดล้อมคลาวด์ที่จัดการ
+- ปิดใช้งานภายใต้การตั้งค่า HIPAA ขององค์กร
+- ไม่มีใน brief mode
+
+## พารามิเตอร์
+
+- `contextLabel` (string, required): หัวข้อสั้น ๆ ที่ผูกข้อเสนอเข้ากับคำขอของผู้ใช้ (ไม่เกิน 128 ตัวอักษร)
+- `plugins` (array, required): plugin ที่มาจากผลลัพธ์ของ `SearchPlugins` — 1–16 รายการ แต่ละรายการประกอบด้วย:
+  - `pluginId` (string, required)
+  - `pluginName` (string, required)
+  - `description` (string, required)
+  - `skills` (array, optional): รายการ `{name, description?}` ไม่เกิน 32 รายการ อธิบาย skill ของ plugin
+
+## ตัวอย่าง
+
+### ตัวอย่างที่ 1: เสนอ plugin ที่ตรงกัน
+
+```
+SuggestPluginInstall(
+  contextLabel="For reviewing pull requests",
+  plugins=[{pluginId="pr-toolkit", pluginName="PR Toolkit", description="Review helpers"}]
+)
+```
+
+การ์ดถูกแสดงให้ผู้ใช้ การเปิดใช้งาน plugin เกิดขึ้นแยกต่างหาก เรียก `ListPlugins` ในการติดตามผลเพื่อค้นพบว่าติดตั้งอะไรไปจริง ๆ
+
+## หมายเหตุ
+
+- ใส่เฉพาะ plugin ที่มาจากผลการค้นหาเท่านั้น — อย่าคิดค้นรายการ plugin เอง

package/concepts/th/Tool-SuggestSkills.md

@@ -0,0 +1,33 @@
+# SuggestSkills
+
+แสดงการ์ดของ standalone skill ที่ผู้ใช้เพิ่มได้ (skill ที่ยังไม่เปิดใช้งาน) ตาม keyword หัวข้อ
+
+## เมื่อใดควรใช้
+
+- คำขอของผู้ใช้ตรงกับ skill ที่พวกเขายังไม่เปิดใช้งาน (`trigger="user_asked"` เมื่อพวกเขาถาม, `trigger="proactive"` เมื่อคุณเสนอเองโดยไม่ถูกขอ)
+
+## การเปิดใช้งาน
+
+- เฉพาะเมื่อไคลเอนต์ Remote Control เชื่อมต่ออยู่ หรือเซสชันทำงานในสภาพแวดล้อมคลาวด์ที่จัดการ
+- ปิดใช้งานภายใต้การตั้งค่า HIPAA ขององค์กร
+- ไม่มีใน brief mode
+
+## พารามิเตอร์
+
+- `keywords` (array of strings, required): keyword หัวข้อจากคำขอของผู้ใช้ 1–8 รายการ แต่ละรายการ 1–64 ตัวอักษร
+- `contextLabel` (string, optional): ป้ายสั้น ๆ ที่ผูกข้อเสนอเข้ากับคำขอ (ไม่เกิน 128 ตัวอักษร)
+- `trigger` (string, optional): ข้อเสนอนี้เริ่มขึ้นอย่างไร — `user_asked` หรือ `proactive`
+
+## ตัวอย่าง
+
+### ตัวอย่างที่ 1: เสนอ skill ตามหัวข้อ
+
+```
+SuggestSkills(keywords=["data visualization", "charts"], contextLabel="For building the dashboard", trigger="user_asked")
+```
+
+skill ที่เปิดใช้งานอยู่แล้วจะถูกกรองออกจากผลลัพธ์
+
+## หมายเหตุ
+
+- แสดงเพียงการ์ดข้อเสนอ — การเพิ่ม skill เกิดขึ้นแยกต่างหาก เรียก `ListSkills` หลังจากนั้นเพื่อยืนยัน

package/concepts/th/Tool-TaskCreate.md

@@ -12,6 +12,12 @@
 
 ข้าม `TaskCreate` สำหรับการกระทำ one-shot ธรรมดา การสนทนาล้วนๆ หรือสิ่งใดก็ตามที่ทำเสร็จได้ในสองหรือสามการเรียก tool โดยตรง
 
+## การเปิดใช้งาน
+
+- พร้อมใช้งานตามค่าเริ่มต้นในโมเดลส่วนใหญ่
+- ไม่พร้อมใช้งานในตระกูล Opus 4.8 / Sonnet 5 / Fable 5 / Mythos 5 และใหม่กว่า (v2.1.233+) เว้นแต่เปิดใช้งานผ่าน `CLAUDE_CODE_ENABLE_TODO_TOOLS=1`, `--allowedTools`, หรือ `--tools`
+- ระบบ task ทั้งหมดถูกปิดใช้งานเมื่อ `CLAUDE_CODE_ENABLE_TASKS=false`
+
 ## พารามิเตอร์
 
 - `subject` (string, required): หัวข้อสั้นในรูปคำสั่ง เช่น `Fix login redirect on Safari` รักษาความยาวไม่เกินประมาณแปดสิบอักขระ

package/concepts/th/Tool-TaskGet.md

@@ -12,6 +12,12 @@
 
 ชอบ `TaskList` เมื่อต้องการเพียงการสแกนระดับสูง; สงวน `TaskGet` สำหรับบันทึกเฉพาะที่คุณตั้งใจจะอ่านอย่างตั้งใจหรือแก้ไข
 
+## การเปิดใช้งาน
+
+- พร้อมใช้งานตามค่าเริ่มต้นในโมเดลส่วนใหญ่
+- ไม่พร้อมใช้งานในตระกูล Opus 4.8 / Sonnet 5 / Fable 5 / Mythos 5 และใหม่กว่า (v2.1.233+) เว้นแต่เปิดใช้งานผ่าน `CLAUDE_CODE_ENABLE_TODO_TOOLS=1`, `--allowedTools`, หรือ `--tools`
+- ระบบ task ทั้งหมดถูกปิดใช้งานเมื่อ `CLAUDE_CODE_ENABLE_TASKS=false`
+
 ## พารามิเตอร์
 
 - `taskId` (string, required): ตัวระบุ task ที่ส่งคืนโดย `TaskCreate` หรือ `TaskList` ID คงที่ตลอดอายุของ task

package/concepts/th/Tool-TaskList.md

@@ -12,6 +12,12 @@
 
 `TaskList` เป็น read-only และถูก; เรียกได้อย่างอิสระเมื่อต้องการ overview
 
+## การเปิดใช้งาน
+
+- พร้อมใช้งานตามค่าเริ่มต้นในโมเดลส่วนใหญ่
+- ไม่พร้อมใช้งานในตระกูล Opus 4.8 / Sonnet 5 / Fable 5 / Mythos 5 และใหม่กว่า (v2.1.233+) เว้นแต่เปิดใช้งานผ่าน `CLAUDE_CODE_ENABLE_TODO_TOOLS=1`, `--allowedTools`, หรือ `--tools`
+- ระบบ task ทั้งหมดถูกปิดใช้งานเมื่อ `CLAUDE_CODE_ENABLE_TASKS=false`
+
 ## พารามิเตอร์
 
 `TaskList` ไม่รับ parameter มันส่งคืนชุด task เต็มสำหรับ context ที่ active เสมอ

package/concepts/th/Tool-TaskUpdate.md

@@ -10,6 +10,12 @@
 - บันทึก dependency ที่เพิ่งค้นพบด้วย `addBlocks` / `addBlockedBy`
 - แนบ `metadata` ที่มีโครงสร้าง เช่น external ticket ID หรือ hint ลำดับความสำคัญ
 
+## การเปิดใช้งาน
+
+- พร้อมใช้งานตามค่าเริ่มต้นในโมเดลส่วนใหญ่
+- ไม่พร้อมใช้งานในตระกูล Opus 4.8 / Sonnet 5 / Fable 5 / Mythos 5 และใหม่กว่า (v2.1.233+) เว้นแต่เปิดใช้งานผ่าน `CLAUDE_CODE_ENABLE_TODO_TOOLS=1`, `--allowedTools`, หรือ `--tools`
+- ระบบ task ทั้งหมดถูกปิดใช้งานเมื่อ `CLAUDE_CODE_ENABLE_TASKS=false`
+
 ## พารามิเตอร์
 
 - `taskId` (string, required): Task ที่จะแก้ไข รับจาก `TaskList` หรือ `TaskCreate`