# New Features ## Headless Browser Fetch The fetch method now simulates requests as if made from a headless browser, providing more accurate web interactions and cookie handling. ## Request / Response Enhancements Added a new handleRedirect property to Request and RequestInit for controlling redirect behavior. The old shouldAllowRedirect property has been deprecated. Added a new cookies property to Response, allowing access to cookies returned in the response. ## Background Networking Introduced new APIs for running download and upload tasks in the background: - BackgroundURLSession - URLSessionDownloadTask - URLSessionUploadTask ## BackgroundKeeper Added BackgroundKeeper to request background runtime access, enabling tasks to continue running while the app is in the background. ## AVPlayer Metadata Access Added loadCommonMetadata() and loadMetadata() methods, along with a new AVMetadataItem class for accessing detailed metadata of the currently playing asset. ## Pasteboard API Introduced a new Pasteboard API for reading and writing clipboard data. The old Clipboard API has been deprecated. ## Gesture System Added comprehensive gesture APIs and modifiers: - View modifiers: gesture, highPriorityGesture, simultaneousGesture, defersSystemGestures, and the new lineSpacing modifier. - Gesture APIs: Gesture, DragGesture, LongPressGesture, MagnifyGesture, RotateGesture, TapGesture. These additions bring gesture and layout handling closer to native SwiftUI behavior. ## UIImage Utilities Added new utility methods to the UIImage class: - Instance methods: toJPEGBase64String(), toPNGBase64String(), toJPEGData(), and toPNGData(). - Static method: fromBase64String() for creating images directly from Base64-encoded strings. ## Widget System Update Widgets are now divided into two kinds: - User Widgets: for completed, published widgets. - Test Widgets: for widgets under development. This separation prevents interference during refresh. Added new methods Widget.reloadUserWidgets() and Widget.reloadTestWidgets() to reload each type independently. ## ControlWidget Enhancements Added a new Button control type that can open the app and execute a specified script. ## CustomKeyboard Environment The Safari API is now available within the CustomKeyboard environment. --- # Improvements ## Knowledge Base Import Fixed the issue preventing documents from being imported from external directories into knowledge bases. ## Widget Rendering Fixed an issue where widgets failed to render local images correctly. ## Text File Handling Fixed a bug where tapping a text file to open it in Scripting could repeatedly trigger the editor view. --- # Fixes ## Health API - Fixed an issue where Health.queryStatistics and Health.queryStatisticsCollection could not read data correctly. - Fixed an issue in the HealthStatistics class where quantity methods failed to return correct values when a source parameter was provided. ## Widget Execution (iOS 26) Fixed an issue where tapping a widget to run a script on iOS 26 could trigger the action twice. ## Modal Dismissal After Script Exit Fixed an issue where views such as Safari, DocumentPicker, Photos, and QuickLook were not automatically closed after calling Script.exit().

# New Features Knowledge Base You can now import multiple files at once by selecting a directory. Assistant Tool Introduced a built-in query knowledge bases tool, enabling the Assistant to search associated knowledge bases when completing tasks. ControlWidget (iOS 18+) Added ControlWidget, allowing you to place Button and Toggle controls in Control Center and assign scripts to handle their logic. Custom Keyboard Added the CustomKeyboard API to create and present your own keyboard UI, handle input events, and insert text programmatically. Bluetooth APIs Introduced BluetoothCentralManager and BluetoothPeripheralManager APIs. Build end-to-end Bluetooth experiences, including scanning, connecting, reading/writing GATT characteristics, subscribing to notifications, advertising, and exposing custom services/characteristics. Added layoutPriority View Modifier Introduced support for the layoutPriority view modifier, allowing developers to control how space is distributed among sibling views when layout constraints are tight. This behavior is consistent with SwiftUI’s native layoutPriority(_:). Introduced modifiers Property and ViewModifiers System A new modifiers property, along with the ViewModifiers class and the modifiers() helper function, has been added to enable fluent, chainable application of view modifiers. This system supports applying the same type of view modifier multiple times (e.g., repeated padding() or background() calls) and ensures modifiers are applied in the exact order they are chained, closely mirroring the behavior of SwiftUI. SVG Rendering Added a new SVG rendering component to display vector graphics seamlessly. Custom Fonts Now supports using fonts installed via the system or third-party apps. # Improvements Request API Added an allowInsecureRequest field to RequestInit / Request for controlling whether insecure requests are permitted. Location API Location.requestCurrent now returns cached location data by default if available. Added a new optional parameter options.forceRequest to always fetch the latest location. Developer Server The dev server now remembers and records the last connected address for faster reconnections. Storage Enhancements set, get, contains, remove, setData, and getData now accept an optional options.shared parameter for working with shared storage, which is accessible across all scripts for easier cross-script functionality. Fixes Assistant Tool Calls Fixed an issue where the Assistant could misparse tool parameters when invoking tools, improving reliability of tool execution. Photos API Fixed an issue where dismissing the Photos.pickPhotos sheet by swiping down would not resolve the promise. HealthKit Permissions Fixed an issue where requesting Health permissions did not trigger the authorization dialog. Script Advanced Settings Fixed an error when renaming a script in the Advanced Settings page, which could cause a refresh failure after saving. # Changes API Providers Removed the Pollinations.AI API provider.

