from features.base import Behaviour, FeatureDetails, Line
from features.command_tags.reading import RUNS
from features.settings import Setting
from features.trigger import MINUTES, Trigger
from features.groups import Group


class CommandTagsDetails(FeatureDetails):
    explains = 'The agent can place action tags in its messages and the journal carries out the matching action. You can see the resulting items in the viewer.'
    name = "command_tags"
    group = Group.AGENT
    label = "Run commands from tags"
    position = 5
    hint = "When the agent writes a tag such as [!reply:12], the journal runs the matching command: here, reply to message 12"
    skill_of = "messages"
    when = "you open a turn with a tag such as [!reply:N], or a tag you wrote was refused"

    title = "Commands from tags"

    aliases = ("tags",)

    speaks_while_waiting = True

    abstract = """
        When the agent writes a tag such as [!reply:12], the journal runs the matching command:
        here, reply to message 12.
    """

    help = """
        A message without a tag is a plain message in the chat.

        [!await] <what you wait for> runs journal work await with the rest of the turn and keeps
        it out of the chat, which already shows what the work waits on: use it instead of a
        work await command followed by a note. [!await on=("<id>", "helper:<n>")] <what> names
        the runs, subagents or helpers it waits on, so it stands until they are back.

        tags.runs maps a tag to the matching command, so [!reply:12] runs
        journal message reply 12 with the turn as its text ([!reply:12,13] answers both messages with one reply), and [!todo="the title"] files a
        to-do with that title and the turn as its brief. [!fact="the claim"] and [!rule="the ruling"]
        file a fact or a rule the same way.

        The first word names the target; named arguments follow it in any order, as in
        [!rule="the ruling", keywords=("git", "branch")], and reach the command as --set.

        A tag runs once, keyed to the turn it came from; two tags in one turn run in the order
        they appear; and a refusal comes back as a nudge on the next turn rather than at the
        moment of acting.

        Running a command a tag stands for, such as journal message reply, shows you its tag
        once in a while, with the reminder that a tag runs only when it opens the last text of
        your turn.
    """

    settings = [
        Setting(
            name="runs",
            default=dict(RUNS),
            title="What each tag runs",
            abstract="A tag's name and the journal command it runs; your entries add to the built-in ones.",
            runs_commands=True,
        ),
    ]

    behaviours = [
        Behaviour(
            name="hint",
            title="Remind the agent which tag runs which command",
            trigger=Trigger(every=30, unit=MINUTES),
        ),
    ]

    lines = [
        Line(
            name="hint",
            title="the {{tag}} tag does this in one step",
            brief="{{hint}}; it runs only when it opens the last text of your turn",
        ),
        Line(
            name="refused",
            title="the {{tag}} tag on {{on}} did not run",
            brief="{{error}} - add what is missing to the tag itself",
        ),
    ]