Skip to content

Releases

v0.13.0

Choose a tag to compare

@github-actions github-actions released this 09 Nov 18:52
v0.13.0
3e7acf5

Changed

  • Requires Python 3.15 or newer; scripts embedded in Substance applications retain Python 3.11 compatibility.
  • Use MCP Core for application discovery, tool responses, schemas, and subprocess execution.

Fixed

  • Match Designer input bounds to native property types and set graph resolutions with absolute inheritance.
  • Declare Designer resource status fields and reject undeclared tool arguments.
  • Start Painter in the background when requested.

v0.12.0

Choose a tag to compare

@github-actions github-actions released this 04 Nov 07:18
v0.12.0
b42c6df

Added

  • Shared precision-preserving texture readers, original storage descriptors and PNG16 writing for material handoffs.
  • Canonical pure response-schema helpers for independent MCP adapters.

v0.9.0

Choose a tag to compare

@github-actions github-actions released this 03 Nov 00:21
v0.9.0
5bbef8a

Added

  • Declared response fields for all Painter, Designer and Sampler tools.
  • Action-specific response validation that preserves existing wire shapes and extra details.
  • Report output conversion failures as uncertain outcomes without suggesting a retry.

v0.8.1

Choose a tag to compare

@github-actions github-actions released this 02 Nov 23:09
v0.8.1
d26accd

Fixed

  • Report unknown tool names as rejected requests with a tool-discovery recovery hint.

v0.8.0

Choose a tag to compare

@github-actions github-actions released this 02 Nov 22:12
v0.8.0
4bd12e7

Added

  • Declared status responses for Painter, Designer and Sampler, plus ownership, texture export and bake results.
  • Structured failure codes, outcome and recovery hints alongside readable MCP errors.

Changed

  • Omit redundant discovery schema titles without changing validation constraints.

v0.7.1

Choose a tag to compare

@github-actions github-actions released this 01 Nov 03:15
v0.7.1
b736934

Fixed

  • A process that only names an application's binary as an argument, such as Adobe's IPC
    broker (-launchedbyvulcan <executable>), no longer counts as that application running;
    a binary must be the process's first argument.

v0.7.0

Choose a tag to compare

@github-actions github-actions released this 01 Nov 01:57
v0.7.0
5e45513

Added

  • MIT LICENSE.
  • Governance files: SECURITY.md (private vulnerability reporting and scope), CONTRIBUTING.md,
    .pr-gates (the commands CI runs), issue forms, a pull request template and a Dependabot
    configuration for uv, npm and GitHub Actions.
  • Trademark and non-affiliation notice in the README.
  • Versioned documentation for cavi-ai.xyz in docs/substance-mcp/source; the release workflow
    builds, verifies and attaches it to each GitHub release, and the README links to it instead of
    repeating it.
  • CI on Linux, macOS and Windows across Python 3.11-3.13 with pinned actions, a lowest-dependency
    leg, CodeQL, a package smoke test (npm run verify:package), a tag-driven release workflow
    with PyPI trusted publishing, and a nightly upgrade and vulnerability canary. Install with
    uv tool install cavi-substance-mcp.
  • Windows support for Designer and Sampler: default install paths under Program Files
    (%ProgramFiles% is honoured), tasklist to see whether an application is running,
    taskkill /T /F to end a timed-out tool and everything it started, and read-only files are
    cleared when a failed output is removed. The fake Designer and Sampler programs install as
    .cmd launchers on Windows, so the tests can run there. The Windows CI leg stays
    experimental until it has run green on a real runner.
  • Designer and Sampler executables are also found on PATH, after an environment override
    and the platform's default install location.
  • CAVI_SAMPLER_SCRIPT_PATH overrides the startup-scripts folder sampler_status reports.
  • An import-closure test proves the code that runs inside Painter and Sampler imports only the
    standard library and, for Sampler, no host-side module.

Changed

  • Requires the MCP Python SDK 2.3 or later. The servers use its MCPServer and re-raise
    anticipated failures (invalid arguments, refused paths, an unavailable or busy
    application) as tool errors, so their messages still reach the client; other exceptions
    are reported without their details.
  • Pillow requires 13.0 or later; the locked 12.3.0 had known vulnerabilities fixed in 13.0.0.
  • Package metadata: readme, MIT license expression and license file, authors, keywords,
    classifiers, project URLs and a description naming all three applications. The build
    requires hatchling>=1.27.
  • The source distribution contains only src/, tests/, evals/, examples/, the README,
    LICENSE, CHANGELOG.md and pyproject.toml.
  • Ruff checks the E, F, I, B, UP and SIM rule sets, including the 100-character line
    limit (E501).
  • .gitignore covers local plans, worktrees, editor state, logs, build output and Substance
    .ssa and .spt files.
  • Receipt verification is its own command, cavi-substance-receipts verify and chain
    (module cavi_substance_mcp.receipts_cli), shared by all three servers. It replaces
    cavi-substance-mcp receipts ..., which is removed; the arguments, output and exit codes
    are unchanged. npm run verify:package runs it from the installed wheel.
  • The Painter server lives in the cavi_substance_mcp.painter subpackage, like Designer and
    Sampler: server, client, runtime and cli moved there under the same names, and
    painter_operations is now painter.operations. cavi-substance-mcp runs
    cavi_substance_mcp.painter.server:main, and the module to run with python -m is
    cavi_substance_mcp.painter.server. The old import paths are gone; there are no aliases.

