> ## Documentation Index
> Fetch the complete documentation index at: https://docs.superember.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Workflow package

> Reference for the SuperEmber workflow package model.

A SuperEmber workflow is a package, not only a canvas.

```text theme={null}
workflow_package
  definition
  interface
  bindings
  metadata
```

## Definition

The definition is the graph:

* nodes
* edges
* source and target ports
* node type
* node version
* node label
* node configuration
* input mapping
* canvas position

## Interface

The interface is the workflow contract:

* input schema
* output schema
* trigger declarations
* sub-workflow contract when reused by another workflow

## Bindings

Bindings are runtime references:

* credentials
* channels
* agents
* fleets
* connectors
* models
* endpoints
* resources

Bindings can be required or optional.

Templates replace bindings with placeholders so secrets and concrete IDs are not exported as live values.

## Metadata

Metadata describes ownership and behavior:

* name
* description
* visibility
* risk labels

Workflow visibility can be private, workspace, or organization scoped.

## Why This Model Matters

The package model enables:

* visual editing
* AI-assisted editing
* validation before publish
* immutable published versions
* test runs
* template export/import
* binding remapping
* reliable run history

## Minimal Example

```json theme={null}
{
  "definition": {
    "nodes": [
      {
        "id": "trigger",
        "type": "trigger.manual",
        "typeVersion": 1,
        "config": { "label": "Start" }
      }
    ],
    "edges": []
  },
  "interface": {
    "triggers": [{ "type": "manual" }]
  },
  "bindings": [],
  "metadata": {
    "name": "Manual starter",
    "visibility": "private"
  }
}
```