New Features - On-Device Knowledge Base (iOS 18+) Add local knowledge bases to enhance Assistant with RAG (Retrieval-Augmented Generation) capabilities. - Chat Presets Create presets with predefined Assistant tools, rules, and linked knowledge bases for faster, customized chats. - Spotlight Integration Search and launch scripts directly from Spotlight. - File App Integration Open .js, .jsx, .tsx, and .json files in Scripting from the Files app. - Script Metadata script.json now supports version, description, localizedNames, localizedDescriptions, author, contributors, and more. Script module also add the metadata property with these information. - Translation APIs (iOS 18+) New Translation and translationHost APIs for building multilingual workflows. - Notifications Notification.schedule introduces a new tapAction parameter: - runScript: run a script when tapped - openURL: open a specified URL when tapped (The old avoidRunningCurrentScriptOnTapped option is now deprecated.) - Widget Interaction Options Widget configuration now supports Open URL under When Interacting, allowing a widget tap to launch a URL. - Storage API Added keys() and clear() methods. Storage operations are now scoped to the current script, preventing key collisions across scripts. Keys are automatically migrated internally, so developers don’t need to handle any changes manually. - SSH in Widgets SSH functionality is now available inside widgets. Improvements - Optimized Assistant interactions for smoother experiences. - Improved script importing — scripts now auto-compile and open in the editor. - New context menu actions in the editor: Delete All and Copy All. - Request API: added shouldAllowRedirect handler to Request / RequestInit. - Data API: new compressed() and decompressed() methods. - OpenAI requests now use the new Response API. Fixes - Fixed an issue where switching themes in Widget.preview didn’t update text colors. - Corrected a typo in the safeAreaInset API. - Fixed a bug where renaming a script inside a group could cause it to disappear. - Resolved multiple API bugs for better stability.

New Featrures - Unified Script Format: Scripts are now exported with the .scripting extension. A simple tap on any .scripting file automatically launches Scripting and imports the script. - Expanded SSH Capabilities: New APIs, including SSHClient and SFTPClient, enable secure remote connections and file transfers. - Updated Reminder API: The Reminder class has added the dueDateComponents property, deprecating dueDate and dueDateIncludesTime. Assistant Enhancements - Optimized text-rendering performance for large-language-model responses, delivering smoother, more responsive output. - New OpenRouter API Provider, and now you can view available models and quickly add them after entering the API Key. Bug Fixes - Fix issues with importing remote scripts and updating remote resource configurations. - Fixed the issue where Reminder.dueDate returns null, and added the dueDateComponents property to Reminder. The previous dueDate and dueDateIncludesTime properties have been deprecated.

# New Features ## Remote Script Import - Import scripts directly from a GitHub repository or any remote server, making it easy to share. ## Enhanced Data API - Data.size property to retrieve the byte length of a Data object. - Data.append() and Data.slice() methods for more flexible binary manipulation. # Performance & Optimization - Optimized OpenAI API request. - Reduced memory footprint in Live Activities and Widgets. - Widgets no longer compile scripts automatically in the widget environment. # User Experience Improvements - Assistant interactions have been streamlined for faster, more intuitive responses. - On relaunch, the app now restores you to the last‑viewed Home tab, so you can pick up right where you left off. # API Updates ## WebViewController.evaluateJavaScript - Now requires using return within your script to send back a value. - Returns a Promise, so you can handle asynchronous results directly. ## WebViewController.addMessageHandler - Now returns a Promise that resolves once the handler has been successfully registered. # Bug Fixes - Fixed an issue where text failed to update correctly when switching themes on the widget preview page.

- Fixed the issue that the base URL with port of custom API provider cannot be connected. - Enhanced the code editor to display additional comment information and resolved the issue of extra spaces being automatically inserted when opening an empty editor.

