Singularity

CLI commands

Print the dynamic Las and built-in tool catalogue as JSON or a tab-separated table.

singularity tools

Spawn Las, build the same dynamic and built-in catalogue exposed to the model, and print it. Direct Most tools are omitted because this command takes no Most credential.

Invocation

singularity tools \
  --las-release-manifest <absolute-file> \
  --las-release-manifest-signature <absolute-file> \
  --las-release-trust-store <absolute-file> \
  --las-release-watermark <absolute-path> \
  [--agent-id <id>] [--format json|table]

Required inputs and options

  • The four Las release-pinning paths are required by clap. They are passed to Las as LAS_RELEASE_MANIFEST_FILE, LAS_RELEASE_MANIFEST_SIGNATURE_FILE, LAS_RELEASE_TRUST_STORE_FILE, and LAS_RELEASE_WATERMARK_FILE.
  • --agent-id / SINGULARITY_AGENT_ID is optional only when Skarbiec is not active. The default --las-only selection includes skarbiec, so the default surface set requires an explicit immutable identity.
  • --las-command node, --las-entrypoint ../las/src/mcp.mjs, --las-only <csv>, and optional --las-skip <csv> select the spawned Las process and surfaces.
  • --format json is the default; --format table selects the compact form. The MCP request and shutdown deadline is fixed at 120 seconds. This command enforces no required-surface list.

Output and state effect

JSON format prints the full pretty-printed tool definitions, including each function's name, description, and JSON Schema. Table format prints one name<TAB>description line per tool. The command does not open or write a being state directory. It shuts down the spawned Las process before returning.

Refusals

  • A missing Las entrypoint is refused as configuration: LAS entrypoint not found: <path>.
  • An invalid supplied identity is refused as mcp: invalid immutable Las agent identity.
  • Active Skarbiec without --agent-id is refused as mcp: Skarbiec requires an explicit immutable Las agent identity.
  • A Las executable that cannot start is refused as mcp: cannot start Las: <error>; missing stdio is mcp: Las stdin unavailable or mcp: Las stdout unavailable.
  • An incompatible initialization response is refused as mcp: Las negotiated an unsupported MCP version.
  • Clap refuses missing release-pinning paths or any --format value other than json or table before runtime code executes.

All MCP refusals exit 3; configuration and clap refusals exit 2; JSON serialization failures exit 5.