Changelog

New features, changes, and fixes in Puter.js and the Puter APIs, grouped by day, newest first.

View as Markdown RSS feed

November 2026

November 16, 2026

November 15, 2026

  • Fixedputer.workers.create() failing with a server error for a worker name longer than 50 characters, or when another user owns the worker's sandbox-<workerName> app. It rejects with bad_request or sandbox_not_owned instead.
  • Changedputer.workers.delete() to also delete the worker's sandbox-<workerName> app, unless another worker still runs as it. A worker you create later with the same name starts with empty key-value data and an empty AppData folder.

November 14, 2026

  • Changedputer.ai.chat() so a request that a Claude model declines runs again on an earlier Claude model, and later calls in the same conversation stay on the model that answered. To get the refusal instead, pass refusalFallback: false. See Refusal fallback.
  • Addedthe speed option to puter.ai.chat() for Claude models. Set it to "fast" for Fast mode or "standard" for standard inference. See Anthropic models.
  • AddedputerId to every model that puter.ai.listModels() returns. It holds the full <service>:<provider>/<model> name, which puter.ai.chat() accepts as model.
  • Changedthe mistral-large-latest, mistral-large, and mistralai/mistral-large-latest model names in puter.ai.chat() to point to Mistral Large 4 instead of Mistral Large 3.
  • Changedthe AI concurrent request limit so a chat request you stop keeps counting until the model finishes. Sending new requests right after stopping a few can hit the limit. See Rate Limits and Quotas.
  • Changedputer.ai.txt2img() on Replicate models to try again when the model's safety checker rejects the image and you didn't set a seed. Only the run that succeeds is charged. See Replicate models.
  • Fixedapps opened from the Puter desktop at desktop.puter.com not getting messages from the desktop. Their windows didn't close, and puter.ui.onWindowClose(), puter.ui.onItemsOpened(), and the localeChanged event of puter.ui.on() didn't fire.

November 13, 2026

  • Fixedputer.kv.set() failing with a server error when a value under the size limit takes more than 400 KB once stored. It rejects with value_too_large.
  • FixedURLs from puter.fs.getReadURL() sometimes failing right after the call resolved, and sending an invalid Content-Type for a file with no known extension, such as README.
  • Fixedputer.fs.write(), puter.fs.copy(), and puter.fs.move() replacing an item whose name differs from the new name only by accents or emoji, such as 😀.txt and 😁.txt. The call keeps the existing item and rejects, unless you set dedupeName: true.
  • Fixedputer.fs.write() not overwriting a file in place when the new name differs from the existing name only in letter case or Unicode normalization, such as notes.txt and Notes.txt.
  • Fixedputer.auth.getMonthlyUsage() and puter.auth.getDetailedAppUsage() resolving to the server's error body when the request failed. They reject with an error that has status and message.
  • Fixedputer.auth.signIn() on a cross-origin isolated page sometimes not finishing after the user signed in, and rejecting with auth_timeout.
  • Fixedapps opened on a file inside a folder shared with the user, such as a file from puter.ui.onLaunchedWithItems(), not being able to read or save that file.
  • Fixedputer.ui.showSaveFilePicker() with type: 'url' not saving the URL's contents. See Saving from a URL.
  • Fixedqueued events from puter.events.onPersistent() going to the events worker while a client with the handler function was still running them. A queued event goes only to clients that run its handler.
  • Changedthe Puter desktop to ignore a push permission your app got only through puter.notifications.enable() on your website. In Puter apps, requestPermission() and enablePush() show Puter's permission dialog for it, and status() resolves to 'off' until the user allows it there.

November 12, 2026

  • Addedthe failed array to the result of puter.fs.unshare(). It lists each recipient and item pair that was refused, with its message and code. When every pair is refused, the call rejects with { message, code, failed }, unless every refusal was user_does_not_exist or subject_does_not_exist.
  • Changedputer.ui.showColorPicker() in Puter apps to resolve to a lowercase 6-digit hex string, such as #ff0000, or to null if the user closes the picker. Before, it resolved to an 8-digit hex string with alpha, or to undefined. On websites, it also opens when the default color has alpha or isn't a valid hex color.
  • Removedthe themeChanged event of puter.ui.on(). It has no replacement, and a handler for it never runs.
  • Deprecatedthe show_in_taskbar option of puter.ui.createWindow(). It has no effect, because the Puter desktop doesn't have a taskbar anymore.

November 11, 2026

  • Changedputer.ai.speech2speech() to reject any model other than eleven_multilingual_sts_v2 or eleven_english_sts_v2 with a field_invalid error.

November 10, 2026

  • Fixeda file becoming unreadable when two puter.fs.write() calls created the same new file at the same time. The last write wins.

