Skip to main content
A private template is a user-owned workflow authored with TemplateSpec. Each version is immutable; execution must bind to an explicit template_id and version_id.

​
Read the bundled contract

The installed CLI carries the matching English and Chinese TemplateSpec documentation:
The syntax is loomloom template-spec docs [topic] --lang en|zh-CN. Topics include spec, authoring, examples, conversation, metadata, inputs, steps, bindings, and execution-units; use all for the complete set or omit the topic to print the index. English is the default language. The index reports spec and language revisions. Prefer these bundled documents over copied examples from another release.

​
Check, create, and version

Append an immutable version instead of editing history:
check is a local authoring validation step; the service can still reject an unavailable model or an environment-specific rule. create and create-version change remote state and require a separate, explicit confirmation when operated by an agent.

​
Topology rule: TS-TOPOLOGY-001

New templates, new versions, and Market publication cannot use bindMode=expanded in fieldBindings or paramBindings.
  • Use one workbook row per independently processed item.
  • For a fixed number of parallel branches, declare multiple explicit steps and connect them with dependsOn and upstreamBindings.
  • multiValue=true represents an ordered collection passed to a compatible input; it does not create dynamic executions.
  • TemplateSpec v1 does not support dynamic-cardinality step fan-out.
Historical versions that already use expanded execution remain compatible for execution. The restriction applies to new authoring and publication; do not rewrite historical versions in place.

​
Execute with a workbook

Download a new workbook when the template version changes. Compatibility with a workbook generated for another version is not promised.

​
Execute with JSONL

Never guess step IDs or substitute an inputAssetId for inputFileId. See Input assets for the distinction.