cc-viewer 1.6.182 → 1.6.183

package/concepts/th/Tool-TaskCreate.md

@@ -1,78 +1,56 @@
 # TaskCreate
 
-## คำจำกัดความ
+สร้าง task ใหม่ใน task list ของทีมปัจจุบัน (หรือ task list ของ session เมื่อไม่มีทีม active) ใช้เพื่อจับรายการงานที่ควรได้รับการติดตาม มอบหมาย หรือกลับมาดูภายหลัง
 
-สร้างรายการในรายการงานแบบมีโครงสร้าง ใช้สำหรับติดตามความคืบหน้า จัดระเบียบงานที่ซับซ้อน และแสดงความคืบหน้าของงานให้ผู้ใช้เห็น
+## เมื่อใดควรใช้
 
-## พารามิเตอร์
-
-| พารามิเตอร์ | ประเภท | จำเป็น | คำอธิบาย |
-|------|------|------|------|
-| `subject` | string | ใช่ | หัวข้องานสั้น ใช้รูปแบบคำสั่ง (เช่น "Fix authentication bug") |
-| `description` | string | ใช่ | คำอธิบายโดยละเอียด รวมถึงบริบทและเกณฑ์การยอมรับ |
-| `activeForm` | string | ไม่ | ข้อความรูปแบบกำลังดำเนินการที่แสดงเมื่อกำลังทำงาน (เช่น "Fixing authentication bug") |
-| `metadata` | object | ไม่ | ข้อมูลเมตาที่แนบกับงาน |
-
-## สถานการณ์การใช้งาน
-
-**เหมาะสำหรับ:**
-- งานหลายขั้นตอนที่ซับซ้อน (มากกว่า 3 ขั้นตอน)
-- ผู้ใช้ให้รายการสิ่งที่ต้องทำหลายรายการ
-- ติดตามงานในโหมดวางแผน
-- ผู้ใช้ร้องขออย่างชัดเจนให้ใช้รายการ todo
+- ผู้ใช้อธิบายงานหลายขั้นตอนที่ได้ประโยชน์จากการติดตามที่ชัดเจน
+- คุณกำลังแบ่งคำขอขนาดใหญ่เป็นหน่วยย่อยที่สามารถเสร็จสิ้นแยกกันได้
+- มีการค้นพบ follow-up ระหว่างงานและไม่ควรถูกลืม
+- คุณต้องการบันทึกเจตนาที่คงทนก่อนส่งงานให้ teammate หรือ subagent
+- คุณกำลังทำงานใน plan mode และต้องการให้แต่ละขั้นตอนของแผนแสดงเป็น task ที่เป็นรูปธรรม
 
-**ไม่เหมาะสำหรับ:**
-- งานเดียวที่ง่าย
-- การดำเนินการง่ายๆ ไม่เกิน 3 ขั้นตอน
-- การสนทนาหรือการสอบถามข้อมูลล้วนๆ
+ข้าม `TaskCreate` สำหรับการกระทำ one-shot ธรรมดา การสนทนาล้วนๆ หรือสิ่งใดก็ตามที่ทำเสร็จได้ในสองหรือสามการเรียก tool โดยตรง
 
-## ข้อควรระวัง
-
-- งานที่สร้างใหม่ทั้งหมดมีสถานะเริ่มต้นเป็น `pending`
-- `subject` ใช้รูปแบบคำสั่ง ("Run tests"), `activeForm` ใช้รูปแบบกำลังดำเนินการ ("Running tests")
-- หลังจากสร้างงาน สามารถตั้งค่าความสัมพันธ์การพึ่งพา (blocks/blockedBy) ผ่าน TaskUpdate
-- ก่อนสร้าง ควรเรียก TaskList เพื่อตรวจสอบว่ามีงานซ้ำหรือไม่
-
-## ข้อความต้นฉบับ
-
-<textarea readonly>Use this tool to create a structured task list for your current coding session. This helps you track progress, organize complex tasks, and demonstrate thoroughness to the user.
-It also helps the user understand the progress of the task and overall progress of their requests.
+## พารามิเตอร์
 
