Load

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 Note
• slice: "1500:2000" — chars 1500–2000 of a Note
• slice: "-500:" — last 500 chars (Python semantics)
• slice: "0:10" — first 10 items of a Collection

Chunked 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

OUTPUT

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.

FAILURE SEMANTICS

Returns failed when:

• Resource not found
• Invalid resource ID/name
• Missing parameters
• Invalid slice: both start and stop non-negative and stop<start

Empty content ≠ error — null Notes return content, not failure.

REPRESENTATION INVARIANTS

• load returns Note/Collection content, not the resource itself
• Prefix distinguishes content from domain-specific output
• For Collections, out binds a new Collection (real resource), value string is a preview
• search-web/semantic-scholar return Collections directly — NO load needed

ANTI-PATTERNS

❌ 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