Skip to content

DeepTutor: Lifelong Personalized Tutoring. https://deeptutor.info/.

4.1 KB
Raw Blame
"""Objective intent gate for chat-native Partner profile authoring."""

from __future__ import annotations

import re

from deeptutor.core.context import UnifiedContext

PARTNER_AUTHORING_CAPABILITY_NAME = "partner_authoring"

# The action has to lead into the Partner object within one clause. Matching the two words
# anywhere in the message fired on turns that only mention a Partner ("I want to file an issue
# about the Partner bug"), and finish_instruction then forces a draft the user never asked for.
_ZH_ACTION = (
    r"(?:创建|新建|生成|设计|定制|帮我做|帮我建|做一个|来一个|来个|加一个"
    r"|(?:想要|需要)(?:一个|一位|个|位))"
)
_ZH_OBJECT = r"(?:partner|伙伴|学习搭子|陪伴者|陪练|助教|导师|教练|学伴|智能体|角色)"
# Stops at clause punctuation and at words that make the object a topic rather than the target.
_ZH_GAP = r"(?:(?!关于|有关|提到|讨论)[^。!?!?;;,,、\n]){0,16}?"
_EN_ACTION = (
    r"(?:\b(?:create|make|build|design|generate|add|set\s+up)\b(?:\s+(?:me|us))?"
    r"|\b(?:want|need)\b)"
)
_EN_DETERMINER = r"\s+(?:a|an|another|one|my\s+own|our\s+own|a\s+new|new)\b"
_EN_GAP = r"(?:\s+(?!(?:about|with|for|of|from|in|on|to|that|which)\b)[\w'-]+){0,3}?"
_EN_OBJECT = (
    r"\s+(?:partners?|companions?|tutors?|mentors?|coach(?:es)?|study\s+budd(?:y|ies))(?![\w-])"
)

_AUTHORING_REQUEST = re.compile(
    rf"{_ZH_ACTION}{_ZH_GAP}{_ZH_OBJECT}|{_EN_ACTION}{_EN_DETERMINER}{_EN_GAP}{_EN_OBJECT}",
    re.IGNORECASE,
)
_QUOTED_OR_CODE = re.compile(
    r"```[\s\S]*?```|~~~[\s\S]*?~~~"
    r"|(?m:^>[^\n]*)|`[^`\n]*`"
    r'|"[^"\n]*"|“[^”\n]*”|「[^」\n]*」|『[^』\n]*』'
    r"|(?<!\w)'[^'\n]+'(?!\w)"
)
_CLAUSE_END = re.compile(r"[。!?!?;;,,\n]")
_NEGATED_ACTION = re.compile(
    r"(?:\b(?:don't|do\s+not|never|not|can't|cannot)\s*(?:want|need)?(?:\s+(?:you\s+)?to)?\s*"
    r"|(?:不|别|不要|不用|无需|不必|不想(?:让你)?|不需要)\s*)$",
    re.IGNORECASE,
)
_MENTION_QUESTION = re.compile(
    r"^\s*(?:(?:explain\s+)?(?:why|how|what)\b|(?:请)?(?:解释)?(?:为什么|为何|怎么|如何))",
    re.IGNORECASE,
)
_NON_PARTNER_TARGET = re.compile(
    r"^\s+(?:issue|bug|report|checklist|style|tone|feature|setting|ticket)\b"
    r"|^(?:功能|问题|报告|文档|风格|语气|清单|按钮|页面)",
    re.IGNORECASE,
)


def partner_authoring_trigger(context: UnifiedContext) -> str | None:
    """Why this turn is in the authoring flow, or ``None`` when it is not.

    ``explicit`` means the user selected the capability; ``heuristic`` means only
    the keyword gate matched, which is a guess about the words they typed.
    """
    # Home/product Chat owns the review card and confirmation flow. A Partner
    # (including one running inside a Group) must not create drafts inside its
    # synthetic workspace merely because someone talks about another Partner.
    if context.metadata.get("source") == "partner":
        return None
    if context.active_capability == PARTNER_AUTHORING_CAPABILITY_NAME:
        return "explicit"
    text = str(context.user_message or "")
    quoted = [match.span() for match in _QUOTED_OR_CODE.finditer(text)]
    for match in _AUTHORING_REQUEST.finditer(text):
        # Mentioning a request inside a quotation or code sample is not an
        # instruction. The action may still be outside quotes around a name.
        if any(start <= match.start() and match.end() <= end for start, end in quoted):
            continue
        clause_start = max(
            (boundary.end() for boundary in _CLAUSE_END.finditer(text, 0, match.start())),
            default=0,
        )
        if _NEGATED_ACTION.search(text[clause_start : match.start()]):
            continue
        if _MENTION_QUESTION.search(text[clause_start : match.start()]):
            continue
        if _NON_PARTNER_TARGET.match(text[match.end() :]):
            continue
        return "heuristic"
    return None


def is_partner_authoring_turn(context: UnifiedContext) -> bool:
    return partner_authoring_trigger(context) is not None


__all__ = [
    "PARTNER_AUTHORING_CAPABILITY_NAME",
    "is_partner_authoring_turn",
    "partner_authoring_trigger",
]