-## When to Use This Tool
+- `subject` (string, required): หัวข้อสั้นในรูปคำสั่ง เช่น `Fix login redirect on Safari` รักษาความยาวไม่เกินประมาณแปดสิบอักขระ
+- `description` (string, required): context ที่ละเอียด — ปัญหา ข้อจำกัด acceptance criteria และไฟล์หรือลิงก์ที่ผู้อ่านในอนาคตจะต้องการ เขียนราวกับว่า teammate จะรับงานเย็นๆ
+- `activeForm` (string, optional): ข้อความ spinner ในรูปปัจจุบันกาลต่อเนื่องที่แสดงขณะที่ task เป็น `in_progress` เช่น `Fixing login redirect on Safari` สะท้อน `subject` แต่ในรูป -ing
+- `metadata` (object, optional): ข้อมูลโครงสร้างแบบกำหนดเองที่แนบกับ task ใช้ทั่วไป: label, hint ลำดับความสำคัญ, external ticket ID, หรือ configuration เฉพาะ agent
 
-Use this tool proactively in these scenarios:
+Task ที่สร้างใหม่จะเริ่มด้วยสถานะ `pending` และไม่มี owner Dependency (`blocks`, `blockedBy`) ไม่ได้ตั้งค่าในตอนสร้าง — ใช้ภายหลังด้วย `TaskUpdate`
 
-- Complex multi-step tasks - When a task requires 3 or more distinct steps or actions
-- Non-trivial and complex tasks - Tasks that require careful planning or multiple operations
-- Plan mode - When using plan mode, create a task list to track the work
-- User explicitly requests todo list - When the user directly asks you to use the todo list
-- User provides multiple tasks - When users provide a list of things to be done (numbered or comma-separated)
-- After receiving new instructions - Immediately capture user requirements as tasks
-- When you start working on a task - Mark it as in_progress BEFORE beginning work
-- After completing a task - Mark it as completed and add any new follow-up tasks discovered during implementation
+## ตัวอย่าง
 
-## When NOT to Use This Tool
+### ตัวอย่างที่ 1
 
-Skip using this tool when:
-- There is only a single, straightforward task
-- The task is trivial and tracking it provides no organizational benefit
-- The task can be completed in less than 3 trivial steps
-- The task is purely conversational or informational
+จับรายงานบั๊กที่ผู้ใช้เพิ่งยื่น
 
-NOTE that you should not use this tool if there is only one trivial task to do. In this case you are better off just doing the task directly.
+```
+TaskCreate(
+  subject: "Repair broken PDF export on Windows",
+  description: "Users on Windows 11 report the export button produces a 0-byte file. Reproduce with sample doc in test/fixtures/export/, then fix the code path in src/export/pdf.ts. Acceptance: export writes a valid PDF and the existing export test suite passes.",
+  activeForm: "Repairing broken PDF export on Windows"
+)
+```
 
-## Task Fields
+### ตัวอย่างที่ 2
 
-- **subject**: A brief, actionable title in imperative form (e.g., "Fix authentication bug in login flow")
-- **description**: Detailed description of what needs to be done, including context and acceptance criteria
-- **activeForm**: Present continuous form shown in spinner when task is in_progress (e.g., "Fixing authentication bug"). This is displayed to the user while you work on the task.
+แบ่ง epic เป็นหน่วยติดตามเมื่อเริ่ม session
 
-**IMPORTANT**: Always provide activeForm when creating tasks. The subject should be imperative ("Run tests") while activeForm should be present continuous ("Running tests"). All tasks are created with status `pending`.
+```
+TaskCreate(
+  subject: "Draft migration plan for auth service",
+  description: "Produce a written plan covering rollout stages, rollback strategy, and monitoring. Output: docs/auth-migration.md.",
+  activeForm: "Drafting migration plan for auth service",
+  metadata: { "priority": "P1", "linearId": "AUTH-214" }
+)
+```
 
-## Tips
+## หมายเหตุ
 
