Skip to main content

v0.37.1 (Alpha)

· 3 min read

Language work in Paraflow with order by, goal trees and with context. The broker adds service accounts and configurable system-actor lists. Paracord adds Node View — a canvas of the node with four zoom levels — and Netflow gains a live logs pane. The Python SDK moves to 3.0.

ComponentVersionChange
Paranet broker2.18.1← 2.17.0
Paraflow3.10.0← 3.9.0
Paracord0.25.0← 0.24.0
Python Paranet SDK3.0.1← 2.1.0
Agentic Runtime1.0.2unchanged
Paralogue2.20.1unchanged

Note: 0.37.0 reached preproduction and was superseded before reaching production.


Paranet (broker 2.18.0 → 2.18.1)​

  • System actors and privileged skills are configurable. PARANET_SYSTEM_ACTORS and PARANET_PRIVILEGED_SKILLS replace the built-in lists when set, so a deployment can add system actors — which now live in para rather than the broker — without a new broker build. A set value replaces the whole list, so any default you still want must be listed.
  • Fixes. An optional paranet:any no longer generates a malformed schema. A request with no partition and no parent conversation now takes its partition from the author's version pre-release tag, so requests originating from events run in the right partition.

Paraflow 3.10.0​

Language​

  • order by on select and foreach: select table(...) order by <col-or-var> [asc|desc], .... Local tables sort in-process; SQL backends emit ORDER BY.
  • goal tree as a right-hand side: let $x = goal tree !goal(bindings); returns the goal's plan as a nested object of {uid, name, data, state, children[], predecessors[]}.
  • with context !goal(...) { } — a with variant taking exactly one goal pattern. It queries for the goal, fails with a Match exception if more than one row matches, then loads it before running the body.
  • New built-ins: SortByString(value, property), SortByNumber(value, property), LocalDateTime(datetime, timezone).
  • Calling a built-in where a user function is expected now reports "Unexpected function X not in expression" rather than "Undefined function".

Runtime​

  • Python SDK log lines are forwarded into Paraflow's logger at the level the SDK sends, tagged usercode. graphql-actor --exe (default uv) selects the Python launcher.
  • Fixes: the planner no longer panics on a closed channel at shutdown; concurrent GraphQL calls from several events no longer hang; events now have a GraphQL client of their own; a JSON-typed input is again serialised before storage.

SortByString, SortByNumber and LocalDateTime are not yet in the published Paraflow reference — the docs sync for them has not landed. The signatures above are from the 3.10.0 build.

Paracord 0.25.0​

  • Node View — a canvas of the node with four view modes (Actors, Skillsets, Skills, Full), selectable as a zoom from the smallest useful diagram to everything, Actors by default.
  • Usage overlay — fades nodes with no recorded traffic, from conversation usage scanned off the node.
  • Deep links into the Ledger — a skill or actor on the canvas links to the Ledger pre-filtered to its conversations.
  • Dependency resolution — actor and skill panels list what a skill depends on and which actors on the node provide it, flagging dependencies nothing provides. A Paraflow delegate names only subject/action, so this is answerable before anything runs rather than when a conversation fails.
  • Netflow gains a logs pane fed by a second WebSocket, filterable by actor and level, with timings in the goal inspector and a new overview page showing run list, connection state and last event.

Upgrade notes​

  • The Python SDK major version moves 2.1.0 → 3.0.1; the Paraflow runtime support for it shipped in v0.36.0.

v0.36.0 (Alpha)

· 2 min read

A deployment-focused release. Kubernetes support for Paraflow. Paracord gains Actor Hub grouping and a direct username/password login for devkit deployments. The broker introduces partitions.

ComponentVersionChange
Paranet broker2.17.0← 2.16.1
Paraflow3.9.0← 3.8.0
Paracord0.24.0← 0.23.0
Agentic Runtime1.0.2← 1.0.1
Paralogue2.20.1unchanged
Python Paranet SDK2.1.0unchanged

Paranet (broker 2.17.0)​

Partitions. 2.17 introduces the partition concept used by the rest of this release — a request carries an optional partition, and EntityId::partition() derives one from an actor version's pre-release tag. Paracord's overlay switch and the partition fixes in broker 2.18.1 both build on it.

Paraflow 3.9.0​

Mostly deployment support. No new grammar rules and no new built-ins; four existing rules changed (ObjectDestructure, RuleObjectDestructure, FunctionDecl, LineComment).

Python SDK 3 support​

Python actors now run as a child process driven over stdio callbacks, with uv creating the environment. Python callback events are marked %private so they no longer appear as skills, and skill docstrings can come from Python. The paraflow image gains Python 3, uv and Node.