November 9, 2026

  • Addedthe serviceSpeed option to puter.ai.chat() to ask for "standard", "fast", or "ultrafast" service. Faster service can cost more, and usageDetails.serviceSpeed reports the speed that served the request. See Service speed.

November 7, 2026

  • Renamedputer.ai.convo() to puter.ai.realtime() (beta). It takes the same options, and the Convo* TypeScript types are now Realtime* types, such as RealtimeOptions. Calls to puter.ai.convo() throw, so switch them to puter.ai.realtime().

November 6, 2026

  • Changedputer.notifications.enable() on a website to show a Puter dialog when it isn't called from a click, or when the click has expired, such as after a sign-in window. The browser's prompt opens from the dialog's Continue button, and Cancel resolves to false. Before, the call rejected with user_gesture_required.

November 5, 2026

  • Addedputer.notifications.markShown() and puter.notifications.dismiss(), so the next notification with the same group creates a new one instead of replacing it. A dismissal also closes the notification on the user's other devices, and fires the dismiss event of puter.notifications.on().
  • Addedpriority: 'high' to puter.notifications.notify() for pushes that need to arrive right away, such as an incoming call.
  • AddedrequireInteraction and actions to what an onPush() handler can return, so a push can stay on screen and show buttons. The id of the pressed button reaches the click event of puter.notifications.on() as action.
  • Addedputer.events.updateSchedule() (beta) to change a schedule's timing or context, or a notification stored with sendAt, without changing its id.
  • Removednotifications shown by the page itself. A page of your website in the background no longer shows a notification from your onPush() handler. Puter pushes it to every browser where the user turned pushes on, unless a page of your app is visible and focused when it arrives. See When a notification is pushed.
  • Addedthe prompt_cache_options option to puter.ai.chat() for GPT-5.6 and later OpenAI models. It sets a 30 minute or 12 hour cache lifetime.
  • ChangedusageDetails from puter.ai.chat() on OpenAI models to report cache writes as cacheWrite30mTokens and cacheWrite12hTokens instead of cacheWrite5mTokens. See ChatResponse.
  • Changedthe default model of puter.ai.txt2img() from gpt-image-2 to gpt-image-2.6-flare. To keep the old model, pass model: 'gpt-image-2'.
  • Addedthe context_trimmed event to puter.ai.convo(). It fires after a reconnect when older items were left out of the restored context. Before, that case fired an error event with context_restore_failed.
  • Changedinterrupt() on a puter.ai.convo() conversation to return a promise that rejects with session_not_ready or session_closed instead of throwing when the conversation isn't ready. Also changed connect() to retry temporary setup failures before it rejects.
  • Fixedputer.ai.convo() ending the conversation when the server sent an event over 64 KiB, and its microphone capture stopping after a reconnect.
  • Changedthe Realtime WebSocket API to close with code 1011 and an internal_error when a server error stops Puter from checking your credential or plan, instead of invalid_api_key with code 1008. It closes with 1013 when the server is overloaded. Reconnect after 1011, 1012, or 1013.
  • Addedthe purpose=handover query parameter to the Realtime WebSocket API for opening a replacement connection while the current one still works.
  • Fixedinput transcription on the Realtime WebSocket API failing to turn on for users with little credit.

November 4, 2026

  • Addedinline handlers to puter.events.onSchedule() and puter.events.onPersistent() (beta). Pass your code as handler without a handlerName, and Puter publishes it in the signed-in user's own user scope.
  • Addedthe scope: 'user' option to puter.events.handlers, and the handlerScope option to onSchedule() and onPersistent(), so a user's session can publish named handlers in its own scope and bind to them.
  • Addedthe from option to puter.events.fetch() (beta). With from: 'end', a read without a cursor returns no items and a cursor at the newest notification, so later reads return only newer notifications.
  • AddedputerPush.savedHandlers() for the push service worker. Call it with false to run only the handlers registered in the worker, never the handler source your pages saved with onPush().
  • Fixedthe off() function from onPush() removing the saved handler while another tab still used it, and pages with a push handler being kept out of the browser's back/forward cache.
  • Fixedputer.notifications.enable() rejecting with push_subscription_conflict for a subscription Puter made earlier with an older key, and pushes stopping after the browser replaced its subscription.
  • Fixednotifications sent from a website that uses Puter.js naming the app by its uid. The notification's app.name is the site's hostname.