-- Create tasks with clear, specific subjects that describe the outcome
-- Include enough detail in the description for another agent to understand and complete the task
-- After creating tasks, use TaskUpdate to set up dependencies (blocks/blockedBy) if needed
-- Check TaskList first to avoid creating duplicate tasks
-</textarea>
+- เขียน `subject` ในรูปคำสั่งและ `activeForm` ในรูปปัจจุบันกาลต่อเนื่อง เพื่อให้ UI อ่านเป็นธรรมชาติเมื่อ task เปลี่ยนเป็น `in_progress`
+- เรียก `TaskList` ก่อนสร้างเพื่อหลีกเลี่ยงการซ้ำ — list ของทีมแชร์กับ teammate และ subagent
+- อย่าใส่ secret หรือ credential ใน `description` หรือ `metadata`; บันทึก task จะเห็นได้โดยทุกคนที่เข้าถึงทีม
+- หลังสร้าง ให้ task ผ่าน lifecycle ด้วย `TaskUpdate` อย่าปล่อยงานให้ถูกละเลยเงียบๆ ใน `in_progress`

package/concepts/th/Tool-TaskGet.md

@@ -1,56 +1,47 @@
 # TaskGet
 
-## คำจำกัดความ
+ดึงบันทึกเต็มสำหรับ task เดียวโดย ID รวมถึง description, สถานะปัจจุบัน, owner, metadata, และ dependency edge ใช้เมื่อ summary ที่ส่งคืนโดย `TaskList` ไม่เพียงพอที่จะลงมือกับ task
 
-รับรายละเอียดงานทั้งหมดผ่าน ID ของงาน
+## เมื่อใดควรใช้
 
-## พารามิเตอร์
-
-| พารามิเตอร์ | ประเภท | จำเป็น | คำอธิบาย |
-|------|------|------|------|
-| `taskId` | string | ใช่ | ID ของงานที่จะรับข้อมูล |
+- คุณเลือก task จาก `TaskList` และต้องการ description เต็มก่อนเริ่มงาน
+- คุณกำลังจะ mark task เป็น `completed` และต้องการตรวจสอบ acceptance criteria อีกครั้ง
+- คุณต้องการตรวจสอบว่า task นี้ `blocks` หรือ `blockedBy` อะไรเพื่อตัดสินใจขั้นตอนถัดไป
+- คุณกำลังสืบสวนประวัติ — ใครเป็น owner, metadata อะไรที่แนบอยู่, เมื่อไหร่ที่เปลี่ยนสถานะ
+- Teammate หรือ session ก่อนหน้าอ้างถึง task ID และคุณต้องการ context
 
-## เนื้อหาที่ส่งคืน
+ชอบ `TaskList` เมื่อต้องการเพียงการสแกนระดับสูง; สงวน `TaskGet` สำหรับบันทึกเฉพาะที่คุณตั้งใจจะอ่านอย่างตั้งใจหรือแก้ไข
 
-- `subject` — หัวข้องาน
-- `description` — ข้อกำหนดโดยละเอียดและบริบท
-- `status` — สถานะ: `pending`, `in_progress` หรือ `completed`
-- `blocks` — รายการงานที่ถูกบล็อกโดยงานนี้
-- `blockedBy` — รายการงานเงื่อนไขก่อนหน้าที่บล็อกงานนี้
-
-## สถานการณ์การใช้งาน
+## พารามิเตอร์
 
-**เหมาะสำหรับ:**
-- รับคำอธิบายและบริบทที่สมบูรณ์ของงานก่อนเริ่มทำงาน
-- ทำความเข้าใจความสัมพันธ์การพึ่งพาของงาน
-- รับข้อกำหนดที่สมบูรณ์หลังจากได้รับมอบหมายงาน
+- `taskId` (string, required): ตัวระบุ task ที่ส่งคืนโดย `TaskCreate` หรือ `TaskList` ID คงที่ตลอดอายุของ task
 
-## ข้อควรระวัง
+## ตัวอย่าง
 
-- หลังจากรับงาน ควรตรวจสอบว่ารายการ `blockedBy` ว่างเปล่าก่อนเริ่มทำงาน
-- ใช้ TaskList เพื่อดูข้อมูลสรุปของงานทั้งหมด
+### ตัวอย่างที่ 1
 
-## ข้อความต้นฉบับ
+ค้นหา task ที่คุณเพิ่งเห็นใน list
 
-<textarea readonly>Use this tool to retrieve a task by its ID from the task list.
+```
+TaskGet(taskId: "t_01HXYZ...")
+```
 