Paracord 0.24.0​

  • Actor Registry is now Actor Hub. Label change only — the /actorhub route is unchanged.
  • Actor Hub groups actor versions. Versions of one actor are collected under it, newest first, and a page's skills and actions are listed alphabetically.
  • Overlay. A connection can carry a partition; the user panel gains an Overlay Enabled switch that sets it to your own actor id and sends it with every actor, skill and conversation query.
  • Cognito login. Some fixes and support for logging into your node with your Cognito user creds.

Behaviour change: DEFAULT_USER now defaults to root rather than root@1.0.0, and local auto-connect no longer appends @1.0.0 to a bare username.

v0.35.0 (Alpha)

· 4 min read

Note: 0.34.0 was overwritten in preproduction, which is why the version went from 0.33 → 0.35.

Note: This release is associated with para (CLI) 0.32.0.

This release rolls up work across Paranet (broker releases 2.14–2.16), Paraflow (3.7), the Python SDK, and Paracord (0.23). Highlights include actor roles across the stack, public documents and node-to-node document transfer, OIDC and session-cookie login, an embedded service endpoint on the broker, a dual-module (ESM + CJS) TypeScript client, and significant type-system and GraphQL improvements in Paraflow.


Paranet​

Features​

  • Actor roles — role support added to the broker (#190), including default actor types on skills.
  • Public documents — documents can now be marked public (#186).
  • Document transfer between nodes.
  • Embedded service (#188) — optional service endpoint on the broker.
  • Dual-module TypeScript client (#189) — the TS client is now built for both ESM and CJS.
  • OIDC support (#195).
  • Session cookie login.
  • Admin panel — the panel was renamed to "admin panel," with added redirects, updated logging, and a fix for serving from a non-root path.
  • Multiple group owners are now allowed.
  • GraphQL conversation scan — new query to scan conversations with a filter.
  • RC version overrides — versions can be overridden for -rc versions of a model.
  • Insecure connection options — gRPC client insecure option, plus a matching TS insecure connection option.
  • Observer added as a basic rule.
  • Database and objects defaults added.
  • Error messages now print the error source.
  • PartialOrd added to EntityId.

Fixes​

  • Certificate handling — fixed reqwest cert issues (#191) and related compilation errors.
  • Fixed gRPC client connections.
  • Fixed login issues, including logins from insecure nodes.
  • Database: fixed adding a new column to existing tables, fixed the provider column, and fixed a SQL issue.
  • Fixed skill matching for -rc versions.
  • Fixed GraphQL queries.
  • Fixed the stress-test server call.
  • Fixed tonic.
  • Build: fixes for the npm build, rollup, and the rollup config; fixed the insecure logic so it does not break in the browser; fixed TS compile errors.
  • Test fixes.

Maintenance​

  • Removed open networked calls, system actors (#197), the unused 0.0.0 actor, and other unused code.
  • Dependency bumps, workspace dependencies, dependency pruning, and Cargo.lock added.

Paraflow​

Features​

  • Type improvements (#179) — explicit type declarations plus output types for events, and documentation on types and skillsets.
  • GraphQL actor enhancements (#183) — support for boolean types, lists, and arbitrary objects in GraphQL; event code generation now always produces unique inputs.
  • Global constants in function bodies, and related GraphQL support.
  • Skill docstring support.
  • Quoted field names supported in the object constructor.
  • GetOr primitive added.
  • Abs added to the stdlib.
  • RPC context added to delegate.
  • PNCP allowed in rollback blocks.
  • Support for -rc versions of actors.

Fixes​

  • Fixed writing to text columns in Postgres with non-text values.
  • Fixed a crash in the type checker, and fixed the type checker for foreach.
  • Fixed two netflow state bugs.
  • Fixed failover/catch in the delegate start phase.
  • Fixed a GraphQL input error.
  • Fixed cert initialization and cert-util.
  • Fixed docgen and updated the stdlib docs; fixed a todo! in the stdlib.
  • Fixed the docstring regex, which had been parsing content greedily.
  • Several client fixes.

Maintenance​

  • Dependency upgrades, paranet-client version update, and version bumps.

Python SDK​

  • @event functions — decorated functions can now produce Paraflow events.
  • @init functions — support for @init and for creating a conversation.
  • Object types on inputs are now supported.
  • Generic types now use built-in JSON instead of the previous approach.
  • dataclass_transform support added.
  • Fixes to background support features.
  • Docs updated.

Paracord​

Features​

  • Actor role support (#128, #129).
  • Ledger rewritten to use backend filtering, with styling for filter reset.
  • onError exposed on pncpClient, via a refactor that exposes it on abstractClient.
  • Styling added to the persona node.
  • Symbols now allowed on the agentic runtime.

Fixes​

  • Fixed the actor filter (#131).
  • Added scroll to the data viewer (ledger details) and to the panel.
  • Fixed node view zoom and the edge option.
  • Access control fixes.

v0.33.0 (Alpha)

· 2 min read

This update introduces a new feature with Actor Personas, alongside some other small improvements.


🌐 Paranet​

🎭 Introducing Actor Personas​

We are introducing a powerful new abstraction layer: Actor Persona. A "Persona" is a role or a specific set of skills that can be fulfilled by different entities (Actors) across the network.

The Concept: Imagine a manufacturing facility with a "Side Panel Assembler" station.

  • The Persona: Side Panel Assembler (defines the skills required).
  • The Actors: John (Day Shift), Sherry (Night Shift), or even Optimus (Humanoid Integration).

By decoupling the work from the individual, Paranet enables:

  • Dynamic Flexibility: Seamlessly swap actors based on availability or capability without reconfiguring the entire operation.
  • End-to-End Tracking: Maintain a continuous thread of conversation and action history, regardless of which actor is performing the role.
  • Ledger Transcription: Every interaction is precisely transcribed to the ledger, providing a permanent, auditable record of role fulfillment.

Check out the [Technical Documentation] for implementation guides.

📄 Distributed Document Management​

We're improving how documents are handled within our distributed node system to increase interoperability.


🌊 Paraflow​

  • Persona Integration: Implementation of backend logic to support persona-based routing and task assignment.
  • Bug Fixes:
    • Annotations: Fixed an issue where certain annotations were being ignored during execution.
    • GraphQL Parsing: Resolved a bug where GraphQL queries failed when JSON input objects contained spaces in field names.

🧶 Paracord​

  • UI/UX Support: Updated the interface to reflect Actor Persona, allowing for better visibility into who (or what) is performing specific tasks.
  • General Maintenance: Performance tweaks to ensure the dashboard remains responsive during heavy network activity.

v0.32.0 (Alpha)

· One min read

Paracord​

🌙 Dark Mode by Default​

Paracord now initializes in Dark Mode out of the box.

  • Eye Comfort: Significant reduction in eye strain for long sessions.
  • Sleek Aesthetic: A high-contrast, modern interface that lets your work take center stage.
  • Note: If you prefer the light side, you can still toggle back in the Appearance settings.

🏗️ Schema Modernization​

Under-the-hood improvements to our core data structures to ensure stability and speed.

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.

v0.30.0 (Alpha)

· 2 min read

Summary​

The v0.30.0 release marks a significant milestone in our infrastructure consolidation and agentic capabilities. Key highlights include the unification of our database storage solutions to PostgreSQL, the introduction of a dedicated Agentic Runtime UI within Paracord, and enhanced production security through mandatory Node Certification.


Paranet Network​

  • Production Node Certification: To enhance network integrity, certification is now a mandatory requirement for all production nodes to leverage data federation with other nodes on the network.
  • Certification Enhancements: Refined the node certification workflow for better reliability and faster onboarding.

Paraflow​

  • Unified DB Storage: PostgreSQL is now the default backend for all actors. By streamlining database dependencies across the board, we have simplified the deployment and maintenance of Paranet nodes.
  • Query & Command Improvements:
    • Implemented support for LIMIT on the SELECT command.
    • Added support for NULL values within limit parameters.
    • Resolved issues with WITH queries.
  • Stability & Fixes:
    • Fixed a bug where the failover goal was utilizing incorrect inputs.
    • Fixed data deserialization issues for double types in PostgreSQL.
    • Various minor performance enhancements and bug fixes.

Paracord​

  • New Agentic Runtime Section: A brand-new UI allows users to interact directly with AI agents.
    • Skill Catalogs: Agents possess skill catalogs, which can include native capabilities or skills inherited from other actors on your node.
    • Natural Language Execution: Agents leverage AI to interpret natural language, providing the context necessary to call the appropriate deterministic skill at the right time.
  • Netflow & Settings:
    • Enhanced the Netflow section for better visibility.
    • Resolved various issues within the User Settings menu.

Agentic Runtime​

  • General stability improvements and minor bug fixes to the underlying runtime engine.

Para CLI​

  • Remote Management: Added the --remote flag with SSH configuration support for managing Remote Node VMs (Docker).
  • Production Readiness:
    • Enhanced support for production end-to-end (e2e) certification processes.
    • Improved federation workflows.
    • Added a compatibility check for PostgreSQL actor databases.
  • Developer Experience:
    • Introduced the para context command for better environment management.
    • Fixed a directory pathing issue specific to Windows builds.
    • Improved support and configuration for Kubernetes deployments.

v0.29.0 (Alpha)

· One min read

This update introduces critical bug fixes for the Paranet Broker and expands user customization options within Paracord via the new Settings menu.


🛠 Paranet Broker​

  • Paraflow Fix: Resolved a bug affecting "to inventory" usage within Paraflow workflows.
  • External UI Support: Fixed several issues in paranet-client to better support external UI integrations with Paranet nodes.
  • Version Tracking: Added node version metadata to allow for easier reference by Paracord and the CLI.
  • Actor Configs: Re-introduced the kind field for actor configurations; this field is now optional.
  • Maintenance: Various miscellaneous stability and performance improvements.

🎨 Paracord​

The standout feature of v0.29.0 is the introduction of the Settings Section, providing users with more control over their environment:

  • UI Themes: Toggle between Light and Dark modes to suit your preference.
  • Visibility Management: You can now toggle the visibility of system actors to declutter your actor hub.
  • Node Information: Quickly reference general node data, including the current platform version, directly from the interface.

v0.28.0 (Alpha)

· One min read

v0.28.0 is focused on stability, refinement, and essential bug fixes within Paraflow.

We also have a cool new Isaac Sim Kit!


🚁 New Starter Kit: Hello Drones​

We’ve added a new template to demonstrate actor composition within the Paranet. Using NVIDIA Isaac Sim, this kit shows how simple, independent actors can be orchestrated into complex behaviors.

  • What’s inside: A drone swarm simulation where write_phrases coordinates existing write_words and random_movements actors.
  • Key Concept: Real-world application of actor reusability and delegation.
  • Get Started: ```bash para init --template hello-drones
    *(Requires Isaac Sim 4.2+ and the `para` CLI)*

🛠️ Enhancements & Fixes​

Paraflow Optimization and bug fixes: General performance improvements to the language runtime for better execution consistency.


Note: Consistency is key during the Alpha phase. Keeping your local environment aligned with the latest release ensures you have the most up-to-date patches.

v0.27.0 (Alpha)

· 2 min read

Welcome to v0.27.0. This update marks a major milestone with the introduction of Agentic Runtime Actors, enabling AI-driven workflows, alongside significant CLI quality-of-life improvements and a long-awaited theme update for Paracord.


🤖 Agentic Runtime (v1.0.0)​

The headline of this release is the debut of Agentic Actors. Unlike traditional actors that follow rigid code paths, these actors are powered by AI models.

  • Natural Language Processing: These actors receive and respond to requests in plain English (or your preferred human language), allowing for more flexible and intuitive system interactions.
  • Learn More: We’ve added docs on how these work in the core_concepts section of our documentation under Agentic Actors.

🛠️ Para Netflow & CLI Enhancements​

We are making it easier to see what’s happening "under the hood" without needing to manually inspect Docker containers.

Netflow Commands​

  • para netflow goals: Launch a runtime web socket to view your live goal trees.
  • para netflow logs: A consolidated stream of runtime logging (Error, Warning, Info). This aggregates Paraflow logs into a single view, saving you from hunting through container logs.

Para Catalog​

New lifecycle commands are now available for catalog management, essential for agentic actors:

  • para catalog create
  • para catalog update

🎨 Paracord (v0.17.0)​

Your eyes can finally rest—Dark Mode has arrived.

  • How to toggle: Click on your User Icon in the navigation bar to switch between Light and Dark themes instantly.

💻 Paralogue (v0.20.1)​

  • ARM64 Support: Paralogue now officially supports ARM64 architecture.
  • Note: Paralogue is still in early testing phases. Expect more detailed documentation to follow as it stabilizes.

📚 Documentation Restructure​

We’ve completely reorganized our docs to better align with the actual developer journey. Based on feedback from our Alpha users, we’ve moved away from "feature-dumping" and toward a logic-driven flow:

  • Getting Started: Your entry point. Includes Intro, Installation, and Learning Requirements.
  • Kits: We’ve prioritized Starter Kits as launchpads.
    • New: Check out the hello_federation kit for a beginner-friendly lesson on multi-node development.
  • Core Concepts: The pillars of the Para ecosystem—Paranet, Federation, Agentic Actors, and Schemas.
  • Tooling: A dedicated home for the CLI, Paracord, and future developer tools.
  • Language: Where Paraflow syntax and our various SDKs live.

Coming Soon: We are currently consolidating common pain points to build a comprehensive Troubleshooting section.