# वर्कलॉग API
SUMMARY: एजेंट टीमों के लिए प्रति-कार्य append-only वर्कलॉग — हर कदम दस्तावेजित करें ताकि कुछ भी खोए नहीं; कार्य, एजेंट, प्रकार और समय से क्वेरी करने योग्य।

KEY CONTEXT:
Auth: Mind Key (or user JWT). All endpoints mind-scoped via the caller's mind/user.
Push (1 call): GET /worklog/push?task_id=T&kind=progress&content=...&agent=Janus&title=...
Create/open a task worklog: POST /worklog { task_id, title? }  (content? -> appends first entry)
Append entry: POST /worklog/:task_id { kind, content, agent?, title? }  (GET variant: /worklog/:task_id/append)
Read: GET /worklog/:task_id?format=json|md|text
Recent across tasks: GET /worklog?limit=50&since=<epoch sec>&task_id=
List tasks: GET /worklog/list?status=active|completed|all&limit=20
Close: POST /worklog/:task_id/close  (GET variant exists)
Delete: DELETE /worklog/:task_id  (GET variant exists)
kinds: start | progress | note | error | summary | close (unknown -> note)
Limits: content max 256 KB per entry; agent max 128 chars; task_id [a-zA-Z0-9._/-] max 256.
Fleet rule (Michael #8882/#10509): POST /worklog at EVERY milestone — fix commit, verdict, escalation, handover, takeover, CRITICAL — not only at session end.
UUID task_ids: append/create/close 404 (task_not_found) देता है जब UUID का कोई Synapse कार्य (agent_tasks) मौजूद न हो। फ्री-फॉर्म स्लग अब भी स्वतंत्र रूप से बनाए जा सकते हैं। (v1.39.46)

वर्कलॉग API
वर्कलॉग फ्लीट के कार्य-इतिहास का एकमात्र प्रमाण-स्रोत है। यह append-only, प्रति-कार्य और क्वेरी-योग्य है। जहाँ  वह संग्रहित करता है जो एजेंट जानता है, वर्कलॉग संग्रहित करता है जो एजेंट ने किया — प्रत्येक कार्य के लिए एक टिकाऊ, ऑडिट-योग्य निशान के रूप में। माइकल का स्थायी नियम (#8882, #10509 में पुनःपुष्ट): पुश-फर्स्ट — हर मील का पत्थर एक एंट्री पाता है, ताकि क्रैश हुई सेशन अपनी कहानी कभी न खोए और कोई भी सिबलिंग ठीक वहीं से आगे बढ़े जहाँ आप रुके थे।
अवधारणाएँ
| शब्द | अर्थ |
| --- | --- |
| टास्क वर्कलॉग | एक नामित लॉग जो स्वतंत्र  से पहचाना जाता है (आपकी पसंद: UUID-प्रीफिक्स, टिकट या टिकट-जैसा स्लग)। |
| एंट्री | एक append-only रिकॉर्ड: , , , वैकल्पिक , टाइमस्टैम्प। |
| स्थिति |  (खुला) →  (बंद) या ।  से सेट होता है। |
एंडपॉइंट
सभी एंडपॉइंट प्रमाणित हैं (Mind Key या यूज़र JWT) और कॉलर के माइंड तक सीमित — दूसरों के माइंड के वर्कलॉग आपको कभी नहीं दिखेंगे।
पुश — एक-कॉल पैटर्न
सबसे सुविधाजनक एंडपॉइंट; एक एंट्री जोड़ता है और गायब होने पर टास्क रिकॉर्ड बनाता है:
[CODE BLOCK]
वर्कलॉग बनाएँ / खोलें
[CODE BLOCK]
 फ़ील्ड के साथ पहली एंट्री उसी कॉल में जुड़ जाती है (रिस्पॉन्स ), अन्यथा खाली टास्क बनता है (रिस्पॉन्स )। GET-वेरिएंट: ।
एंट्री जोड़ें
[CODE BLOCK]
एंट्री-प्रकार (अज्ञात मान  के रूप में संग्रहित होते हैं):
| kind | कब उपयोग करें |
| --- | --- |
|  | टास्क क्लेम किया, काम शुरू |
|  | मील का पत्थर: कमिट, MR, वर्डिक्ट, टेस्ट-परिणाम |
|  | संदर्भ, निर्णय, अवलोकन |
|  | विफलताएँ जिनमें आपने क्या प्रयास किया वह भी (आपका भविष्य-रूप धन्यवाद देगा) |
|  | संदर्भ-हस्तांतरण से पहले फेज़/सेशन-सारांश |
|  | अंतिम परिणाम; स्थिति-बदलाव के लिए  एंडपॉइंट बेहतर |
सीमाएँ:  प्रति एंट्री 256 KB तक,  128 वर्ण तक।
पढ़ें
[CODE BLOCK]
 (डिफ़ॉल्ट) टास्क-रिकॉर्ड + एंट्री संरचित डेटा के रूप में देता है,  मानव-पठनीय मार्कडाउन ट्रांसक्रिप्ट देता है,  सादा टेक्स्ट।
टास्कों के बीच हाल की गतिविधि
[CODE BLOCK]
वैकल्पिक  फ़िल्टर।  एपॉक सेकंड टाइमस्टैम्प है।
टास्क सूची
[CODE BLOCK]
बंद करें (और हटाएँ)
[CODE BLOCK]
दोनों के GET-वेरिएंट हैं (, ) open-tool LLM क्लाइंट्स के लिए। बंद करने पर लॉग सुरक्षित रहता है — हटाना ही एकमात्र विनाशकारी ऑपरेशन है।
एजेंटों के लिए अनुशंसित लय
1.  — टास्क क्लेम करते समय  एंट्री (क्लेम-प्रमाण)।
2.  — हर मील के पत्थर पर  एंट्री — कमिट-SHA, MR-नंबर, वर्डिक्ट, पाइपलाइन-स्थिति। पुश-फर्स्ट (माइकल #8882): सेशन-अंत तक इकट्ठा न करें।
3.  — हर योग्य विफलता के लिए  एंट्री, फिक्स के साथ।
4.  — संदर्भ समाप्त होने से पहले  — अगला रन state-स्क्रिप्ट + वर्कलॉग से फिर शुरू करता है।
5.  — कार्य पूरा होने पर  (प्रमाण अंतिम एंट्री में)।
पूरे-फ्लीट टास्क-परंपरा () इसी API पर आधारित है; एजेंट-गाइड एजेंटों के लिए वर्कलॉग में कॉपी-पेस्ट प्रॉम्प्ट-ब्लॉक है ताकि कोई एजेंट इस फ़ीचर को "भूले" नहीं (माइकल #10509)।
taskid नियम (v1.39.46)
पूर्ण UUID प्रारूप वाली  को हर लेखन पथ पर
(, , ,
) एक मौजूदा Synapse कार्य
() का संदर्भ देना होगा — अन्यथा एंडपॉइंट संकेत सहित
 देता है। इससे hallucinated या truncated
UUID अब चुपचाप अनाथ worklog कार्य नहीं बनाते। गैर-UUID स्वतंत्र id
(, ,  जैसे प्रीफिक्स
स्लग) अब भी स्वतंत्र रूप से बनाए जा सकते हैं (MEGA-1A डिज़ाइन)। पढ़ने और
हटाने के पथ अपरिवर्तित हैं — वे कभी कुछ नहीं बनाते।