-## When to Use This Tool
+Field ทั่วไปของ response: `id`, `subject`, `description`, `activeForm`, `status`, `owner`, `blocks`, `blockedBy`, `metadata`, `createdAt`, `updatedAt`
 
-- When you need the full description and context before starting work on a task
-- To understand task dependencies (what it blocks, what blocks it)
-- After being assigned a task, to get complete requirements
+### ตัวอย่างที่ 2
 
-## Output
+แก้ไข dependency ก่อนเริ่ม
 
-Returns full task details:
-- **subject**: Task title
-- **description**: Detailed requirements and context
-- **status**: 'pending', 'in_progress', or 'completed'
-- **blocks**: Tasks waiting on this one to complete
-- **blockedBy**: Tasks that must complete before this one can start
+```
+TaskGet(taskId: "t_01HXYZ...")
+# ตรวจสอบ blockedBy — หาก task ใดที่อ้างถึงยัง pending
+# หรือ in_progress ให้ทำงานบน blocker ก่อน
+```
 
-## Tips
+## หมายเหตุ
 
-- After fetching a task, verify its blockedBy list is empty before beginning work.
-- Use TaskList to see all tasks in summary form.
-</textarea>
+- `TaskGet` เป็น read-only และปลอดภัยที่จะเรียกซ้ำ; ไม่เปลี่ยนสถานะหรือ ownership
+- หาก `blockedBy` ไม่ว่างและมี task ที่ไม่ใช่ `completed` อย่าเริ่ม task นี้ — แก้ blocker ก่อน (หรือประสานกับ owner ของมัน)
+- Field `description` อาจยาว อ่านให้ครบก่อนลงมือ; การสแกนนำไปสู่การพลาด acceptance criteria
+- `taskId` ที่ไม่รู้จักหรือถูกลบจะคืน error รัน `TaskList` อีกครั้งเพื่อเลือก ID ปัจจุบัน
+- หากคุณกำลังจะแก้ไข task ให้เรียก `TaskGet` ก่อนเพื่อหลีกเลี่ยงการ overwrite field ที่ teammate เพิ่งเปลี่ยน

package/concepts/th/Tool-TaskList.md

@@ -1,56 +1,62 @@
 # TaskList
 
-## คำจำกัดความ
+ส่งคืนทุก task ในทีมปัจจุบัน (หรือ session) ในรูป summary ใช้เพื่อสำรวจงานที่ค้างอยู่ ตัดสินใจว่าจะรับอะไรต่อไป และหลีกเลี่ยงการสร้างสิ่งซ้ำ
 
-แสดงรายการงานทั้งหมดในรายการงาน เพื่อดูความคืบหน้าโดยรวมและงานที่พร้อมทำ
+## เมื่อใดควรใช้
+
+- เมื่อเริ่ม session เพื่อดูว่าอะไรถูกติดตามไว้แล้ว
+- ก่อนเรียก `TaskCreate` เพื่อยืนยันว่างานยังไม่ถูกจับ
+- เมื่อตัดสินใจว่าจะอ้างสิทธิ์ task อะไรต่อไปเป็น teammate หรือ subagent
+- เพื่อตรวจสอบความสัมพันธ์ dependency ข้ามทีมในพริบตา
+- เป็นระยะระหว่าง session ที่ยาว เพื่อ re-sync กับ teammate ที่อาจอ้าง เสร็จ หรือเพิ่ม task
+
+`TaskList` เป็น read-only และถูก; เรียกได้อย่างอิสระเมื่อต้องการ overview
 
 ## พารามิเตอร์
 
-ไม่มีพารามิเตอร์
+`TaskList` ไม่รับ parameter มันส่งคืนชุด task เต็มสำหรับ context ที่ active เสมอ
+
+## รูปร่างการตอบกลับ
 
-## เนื้อหาที่ส่งคืน
+แต่ละ task ใน list เป็น summary ไม่ใช่บันทึกเต็ม คาดว่า:
 
