Skip to content

docs(#3996): describe portable generated media and Gemini output limits - #4030

Open
aheritier wants to merge 3 commits into
generated-image-inline-tuifrom
generated-media-docs
Open

docs(#3996): describe portable generated media and Gemini output limits#4030
aheritier wants to merge 3 commits into
generated-image-inline-tuifrom
generated-media-docs

Conversation

@aheritier

@aheritier aheritier commented Aug 22, 2026

Copy link
Copy Markdown
Collaborator

What and why

Align model, Google-provider, session, TUI, and example references with catalogue/override eligibility, ordinary-request guards, safe workspace-only naming, portable session blobs, no-resend history, and no generated-media size cap. Document the phrase-warning blind spots and exactly-one-image filename fallback. Database compatibility prose is caution-only: migrations happen in place, older binaries may not understand the upgraded schema, and compatibility tests use isolated disposable stores. It provides no operational database procedure.

Part of #3996. Review this PR against its immediate parent, #4029, rather than the aggregate stack against main.

Commit inventory

Head: 4b04a89084ac6ea9d35630b3e1111ee73ceeb18a; parent SHA: 950d801ff3a2eb4ee5aaf56265bf6fe8faa54110.

  • 0df48c0b85490c0b3bb430e3bdff187d6b75acf5 — docs: explain the workspace artifact lifecycle
  • 4c0d297f5df9410a1f3222264d790c4814400f17 — docs: describe generated-image requests and workspace-only saves
  • 4b04a89084ac6ea9d35630b3e1111ee73ceeb18a — docs: clarify uncapped generated-media storage and resolution

Validation

Build, test compilation, owning-package tests and the named fixture passed at this PR head.

Exact deterministic fixture command:

go test -v -count=1 ./pkg/modelinfo ./pkg/model/provider/gemini ./pkg/runtime -run 'TestResolveOutputImage|TestCheckImageOutputRequestCompatibility|TestExtractExplicitOutputFilename|TestResolveGeneratedFile_PortableBlobWinsOverWorkspace|TestResolveGeneratedFile_LegacyManifestRoundTripsLargeWorkspaceFile|TestImageGenerationTextOnlyWarning'

Matched top-level tests: pkg/model/provider/gemini: 2; pkg/modelinfo: 1; pkg/runtime: 4.

Deterministic scope: the named local fixture exercises this PR boundary with disposable configuration/stores and fake or loopback providers as applicable. Every listed package ran nonzero matching top-level tests.

Deferred/live scope: Markdown lint and canonical-front-matter checks passed. Live provider and active-database checks were not run. The final stack head passed build, lint, full tests, an uncached full suite, focused race tests and documentation checks in disposable environments. Remote CI is tracked by the checks below; no new paid-provider or active-database validation was run.

@aheritier aheritier added area/docs Documentation changes kind/docs Documentation-only changes labels Aug 22, 2026
rumpl
rumpl previously requested changes Aug 24, 2026
Comment thread docs/features/sessions/index.md Outdated
aheritier

This comment was marked as resolved.

@aheritier
aheritier force-pushed the generated-media-docs branch 2 times, most recently from 7bf4821 to 6edff56 Compare September 6, 2026 16:16
@aheritier
aheritier force-pushed the generated-media-docs branch from 6edff56 to 2a33362 Compare September 7, 2026 11:19
@aheritier
aheritier force-pushed the generated-media-docs branch 2 times, most recently from 20caea4 to e54ff19 Compare September 7, 2026 16:13
@aheritier
aheritier force-pushed the generated-media-docs branch from 468f9cd to 48cef72 Compare September 8, 2026 17:31
@aheritier
aheritier force-pushed the generated-media-docs branch from 48cef72 to 4b04a89 Compare September 8, 2026 20:37
@aheritier aheritier changed the title docs(#3996): document verified generated-image behavior docs(#3996): describe portable generated media and Gemini output limits Sep 8, 2026
@aheritier
aheritier marked this pull request as ready for review September 8, 2026 20:39
@aheritier
aheritier requested a review from a team as a code owner September 8, 2026 20:39
@aheritier
aheritier requested a review from rumpl September 8, 2026 20:45
@dgageot
dgageot force-pushed the generated-media-docs branch from 4b04a89 to 8e68f8b Compare September 9, 2026 07:41
dgageot
dgageot previously approved these changes Sep 9, 2026
@aheritier
aheritier force-pushed the generated-media-docs branch from 8e68f8b to 7e7fc95 Compare September 9, 2026 11:56
@dgageot
dgageot force-pushed the generated-media-docs branch from 7e7fc95 to 84758cf Compare September 9, 2026 12:15
@aheritier
aheritier force-pushed the generated-media-docs branch from 84758cf to cb106d3 Compare September 9, 2026 12:56
@aheritier
aheritier force-pushed the generated-media-docs branch from cb106d3 to 71863af Compare September 9, 2026 13:32
@aheritier
aheritier force-pushed the generated-media-docs branch from 71863af to 6472397 Compare September 9, 2026 14:07
stack merge was automatically disabled September 9, 2026 14:31

Pull Request is not mergeable

stack merge was automatically disabled September 9, 2026 15:20

Pull Request is not mergeable

Describe owning-workspace saves, sanitized redirects, manifest-gated references, portable session copies, no-resend history and inline fallbacks. Keep optional validation isolated from active session databases and distinguish deterministic coverage from deferred live Vertex validation.
Document catalog defaults, explicit capability overrides, TEXT+IMAGE requests, workspace-only redirection, provider-controlled formats, normal ACP completion and inline fallback labels. Vertex live image validation remains deferred.
Generated media has no application-level byte cap in portable session storage or authorized file resolution. Ordinary attachment limits are unchanged.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area/docs Documentation changes kind/docs Documentation-only changes

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants