unsigned integer CLI input %s is not supported; use int or a

Error message

unsigned integer CLI input %s is not supported; use int or an explicit JSON encoding

What it means

CLI input authoring guard: unsigned integer kinds are rejected for direct CLI flags (their parsing and negative-value semantics differ); only signed int kinds or an explicit json encoding are supported.

Source

Thrown at shortcuts/common/typed_compile_data.go:95

			stringShape.Enum = append(stringShape.Enum, raw)
		}
		shape = stringShape
	case reflect.Bool:
		booleanShape := typedBooleanShape{}
		for _, raw := range schema.enum {
			v, err := parseBool(raw)
			if err != nil {
				return nil, fmt.Errorf("enum value %q is not boolean", raw)
			}
			booleanShape.Enum = append(booleanShape.Enum, v)
		}
		if hasStringConstraints(schema) || hasNumberConstraints(schema) || hasItemConstraints(schema) {
			return nil, fmt.Errorf("boolean field has incompatible schema constraint")
		}
		shape = booleanShape
	case reflect.Int, reflect.Int8, reflect.Int16, reflect.Int32, reflect.Int64, reflect.Uint, reflect.Uint8, reflect.Uint16, reflect.Uint32, reflect.Uint64:
		if input && baseType.Kind() >= reflect.Uint && baseType.Kind() <= reflect.Uint64 {
			return nil, fmt.Errorf("unsigned integer CLI input %s is not supported; use int or an explicit JSON encoding", baseType)
		}
		integerShape := typedIntegerShape{}
		if schema.minimum != nil {
			v := int64(*schema.minimum)
			if float64(v) != *schema.minimum {
				return nil, fmt.Errorf("minimum must be an integer")
			}
			integerShape.Minimum = &v
		}
		if schema.maximum != nil {
			v := int64(*schema.maximum)
			if float64(v) != *schema.maximum {
				return nil, fmt.Errorf("maximum must be an integer")
			}
			integerShape.Maximum = &v
		}
		for _, raw := range schema.enum {
			v, err := strconv.ParseInt(raw, 10, baseType.Bits())

View on GitHub (pinned to 7fd6ef3c07)

Solutions

Use a signed int type, or declare encoding:"json" for the field

Defensive patterns

Strategy: validation

When it happens

Trigger: Thrown at shortcuts/common/typed_compile_data.go:95 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of larksuite/cli@7fd6ef3c07 (2026-09-04). Data as JSON: /api/errors/b6e5a472323c6c5b. Report an issue: GitHub.