-ข้อมูลสรุปของแต่ละงาน:
-- `id` — ตัวระบุงาน
-- `subject` — คำอธิบายสั้น
-- `status` — สถานะ: `pending`, `in_progress` หรือ `completed`
-- `owner` — ผู้รับผิดชอบ (ID ของ agent) ว่างหมายถึงยังไม่ได้มอบหมาย
-- `blockedBy` — รายการ ID ของงานที่ยังไม่เสร็จที่บล็อกงานนี้
+- `id` — ตัวระบุคงที่สำหรับใช้กับ `TaskGet` / `TaskUpdate`
+- `subject` — หัวข้อสั้นในรูปคำสั่ง
+- `status` — หนึ่งใน `pending`, `in_progress`, `completed`, `deleted`
+- `owner` — handle ของ agent หรือ teammate หรือว่างเมื่อไม่ถูกอ้างสิทธิ์
+- `blockedBy` — array ของ task ID ที่ต้องเสร็จก่อน
 
-## สถานการณ์การใช้งาน
+สำหรับ description เต็ม, acceptance criteria, หรือ metadata ของ task เฉพาะ ให้ follow up ด้วย `TaskGet`
 
-**เหมาะสำหรับ:**
-- ดูว่ามีงานใดพร้อมทำ (สถานะ pending ไม่มี owner ไม่ถูกบล็อก)
-- ตรวจสอบความคืบหน้าโดยรวมของโปรเจกต์
-- ค้นหางานที่ถูกบล็อก
-- ค้นหางานถัดไปหลังจากทำงานเสร็จ
+## ตัวอย่าง
 
-## ข้อควรระวัง
+### ตัวอย่างที่ 1
 
-- ควรดำเนินการงานตามลำดับ ID (ID น้อยสุดก่อน) เพราะงานก่อนหน้ามักให้บริบทสำหรับงานถัดไป
-- งานที่มี `blockedBy` ไม่สามารถรับมาทำได้จนกว่าการพึ่งพาจะถูกแก้ไข
-- ใช้ TaskGet เพื่อรับรายละเอียดที่สมบูรณ์ของงานเฉพาะ
+ตรวจสอบสถานะอย่างเร็ว
 
-## ข้อความต้นฉบับ
+```
+TaskList()
+```
 
-<textarea readonly>Use this tool to list all tasks in the task list.
+สแกน output หาสิ่งที่เป็น `in_progress` โดยไม่มี `owner` (งานค้าง) และสิ่งที่ `pending` โดยมี `blockedBy` ว่าง (พร้อมรับ)
 
-## When to Use This Tool
+### ตัวอย่างที่ 2
 
-- To see what tasks are available to work on (status: 'pending', no owner, not blocked)
-- To check overall progress on the project
-- To find tasks that are blocked and need dependencies resolved
-- After completing a task, to check for newly unblocked work or claim the next available task
-- **Prefer working on tasks in ID order** (lowest ID first) when multiple tasks are available, as earlier tasks often set up context for later ones
+Teammate เลือก task ถัดไป
 
-## Output
+```
+TaskList()
+# Filter ไปยัง: status == pending AND blockedBy ว่าง AND owner ว่าง
+# ในบรรดานั้น เลือก ID ที่ต่ำกว่า (task มักถูกหมายเลขตามลำดับ
+# การสร้าง ดังนั้น ID ต่ำกว่าเก่ากว่าและมักมีความสำคัญสูงกว่า)
+TaskGet(taskId: "<chosen id>")
+TaskUpdate(taskId: "<chosen id>", status: "in_progress", owner: "<your handle>")
+```
 
-Returns a summary of each task:
-- **id**: Task identifier (use with TaskGet, TaskUpdate)
-- **subject**: Brief description of the task
-- **status**: 'pending', 'in_progress', or 'completed'
-- **owner**: Agent ID if assigned, empty if available
-- **blockedBy**: List of open task IDs that must be resolved first (tasks with blockedBy cannot be claimed until dependencies resolve)
+## หมายเหตุ
 
