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. |
|
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.
pWe 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")).
- not
f_okReturn f. - not
c_okReturn c. - not
n_okReturn 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)).