Assistant Experience Enhancements - Extract text from local files or web pages and send it along with your message - Select and run scripts directly within the Assistant output pane, with results appended to the conversation - Improved custom API provider workflow: after entering a Base URL and API Key, fetch and display all available models with one action New API Support - OAuth2 Module: Seamlessly implement the full OAuth2 authentication flow - createOAuthCallbackURLScheme: New Script class method to simplify callback URL scheme configuration when using the OAuth2 module - MessageUI Module: Invoke the system messaging interface to quickly send SMS or email - Crypto Module: Comprehensive upgrade with support for MD5, SHA1, SHA256, SHA384, SHA512, HMAC-MD5, HMAC-SHA1, HMAC-SHA224, HMAC-SHA256, HMAC-SHA384, HMAC-SHA512, and AES‑GCM encryption/decryption (legacy MD5 module deprecated) - Data Class Extensions: Added toHexString and fromHexString methods for easy conversion between hexadecimal strings and binary data Share Extension Improvements - After saving a script via the iOS Share Sheet, choose whether to open Scripting immediately - If opened, the app will automatically refresh and load the newly saved script iOS 17 Compatibility Updates - Fixed an issue where some icons did not display correctly on iOS 17 - Resolved occasional blank screens on the script page

HealthKit Integration Upgraded New Health API to access iOS HealthKit data Built-in sample scripts for common health tasks: Step Count: widget script displaying today’s steps Record Body Mass: page tool and assistant for logging weight Read Basic Physical Data: assistant tool to fetch height, birthdate, sex, etc. Read Body Mass: assistant tool to retrieve historical weight records Record Food Intake: assistant tool to log daily meals Read Food Intake: assistant tool to query food intake history Smarter Notifications Proper configuration of Time Sensitive Notifications to ensure critical alerts are never silenced Charts Components Enhancements Expanded Charts API with additional properties for greater flexibility and richer visualizations

Advanced Notification System Enhancements Introduced CalendarNotificationTrigger, LocationNotificationTrigger, and TimeIntervalNotificationTrigger to support more flexible and powerful notification triggers. The old triggerTime and repeatsType parameters in Notification.schedule are now deprecated. Use the unified trigger parameter instead. Added the DateComponents utility class to simplify creating calendar-based notification triggers. Notification.getAllPendings now returns an array of NotificationRequest objects, offering detailed access to pending notifications. Notification.getAllDelivereds now returns NotificationInfo instances with a new request property (of type NotificationRequest). The original fields on NotificationInfo are now deprecated and should be accessed via the request. Widget Improvements and Preview Support Added the widgetBackground view modifier to enable proper background styling for widgets in iOS 18+ tinted mode. Introduced the Widget.preview method, which can be used inside index.tsx to enable live previews of widgets—ideal for custom configuration pages or editing environments. Documentation Updates Added several documentation enhancements, including updated references for the Charts API and related view components.

Added support for widgetAccentable and widgetAccentedRenderingMode view modifiers to adapt widgets to iOS 18+ tinted mode Introduced DynamicImageSource for the Image component, allowing widgets to display different images for light and dark modes Improved the user experience of Document Picker and Photos Picker Fixed various bugs to enhance stability and performance

- Added support for selecting API provider and model when using Assistant.requestStructuredData - New setting to configure whether tools in a single assistant reply run in parallel or sequentially - Assistant messages now support rich rendering of HTML and Mermaid diagrams - Introduced new view modifiers: scrollTargetLayout, scrollTargetBehavior, scrollContentBackground, truncationMode, allowsTightening, flipsForRightToLeftLayoutDirection, containerRelativeFrame, safeAreaPadding - Notification module now includes methods to manage script-specific notifications correctly - Fixed issues where some notification methods did not behave as expected - Improved interaction experience and fixed several bugs that could cause crashes

New Features * Drag-and-Drop Support Added a new `onDropContent` view modifier, enabling scripts to receive files dragged from other apps. * Improved Gradient API Introduced a new utility for working with gradients, making gradient-related code more readable and maintainable. * Enhanced File Writing Added `FileManager.appendText` and `FileManager.appendData` methods to support appending text or binary data to existing files. * New AbortController API Replaced the legacy `CancelToken` class with the modern `AbortController` and `AbortSignal` APIs for better cancellation handling. * Shortcut Enhancements Introduced new shortcuts: "Run TypeScript Code" and "Run Script for Audio Recording". Scripts run via the "Run Script" shortcut can now interact with Live Activity and Audio Playback APIs. Improvements * Documentation Updates Added detailed documentation for view modifiers to help developers better understand and utilize layout and styling capabilities. * Memory Optimization Improved memory usage when running scripts in Widgets and AppIntents, leading to more efficient performance.