-Use TaskGet with a specific task ID to view full details including description and comments.
-</textarea>
+- Heuristic ของ teammate: เมื่อมีหลาย task ที่ `pending` ถูก unblock และไม่มี owner ให้เลือก ID ต่ำที่สุด สิ่งนี้รักษางานเป็น FIFO และหลีกเลี่ยง agent สองตัวคว้า task ที่โดดเด่นเดียวกัน
+- เคารพ `blockedBy`: อย่าเริ่ม task ที่ blocker ของมันยัง `pending` หรือ `in_progress` ทำงาน blocker ก่อนหรือประสานกับ owner ของมัน
+- `TaskList` เป็นกลไกการค้นพบเพียงอย่างเดียวสำหรับ task ไม่มีการค้นหา; หาก list ยาวให้สแกนตามโครงสร้าง (ตามสถานะ แล้วตาม owner)
+- Task ที่ลบแล้วอาจยังปรากฏใน list ด้วยสถานะ `deleted` เพื่อการติดตามกลับ ละเลยสำหรับการวางแผน
+- List สะท้อนสถานะสดของทีม ดังนั้น teammate อาจเพิ่มหรืออ้างสิทธิ์ task ระหว่างการเรียก List ใหม่ก่อนอ้างสิทธิ์หากเวลาผ่านไป

package/concepts/th/Tool-TaskOutput.md

@@ -1,40 +1,50 @@
 # TaskOutput
 
-## คำจำกัดความ
+ดึง output ที่สะสมของ task เบื้องหลังที่กำลังรันหรือเสร็จสิ้น — คำสั่ง shell เบื้องหลัง, agent ในเครื่อง, หรือ session ระยะไกล ใช้เมื่อต้องการตรวจสอบสิ่งที่ task ที่รันนานได้ผลิตจนถึงขณะนี้
 
-รับผลลัพธ์ของงานเบื้องหลังที่กำลังทำงานหรือเสร็จสิ้นแล้ว ใช้ได้กับ shell เบื้องหลัง agent แบบอะซิงโครนัส และเซสชันระยะไกล
+## เมื่อใดควรใช้
+
+- Session ระยะไกล (เช่น cloud sandbox) กำลังรันและคุณต้องการ stdout ของมัน
+- Agent ในเครื่องถูก dispatch ใน background และคุณต้องการความคืบหน้าบางส่วนก่อนที่มันจะส่งกลับ
+- คำสั่ง shell เบื้องหลังรันนานพอที่คุณต้องการตรวจสอบโดยไม่หยุดมัน
+- คุณต้องยืนยันว่า task เบื้องหลังกำลังมีความคืบหน้าจริงๆ ก่อนรอนานขึ้นหรือเรียก `TaskStop`
+
+อย่าหันไปใช้ `TaskOutput` โดยอัตโนมัติ สำหรับงานเบื้องหลังส่วนใหญ่มีเส้นทางที่ตรงกว่า — ดูหมายเหตุด้านล่าง
 
 ## พารามิเตอร์
 
-| พารามิเตอร์ | ประเภท | จำเป็น | คำอธิบาย |
-|------|------|------|------|
-| `task_id` | string | ใช่ | ID ของงาน |
-| `block` | boolean | ใช่ | บล็อกรอจนกว่างานจะเสร็จหรือไม่ ค่าเริ่มต้น `true` |
-| `timeout` | number | ใช่ | เวลารอสูงสุด (มิลลิวินาที) ค่าเริ่มต้น 30000 สูงสุด 600000 |
+- `task_id` (string, required): ตัวระบุ task ที่ส่งคืนเมื่องานเบื้องหลังเริ่มต้น ไม่ใช่เหมือน `taskId` ของ task-list; นี่คือ handle runtime สำหรับการ execute เฉพาะ
+- `block` (boolean, optional): เมื่อ `true` (ค่าเริ่มต้น) รอจนกว่า task จะสร้าง output ใหม่หรือเสร็จก่อนส่งกลับ เมื่อ `false` ส่งกลับทันทีด้วยสิ่งที่ buffer ไว้
+- `timeout` (number, optional): millisecond สูงสุดที่ block ก่อนส่งกลับ มีความหมายเฉพาะเมื่อ `block` เป็น `true` ค่าเริ่มต้น `30000`, สูงสุด `600000`
+
+## ตัวอย่าง
+
+### ตัวอย่างที่ 1
+
+ดู session ระยะไกลโดยไม่ block
 
-## สถานการณ์การใช้งาน
+```
+TaskOutput(task_id: "sess_01HXYZ...", block: false)
+```
 
