Mirrors/talemate
1
0
Fork 0
mirror of https://github.com/vegu-ai/talemate.git synced 2026-09-02 20:20:40 +02:00
Code Issues Packages Projects Releases Wiki Activity
Files
main
talemate/docs/user-guide/node-editor/reference/nodes/util-packaging.md

87 lines
3.3 KiB
Markdown
Raw Permalink Normal View History

0.39.0 (#274) - **Help Agent** — A new agent that answers questions about Talemate itself — settings, agents, clients, the world editor — grounded in the bundled documentation, and able to change agent and application settings on request. - **Timeline Rollback** — Scrub a slider across a scene's automatic version history, preview the message history at any revision, then roll the scene back in place or fork the revision into a new save. - **Pi Bridge Client** — A new client type that drives generations through the pi coding agent's headless RPC mode, making any model pi can reach usable in Talemate. - **Application Settings** — Settings move out of their modal into an always-available Settings tab, with a single topic-grouped sidebar, a settings search, all API keys on one page, and unsaved-change tracking. - **Scene Library** — The home screen is rebuilt as a full-page landing view with a file-tree scene library, cover thumbnails and per-save metadata, scene and save deletion, and a drag-and-drop import dropzone. - **Fast Character Creation** — Generate a character in a single request instead of one prompt per aspect, with a Consolidate multi-select, a token budget, and a Fill in misses pass. Off by default. - **Scene Backdrop** — Set any scene illustration as a backdrop filling the scene view behind the messages, saved with the scene, with configurable text legibility and an Immersive quick-toggle. - **Scene Visual Manager** — World Editor → Scene gains a Visuals tab to browse, upload, generate and delete the scene's backgrounds and illustrations, and set the cover image and backdrop. - **Visual Prompt Finalization** — Post-processing actions — match and replace, or a free-form AI instruction — rewrite image prompts right before they reach the image backend, with per-scene and per-character overrides and reusable template sets. - fixes #271 - fixes #275 Plus 25 improvements and 39 bug fixes — see [CHANGELOG.md](https://github.com/vegu-ai/talemate/blob/prep-0.39.0/CHANGELOG.md#0390) for the full list.
2026-08-29 13:21:22 +03:00
# Packaging Nodes
Package node modules for reuse and installation into scenes — see [Package](../../core-concepts/package.md) for the packaging workflow.
<!-- glossary:generated - everything below this line is generated by `python -m talemate.game.engine.nodes.tools glossary --write` - do not edit -->
_4 nodes._
| Node | Registry path |
| --- | --- |
| [Dynamic Storyline Package](#dynamic-storyline-package) | `package/talemate/DynamicStoryline` |
| [Install Node Module](#install-node-module) | `util/packaging/InstallNodeModule` |
| [Package](#package) | `util/packaging/Package` |
| [Promote Config](#promote-config) | `util/packaging/PromoteConfig` |
## Dynamic Storyline Package
`package/talemate/DynamicStoryline`
Node module (base type `util/packaging/Package`) defined in `src/talemate/game/engine/nodes/modules/scene/dynamic-storyline-package.json`.
**Properties**
| Property | Type | Default | Description |
| --- | --- | --- | --- |
| `package_name` | `str` | `"Dynamic Storyline"` | The name of the node module |
| `author` | `str` | `"Talemate"` | The author of the node module |
| `description` | `str` | `"Generate a random story premise at the beginning of the scene."` | The description of the node module |
| `installable` | `bool` | `True` | Whether the node module is installable to the scene |
| `restart_scene_loop` | `bool` | `True` | Whether the scene loop should be restarted after the package is installed |
## Install Node Module
`util/packaging/InstallNodeModule`
Marks a node module for installation when placed inside a Package graph.
When the package is installed to a scene, each InstallNodeModule node causes
the referenced node module to be instantiated and added to the scene loop.
**Properties**
| Property | Type | Default | Description |
| --- | --- | --- | --- |
| `node_registry` | `str` | `unset` | The registry path of the node module to package |
## Package
`util/packaging/Package`
Graph that defines an installable package of node modules for easy scene
installation.
Place InstallNodeModule nodes inside it to mark node modules for
installation, and PromoteConfig nodes to expose module properties as
package configuration.
**Properties**
| Property | Type | Default | Description |
| --- | --- | --- | --- |
| `package_name` | `str` | `""` | The name of the node module |
| `author` | `str` | `""` | The author of the node module |
| `description` | `str` | `""` | The description of the node module |
| `installable` | `bool` | `True` | Whether the node module is installable to the scene |
| `restart_scene_loop` | `bool` | `False` | Whether the scene loop should be restarted after the package is installed |
## Promote Config
`util/packaging/PromoteConfig`
Promotes a single module property to be configurable through the scene once the package is installed.
Place inside a Package graph alongside the InstallNodeModule node whose
module property should be exposed.
**Properties**
| Property | Type | Default | Description |
| --- | --- | --- | --- |
| `node_registry` | `str` | `unset` | The registry path of the node module to package |
| `property_name` | `str` | `unset` | Property Name |
| `exposed_property_name` | `str` | `unset` | Exposed Property Name |
| `required` | `bool` | `False` | Whether the property is required |
| `label` | `str` | `""` | Label |
Reference in New Issue Copy Permalink