November 3, 2026

  • Addedschedules to the Events API (beta). A handler can run at an interval, on a cron expression, or once at a set time, even while your app is closed. Create one with puter.events.onSchedule(), and manage them with listSchedules(), getSchedule(), and removeSchedule().
  • Addedthe sendAt option to puter.notifications.notify() to send a notification at a set time, and puter.notifications.cancel() to cancel it before it goes out. With a sendAt more than 5 seconds ahead, notify() resolves to { scheduleId, sendAt } instead of a notification uid.
  • Changedputer.auth.signOut() to return a Promise. On a website, it also ends this browser's push subscription for your app, and so does a different user signing in.
  • Fixedputer.notifications.disable() ending a push subscription that another service, such as Firebase, made on your site. Only the subscription Puter made is removed.
  • Fixedputer.notifications.onPush() opening the Puter sign-in window when it renewed the subscription on page load, and other tabs subscribing again after disable() ran in one tab.
  • Fixedtaps on push notifications on a website. A tap opens one page, once, and a tap without a URL opens your site's root, or your service worker's folder when your pages are inside it.
  • Fixedputer.ui.showFontPicker() in Puter apps ignoring the default font, and failing when given a font name as a string.

November 2, 2026

  • Changedputer.notifications.status() on a website to check this browser's subscription with Puter. It resolves to 'off' after the user removes this browser or turns your app off in Puter's settings, and page loads don't turn pushes back on in that browser until your page calls enable().
  • Fixedthree Workers router responses. A 404 for an unmatched path or method has the CORS header, a fetch() response returned by a handler is sent instead of becoming a 500, and a Puter.js error thrown in a handler comes back as JSON in the 500 body.
  • Fixedputer.kv writes rejecting some values over MAX_VALUE_SIZE with bad_request. Every value over the limit rejects with value_too_large.

October 2026

October 31, 2026

  • Addedthe fallback option to puter.ai.chat(). Pass false to get the first provider's error, instead of having Puter retry the request on another provider that serves the same model.
  • Changedhow puter.ai.convo() reconnects. It keeps trying for about a minute, restores up to 40 recent conversation items, and moves to a new session before a planned server restart.
  • Addedthe puter.reconnect event to the Realtime WebSocket API. Puter sends it before the server a session runs on restarts, so your client can move to a new connection first.
  • Changedrealtime sessions to refuse conversation.item.retrieve events and MCP tools with an invalid_event error and a 1008 close.
  • Changedputer.notifications.notify() so a notification reaches only the app that sent it. The Puter desktop's notifications panel doesn't show it.
  • Changedthe group option of notify() to replace the newest notification your app sent the user in that group, unless that one was shown or dismissed. The replacement keeps the same uid, and onNotification() gets it again with replaced: true. A group can be up to 128 characters and contain @.
  • Addedputer.notifications.status(), which tells you whether your app's pushes reach the user's current browser, without prompting the user.
  • Addedthe notify option to puter.kv.share() and the to option to notify(), so the owner and the holder of a share can send each other notifications. The kv.share.received notification only goes out for shares made with notify: true.
  • Addedthe 'pushNotifications' resource to puter.perms.request(), so you can ask for push permission in the same prompt as other access.
  • Changedputer.notifications.enable() on a website to resolve once the browser has subscribed, without waiting for the confirmation push.
  • Changedenable() and enablePush() in Puter apps to show Puter's permission dialog when your app doesn't have push permission yet. In Puter apps, disable() removes your app's push permission.
  • Changeda 'kvShare' request in puter.perms.request() to ask for 'read' access when access is left out, the same default as puter.kv.share().
  • Addeda rate limit on calls through share handles into one user's data for one app. Calls over it reject with too_many_requests. See Rate Limits and Quotas.
  • Changedputer.kv.share() so a call that changes nothing for any recipient doesn't count toward the share limits. Your app can call it each time it opens to get the handle back.
  • Changedputer.events.onLocal() subscriptions through a share handle to end with subscription_ended when the share stops. Key-value events through a watch share leave out the value, even with includeValue.
  • Addedputer.events.update() (beta) to change a persistent subscription's context without ending it. The subscription keeps its subId and the events it hasn't delivered yet.
  • Changedthe events worker to retry a handler run that fails because of Puter, such as a 5xx error, without counting it toward the failures that suspend a subscription.
  • Addedapp_uid and app_name to the WorkerDeployment object from puter.workers.create(), and app_name to the WorkerInfo object. They name the app the worker runs as.
  • AddeddnsProvider and redirectFrom to the CustomDomain object. When a root domain's DNS is on Route 53 or GoDaddy, the domain is added as its www. hostname, and an A record with the purpose redirect forwards the root domain to it.

