Changelog

Feature release for Parameter Controls, a new setting that allows server bots to add additional input elements to their UI on Poe.

• Added Parameter Controls setting for server bots
• Allows server bots to add additional input elements to their UI
• Enables more interactive bot experiences

client: add extra_headers to stream_request()

• Added extra_headers parameter to stream_request() function
• Enables custom headers in streaming requests

App Creator now uses Lyria by default to create apps with music generation features.

• Lyria is now the default music generation model in App Creator
• Enables creation of apps with music generation features
• Example: Make an app that allows users to upload images and generate music clips based on the image content

Add a file upload function to client. This should enable file input for bot query requests.

• Added upload_file function to client
• Enabled file input for bot query requests
• Improved file handling capabilities

App Creator now uses Runway-Gen-4-Turbo by default to create apps with video generation features.

• Runway-Gen-4-Turbo is now the default video generation model
• Enables creation of apps with cinematic video generation
• Example: Make an app that brings photos to life with cinematic camera movements and atmospheric effects

App Creator now always edits the latest version of your app code and is powered by Claude Sonnet 4.

• App Creator now always edits the latest version of your app code
• No longer supports editing older versions to avoid code edit failures
• Powered by Claude Sonnet 4 for improved performance
• Edits rather than rewrites code more frequently
• Makes less unsolicited edits
• Creates apps with improved UI

Previously the total length of a bot's response could not exceed 100,000 characters. This has now been updated to 512,000 characters. To see other limits visit https://creator.poe.com/docs/poe-protocol-specification#limits.

• Increased response limit from 100,000 to 512,000 characters
• Applies to all server bot responses
• Updated protocol specification with new limits

The default values on SettingsResponse are changing in the next version of the Poe Protocol, and this updates fastapi_poe to use the new version's functionality.

• Updated protocol version to 1.1
• Changed default values on SettingsResponse
• Updated fastapi_poe to use new protocol functionality

App Creator now automatically performs HTML and JavaScript syntax checking when editing code.

• Automatic HTML syntax checking during code editing
• Automatic JavaScript syntax checking during code editing
• Prevents syntax errors in generated apps

App Creator now handles combining /repeat and multiple at-mentions in parallel messaging more effectively.

• Better handling of /repeat command with multiple at-mentions
• Improved parallel messaging performance
• More effective combination of multiple commands

App Creator now uses GPT-Image-1 by default to create apps with image generation features.

• GPT-Image-1 is now the default image generation model
• Enables creation of apps with advanced image generation
• Example: Make an app that turns photos into 3D chibi anime style images

Canvas apps now support file downloads and external links functionality.

• Added support for file downloads in canvas apps
• Added support for external links in canvas apps
• Example app: Drawing canvas with download button
• Example app: Website with links to other famous websites

You can now remix eligible canvas apps using App Creator to customize them into your own unique versions.

• Remix feature launched for canvas apps
• Users can customize existing apps into unique versions
• Apps with remix enabled show a 'Remix' button in the header
• Creators can control whether their apps can be remixed
• Apps created before April 21, 2025 have Remix enabled by default

New methods and settings for server bot creators to define and explain variable pricing for their bots.

• New method authorize_cost: used to ensure the user is willing to spend enough points before you make potentially expensive model calls
• New method capture_cost: used to capture the actual cost after you perform the model calls
• New setting cost_label: used to show a short pricing string in the Poe UI (e.g. "100+ points")
• New setting rate_card (previously custom_rate_card): used to provide a more detailed explanation of your pricing structure

Add get_bot_response_sync, which is a synchronous wrapper around get_bot_response. This allows users to call the function more easily without having to worry about asyncio.

• Added get_bot_response_sync function
• Synchronous wrapper around get_bot_response
• Simplifies usage without requiring asyncio knowledge

Fix an issue with release 0.0.57 where attachments were not made if post_message_attachment was called at the end of get_reponse.

• Fixed issue where attachments weren't created when post_message_attachment was called at the end of get_reponse
• Resolves regression from version 0.0.57

Fixed an issue preventing the HTML Drag and Drop API from functioning properly on Chrome when users had the chat and canvas displayed side-by-side.

• Fixed HTML Drag and Drop API functionality on Chrome
• Resolved issue with side-by-side chat and canvas display
• Improved drag and drop user experience

Bots can now pass attachments to each other via fp.stream_request. OpenAI tool calling improvement included.

• Bots can now pass attachments to each other via fp.stream_request
• Call post_message_attachment function to emit file events to other server bots
• Calling bots receive files in the attachment field of a PartialResponse
• OpenAI tool calling improvement: request finishes without extra unnecessary second call if no tools are decided to be called, saving cost

Added better support for libraries that use Web Workers and WebAssembly, making it easier to build more powerful applications with less friction.

• Improved support for Web Workers and WebAssembly libraries
• Libraries now work directly without confirmation prompts
• Supported libraries include Pyodide, PDF.js, and HEIC2any
• Example: Run Python code within canvas apps
• Example: Create apps that analyze PDFs
• Example: Convert HEIC images to standard formats

Improved UI lag in long chats with App Creator via frontend rendering optimizations.

• Reduced UI lag in long chats with App Creator
• Frontend rendering optimizations implemented
• Better performance for extended conversations

App Creator can now incorporate various text, image, video, and audio bots into apps by default without explicit user instruction.

