Configuration reference

Specification - implementation in progress. All keys listed below are part of the specified interface. Keys marked (preview) are not yet enforced by the runtime in all environments.

vault.json keys

Root

Key	Type	Required	Default	Description
name	string	Yes	-	Unique vault name. Alphanumeric and hyphens only.
tier	string	Yes	-	"L1", "L2", "L3", or "L4"
environment	string	Yes	-	"sandbox", "staging", or "production"
description	string	No	-	Human-readable description. Shown in flexor status.

data

Key	Type	Required	Default	Description
data.catalog	string	No	-	PlexiFact catalog URI. Required for agents using PlexiFact skills.
data.default_connection_timeout_ms	integer	No	5000	Connection timeout for data source requests.
data.max_rows_per_query	integer	No	10000	Safety limit on result set size per skill invocation.

notifications

Key	Type	Required	Default	Description
notifications.default_channel	string	No	"slack"	"slack", "email", or "webhook"
notifications.slack_webhook	string	No	-	Slack Incoming Webhook URL or "env:VAR_NAME" reference.
notifications.email_from	string	No	-	Sender address for email notifications.
notifications.webhook_url	string	No	-	HTTP endpoint for webhook notifications.

audit

Key	Type	Required	Default	Description
audit.enabled	boolean	No	true	Whether to write audit log entries.
audit.retention_days	integer	No	90	Audit log retention in days.
audit.destination	string	No	"vault://audit-log/"	Where to write audit entries.
audit.secondary_destination	string	No	-	Additional destination (e.g., S3 bucket URI). (preview)
audit.include_inputs	boolean	No	false	Include skill inputs in audit entries. Enable for compliance-sensitive environments.
audit.include_outputs	boolean	No	false	Include skill outputs in audit entries.
audit.pii_redaction	boolean	No	false	Apply PII redaction to audit entries before writing.
audit.pii_patterns	string[]	No	[]	Regex patterns for PII redaction. Applied when pii_redaction is true.

sync

Key	Type	Required	Default	Description
sync.auto	boolean	No	false	Auto-sync on flexor deploy.
sync.pre_run	boolean	No	false	Sync vault before each agent run. Adds latency.

permissions (preview)

Key	Type	Required	Default	Description
permissions.who_can_edit_l2	string[]	No	-	List of team or user identifiers allowed to modify L2 vault files.
permissions.who_can_create_agents	string[]	No	-	List of team or user identifiers allowed to create agents.
permissions.who_can_deploy_production	string[]	No	-	List of team or user identifiers with production deploy access.

---

Skill YAML keys

Root

Key	Type	Required	Description
name	string	Yes	Unique skill identifier. Snake_case.
version	string	Yes	Semantic version string (e.g., "1.0", "2.1.3").
description	string	Yes	One sentence. Used in the skill library index.
tags	string[]	No	Categorization tags.
deprecated	boolean	No	If true, invocations log a deprecation warning.
replaces	string	No	Name of the skill this supersedes.
trigger_keywords	string[]	No	Keywords that improve skill discoverability in the library.

inputs / outputs

Each field under inputs or outputs:

Sub-key	Type	Required	Description
type	string	Yes	"string", "integer", "number", "boolean", "array", "object"
required	boolean	No	Applies to inputs only. Defaults to false.
default	any	No	Applies to inputs only. Used when value is not provided.
description	string	No	Shown in skill documentation.
enum	any[]	No	Restricts the value to one of the listed options.

steps

Each step in the steps array:

Key	Type	Required	Description
action	string	Yes*	Action identifier (e.g., "plexifact.catalog.get_feed_metadata"). *Required for action steps.
call	string	Yes*	Skill name to invoke. *Required for call steps.
args	object	No	Arguments to pass. Values can use template syntax.
capture	string	No	Variable name to store the step’s return value.
condition	string	Yes*	Boolean template expression. *Required for condition steps.
on_error.strategy	string	No	"fail" (default), "fallback", "skip", "retry"
on_error.max_retries	integer	No	Used when strategy is "retry". Defaults to 3.
on_error.fallback_value	any	No	Used when strategy is "fallback".
optional	boolean	No	If true in a parallel block, failure of this step does not fail the parallel group.

---

Agent YAML keys

Key	Type	Required	Description
name	string	Yes	Unique agent name. Snake_case.
version	string	Yes	Semantic version string.
description	string	Yes	One sentence. Shown in the agent roster.
owner	string	No	Team or user identifier. Used in alert routing.
trigger.type	string	Yes	"schedule", "event", "webhook", "manual"
trigger.cron	string	Yes*	Cron expression. *Required for schedule triggers.
trigger.source	string	Yes*	Event source. *Required for event triggers.
trigger.event	string	Yes*	Event name. *Required for event triggers.
trigger.filter	object	No	Key-value conditions that must match the event payload.
environment	string	Yes	"sandbox", "staging", or "production"
retry.max_attempts	integer	No	Number of retry attempts on failure. Defaults to 0 (no retry).
retry.backoff_seconds	integer	No	Seconds to wait between retries.
retry.on_final_failure	string	No	Action to take after all retries exhausted. "notify_ops" sends to the default notification channel.
tasks	array	Yes	Ordered list of steps (same structure as skill steps).
paused	boolean	No	If true, agent does not fire on trigger.
system_prompt	string	No	Prompt context for knowledge-base-assisted decision making. (preview)