Repository navigation
v0.0.45
Upgrade notes
- This is a breaking change for models that use an image model Amazon Bedrock no longer serves (item 1). Before you upgrade, check the provider and the
paintModelIdof each model on thenova-canvasorpainterprovider in the admin console. No migration changes these models. - Stacks with AutoUpdate pull the new image automatically (items 1 and 2). Before users rely on the new
painter, check thatlocalLlmModelcan see images (Claude Sonnet is recommended), and checkprice_per_imageandimage_prices(item 2). Apainterconfig without a price is now billed at the built-in list prices. regionsno longer applies topainter; remove it from the model config (item 2). If BRConnector runs outside us-east-1, us-east-2 and us-west-2, uploaded pictures and prompts go to us-west-2.lambda-webstacks serve BRClient at/brclient/once the package is rebuilt from aSourceRefthat includes item 3. WhenSourceRefis a branch, changeWebFnBuildId(for example from1to2) to rebuild. The package build now downloads the BRClient source from GitHub and its dependencies from the npm registry, and builds BRClient, so the build takes a few minutes longer (item 3).- The Claude Code Web backend image gets item 5 only when it is rebuilt. To rebuild it, change
ClaudeCodeWebImageBuildId(for example from1to2). See Claude Code Web. - Release the templates and the BRConnector image together as 0.0.45, the image first or at the same time. A new
lambdaorlambda-webstack with a generated password (PGPasswordempty) needs the 0.0.45 BRConnector to read it (item 7); with an older image orSourceRefit cannot reach its database. Stacks with a password are not affected. - Updating a stack to the new
quick-build-brconnector.yamlorbrconnector-ecs-fargate.yamlasks forPGStorageEncrypted(item 6). Choosefalsefor a stack created from an earlier template:truereplaces its database with a new, empty one. On later updates, keep the value the stack has. Keep the currentPGPassword(with the AWS CLI,UsePreviousValue=true; without it, the update generates a new password). The existing database keeps its data and its password and stays unencrypted, and the update turns on its deletion protection. See Template updates of existing stacks.
-
End-of-life Image Models Removed - Amazon Bedrock no longer serves Amazon Nova Canvas (
amazon.nova-canvas-v1:0), Amazon Titan Image Generator (amazon.titan-image-generator-v1,amazon.titan-image-generator-v2:0), Stability SDXL (stability.stable-diffusion-xl-v0,stability.stable-diffusion-xl-v1),stability.sd3-large-v1:0andstability.stable-image-ultra-v1:0, so BRConnector no longer supports them.- The
nova-canvasprovider is removed. A request to a model on it gets HTTP 400 that points topainter. The model stays in the database for you to change or delete. To keep drawing, create apaintermodel with one of the models below. paintersupportsstability.stable-image-ultra-v1:1,stability.stable-image-core-v1:1andstability.sd3-5-large-v1:0. Amazon Bedrock serves them only in us-west-2, andpaintercalls that Region by itself. See painter.- A
paintermodel whosepaintModelIdis not a Stability model now answers with an error that lists the three models, and does not call Bedrock. Apaintermodel on a retired Stability model still fails at Bedrock. - To fix a
paintermodel, set itspaintModelIdto one of the three models.
- The
-
painter Image to Image - Users can upload up to 5 pictures (10 MB each; JPEG, PNG or WebP) in BRClient with one sentence. The chat model chooses one of eight Stability capabilities: text to image, image to image, search and replace, remove background, style guide, style transfer, control structure and control sketch. See painter.
- One request can run up to 5 steps. Each step's picture streams back as soon as it is made, with a line that names the capability, the model and the input pictures. Later messages can refer to earlier pictures.
- Each picture is billed at the price of the model that made it. The new
image_pricesfield sets a price for each model ID. Without a price, painter uses the built-in list prices. - Non-stream requests do not draw. They go to the chat model as before.
- painter replies in the language of the user's latest message, also when earlier messages use another language.
- Breaking:
localLlmModelmust now support function calling and see images. - Use Claude Sonnet as
localLlmModel. The configuration example now usesclaude-sonnet-5-5-chat. In tests, Amazon Nova Pro ran extra billed steps the user did not ask for and showed its<thinking>text in the reply. See Choosing the chat model. - Breaking:
regionsno longer applies topainter. Ultra, Core and SD3.5 Large run in us-west-2. The sixus.stability.*image services run in the host Region when it is us-east-1, us-east-2 or us-west-2, and in us-west-2 otherwise. Outside those three Regions, pictures and prompts are sent to us-west-2, so do not usepainterif you have data-residency requirements. The role needsbedrock:InvokeModelin the target Region, and an SCP that limitsaws:RequestedRegionblocks calls to us-west-2. - Breaking: a config with no price is now billed at the built-in list prices, not at 0. A config with
price_per_imagekeeps that one price for every capability untilimage_pricesis set. - Breaking: presigned picture URLs now last up to 4 hours instead of 1. A URL signed with temporary credentials stops working when the credentials expire, so older pictures can stop loading sooner.
- Uploaded pictures are stored in
<s3Prefix>/uploads/<date>/. BRConnector sets no lifecycle rule, so pictures stay until you delete them. - Fix: a non-stream answer from a
bedrock-conversemodel now keeps every tool call, in order. It kept only the last one before. - Fix: when Bedrock returns
AccessDeniedException, the reply now quotes the message from Bedrock. It also says if the AWS Marketplace subscription for the model is not complete, or else names the Region where the role needsbedrock:InvokeModel. Before, every denial got the IAM hint. The log now records each denial, without the prompt or the pictures. See IAM permissions. - Fix: a
painterstream now ends with a chunk that has afinish_reasonbefore[DONE]:lengthat the 5-step limit,content_filterwhen the image model filtered the prompt or a picture, andstopotherwise. Before, every chunk hadfinish_reason: null, so a client that checks it could not tell that the reply was complete.
-
BRClient Built from Source - The images and the
lambda-webpackage now build BRClient from the upstream source, at the commits thatscripts/brclient.sourcepins. See BRClient source.- The
lambda-webpackage now serves BRClient at/brclient/. Before,/brclient/returned 404 onlambda-web. - This release pins upstream
mainplus the unmerged upstream pull request #82. A message with pictures gets a Download button that saves its pictures. A picture that the browser cannot save opens in a new tab, and an expired picture link shows a message. - Each artifact contains
brclient/.source, which names the commits and the git tree it was built from. - Before each release, run
node scripts/resolve-brclient.mjsand commitscripts/brclient.source. After upstream merges the pull request, the same command pinsmainonly. See Before a release.
- The
-
Model Lists for Keys Without a Group - A key that is not in a group now lists only the models bound to it in
GET /v1/models,/user/model/list,/user/model/list-for-brclientand the Claude Code Web (/cc) model menu. Before, these lists also showed the models of every group, and a call to one of those models was refused. A key in a group still lists its group's models and its own. The admin key, which cannot call these models, now gets an empty list from/user/model/list-for-brclient. -
Dependency Updates - Dependencies with known vulnerabilities move to fixed releases.
- The Claude Code Web backend image installs litellm 1.100.4, cryptography 46.0.7, anyio 4.14.2, certifi 2026.10.18, fsspec 2026.6.0, mcp 1.28.1, pyasn1 0.6.5 and urllib3 2.8.0. litellm 1.100.4 needs a newer boto3, so the AWS CLI in the workspace terminal also moves from 1.44.38 to 1.46.3.
- cryptography and starlette keep known vulnerabilities that only a later major release fixes. They stay on their current major releases for now.
- The BRConnector image does not change. Each build installs the newest releases that
package.jsonallows, and these already include the fixes. The lockfile that the tests use now has these fixes too. zod stays on 3.25.76 in both, because its fix is only in zod 4. - The Claude Code Web web client is built with rollup 4.68.2 instead of 4.52.5.
-
RDS Database Settings in the Templates - The RDS database that
quick-build-brconnector.yamlandbrconnector-ecs-fargate.yamlcreate (DatabaseModeStandalone) has new settings.PGPasswordcan be left empty. The stack then generates the database password into AWS Secrets Manager (thePGPasswordSecretArnoutput), and BRConnector reads it from there. A stack created with a password keeps it. An entered password is 8 to 128 letters and digits.- The new
PGStorageEncryptedparameter encrypts the storage of the database. It has no default: choosetruefor a new stack. On an update, keep the current value, which isfalsefor a stack created from an earlier template. - The database has deletion protection. To delete a stack, turn it off first. See Deleting a stack, which also shows how to delete the final snapshot that CloudFormation keeps.
- When a stack update replaces the database, CloudFormation now keeps the old one: as a snapshot, or, while its deletion protection is on, as a running database outside the stack. Before, it deleted the old database without a snapshot.
- In
brconnector-ecs-fargate.yaml,PGUseris NoEcho and has no default. - The templates list the outbound rules of each security group (all IPv4 and IPv6 traffic, as before) and set the database to not publicly accessible (as before).
-
Database Password from Secrets Manager - When
PGSQL_PASSWORD_SECRET_ARNis set, BRConnector reads the database password from that Secrets Manager secret instead ofPGSQL_PASSWORD. The templates set it forlambdaandlambda-webwhen they generate the password (item 6). See Development. -
Docs - A GPT-6 Sol example and a note on
reasoning_effortfor GPT reasoning models with tools in bedrock-runtime-openai. The left sidebar shows the full navigation tree.
Changelog in Chinese: 更新日志