Files
marqdo/ext/ai/context.mq.md

4.7 KiB

markup, title, description, import
markup title description import
occlusion AI context — short, explicit source scopes Pack user input and caller-provided file/class/function excerpts.
agent plugin json
ext/ai/agent.mq.md lib/plugin.mq.md lib/json.mq.md

Pass only the documentation that the next model decision needs. The supplied file/class/function snippets are data; they do not execute as Marqdo source. A future compiler-backed selector can supply these arguments from AST spans. This helper does not yet infer class/function scopes automatically.

pack

参数 类型 默认 说明
user text required Latest user input
file text "" File-level description excerpt
class text "" Current class excerpt
function text "" Current function excerpt
budget_tokens number 2048 Small-model context budget
返回 类型 说明
result map Bounded ContextPackV2 and compaction evidence

Use user, file="", class="", function="", budget_tokens=2048 as the inputs for this operation.

Keep the latest request and current function first. Low-priority file context may be dropped under pressure; any important constraint must be in a retained field, not in a discardable tool transcript.

items =

@ origin trust priority text retain
1 user user 0 user True
2 function unknown 1 function True
3 class unknown 2 class False
4 file unknown 3 file False

Return [Pack the supplied scopes and compact redundant context](agent.context_pack_compact(items=items, budget_tokens=budget_tokens, goal=user)).

scope

参数 类型 默认 说明
scope text "function" file / class / function / tool
class text None Class heading for disambiguation
function text None Function/tool heading
source text None Source override; otherwise current entry module
max_chars number 1600 Maximum Unicode characters
返回 类型 说明
result map Exact source excerpt, line range, or explicit ambiguity

Use scope="function", class=None, function=None, source=None, max_chars=1600 as the inputs for this operation.

The native selector respects Markdown headings and ignores fenced-code heading lookalikes. Repeated function names require a class; missing/ambiguous scopes return an error value, never an unrelated or whole-file fallback.

We retain p = Locate native agent plugin.

  1. p We Load native agent plugin.

Return No native parser available.

Return [Project the requested document scope](agent_context_scope(source=source, scope=scope, class=class, function=function, max_chars=max_chars)).

compose

参数 类型 默认 说明
user text required Latest user input
class text required Current class name
function text required Current function name
source text None Override current entry source
budget_tokens number 2048 Small-model context budget
返回 类型 说明
result map ContextPackV2 or an explicit failed selector

Use user, class, function, source=None, budget_tokens=2048 as the inputs for this operation.

Project file, class and function scopes independently. Refuse ambiguous names rather than silently importing an unrelated class or the entire source. The latest user input stays in the retained portion of the resulting context pack.

We retain f = [Select file preface](scope(scope="file", source=source, max_chars=500)). We retain c = [Select current class](scope(scope="class", class=class, source=source, max_chars=800)). We retain n = [Select current function](scope(scope="function", class=class, function=function, source=source, max_chars=1500)). We retain f_ok = [Check file selection](json.get(value=f, key="ok")). We retain c_ok = [Check class selection](json.get(value=c, key="ok")). We retain n_ok = [Check function selection](json.get(value=n, key="ok")).

  1. not f_ok Return f.
  2. not c_ok Return c.
  3. not n_ok Return n.

We retain ft = [Read file preface](json.get(value=f, key="text")). We retain ct = [Read class explanation](json.get(value=c, key="text")). We retain nt = [Read function explanation](json.get(value=n, key="text")). Return [Compact only the selected scopes](pack(user=user, file=ft, class=ct, function=nt, budget_tokens=budget_tokens)).