• Text bots: Claude-3.7-Sonnet, GPT-4o, GPT-4o-mini, o3-mini, Gemini-2.0-Flash
• Image bots: FLUX-pro-1.1, FLUX-schnell, remove-background, Bria-Eraser, TopazLabs
• Video bots: Runway, Veo-2
• Audio bots: ElevenLabs, PlayAI-Dialog
• No explicit user instruction required for incorporation

Improved App Creator's ability to stream responses from text bots immediately into the app rather than waiting for the bot response to finish.

• Improved streaming response handling from text bots
• Responses stream immediately into the app
• No longer waits for bot response to finish before displaying
• Better real-time user experience

Canvas app details now display monthly user counts for better analytics.

• Monthly user counts now visible in Canvas app details
• Better analytics for app creators
• Improved app performance tracking

You can now upload images as attachments directly to App Creator and use them in your app, making it easier to customize your app's design and experience.

• Upload images as attachments directly to App Creator
• Use uploaded images in your app customization
• Easier app design and experience customization
• Direct integration with app development workflow

Added the 'Game apps' category on home page and Explore page.

• New 'Game apps' category added to home page
• Game apps category added to Explore page
• Better organization of gaming-related canvas apps

Opening existing chats with canvas on mobile web now displays the canvas view by default, rather than the chat view.

• Canvas view now default when opening existing chats on mobile web
• Previously defaulted to chat view on mobile
• Better mobile user experience for canvas apps

App Creator will now use vanilla Tailwind CSS for styling by default, rather than Flowbite.

• Switched from Flowbite to vanilla Tailwind CSS
• Improved output quality, especially for dark mode styling
• Faster app loading speed
• Better default styling approach

Enabled Claude 3.7 Sonnet's 'thinking' capability by default for App Creator to improve performance. The default thinking budget is 4096 tokens.

• Claude 3.7 Sonnet 'thinking' capability enabled by default
• Default thinking budget set to 4096 tokens
• Improved App Creator performance
• Better handling of Markdown responses from bots in created apps

Initial launch of Canvas Apps and App Creator on the web platform.

• Canvas Apps feature launched on web platform
• App Creator tool launched for creating interactive apps
• Full web-based app development environment
• Support for interactive canvas-based applications

This release adds the new DataResponse object which bots can yield to attach a metadata string to their response.

• Added DataResponse object for attaching metadata to responses
• Metadata string can be accessed in the metadata field of associated ProtocolMessage
• Useful for storing additional information about previous messages in conversation

If allow_attachments and expand_text_attachments are both True, PDF files uploaded by the users will have their contents automatically appended to the conversation for the model to reference.

• PDF files now supported in expand_text_attachments
• PDF contents automatically appended to conversation when both allow_attachments and expand_text_attachments are True
• Previously only worked for text and html files

Previously, when defining server_bot_dependencies there was a limit of 10 calls to other bots for a single message. This limit has been increased to 100 calls for a single message.

• Increased server_bot_dependencies limit from 10 to 100 calls per message
• Enables more complex bot interactions and workflows

Updated the suggested optimized Poe Previews prompt to better support React. See https://creator.poe.com/docs/how-to-create-a-prompt-bot#optimize-prompt-for-previews for the full prompt

• Updated Poe Previews prompt with better React support
• Optimized prompt available in documentation
• Improved preview generation capabilities

Added ability for server bots to help users create prompt bots with pre-filled fields. See https://creator.poe.com/docs/server-bots-functional-guides#creating-bots-that-help-their-users-create-prompt-bots for more details.

• Server bots can now help users create prompt bots
• Support for pre-filled fields in prompt bot creation
• Detailed documentation available for implementation

Added download_filename for specifying a filename when downloading from url. Previously the filename from the download_url was always used. This enables bots to set a custom filename for attachments they post via download_url.

• Added download_filename parameter for custom filenames
• Previously filename from download_url was always used
• Enables custom filenames for bot-posted attachments

Users can now call sync_bot_settings using fp.sync_bot_settings() directly

• Exposed sync_bot_settings function for direct calling
• Available via fp.sync_bot_settings()

Prior to this change, the text field of ErrorResponse was not displayed on the client and errors always showed the text "Bot x ran into an unexpected issue". With this change, the text field is now displayed to the user, allowing for custom error messages.

• ErrorResponse text field now displayed to users
• Enables custom error messages instead of generic "Bot x ran into an unexpected issue"
• Recommended to put raw exception in raw_response field

Added an additional field sender_id in ProtocolMessage. This is intended to help bot creators differentiate between who sent a particular message, which is useful in a multi-bot chat.

• Added sender_id field to ProtocolMessage
• Helps differentiate message senders in multi-bot chat
• Useful for bot creators managing multi-bot conversations

Added enable_multi_bot_chat_prompting setting and increased bot message timeout from 120s to 600s.

• Added enable_multi_bot_chat_prompting setting (defaults to False)
• When enabled, Poe combines previous chat history into single message with special prompting
• Provides sufficient context for current bot in multi-bot chat
• Increased bot message timeout from 120s to 600s

Added expand_text_attachments and enable_image_comprehension settings to request parsed content/descriptions from text and image attachments with the query request.

• Added expand_text_attachments setting for parsed text content
• Added enable_image_comprehension setting for image descriptions
• Content sent through new parsed_content field in attachment dictionary
• Makes enabling file uploads much simpler
• Added enforce_author_role_alternation setting for LLM provider compatibility