Assistant Enhancements - Fixed intermittent failures when invoking multiple tools concurrently, ensuring stable multi-tool execution - Optimized chat interface styling and interaction flow for a smoother user experience - Integrated pollinations.ai free API (deepseek & deepseek‑reasoner models); special thanks to pollinations.ai for their support Script Management & Compatibility - Improved script grouping operations for more efficient organization - Added script search functionality on the Dev Server page for quick lookup and editing - Resolved layout issues on iPad script page to ensure consistent cross‑device presentation Platform Events & PDF Support - Added support for scenePhase app lifecycle events to monitor foreground/background transitions - Introduced PDFDocument and PDFPage APIs for creating, reading, and manipulating PDF files Data Visualization & Notification Enhancements - Extended ChartMarkProps with foregroundStyleBy, symbolBy, symbolSizeBy, positionBy, lineStyleBy, etc., for richer chart styling - Enhanced Notification.schedule with avoidRunningCurrentScriptWhenTapped parameter to control script execution on notification tap

Assistant Improvements * Support for invoking multiple tools in a single response * Support for previewing HTML and Mermaid diagrams, rendering block-level LaTeX formulas * Temporary editor for running TS/JS code directly in chat * Enhanced chat window layout and interaction experience * New prompt templates for quickly inserting common instructions New System APIs * Vision API: extract text from images or scan documents into text * Crypto API: access common cryptographic functions Workspace Enhancements * Script grouping support for better organization * Keyboard shortcuts supported on external keyboards and macOS Stability & Performance * Improved interaction in the FileBookmarks management page * NavigationLink performance improvements and fix for view modifier inheritance issues * Fixed crash issue when calling `new CalendarEvent()` on certain system versions * Various bug fixes and overall performance optimizations

Fixed an issue that caused the app to crash on iOS 18.4

- Added Custom Role Mode for the Assistant: You can now define custom roles for the AI, not just limited to code generation. - Assistant tools can now be mentioned directly in the input box for quicker access. - All scripts are now saved in the "scripts" folder under Documents for better organization. - Fixed an issue where file bookmarks were not working properly. - Corrected various documentation errors.

- Assistant Tool is now script-based and can be created via Assistant - Save scripts to Scripting directly from other apps like browsers - Widget preview now supports interaction and live UI updates - New URL Scheme APIs and singleMode support in Script.run - StrokeStyle now supports lineWidth, lineCap, and lineJoin - New Wake Lock API to prevent device sleep during execution - Fixed Shortcuts param parsing issue on macOS and other minor bugs

Fixed the bug causing the app to crash.

New APIs to Empower Your Scripts - Contact API added — access, edit, and delete contacts directly from your script - Mail API added — launch the email composer view within your script - FileManager now supports mimeType and destinationOfSymbolicLink APIs to fetch file MIME types and resolve symbolic links Enhanced UI Features - Added AngularGradient and MeshGradient (iOS 18+) for more advanced and colorful UI designs - New redacted / unredacted view modifiers — easily apply redaction effects for sensitive data Smarter, More Customizable AI - Support for Custom Assistant Rules — define your own AI behaviors - Support for adding Custom AI API Providers — integrate your preferred AI services beyond built-in options Improved Local Development Experience - Development Server now supports QR code connection and manual address input, making it easier to connect and debug Bug Fixes & Performance Improvements - Fixed some typos in the Weather API - Improved Assistant rendering performance for a smoother experience

- Fixed an issue where the chat window may crash.

- Optimized overall performance for a smoother experience. - Fixed an issue where the chat window might jitter when the assistant outputs streaming response. - Resolved an issue where extra slashes in file or directory Mentions prevented content from being sent correctly. - Fixed an issue where the editor did not automatically switch to the corresponding file when using file-writing tools. - Addressed a crash issue on iPad when calling `Dialog.actionSheet`.

- Assistant Overhaul - Custom Assistant Tools - Local Development Server - New API Additions - Bug Fixes & Improvements

- Added functionality for task completion through conversations with large AI models.

- The Widget.present now supports passing a second parameter to control when the widget should be refreshed. - New APIs such as AnimatedImage, AnimatedFrames, AnimatedGif, and swingAnimation have been added for displaying widget animations. - Added new properties to the Chart. - Optimized the notifications settings page. - Added language setting options.

- Added Search Files, Go to Symbol, Go to Line. - Added "Keyboard" API. - Removed RichText and use Text.styledText to render rich text content. - Bug fixes