October 30, 2026

  • Addedputer.ai.convo() (beta) for realtime voice and text conversations with OpenAI's realtime models. It has helpers for the microphone, playback, and interruptions, and needs a paid Puter plan.
  • Addedthe Realtime WebSocket API (beta) to use the same realtime models through Puter without Puter.js.
  • Changedputer.notifications.notify() to push a notification only when no open page of your app answers within 5 seconds that it's visible and focused, or that it shows the notification itself. See When a notification is pushed.
  • Changedpush opt-in on websites to stay off until your page turns it on. On page loads, onPush() keeps a browser subscribed only after enable(), and stops after disable(), after the user turns your app off in Puter, or after puter.auth.signOut().
  • Addedthe push_worker_conflict, push_subscription_conflict, push_subscribe_failed, and user_gesture_required errors to puter.notifications.enable(), and the invalid_handler error to onPush().
  • Changedthe push service worker script to load from https://js.puter.com/push-sw.js. The old https://js.puter.com/v2/push-sw.js URL still works.
  • Fixedputer.auth.signIn(), puter.perms.request(), and other calls that open a Puter popup showing nothing when the browser blocked the popup, such as in Safari and iPhone Home Screen web apps. They show a Continue dialog instead.

October 29, 2026

October 28, 2026

  • Addedthe queue option to puter.events.onPersistent() (beta) in place of delivery: 'single', which still works. Subscriptions report queue instead of delivery and targets.
  • ChangedonPersistent() subscriptions without queue to run the handler in your app's events worker and also send each event to every connected client. Before, each event went to only one of the two. The targets option is ignored.
  • Changedqueued deliveries to drop the event when the handler throws, instead of retrying it. Temporary errors and errors thrown with retry: true are still retried, and a connected client has 15 seconds to answer before the events worker takes the event. See What happens when a handler fails.
  • Fixedputer.net.Socket sending writes made right after it connects out of order, and treating an open listener that throws as a failed connection.
  • Changedputer.ai.speech2txt() on OpenAI models to ignore response_format and stream in extra_body. Set response_format as a top-level option instead.

October 27, 2026

October 26, 2026

  • Addedsharing with up to 50 users in one puter.kv.share() call (beta). Pass an array of recipients, and the call resolves to one result per recipient.
  • Addedthe appUid option to puter.kv.listShared() and puter.kv.listSharedByMe(), and the state option to listSharedByMe() to list only live or only stopped shares. Stopped shares are kept for 30 days.
  • Changedwatch shares so the holder can list keys, without their values, with puter.kv.list().
  • ChangedKimi K3 in puter.ai.chat() to report the prompt tokens written to its cache as cache_write_tokens in usage, separate from prompt_tokens.
  • Fixedputer.ai.chat() encoding a tool call's arguments twice when you sent an assistant message with tool_calls back to a model served through an OpenAI-compatible API.

October 25, 2026

  • Addedkey-value sharing (beta). A user can share the keys under a prefix with another Puter user at watch, read, or write access with puter.kv.share(), and the other user passes the share's handle to the puter.kv methods. Manage shares with unshare(), listShared(), and listSharedByMe().
  • Addedthe onlyIfAbsent option to puter.kv.set(). It writes the key only when the key has no live entry, and resolves to false otherwise.
  • Addedthe 'fs', 'backgroundEvents', and 'kvShare' resources to puter.perms.request() and puter.perms.check(), with the puter.perms.Resource, puter.perms.Access, and puter.perms.Folder constants. The 'permission' resource and raw permission strings are deprecated.
  • Fixedputer.perms.check() returning false for a file inside a folder your app already has access to, which made puter.perms.request() prompt again.
  • Addedthe viaWorker field to filesystem and key-value events. It's true when server-side code running as the account, such as a worker, made the change.

October 23, 2026

  • FixedPuter.js calls made with an expired session rejecting with Unauthorized even after the user signed in again. Puter.js retries the call once with the new session.

October 22, 2026

  • Changedhow a stopped puter.ai.chat() stream is billed. Once the request reaches the model, the model finishes its response and the whole response is billed, even if you break out of the stream or abort it with an AbortSignal.
  • Fixedputer.workers.delete() removing the worker when Puter couldn't take its script down, and rejecting when the script was already gone. A call that fails keeps the worker, so you can call it again.

October 21, 2026

  • Fixedputer.fs.read() ignoring the offset and byte_count options. Without byte_count, the read goes from offset to the end of the file.
  • Fixedputer.auth.signIn() calls made at the same time sharing one sign-in window. Each call opens its own window and completes from it.

October 20, 2026

  • Addedthe inputVideo option to puter.ai.txt2vid() to edit a video you supply, with the prompt describing the change. See Video input.
  • AddedBlob, File, and Puter file paths as image inputs to puter.ai.txt2img() and puter.ai.txt2vid(). Puter.js uploads a Blob, a File, or a data: URI over 1 MiB to a temporary file in the user's storage for the length of the call.
  • FixedisDir being false for a folder your app is opened with, in the FSItem objects that puter.ui.onLaunchedWithItems() passes to your handler.

October 19, 2026

  • FixedGemini text-to-speech in puter.ai.txt2speech() failing on audio longer than about 65 seconds.
  • FixedgetAuthToken() in Node.js leaving its local sign-in server running after the user signed in. The call rejects when it can't open the browser.

October 17, 2026