ڎj&dZddlmZddlmZmZddlmZddlm Z dd l m Z dd l m Z dd lmZmZGd d eZGddeZdS)zThe task updated tool class.)Literal) BaseModelField) _TaskToolBase) ToolChunk) AgentState)DeveloperOrientedException) TextBlockToolResultStateceZdZUdZedZeed<eddZedzed<edd Z edzed <edd Z e edzed <edd Z e ddzed<eddZe edzed<eddZedzed<eddZedzed<dS)_TaskUpdateParamszThe params of the update task.z The task id.) descriptiontask_idNzNew subject for the task)defaultrsubjectzNew description for the taskrzTask IDs that this task blocks add_blockszNew status for the task)pending in_progress completeddeletedstatuszTask IDs that block this taskadd_blocked_byzNew owner for the taskownerzEMetadata keys to merge into the task. Set a key to null to delete it.metadata)__name__ __module__ __qualname____doc__rrstr__annotations__rrrlistrrrrrdictPC:\Projects\DSCons\.venv\Lib\site-packages\agentscope\tool\_task\_update_task.pyrrs((5^444GS444%.GS4Z$e2Kt$)54$$$JS D u-  G    (-u3(((NDI$,E3:"E*HdTkr'rceZdZUdZdZeed<dZeed<e Z e ed< dde ded edzdedzd e edzd ed dzd e edzdedzde dzdefdZededede ddfdZdS) TaskUpdatez"The tool to update the agent task.nameulUse this tool to update a task in the task list. ## When to Use This Tool **Mark tasks as resolved:** - When you have completed the work described in a task - When a task is no longer needed or has been superseded - IMPORTANT: Always mark your assigned tasks as resolved when you finish them - After resolving, call TaskList to find your next task - ONLY mark a task as completed when you have FULLY accomplished it - If you encounter errors, blockers, or cannot finish, keep the task as in_progress - When blocked, create a new task describing what needs to be resolved - Never mark a task as completed if: - Tests are failing - Implementation is partial - You encountered unresolved errors - You couldn't find necessary files or dependencies **Delete tasks:** - When a task is no longer relevant or was created in error - Setting status to `deleted` permanently removes the task **Update task details:** - When requirements change or become clearer - When establishing dependencies between tasks ## Fields You Can Update - **status**: The task status (see Status Workflow below) - **subject**: Change the task title (imperative form, e.g., "Run tests") - **description**: Change the task description - **owner**: Change the task owner (agent name) - **metadata**: Merge metadata keys into the task (set a key to null to delete it) - **add_blocks**: Mark tasks that cannot start until this one completes - **add_blocked_by**: Mark tasks that must complete before this one can start ## Status Workflow Status progresses: `pending` → `in_progress` → `completed` Use `deleted` to permanently remove a task. ## Staleness Make sure to read a task's latest state using `TaskGet` before updating it. ## Examples Mark task as in progress when starting work: ```json {"task_id": "1", "status": "in_progress"} ``` Mark task as completed after finishing work: ```json {"task_id": "1", "status": "completed"} ``` Delete a task: ```json {"task_id": "1", "status": "deleted"} ``` Claim a task by setting owner: ```json {"task_id": "1", "owner": "my-name"} ``` Set up task dependencies: ```json {"task_id": "2", "add_blocked_by": ["1"]} ```r input_schemaN _agent_staterrrr)rrrrrrrreturnc (Kt|tstd|jd|dd} t |jjD]\} } | j|kr| } | .ttd|dgtj Sg} |r,| d ||jj| _ |,| d ||jj| _d |jjD|rY|jj| jfd |D}|r1| d |D]}|||||Y|jj| jfd|D}|r1| d|D]}|||||r|dkr|jj| |jjD]H} || jvr| j||| jvr| j|Ittd|dgS| d||jj| _|,| d||jj| _| rw| d| D]M\}}|,|jj| j|d3||jj| j|<N| rd|dd| d}nd|d}|jj| jdkr|dz }tt|gS)zUpdate the agent task.zError: z) requires AgentState to be provided, got z instead.Nz TaskNotFoundError: The task (id=z) does not exist.)text)contentstaterrcg|] }|j Sr&)id).0_s r( z#TaskUpdate.call..sFFFqtFFFr'c$g|] }|v|v | Sr&r&)r5r6current_blocks existed_idss r(r7z#TaskUpdate.call..s8N**qK/?/?/?/?/?r'rc$g|] }|v|v | Sr&r&)r5r6current_blocked_byr:s r(r7z#TaskUpdate.call..s9...1 3C3C3C3C3Cr'rrz Task (id=z) has been deleted.)r1rrrzUpdate task (id=z) z, .z%No updates were made to the task (id=zR). Make sure you provided at least one field to update and the values are correct.rzj Task completed. Call TaskList now to find your next available task or see if your work unblocked others.) isinstancer r r+ enumerate tasks_contexttasksr4r r rERRORappendrrblocks_update_block_relation blocked_bypopremover2ritemsrjoin)selfr-rrrrrrrrindexitaskupdated_fields new_blocksblock_idnew_blocked_by blocked_by_idkvresr<r9r:s @@@r(callzTaskUpdate.calls, 33 ,+$)+++++   !;!ABB  GAtw'!! =C(/CCC &+   F  ! !) , , ,>EL & ,U 3 ;  "  ! !- 0 0 0BML & ,U 3 ?FF\%?%EFFF  )7=eDKN#J  %%l333 *H// $  %!-!;!A" 'N  %%&6777%3M//%$  C""*044U;;;(6<88D$+-- **7333$/11..w777 !!IW!I!I!I  ! !( + + +>L$>>> #"&'++/ $F8F8 F8F8t F8 4Z F8 I$ F8HI F8S D(F8TzF8+F8 F8F8F8F8P111!1  111\111r'r*N)r!typingrpydanticrr_task_tool_baser _responser r2r exceptionr messager rrr*r&r'r(ras""%%%%%%%%******!!!!!!33333311111111%%%%% %%%Po1o1o1o1o1o1o1o1o1o1r'