Skip to main content

v0.31.1 (Alpha)

· 3 min read

[!IMPORTANT] CLI Requirement: para (CLI) v0.29.0 or higher is required for compatibility with this release.

Summary​

This release introduces significant enhancements to the Paraflow language syntax, including native foreach loops and literal boolean support. A major shift in skillset management now allows for inline declarations within Paraflow source code, reducing reliance on external YAML files. Paracord and Paranet have also been updated to support complex, nested schemas and improved SQL JSON handling.

🌟 Key Highlights​

  • Inline Skillset Declarations: Define external and broadcast skillsets directly in .paraflow files, deprecating the need for separate .skill.yml files.
  • Complex Schema Support: Native support for array[T] and nested objects (including docref for file uploads) across the entire stack.
  • Enhanced SQL Integration: Direct support for json columns; INSERT, UPDATE, and SELECT now handle arbitrary objects without manual stringification.
  • Control Flow Improvements: Added foreach $item in $items { ... } syntax and support for true/false literals.

🌐 Paranet Network​

Schema Management​

  • Refactored SchemaRef: Improved for backwards compatibility with a new internal format.
  • GraphQL Enhancements: Added ability to fetch inputSchema and outputSchema directly via GraphQL queries.

Messaging​

  • Open Messaging: Implemented the ability to send open messages within a conversation.
  • Reliability: Improved resend implementation and added comprehensive test coverage.

Development​

  • Dev Node Access: Allowed logins on dev nodes to return empty tokens for easier local testing.
  • Client Updates: Updated paranet-client-ts to allow overriding the fetch implementation.

💻 Paraflow​

Syntax & Types​

  • foreach Loops: Added support for array types.
  • Boolean Literals: Added support for true and false literals (replacing the need for True()/False() functions).
  • Type Annotations: Explicit array[T] type annotations and model generation.

Logic & Goals​

  • Failover Goals: Refactored failover goals to be fully generic (GoalPrimary), enabling usage like !Fallible() else !Retry().

Utility Functions​

  • ConversationId: New utility function for session tracking.
  • Actor Context: New functions to retrieve the current Actor ID.

Database​

  • JSON Mapping: Refactored SQL params to support direct JSON mapping.
  • Generic Schema: Improved schema generation to be properly generic.
  • Postgres Fixes: Resolved issues regarding null insertion in PostgreSQL.

🎨 Paracord​

Dynamic UI​

  • Panel Interface: Updated to handle arbitrary object inputs and complex schemas.
  • File Uploads: Added support for file uploads (e.g., images array[docref]) within panel workflows.

Panel Enhancements​

  • Skill Requests: Added ability to respond to skill requests and retrieve historical messages.
  • Stream Management: New functionality to close streams within the panel interface.
  • UI Polish: Fixed pathing issues and filter label UI bugs.

🐞 Bug Fixes​

  • Compatibility: Fixed Windows-specific line ending issues in annotations.
  • Stability: Resolved type-checking errors in the combine parser and fixed SQLite store issues for ca_actor.
  • Cleanup: Removed unnecessary files and corrected internal function implementations.
  • Build: Re-introduced .npmrc and applied tweaks to improve compilation reliability.