Changed (breaking)

  • The default workspace is ~/Documents/SubstanceMCP; set CAVI_SUBSTANCE_WORKSPACE to keep
    using a previous folder. Only the default is created on
    demand. A workspace named by CAVI_SUBSTANCE_WORKSPACE must already exist, and a missing one
    is refused with a message instead of being created. Read-only calls never create it; a Sampler
    call does, because it holds its lock file there.
  • SAMPLER_SCRIPT_PATH is read as CAVI_SAMPLER_SCRIPT_PATH for the scripts folder that
    sampler_status reports, with no alias. The variable each launch sets for the Sampler it
    starts is still Adobe's own SAMPLER_SCRIPT_PATH.
  • The deprecated Designer sampler tool is removed, and designer_status no longer has a
    sampler entry. Use cavi-substance-sampler-mcp.
  • designer_status no longer lists sbsupdater, which no operation uses.
  • Painter no longer adopts edit-lease state left by lease versions that were never released
    (_cavi_mcp_lease_v2 and the unversioned attribute).
  • Painter: bake gains action="cancel". Deleting a node whose subtree holds layers this
    lease did not create requires confirm_name. layer_edit times out after 120 seconds.
  • Sampler: sampler_build defaults to dry_run=true. sampler_asset action="delete"
    requires confirm=true, and sampler_asset and sampler_layer are annotated
    destructive. sampler_inspect action="project" requires project. sampler_export
    rejects target with a non-image format instead of switching it to PNG. Creating an
    asset whose name already exists is refused.
  • Receipts: inputs supplied by an application, such as a Designer built-in template, are
    recorded as schema 2 app-resource rows (name, SHA-256 and tool version) instead of
    absolute paths. Receipts without such inputs stay schema 1, and both schemas are read.
    Recording a missing file or a path outside the workspace is an error.
  • Sampler job manifests are standard receipts: workspace-relative paths only, per-export
    receipts listed as outputs, and atomic writes. The top-level app_name, workspace and
    app.executable fields are gone.

Fixed

  • Sampler refuses a resource that changed while it was imported instead of reporting it
    verified.
  • Batch preflight reports a step that names a duplicated asset as ambiguous.
  • Channel packing quantizes each plane straight into the output image and frees sources
    after their last use, and refuses packs that would decode more than 2 GiB.
  • Painter accepts schema 2 receipts as source_manifest and refuses to record a missing
    output; it now uses the shared receipts module instead of its own drifted copy.
  • A Designer or Sampler program whose grandchild kept its output pipe open held the call until
    the timeout and then reported a timeout for a run that had already finished. A call now ends
    when the process exits.
  • Designer output that exceeds the limit is no longer silently shortened: a cut sbsrender
    report is an error and error messages say when output was dropped.
  • A timed-out Designer tool is asked to stop (SIGTERM) before it is killed, like Sampler.
  • runtime start refuses to launch when it cannot tell whether Painter is already running.
  • serverInfo.version reports the package version instead of the MCP SDK version.
  • Painter tool calls run off the event loop and are serialized, so a long call no longer
    blocks other requests, and a request cancelled while queued is never sent.
  • A lost bake end event no longer blocks every later Painter call.
  • .sbsar imports use the bytes that were hashed.
  • wait_ready requires that Painter is not baking and no mesh reload is pending.
  • Failed exports and save_copy calls remove the directory they created.
  • Non-ASCII lease ids, enum non-members as blend_mode, non-boolean dry_run values and
    duplicate names on rename are rejected.
  • Painter transport errors and HTTP 5xx responses are reported as unavailable, and each
    request has a wall-clock deadline.
  • Sampler batch exports work for asset names that are not already directory-safe.
  • The --version probe of a Designer or Sampler program waits at most 5 s instead of 20 s, and a
    Sampler launch counts it against the call's timeout instead of adding to it.
  • Receipts, batch job files and Painter's source_manifest larger than 8 MiB are refused with
    a message instead of being read whole.
  • When a failed Designer or Sampler operation cannot remove the output directory it created,
    the error names what is left.
  • A cancelled batch job releases the workspace lock and removes its directory.
  • Every Sampler launch takes the workspace lock.
  • Single Sampler operations edit a copy of the project and replace it only on success.
  • A non-zero Sampler exit fails the call.
  • Target exports wait for every expected map to be complete, with no file changing size for one
    second, before hashing; a pause in Sampler's flush no longer records a partial file.
  • Job validation applies the runtime's naming rules before Sampler launches.
  • A job whose input changes while it runs fails.
  • A batch job saves its project before an export when it has unsaved changes, so each export
    receipt records the project it was exported from and a new project's first export no longer
    fails on a missing .ssa.
  • The Painter simulator in evals/ accepts only the two expressions the client sends and no
    longer evaluates request text.