Load persistent Note or Collection by ID or name, with optional slice
target: Note/Collection ID (e.g., Note_123), name (e.g., "my-note"), or variableout: Variable nameslice (optional): Python-style slice string controlling how much content to returnREQUIREMENTS:
Note_123) or name ("my-note")NOT SUPPORTED:
| Target type | Units | Default | Ceiling |
|---|---|---|---|
| Note | characters | "0:4096" | 4096 chars (default only) |
| Collection |
| items |
"0:5" |
| 16 items (default only) |
When slice is explicit (e.g. ":" for full, "0:10000"), no ceiling — full requested range is returned. Syntax follows Python slice notation: "start:stop", ":stop", "start:", ":" (all, no limit).
Validation: Rejects only when both start and stop are non-negative and stop < start. Standard Python semantics supported, including negative indices.
Examples:
slice: ":" — full content (no limit)slice: "0:1000" — first 1000 chars of a Noteslice: "1500:2000" — chars 1500–2000 of a Noteslice: "-500:" — last 500 chars (Python semantics)slice: "0:10" — first 10 items of a CollectionChunked processing pattern (for large Notes):
load(target=$doc, slice="0:500", out=$chunk1) → process $chunk1
load(target=$doc, slice="500:1000", out=$chunk2) → process $chunk2
load(target=$doc, slice="1500:2000", out=$chunk3) → process $chunk3
Notes: Returns the sliced text content with character count metadata. To read content in code blocks, use get_text("$var") on the bound variable rather than parsing the return value.
Collections: The out binding is a new Collection containing the sliced items. The planner-visible value is a content preview showing each item's Note ID and first 200 chars.
Returns failed when:
Empty content ≠ error — null Notes return content, not failure.
load returns Note/Collection content, not the resource itselfout binds a new Collection (real resource), value string is a preview❌ map(load) on search-web results → Results already materialized Notes
❌ load(target=$collection) → Load individual Notes/Collections, not from Collection
❌ Expecting domain output → Returns prefixed Note/Collection content
❌ Omitting slice when you need full content → Use slice: ":" to get up to ceiling