Skip to content

v0.25.0 — Studio AI

Choose a tag to compare

@github-actions github-actions released this 22 Oct 07:29
· 98 commits to main since this release

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=off disables 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 resolve but 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: false and 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 --composite now 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|false now parses the positional value correctly; it was previously treated as a flag.
  • Negative geometry values work directly (#394). Positional numbers for layer-geometry translate, 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-shape no longer drops non-string fill/stroke values, and put-path rejects paint objects with neither fallback nor ref. 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). serve checks that the document exists before binding and does not announce that it is listening after a failure. A busy port reports [conflict] with a --port hint.
  • Unreadable resources get consistent diagnostics (#207). import and extension add/run report [missing-resource] for unreadable input files.
  • Extensions validate inputs before execution (#205, #206). extension run rejects an unknown --page with [missing-resource] and non-object --args with [invalid-input] before running the module.
  • Pasted API keys are rejected safely (#357). ai connect --credential-env accepts an environment-variable name, not the key itself. Invalid values return invalid-credential-env, save nothing, and never echo the supplied value.

CLI help corrections

  • layout-grid guide-remove --help explains that a guide ID and --page are mutually exclusive (#169).
  • layout-grid step-repeat --help documents the count range of 1–1000 (#388).
  • raster select-load --help lists the accepted selection modes (#380).
  • shape --help lists the required geometry for each shape kind (#399).
  • benchmark --help documents 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.