SIA/procedures/user_communication/procedure.md

User Communication

Prerequisites

• User information is stored in the /user directory
• Tasks and their progress are documented in the /tasks directory

Flow

flowchart TD
    Start([Start])
    LoadUserBasic[The /user/basic.md file should contain info to identify and address the user properly<br>Also load the last 10 messages from /user/conversation_history/ ]
    PrepareForDraft{Have everything needed for drafting a message?}
    DraftMessage[Draft message in reasoning entry]
    ReadInput[Read input from standard input]
    ReasonCleanContext[List id's of entries that are no longer needed<br>Explain for each entry why it is no longer needed]
    DeleteEntries[Remove the entries that are no longer needed<br>End by deleting the ReasonCleanContext entry]
    AddHistoryUser[Add the message to the /user/conversation_history/ directory<br>The filename is the id of the stdin entry with .user extension]
    LoadTask[Look for the task in the /tasks directory and load relevant files]
    LoadUserDetails[Look in the /user directory for relevant files]
    EstimateScript[Draft the script in a reasoning block and estimate its runtime and output length]
    ScriptAcceptable{Does the draft script make sense and are the estimations short enough to not hinder the conversation?}
    RunScript[Run the script, make sure to set appropriate timeout and output limits]
    ReviewDraft{Is the message well structured and free of logical errors?}
    SendMessage[Send the message using standard output]
    AddHistoryAgent[Add the message to the /user/conversation_history/ directory<br>The filename is the id of the stdout entry with .agent extension]
    ReasonResponse[Is the conversation ongoing?<br>How long is the user expected to take to respond?]
    NeedAwaitResponse{Is it likely to get a response within a minute?}
    BusyWait[Wait 1 second for the first busy wait, double the time each iteration until a response is received<br>Make sure to set the timout]

    End([Clean the context])

    Start --> LoadUserBasic
    LoadUserBasic --> PrepareForDraft

    PrepareForDraft -->|Got all needed info| DraftMessage
    PrepareForDraft -->|Getting the required info would slow the conversation| DraftMessage
    PrepareForDraft -->|Input available on stdin| ReadInput
    PrepareForDraft -->|Context usage more than 50%| ReasonCleanContext
    PrepareForDraft -->|Task mentioned but not loaded| LoadTask
    PrepareForDraft -->|Personal or social info mentioned but not loaded| LoadUserDetails
    PrepareForDraft -->|Calculations, system info or other numerical values that can be scripted are mentioned| EstimateScript

    ReasonCleanContext --> DeleteEntries
    DeleteEntries --> PrepareForDraft

    ReadInput --> AddHistoryUser
    AddHistoryUser --> PrepareForDraft

    LoadTask --> PrepareForDraft
    LoadUserDetails --> PrepareForDraft

    EstimateScript --> ScriptAcceptable
    ScriptAcceptable -->|Acceptable| RunScript
    ScriptAcceptable -->|Not acceptable| PrepareForDraft
    RunScript --> PrepareForDraft
    
    DraftMessage --> ReviewDraft{Is this really what I want to say?}
    ReviewDraft -->|Rewrite better| DraftMessage
    ReviewDraft -->|Good message| SendMessage
    
    SendMessage --> AddHistoryAgent
    AddHistoryAgent --> ReasonResponse
    ReasonResponse --> NeedAwaitResponse
    
    NeedAwaitResponse -->|Quick response is unlikely| End
    NeedAwaitResponse -->|Input available on stdin| PrepareForDraft
    NeedAwaitResponse -->|Quick response is likely| BusyWait
    BusyWait --> NeedAwaitResponse