Skip to content

docs(agent): document processing limits #22

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
nkavian merged 1 commit into from
Sep 15, 2026
Merged

docs(agent): document processing limits #22

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
7 changes: 6 additions & 1 deletion odp-agent/README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -138,6 +138,10 @@ documents into the returned schema, and validates full Offering attributes. `$dy
to fragment references such as `#node`. An unavailable, unsupported, or non-matching schema removes
only the uninterpretable attributes and produces a scoped issue; the Offering remains usable.

Attribute Schema processing is limited to 256 KiB per document, 16 documents, eight reference
levels, and one MiB for the complete graph. Each Attribute Schema request has a 30-second timeout
and accepts at most 16 JSON nesting levels. These are fixed SDK safety ceilings.

Actions are normalized to absolute compact HTTP or OpenAPI targets. Resolve the supporting document
for one explicitly selected Action without invoking it:

Expand All @@ -152,7 +156,8 @@ if (action.requestSchema() != null) {
```

Compact HTTP request schemas follow the same bounded resolution rules as Attribute Schemas. OpenAPI
targets require a JSON OpenAPI 3.1 document containing exactly one matching `operationId`.
targets require a JSON OpenAPI 3.1 document containing exactly one matching `operationId`; each
OpenAPI document is limited to one MiB and 32 JSON nesting levels.

## Continue a response

Expand Down