commands:Command
A CLI-invocable SPARQL workflow.
Extends: matrix:Resource
Base class for slash commands. Invoked via /alias in CLI with optional natural language modifier. Script executes with ?modifier binding, results fed to agent for interpretation.
Properties
commands:alias (required, max 1)
CLI invocation name without leading slash (e.g., 'overdue-tasks', 'custom-command').
Command must have exactly one alias. Alias must start with lowercase letter, contain only lowercase letters, numbers, and hyphens.
Must be URL-safe: lowercase letters, numbers, hyphens, and colons. Combined with prefix to form full command name (e.g., 'ex:custom-command').
commands:description (optional, max 1)
Human-readable description of what the command does.
Command may have at most one description.
commands:interpretation (optional, max 1)
Guidance for how the agent should interpret and present the command results.
Command may have at most one interpretation.
Instructions for the agent on how to summarize, format, or act on the RDF results returned by the command script.
commands:prefix (optional, max 1)
Namespace prefix for the command (e.g., 'ex', 'proj').
Command prefix must be lowercase letters and numbers only.
Combined with alias to form full command name. For matrix commands, typically matches the matrix prefix. Full command is invoked as /prefix:alias.
commands:script (required, max 1)
CONSTRUCT or DESCRIBE script executed when command is invoked.
Command must have exactly one script.
Must use os:construct or os:describe content. Script has access to ?modifier binding containing natural language text after the command. Can use sub-agents (os:Find, etc.) to interpret the modifier.