-**เหมาะสำหรับ:**
-- ตรวจสอบความคืบหน้าของ agent เบื้องหลังที่เริ่มผ่าน Task (`run_in_background: true`)
-- รับผลลัพธ์การรันคำสั่ง Bash เบื้องหลัง
-- รอให้งานอะซิงโครนัสเสร็จสิ้นและรับผลลัพธ์
+ส่งคืน stdout/stderr ที่ผลิตตั้งแต่ task เริ่ม (หรือตั้งแต่การเรียก `TaskOutput` ครั้งก่อน ขึ้นกับ runtime)
 
-**ไม่เหมาะสำหรับ:**
-- งานเบื้องหน้า — งานเบื้องหน้าส่งคืนผลลัพธ์โดยตรง ไม่ต้องใช้เครื่องมือนี้
+### ตัวอย่างที่ 2
 
-## ข้อควรระวัง
+รอสั้นๆ ให้ agent ในเครื่อง emit output เพิ่ม
 
-- `block: true` จะบล็อกจนกว่างานจะเสร็จหรือหมดเวลา
-- `block: false` ใช้สำหรับตรวจสอบสถานะปัจจุบันแบบไม่บล็อก
-- ID ของงานสามารถค้นหาได้ผ่านคำสั่ง `/tasks`
-- ใช้ได้กับงานทุกประเภท: shell เบื้องหลัง, agent แบบอะซิงโครนัส, เซสชันระยะไกล
+```
+TaskOutput(
+  task_id: "agent_01ABCD...",
+  block: true,
+  timeout: 10000
+)
+```
 
-## ข้อความต้นฉบับ
+## หมายเหตุ
 
-<textarea readonly>- Retrieves output from a running or completed task (background shell, agent, or remote session)
-- Takes a task_id parameter identifying the task
-- Returns the task output along with status information
-- Use block=true (default) to wait for task completion
-- Use block=false for non-blocking check of current status
-- Task IDs can be found using the /tasks command
-- Works with all task types: background shells, async agents, and remote sessions</textarea>
+- คำสั่ง bash เบื้องหลัง: `TaskOutput` ถือเป็น deprecated ในการใช้งานนี้ เมื่อคุณเริ่ม task shell เบื้องหลัง ผลลัพธ์จะรวม path ไปยังไฟล์ output ของมันแล้ว — อ่าน path นั้นโดยตรงด้วย tool `Read` `Read` ให้การเข้าถึงแบบสุ่ม offset บรรทัด และมุมมองที่เสถียร; `TaskOutput` ไม่ให้
+- Agent ในเครื่อง (tool `Agent` ที่ dispatch ใน background): เมื่อ agent เสร็จ ผลลัพธ์ของ tool `Agent` จะมีการตอบสุดท้ายแล้ว ใช้สิ่งนั้นโดยตรง อย่า `Read` ไฟล์ transcript ที่ symlink — มันมี tool-call stream เต็มและจะ overflow context window
+- Session ระยะไกล: `TaskOutput` คือวิธีที่ถูกต้องและมักเป็นวิธีเดียวในการ stream output กลับ ชอบ `block: true` ด้วย `timeout` ที่พอเหมาะมากกว่าการ poll loop ที่แน่น
+- `task_id` ที่ไม่รู้จักหรือ task ที่ output ถูก garbage-collect จะคืน error Re-dispatch งานหากยังต้องการ
+- `TaskOutput` ไม่หยุด task ใช้ `TaskStop` เพื่อ terminate

package/concepts/th/Tool-TaskStop.md

@@ -1,32 +1,45 @@
 # TaskStop
 
-## คำจำกัดความ
+หยุด task เบื้องหลังที่กำลังรันอยู่ — คำสั่ง shell, agent ที่ถูก dispatch, หรือ session ระยะไกล — โดย runtime handle ใช้เพื่อคืน resource ยกเลิกงานที่ไม่มีประโยชน์แล้ว หรือกู้คืนเมื่อ task ค้าง
 
