Repository navigation
v0.25.0 — Studio AI
Pentool v0.25.0
Optional image generation and editing in Studio, plus the accumulated internal
0.24.2 bug fixes. No new document fields or dependencies.
Studio AI
- Connect and validate providers using credential references; browser forms never
receive an API key. Provider settings require the collaboration owner role. - Review requests offline, then explicitly confirm provider, model, host, call
count, prompt hash and source hashes before contacting a paid model. - Generate images, preview candidates, accept into the selected layer, replace a
selected image, or discard a run. Runs survive reloads and remain bounded to 16. - Accept with revision guards and source/lock checks using the CLI transaction
engine. Each acceptance is one undoable document-history step. Selected accepted
images show their provider/model provenance in the AI panel. - Gemini image variations and background removal; local magenta key-out is offline.
- Cancel between provider calls and before storing candidates. A request already
sent may still be billed and finishes or times out before the worker exits. PENTOOL_AI=offdisables operations and hides the AI entry points.
Bug fixes
Rendering and export
- Parent-page artwork now renders. Items inherited from parent pages previously appeared in
parent resolvebut were missing from PNG, SVG, PDF, and Studio previews. They now render beneath the page's own layers, respecting overrides, detached items, and hidden parent layers. - Hidden objects stay hidden in exports (#396). In v4 documents, nodes marked
visible: falseand descendants of hidden groups are now excluded from PNG, SVG, and PDF output. Layer visibility already worked. - Spot-only composite previews keep their CMYK destination (#397).
color separate --compositenow retains the configured or explicit CMYK output destination, so spot colors render over process paper correctly.
Editing and document safety
- Spread facing can be switched on and off.
spread <doc> facing <spread> true|falsenow parses the positional value correctly; it was previously treated as a flag. - Negative geometry values work directly (#394). Positional numbers for
layer-geometrytranslate, rotate, scale, transform, hit, move-anchor, and set-handle accept negative values without requiring a--separator. - Batch edits reject invalid paints instead of silently losing them.
put-shapeno longer drops non-string fill/stroke values, andput-pathrejects paint objects with neitherfallbacknorref. Invalid requests fail with an explanation and leave the document unchanged. Gradient styles use{"fallback": {...}}.
Server, extensions, and provider setup
- Server startup errors are accurate (#160).
servechecks that the document exists before binding and does not announce that it is listening after a failure. A busy port reports[conflict]with a--porthint. - Unreadable resources get consistent diagnostics (#207).
importandextension add/runreport[missing-resource]for unreadable input files. - Extensions validate inputs before execution (#205, #206).
extension runrejects an unknown--pagewith[missing-resource]and non-object--argswith[invalid-input]before running the module. - Pasted API keys are rejected safely (#357).
ai connect --credential-envaccepts an environment-variable name, not the key itself. Invalid values returninvalid-credential-env, save nothing, and never echo the supplied value.
CLI help corrections
layout-grid guide-remove --helpexplains that a guide ID and--pageare mutually exclusive (#169).layout-grid step-repeat --helpdocuments the count range of 1–1000 (#388).raster select-load --helplists the accepted selection modes (#380).shape --helplists the required geometry for each shape kind (#399).benchmark --helpdocuments its layer and object ranges (#350).
These include the fixes tracked internally as 0.24.2; that version was not published separately.
Limitations
Masked inpaint/outpaint and spending budgets remain deferred. Model availability,
pricing and support depend on the configured provider. CPU rendering remains
normative. Placed native table rendering remains a known gap.
Validation
- Three-platform CI, Studio tests, browser core and binary budgets.
- Local verification: 1,731 Rust tests and 49 Studio tests; optimized CLI discovery and PNG/SVG/PDF exports; mock-provider Studio AI and spot-only composite smoke checks; live browser accept/undo and AI-disabled checks.
- Release archives verified against SHA-256 checksums before publication.