-หยุดงานเบื้องหลังที่กำลังทำงานอยู่
+## เมื่อใดควรใช้
+
+- คำสั่ง shell เบื้องหลังรันนานกว่าที่คาดและคุณไม่ต้องการผลลัพธ์อีกต่อไป
+- Agent ในเครื่องวนซ้ำหรือหยุดชะงักและต้องถูกตัดสั้น
+- ผู้ใช้เปลี่ยนทิศทางและงานเบื้องหลังสำหรับทิศทางก่อนหน้าควรถูกละทิ้ง
+- Session ระยะไกลกำลังจะ timeout หรือกำลังยึด resource ที่คุณต้องการ
+- คุณต้องการ slate ว่างก่อนเริ่มการรันใหม่ของ task เดียวกัน
+
+ชอบให้งานเบื้องหลังอายุสั้นทำเสร็จเอง `TaskStop` สำหรับกรณีที่การทำงานต่อไม่มีค่าหรือเป็นอันตราย
 
 ## พารามิเตอร์
 
-| พารามิเตอร์ | ประเภท | จำเป็น | คำอธิบาย |
-|------|------|------|------|
-| `task_id` | string | ไม่ | ID ของงานเบื้องหลังที่จะหยุด |
-| `shell_id` | string | ไม่ | เลิกใช้แล้ว ใช้ `task_id` แทน |
+- `task_id` (string, required): runtime handle ที่ส่งคืนเมื่อ task เบื้องหลังเริ่มต้น นี่คือตัวระบุเดียวกันที่ `TaskOutput` รับ ไม่ใช่ `taskId` ของ task-list
+
+## ตัวอย่าง
+
+### ตัวอย่างที่ 1
+
+หยุดคำสั่ง shell เบื้องหลังที่ไม่หยุด
+
+```
+TaskStop(task_id: "bash_01HXYZ...")
+```
 
-## สถานการณ์การใช้งาน
+คำสั่งได้รับ terminate signal; output ที่ buffer ไว้เขียนจนถึงขณะนี้ยังอ่านได้ที่ path output
 
-**เหมาะสำหรับ:**
-- ยุติงานที่ทำงานนานที่ไม่ต้องการอีกต่อไป
-- ยกเลิกงานเบื้องหลังที่เริ่มผิดพลาด
+### ตัวอย่างที่ 2
 
-## ข้อควรระวัง
+ยกเลิก agent ที่ถูก dispatch หลังการแก้ทิศทางของผู้ใช้
 
-- ส่งคืนสถานะสำเร็จหรือล้มเหลว
-- พารามิเตอร์ `shell_id` เลิกใช้แล้ว ควรใช้ `task_id`
+```
+TaskStop(task_id: "agent_01ABCD...")
+```
 
-## ข้อความต้นฉบับ
+## หมายเหตุ
 
-<textarea readonly>
-- Stops a running background task by its ID
-- Takes a task_id parameter identifying the task to stop
-- Returns a success or failure status
-- Use this tool when you need to terminate a long-running task
-</textarea>
+- `TaskStop` ขอการ terminate; ไม่รับประกันการ shutdown ทันที Task ที่ทำงานดีจะออกอย่างรวดเร็ว แต่ process ที่ทำ blocking I/O อาจใช้เวลาสักครู่ในการ unwind
+- การหยุด task ไม่ลบ output ของมัน สำหรับ task shell เบื้องหลัง ไฟล์ output บน disk จะถูกรักษาและยังอ่านได้ด้วย `Read` สำหรับ agent และ session output ใดก็ตามที่จับก่อนการหยุดยังเข้าถึงได้ผ่าน `TaskOutput`
+- `task_id` ที่ไม่รู้จักหรือ task ที่เสร็จแล้วจะคืน error หรือ no-op สิ่งนี้ปลอดภัย — คุณสามารถเรียก `TaskStop` แบบป้องกันโดยไม่ตรวจสอบสถานะก่อน
+- หากคุณตั้งใจจะ restart งานเดียวกัน ให้หยุด task เก่าก่อน dispatch ตัวใหม่เพื่อหลีกเลี่ยงการรันขนานสองตัวแข่งกันบน resource ร่วม (ไฟล์, port, database row)
+- `TaskStop` ไม่ส่งผลต่อ entry ใน task list ของทีม เพื่อยกเลิก task ที่ถูกติดตาม อัปเดตสถานะเป็น `deleted` ด้วย `TaskUpdate`